Reutilizar Componentes Entre Cartas
Para configurar componentes, você deve ter uma das seguintes funções:
- Administrador Geral do Sistema
- Administrador de Cartas
Cada carta pode conter componentes em comum que são usados em todas elas, como cabeçalhos, rodapés etc. Isso permite definir (e atualizar) os componentes em um só lugar. Por exemplo, você pode definir um cabeçalho comum para todas as cartas, que inclua um logotipo corporativo. No futuro, se você alterar a formatação do logotipo (como o alinhamento) na página Configuração de Componentes, essa alteração será aplicada automaticamente a todas as cartas que usam esse componente. Para informações sobre a configuração de cartas em geral, veja Configurar Cartas do Alma.
As alterações feitas nos componentes afetam todas as cartas. Portanto, é recomendável revisar as alterações cuidadosamente antes de salvá-las.
Acessar a Página de Configuração de Componentes
A página Configuração de Componentes (Menu de Configuração > Geral > Cartas > Configuração de Componentes) permite personalizar modelos e outros componentes compartilhados entre cartas. Assim como as cartas, os componentes são compostos de etiquetas (expressões de texto estático) e do modelo (folha de estilo XSL para formatação e dados dinâmicos).
![Components Configuration.png](https://knowledge.exlibrisgroup.com/@api/deki/files/74754/Components_Configuration.png?revision=1)
Configuração de Componentes
Configurar Etiquetas de Componentes
Você pode usar as etiquetas para editar uma carta sem precisar editar o modelo XSL real. Por exemplo, se você deseja que a carta declare "Entre em Contato com a Biblioteca" em vez de apenas “Entre em Contato Conosco", poderá alterá-la nas etiquetas.
Como atualizar uma etiqueta:
- Na página Configuração de Componentes, selecione Editar na lista de ações da linha do componente.
- Selecione o botão Etiquetas. Observe que, se o componente não tiver uma etiqueta, o botão Etiquetas estará desativado.
- Selecione Personalizar na etiqueta que deseja editar.
- Atualize a etiqueta conforme necessário. Você também terá as seguintes opções:
- Alterar idioma - Se outro idioma estiver configurado, o campo Tradução será aberto para edição.
- Restaurar - Se a linha foi modificada, os campos Habilitado e Descrição serão restaurados para o padrão.
- Restaurar Tradução - Se outro idioma estiver configurado e a etiqueta Tradução foi modificada, o campo será restaurado para o padrão.
- Ao concluir, selecione Salvar.
- Você pode habilitar ou desabilitar a etiqueta selecionando o botão de alternância na coluna Habilitado.
Personalizar Modelos de Componentes
Você pode visualizar e editar o modelo (folha de estilo XSL) usado para formatar o componente e determinar os campos e o texto que serão exibidos na carta. Configure o modelo para personalizar quais etiquetas e dados aparecerão e como serão exibidos nas cartas. Além disso, você pode usar instruções condicionais de XSL para tomar decisões sobre o que aparecerá em uma carta e até mesmo se a carta será enviada. Consulte Como usar a condição “if” para configurar que uma carta não seja enviada em determinadas circunstâncias.docx para ver um exemplo.
Para personalizar o modelo de um componente (folhas de estilo XSL):
- Na página Configuração de Componentes, selecione Editar nas ações da linha do componente relevante.
- Edite as informações no painel de XSL conforme necessário.
Os campos disponíveis nesta página estão nas etiquetas associadas ao componente e nos campos XML que são gerados pelo Alma.- Use as funções substring e string-length para exibir os últimos quatro dígitos de um código:<b>@@requested_for@@ :*****
<xsl:value-of select="substring (notification_data/user_for_printing/identifiers/code_value/value,string-length(notification_data/user_for_printing/identifiers/code_value/value) - 3)"/></b> - Se o fragmento abaixo seguir a linha de endereço no arquivo SenderReceiver.xsl, você pode garantir que o número de telefone do usuário seja incluído em todas as cartas que usam esse modelo.<tr>
<td><xsl:value-of select="notification_data/user_for_printing/phone"/></td>
</tr> - Faça com que o nome da folha de estilo apareça como texto oculto no resultado adicionando o seguinte após a etiqueta <html>.<html> <xsl:attribute name="data-filename"> <xsl:value-of select="/notification_data/general_data/letter_type"/> </xsl:attribute>O resultado incluirá algo parecido com:<html data-filename=”FulLoanReceiptLetter”> ...
- Use as funções substring e string-length para exibir os últimos quatro dígitos de um código:
- Você pode usar Ctrl+Shift+f para implementar “Prettyprint” (converter e apresentar o código-fonte de XSL com quebras de linha e recuos para facilitar a leitura do código).
-
Selecione Salvar Rascunho para salvar as personalizações como rascunho. As alterações feitas no rascunho não serão aplicadas ao componente até que Salvar seja selecionado. A marca d'água de rascunho é exibida no painel de XSL em modo rascunho. Observe que, uma vez selecionado Salvar, as alterações serão aplicadas a todas as cartas que usam este componente. Selecione Remover Rascunho para apagar o rascunho e exibir o último XSL salvo. Selecione Restaurar para restaurar o XSL ao seu estado original. Observe que, enquanto um rascunho está ativo, as opções Editar Rascunho e Remover Rascunho estão disponíveis no menu de ações da linha do componente.
-
Para pré-visualizar as alterações, visualize uma carta que usa esse componente.
-
Para pré-visualizar as alterações feitas em um rascunho de componente:
-
Navegue para uma carta que use esse componente.
-
Na carta, atualize o XSL adicionando _DRAFT para a instrução <xsl:include href="" /> relevante, conforme mostrado no exemplo a seguir:
<xsl:include heref="footer.xsl_DRAFT"/> -
O painel de pré-visualização exibirá o rascunho de componente (o rodapé atualizado neste exemplo), para que você possa revisar as alterações.
-
Quando as alterações forem concluídas, remova o sufixo _DRAFT da instrução “include”:
<xsl:include heref="footer.xsl"/>
-
-
Selecione Salvar para aplicar as alterações ao componente, ou seja, substituir o XSL atual pelas atualizações. Isso também removerá a marca d'água de rascunho. As alterações serão aplicadas a todas as cartas que utilizam este componente. Observe que após salvar, a carta permanece na janela de pré-visualização. Para retornar à lista completa de cartas, selecione Cancelar.
Lista de Componentes
A tabela a seguir lista os componentes disponíveis no Alma.