Para apresentar dados do docu tools em um Relatório em PDF ou Excel, utilizamos placeholders. Estes placeholders servem como marcadores dentro do seu Modelo, indicando onde os dados do docu tools devem ser inseridos. Por exemplo, você pode criar um placeholder como #{{project-name}} no Modelo, que será dinamicamente preenchido com o nome real do projeto no docu tools ao gerar o Relatório.
Existem diferentes grupos de placeholders para Excel e Word, pois alguns estão disponíveis apenas em um ou outro. Utilizando eficazmente esses placeholders, você pode criar Modelos dinâmicos e flexíveis que representam precisamente os dados de seus projetos, Relatórios e Tarefas.
Sintaxe e Design de Placeholders
Todos os placeholders são encapsulados em chaves duplas #{{ }} e devem seguir exatamente a sintaxe especificada, independentemente do idioma usado no texto do Modelo: Por exemplo, #{{pin-number}} é um placeholder válido que recupera o Número do Pin selecionado. Placeholders como {pin-number}, #{{pinnummer}} ou #{{pinnumber}} são inválidos devido a uma sintaxe incorreta e não funcionarão.
Placeholders não funcionam se contiverem espaços. Para criar um placeholder para um Título de várias palavras, substitua o espaço por um hífen -, por exemplo, use #{{dataset-room-info}} em vez de #{{dataset-Room info}}.
A aparência da saída é definida com base na formatação do placeholder no Modelo. Portanto, se o seu Relatório não estiver como você deseja, você precisará alterar o Modelo. Por outro lado, os dados dinâmicos são apresentados como foram inseridos no docu tools. Se houver um erro de digitação no Título do Pin exibido, ele deve ser corrigido no Pin correspondente no docu tools.
Áreas de Placeholders
Ao trabalhar com placeholders de Tarefas e Pins, uma estrutura específica deve ser observada. Como Pins e Tarefas frequentemente se repetem em um Relatório, é importante definir a seção específica onde esses placeholders aparecem. Esta área limitada é preenchida com dados de um Pin ou Tarefa, repetindo-se tantas vezes quanto aparecem no Relatório.
Estas seções sempre começam com #{{pins}} ou #{{tasks}} e terminam com #{{/pins}} ou #{{/tasks}}. Todo o conteúdo entre esses placeholders é repetido dependendo do número de Pins ou Tarefas. É importante notar que o / adicional está contido apenas na tag de fechamento.
Outras áreas incluem:
#{{pin-sort}}e#{{/pin-sort}}- Área para placeholders de ordenação de Pins.#{{pin-medias}}e#{{/pin-medias}}- Espaço para#{{pin-media-file-name}}em Relatórios Excel.#{{comments}}e#{{/comments}}- Área para comentários de Tarefas.#{{attendees}}e#{{/attendees}}- Seção para placeholders de contato.
Também existem seções onde o texto só é exibido se uma condição for atendida. Normalmente, os placeholders no Relatório não são exibidos se não houver dados para preenchê-los. Por exemplo, se não houver Tarefas em um Pin específico, os placeholders de Tarefas não serão exibidos. No entanto, para adicionar um cabeçalho que é exibido quando o conteúdo correspondente está presente, foram introduzidos placeholders If. Essas seções são posicionadas fora dos placeholders de abertura e fechamento e verificam a presença de conteúdo. Cabeçalhos são exibidos apenas quando há conteúdo que atende à condição especificada.
Definimos os seguintes segmentos if:
#{{if-tasks}}e#{{end-if-tasks}}- Cabeçalhos são exibidos apenas se houver pelo menos uma Tarefa ativa no Pin.#{{if-media}}e#{{end-if-media}}- Cabeçalhos são exibidos apenas se houver conteúdo de Mídia.#{{if-task-comment}}e#{{/if-task-comment}}- Cabeçalhos são exibidos apenas se a Tarefa contiver comentários.
Esses placeholders podem ser usados, por exemplo, da seguinte maneira:
#{{pins}}#{{if-media}}Fotos do Pin#{{end-if-media}}#{{picture-table-small}}#{{/pins}}
O cabeçalho "Fotos do Pin" não será exibido no Relatório se o Pin não contiver fotos.
Conteúdos Inativos em Relatórios
Em Relatórios, Tarefas inativas e Mídias são excluídas. No entanto, Pins inativos são incluídos no Relatório.
Placeholders para Relatórios
#{{today}}- A data de criação do protocolo para fácil identificação da atualidade do Relatório, o que permite um acompanhamento e monitoramento adequados do progresso na resolução de problemas ao longo do tempo.#{{weeknumber}}- Mostra o Número da semana em que o Relatório foi criado.#{{author}}- Indica o nome do usuário que criou o Relatório.#{{author-email}}- Mostra o Endereço de e-mail do criador do Relatório.#{{author-number}}- Mostra o número de telefone do usuário que criou o Relatório.#{{author-company}}- Mostra a empresa do criador do Relatório.#{{report-title}}- Mostra o Título dado ao Relatório no momento da criação no aplicativo.#{{report-filter}}- Mostra o Filtro usado para criar o Relatório. Funciona quando o Relatório é criado na Visualização em lista dos Relatórios.#{{pagebreak}}- Insere uma quebra de página em Relatórios Word.
Dica: Quebras de página gerais podem ser inseridas diretamente no Modelo Word como elementos estáticos. Se você deseja inserir uma quebra de página após cada Pin ou Tarefa, simplesmente insira o placeholder #{{pagebreak}}.
Placeholders para a Criação de um Campo de Assinatura
Esses placeholders permitem a assinatura direta dentro do aplicativo iPad e contribuem para a saída final do Relatório:
#{{signature-NAME}}- Exibe um campo de assinatura durante a criação do Relatório, que é então incluído no Relatório final.#{{signaturename-NAME}}- Gera um campo de texto para o nome do signatário durante a criação do Relatório em um iPad, que é então incluído no Relatório.
NOTA: Como esses placeholders podem ser usados várias vezes dentro de um Modelo de Relatório, é importante distingui-los. O segmento "NAME" do placeholder deve ser substituído por uma descrição significativa que indique o local no Relatório onde você deseja exibir a assinatura e o nome específicos.
Configure, por exemplo, um Relatório com dois campos de assinatura e nome usando a seguinte sintaxe no Modelo:
O Relatório exibirá os resultados conforme mostrado abaixo:
Esses placeholders estão incluídos em nosso Modelo de Relatório padrão "Diário de obra".
Placeholders para Informações Meteorológicas
Os placeholders fornecem dados relacionados ao clima com base no local especificado nas configurações do seu projeto. Para garantir sua funcionalidade, observe a validação à direita do endereço.
#{{weather-icon-info}}- Mostra a previsão do tempo para o endereço do projeto especificado com um pequeno símbolo meteorológico. O placeholder é formatado como uma tabela que mostra o símbolo do tempo na primeira coluna e a descrição da previsão junto com as informações de temperatura na segunda coluna.#{{weather}}- Quando este placeholder é usado em um Modelo de Relatório, uma nova seção é exibida na janela de criação do Relatório, selecionando automaticamente os dados meteorológicos para o dia atual. Ao Clicar no botão Editar, você pode selecionar ou alterar a data. Usando o botão de exclusão, a data é redefinida para o dia atual. Este placeholder não inclui um símbolo meteorológico.#{{pin-weather}}- Este placeholder fornece o clima do dia em que o Pin foi criado.
Placeholders para Ordenação de Pins
Com esses placeholders, você pode organizar Relatórios por Planos e Categorias e anexar um Título para garantir a ordenação correta no índice.
Se não houver um placeholder de ordenação específico, o aplicativo usa a ordenação padrão da Lista de tarefas de Pins. No entanto, os placeholders de ordenação substituem a ordenação padrão do aplicativo. NOTA: Esses placeholders são apenas para Relatórios Word.
NOTA: Os placeholders de ordenação devem englobar a área do Pin dentro da área de ordenação. O uso correto é:
#{{pin-sort}}...Placeholder de ordenação...#{{pin}}...Placeholder de Pin...#{{/pin}}#{{/pin-sort}}
#{{pin-sort}}- Abre a área de ordenação de Pins.#{{/pin-sort}}- Fecha a área de ordenação de Pins.#{{sort-by-plan}}- Esta função organiza os Pins pelo nome do Plano ao qual estão associados, ordenando-os subsequentemente pelos seus Números de Pin.#{{sort-by-category}}- Com esta função, os Pins são organizados por suas respectivas Categorias, com as Categorias ordenadas alfabeticamente de Z a A.#{{pin-sort-title}}- Este placeholder é usado em conjunto com um dos dois placeholders anteriores. Serve para mostrar o nome do Plano ou Categoria ordenado.