Criar modelo de relatório de visita HTML

Espaços reservados HTML

Em modelos de relatório de visita HTML. Os espaços reservados são definidos usando texto dentro dos marcadores no conteúdo das tags HTML ou são definidos como atributos de elementos HTML. Há cinco tipos de espaços reservados. Três deles são definidos usando texto dentro dos marcadores. Dois deles são definidos por atributos em elementos HTML.

Layout

Espaços reservados podem ser colocados em qualquer lugar como parte do conteúdo das tags HTML do documento. Assim, a construção a seguir é completamente válida.

<span>Nº da ordem de serviço ##ServiceOrder## tem uma data de início ##StartDate##</span>

Os espaços reservados ##ServiceOrder## e ##StartDate## são substituídos pelos valores correspondentes da visita no relatório de visita real.

Para definir uma seção de conjunto de dados, dois atributos são usados “data-dataset” e “data-datasetrow”.

O atributo “data-dataset” designa o elemento que está presente se houver algum registro no conjunto de dados. Quando o conjunto de dados não tem registros, o elemento não é exibido. Se algum conteúdo de cabeçalho e rodapé precisar ser exibido somente se houver algum registro, eles deverão ser contidos nesse elemento. Se qualquer conteúdo de cabeçalho e rodapé precisar sempre ser exibido, mesmo que não haja registros, é necessário colocá-lo fora desse elemento.

O atributo “data-datasetrow” designa o elemento que é repetido para cada registro do conjunto de dados. Cada seção repetida é preenchida com os valores de dados de um registro do conjunto de dados. Um elemento com o atributo “data-datasetrow” normalmente é definido dentro de um elemento com um atributo "data-dataset” correspondente.

Para que seja possível representar relações primário/secundário, o elemento do conjunto de dados do secundário deve ser agrupado no elemento da linha do conjunto de dados do primário. Essas relações entre primários e secundários estão presentes entre atividades e, por exemplo, custo de mão de obra.

No caso de atividades e custos de mão de obra, se o custo de mão de obra precisar ser apresentado por atividade, o elemento do conjunto de dados de custo de mão de obra deve ser agrupado no elemento da linha do conjunto de dados da atividade. Os conjuntos de dados têm uma estrutura para reconhecimento de uso como conjunto filho. Em vez de apresentar todos os custos de mão de obra de uma visita, somente o custo de mão de obra da atividade atual é exibido na seção de custo de mão de obra agrupada.

Nenhum elemento do conjunto de dados de documento

O conjunto de dados do documento é o conjunto de dados de base e tem somente um registro. Os elementos do conjunto de dados e datasetrow não precisam ser designados e não devem ser designados para o conjunto de dados do documento.

Elemento opcional do conjunto de dados

Designar um elemento do conjunto de dados com o atributo "data-dataset" que contém os elementos datasetrow é opcional. Se só um elemento repetido precisar ser exibido para o conjunto de dados, somente um elemento com o atributo “data-datasetrow” poderá ser designado. Isso é mostrado no exemplo 2. Para o conjunto de dados de atividades, não é usado nenhum atributo "data-dataset", somente um atributo “data-datasetrow” designa o elemento que deve ser repetido para cada registro no conjunto de dados de atividades.

Valores de dados primários no secundário

Se um elemento de conjunto de dados ou “datasetrow” contiver espaços reservados de dados que não correspondam a nenhuma das propriedades do conjunto de dados, a substituição ocorrerá usando o conjunto de dados primários. Se nenhuma correspondência for encontrada no conjunto de dados pai, o espaço reservado será correspondido aos valores do conjunto de dados do documento e, possivelmente, substituído por eles. Isso é mostrado no exemplo 2. Para o datasetrow de atividades, o código da ordem de serviço é impresso junto com a linha de atividade usando o espaço reservado ##ServiceOrderCode## do conjunto de dados do documento.

Totais

Para cada conjunto de dados que representa custos, totais são calculados. No modelo padrão, esses totais são apresentados no parágrafo do resumo.

Os espaços reservados Totalxxx e GrandTotal exibem valores de todos os custos das atividades selecionadas. As linhas de detalhes desses custos não necessariamente precisam ser apresentadas no relatório. Os espaços reservados TotalDetailxxx e GrandDetailTotal contêm valores somente a partir das linhas de custo de detalhes.

Editar o modelo

Para editar um modelo de relatório de visita HTML, é necessário ter conhecimento básico de HTML. É possível editar um arquivo HTML abrindo um editor de texto, mas há muitas ferramentas mais sofisticadas disponíveis para criar e editar arquivos HTML.

Estilo e imagens

O modelo não suporta arquivos externos. O estilo e as imagens devem ser integrados ao arquivo de modelo. Estilos na forma de CSS pode ser definidos in-line usando o atributo de estilo nos elementos HTML ou internamente no nível do documento usando um elemento de estilo na seção de cabeçalho. As imagens podem ser integradas ao documento HTML de várias maneiras.

Um exemplo de uma imagem integrada pode ser encontrado no modelo padrão HTML no LN. Esse modelo pode ser importado e baixado da sessão Modelos de relatório de visita (tsmdm5100m000) ou da sessão Arquivos adicionais(ttadv2570m000, arquivo adicional tssocLN_Mobile_Service_Visit_Report_Template.html).