Configuração do template de Excel

O passo inicial na criação de um novo relatório envolve a definição do seu modelo de relatório. Este modelo é um ficheiro Excel que contém uma folha específica denominada cob_config_v2. Aqui, especifica-se os dados a extrair da plataforma e onde devem ser inseridos.

Como se pode ver na imagem acima, esta folha especial está dividida em dois blocos:

• COB_ARGS: A secção onde especificará os argumentos utilizados no seu relatório
• COB_SHEETS: A localização para especificar que dados devem ser extraídos e onde devem ser inseridos.

COB_ ARGS

Esta secção funciona de forma muito semelhante a uma tabela de chaves e valores. À esquerda, especifica o nome da variável e, à direita, define o seu valor.

TIP

Certas fórmulas são suportadas. Por exemplo, é possível utilizar a função concatenar para construir as consultas de forma dinâmica no Excel.

The specialquery variable

Ao trabalhar com relatórios que requerem a receção das linhas seleccionadas a partir de uma pesquisa, é necessário utilizar uma variável denominada “query”. Esta variável conterá a query de consulta com os IDs de todos os registos seleccionados no formato id.raw:(id1 OR id2 OR ...).

COB_ SHEETS

Como visto anteriormente, as colunas necessárias para esta secção são:

column	description
Target Sheet	A folha onde os dados serão gravados.
Header Line	A linha com os nomes dos campos que queremos extrair informações.
Type of search	O tipo de pesquisa. Os valores suportados são: definição, domínio, elasticsearch
Target	Baseado no tipo de busca, pode ser o nome da definição, ou o nome do domínio ou o índice do elasticsearch, respetivamente.
search	A query que irá ser executada
Hide Sheet	Se no final do relatório a planilha deve ser escondida
Hide Header	Se no final do relatório a linha de cabeçalhos deve ser ocultada

Para cada linha acrescentada em COB_SHEETS, será incluída uma nova folha no relatório final, se ainda não estiver presente.

Como se pode ver no exemplo acima e com a folha Countries, estamos a definir que a informação que queremos extrair é:

• ID
• Country Code
• Short Name
• 2-alpha code
• Long Name