Criar um modelo de relatório de visita de documento Rich Text

O modelo é armazenado como um documento rich text (.rtf). É possível criar ou modificar o modelo usando um processador de texto que oferece suporte a arquivos RTF.
Este guia do usuário usa o layout do modelo padrão em todos os valores e amostras. O modelo padrão completo foi adicionado no apêndice Modelo padrão para o relatório de visita. O modelo padrão também fica disponível no LN na sessão Modelo de relatório de visita (tsmdm5100m000).
Nota

Os modelos RTF são usados para o LN Mobile Service para Windows, portanto, não para a versão Android/iOS. A versão Android/iOS usa modelos HTML.

Espaços reservados para documento rich text

Em todos os modelos de relatório de visita de documento rich text, espaços reservados são definidos usando texto dentro dos marcadores. Há quatro tipos de espaços reservados. Todos eles são definidos usando texto dentro dos marcadores.

Notação Tipos de espaço reservado
<<label name>> Etiq.
##nome do espaço reservado## Item de dados de um conjunto de dados
%%nome do espaço reservado%% Imagem de um conjunto de dados
[[identificador do conjunto de dados]] Identificador de conjunto de dados
Tabela 1. Exemplo de espaços reservados:
##DepartmentName## <<Order>> ##ServiceOrder##

##DepartmentAddress##

<<OrderReference>>

<<StartTime>>

<<ServiceEngineer>>

##ReferenceA##

##StartTime##

##Engineer##

Neste exemplo, <<Order>>, <<OrderReference>> e assim por diante, são etiquetas (espaços reservados para texto traduzível). ##DepartmentName##, ##ServiceOrder## e assim por diante são itens de dados. Nesse caso, eles são recuperados do conjunto de dados de nível de documento. Já que esse conjunto de dados de documento está amplamente disponível, esses espaços reservados podem ser usados em qualquer lugar do documento. Para obter uma lista de todos os espaços reservados, consulte o apêndice Espaços reservados para modelo de relatório de visita.

O exemplo acima pode resultar no seguinte quando o relatório é gerado e os espaços reservados são substituídos por dados reais.
Departamento de serviço NL Ordem de serviço SOO001407

Het Torentje

Binnenhof 19

2513 AA Den Haag, Zuid Holland

Países Baixos

Referência

Data inicial

Engenheiro de serviço

CUST_B_00012

15-8-2016 10:28

José Silva

Layout

Basicamente, é possível posicionar espaços reservados em qualquer lugar do documento rtf. Portanto, uma construção como o número de ordem de serviço ##ServiceOrder## tem a data inicial ##StartDate## é completamente válida.

Para que seja possível alinhas elementos, guias ou tabelas podem ser usadas. É possível inserir tabelas. Colunas e/ou linhas podem ser mescladas. Por exemplo, uma tabela com duas linhas, a primeira linha com uma célula e a segunda com três células, é válida.

<<AlgumTextoTraduzido>>
##FieldA## ##FieldB## ##FieldC##

O layout mostrado acima recupera os campos A, B e C do conjunto de dados do documento.

Para que seja possível exibir dados de qualquer outro conjunto de dados, é necessário seguir uma convenção de layout. Todos os espaços reservados dependentes de conjuntos de dados devem ficar em uma tabela. O identificador do conjunto de dados é fundamental para a convenção de layout. O identificador deve ser colocado na primeira célula da primeira linha, como o primeiro texto da tabela.

Convenção de layout de conjunto de dados:

[[DataSetIdentifier]]
<<HeaderTextA>> <<HeaderTextB>> <<HeaderTextC>>
##FieldA## ##FieldB## ##FieldC##

A convenção de conjunto de dados define três ou mais linhas.

  • A primeira linha deve guardar o identificador do conjunto de dados (com os marcadores [[ ]]). Consulte também as definições de conjunto de dados fornecidas previamente no documento. Quando o identificador do conjunto de dados não é encontrado, a tabela é tratada como uma tabela de layout. Veja acima. A linha do identificador do conjunto de dados é excluída após a execução da mesclagem.
  • O número de replicações da última linha é determinado pelas linhas guardadas no conjunto de dados. Espaços reservados para dados de cada linha replicada são substituídos pelos valores de registro do conjunto de dados correspondentes. Se a linha do layout contiver espaços reservados para dados que não correspondam às propriedades do conjunto de dados, a substituição ocorrerá com o uso do conjunto de dados pai. 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.
  • Todas as outras linhas são linhas de cabeçalho (zero, uma ou mais). As linhas de cabeçalho costumam conter espaços reservados para texto traduzível (<< >>). Se as linhas de cabeçalho contiverem espaços reservados para dados, os dados serão substituídos com base no conjunto de dados pai. Se não aplicável, os espaços reservados serão substituídos por dados do conjunto de dados do documento.

O requisito mínimo para uma tabela de conjunto de dados é duas linhas. Linhas de cabeçalho são opcionais.

Exemplo com duas linhas de cabeçalho:

[[MaterialCost]]
<<Materials>>
<<Quantity>> <<ItemCode>> <<ItemDescription>> <<Amount>>
##Quantity## ##Item## ##Description## ##AmountOrCoverage##

Exemplo sem linhas de cabeçalho:

[[MaterialCost]]
##Quantity## ##Item## ##Description## ##AmountOrCoverage##

Layout aninhado

Para que seja possível representar relações de primário/secundário, uma convenção adicional é definida. No caso de atividades e materiais, se for necessário apresentar materiais por atividade, a tabela de materiais deve estar aninhada na tabela de atividades. Os conjuntos de dados têm uma estrutura para reconhecimento de uso como conjunto filho. Em vez de apresentar todos os materiais de uma visita, somente os materiais da atividade atual são apresentados nas tabelas de materiais aninhadas.

Nota

Tenha cuidado ao inserir as tabelas aninhadas na última linha. Se mais de uma tabela for necessária (por exemplo, material, mão de obra e outros custos), as tabelas poderão ser inseridas na mesma célula com um fim de parágrafo (apenas um RETURN) entre si. Consulte também o layout de Materials - LaborCost - OtherCost no apêndice Modelo padrão para relatório de visita.

No Word, é fácil fazer isso. Posicione o cursos em uma célula da tabela e selecione 'Adicionar tabela' na guia INSERIR.

Convenção de layout de conjunto de dados aninhado:

[[DataSetIdentifier]]
<<HeaderTextA>> <<HeaderTextB>> <<HeaderTextC>>
##FieldA## ##FieldB## ##FieldC##
[[DataSetIdentifier]]
<<HeaderTextX>> <<HeaderTextY>> <<HeaderTextZ>>
##FieldX## ##FieldY## ##FieldZ##

Exemplo de layout de conjunto de dados agrupado:

[[Activities]]
<<Activity>> ##Description##
[[MaterialCost]]
<<Materials>>
<<Quantity>> <<ItemCode>> <<Description>>
##Quantity## ##Item## ##ItemDescription##

No exemplo acima, um conjunto de dados de custo de material [[MaterialCost]] é agrupado em um conjunto de dados de atividade [[Activities]]. ##Description## é recuperado do conjunto de dados de atividades. ##Quantity##, ##Item## e ##ItemDescription## são recuperados do conjunto de dados MaterialCost.

Exemplo de resultado de layout do conjunto de dados agrupado:

Caixa de reparo de atividade
Materiais
Quantidade Código do item Descrição
6 peças AVDK17 Área de transferência
3 caixas AVDK1501 Nails

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.

Dessa forma, o cliente pode decidir exibir somente os totais sem detalhes ou exibir os detalhes e, em seguida, os totais.

Ferramentas para edição do modelo

O modelo deve ser armazenado como um arquivo rtf. O Microsoft Word pode lidar com esse tipo de arquivo, apesar de haver outros aplicativos de processamento de texto capazes de editar esse tipo de arquivo. Após a criação do modelo, o arquivo deve ser armazenado como um documento .rtf.

Nota

Apesar de o layout na tela parecer o mesmo, há diferenças entre processadores de texto (e também o aplicativo) no que se refere ao resultado impresso. Assim, se você usar papel pré-impresso, teste o modelo com dados reais e salve como pdf.

Ferramentas para edição do modelo

O modelo deve ser armazenado como um arquivo rtf. O Microsoft Word pode lidar com esse tipo de arquivo, apesar de haver outros aplicativos de processamento de texto capazes de editar esse tipo de arquivo. Após a criação do modelo, o arquivo deve ser armazenado como um documento .rtf.

Nota

Apesar de o layout na tela parecer o mesmo, há diferenças entre processadores de texto (e também o aplicativo) no que se refere ao resultado impresso. Assim, se você usar papel pré-impresso, teste o modelo com dados reais e salve como pdf.

Dica: Como editar espaços reservados

Ao adicionar ou alterar espaços reservados, digite todo o espaço reservado em uma ação e não mude nenhum caractere individual, pois o Word ocasionalmente adiciona marcadores invisíveis ao documento rtf. Nesse caso, a mesclagem de relatórios não poderá interpretar o modelo corretamente e o espaço reservado não será substituído no relatório de visita. Para espaços reservados que, apesar de ortograficamente corretos, não mostram o valor mesclado, edite o documento do modelo e digite novamente, do início ao fim, incluindo os marcadores de abertura e fechamento.

Dica: Exibição de layout da Web nas configurações do MS Word

Ao usar o Word como editor, é recomendável usar o modo de exibição de layout da Web. Na barra do menu, selecione a guia EXIBIR e clique em Exibição de layout da Web. As bordas das tabelas que ultrapassam a margem direita do papel ficam visíveis e podem ser editadas.

Dica: exibir linhas de grade

As linhas de grade de células também podem ser exibidas. Por padrão, esse recurso fica desativado. Use a opção de layout de borda na guia INÍCIO e clique em Exibir linhas de grade. As bordas sem uma linha visível são representadas como uma linha pontilhada.