Skip to main content
ExLibris
  • Subscribe by RSS
    • Back
    Alma
    Ex Libris Knowledge Center

    Reutilizar Componentes Entre Cartas

    1. Last updated
    2. Save as PDF
    Translatable
    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
    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:
    1. Na página Configuração de Componentes, selecione Editar na lista de ações da linha do componente.

      Edit component.
    2. Selecione o botão Etiquetas. Observe que, se o componente não tiver uma etiqueta, o botão Etiquetas estará desativado.

      Labels buttton for component.
    3. Selecione Personalizar na etiqueta que deseja editar.

      Customize component label.
    4. 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.
    5. Ao concluir, selecione Salvar.

      Update label and save.
    6. 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):
    1. Na página Configuração de Componentes, selecione Editar nas ações da linha do componente relevante. 
    2. Edite as informações no painel de XSL conforme necessário.

      Edit XSL.

      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”> ...
    3. 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).
    4. 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.  
    5. Para pré-visualizar as alterações, visualize uma carta que usa esse componente.
    6. Para pré-visualizar as alterações feitas em um rascunho de componente:
      1. Navegue para uma carta que use esse componente.
      2. 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"/>
      3. O painel de pré-visualização exibirá o rascunho de componente (o rodapé atualizado neste exemplo), para que você possa revisar as alterações. 
      4. Quando as alterações forem concluídas, remova o sufixo _DRAFT da instrução “include”:
        <xsl:include heref="footer.xsl"/>
    7. 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.
    Componentes da Carta
    Carta Descrição
    checksum_calc.xsl Para uso interno.
    footer.xsl

    Define o texto usado no rodapé de todas as cartas de e-mail. Defina o seguinte em Geral > Configurações Gerais > Outras Configurações:

    Valor do Parâmetro Chave do Parâmetro
    contact_us email_contact_us
    my_account email_my_account
    header.xsl Define o texto (como o logotipo da sua instituição, o nome da carta e a data) usado no cabeçalho de todas as cartas de e-mail.
    mailReason.xsl Define a saudação (como Prezado(a) Sr.(a)) usada na maioria das cartas. O seguinte imprimiria Prezado(a) John Smith para um usuário chamado John Smith:

    <xsl:template name="toWhomIsConcerned">
    <table cellspacing="0" cellpadding="5" border="0">
    <tr>
    <td>
    <xsl:for-each select="notification_data">
    <h3>@@dear@@ &#160;<xsl:value-of select="receivers/receiver/user/first_name"/>&#160;<xsl:value-of select="receivers/receiver/user/last_name"/></h3>
    </xsl:for-each>
    </td>
    </tr>
    </table>
    recordTitle.xsl Define o texto usado para detalhes bibliográficos nas cartas de e-mail.
    senderReceiver.xsl

    Define as informações de endereço para todas as cartas de e-mail. Este componente usa <xsl:value-of select="notification_data/user_for_printing/name"/>, que é preenchido de acordo com a configuração em Exibição do Nome do Usuário. No entanto, user_for_printing também inclui os valores de nome e de nome de preferência, portanto, pode ser configurado de forma diferente. Por exemplo, user_for_printing do XML do relatório de atividades:

    <first_name>Ford</first_name>
    <identifiers><code_value><code>Primary Identifier</code>
    <value>fprefect</value>
    </code_value>
    <code_value><code>BARCODE</code>
    <value>11223344</value>
    </code_value>
    </identifiers>
    <last_name>Prefect</last_name>
    <middle_name></middle_name>
    <name>Prefecta, Forda</name>
    <phone></phone>
    <postal_code></postal_code>
    <preferred_first_name>Forda</preferred_first_name>
    <preferred_last_name>Prefecta</preferred_last_name>
    <preferred_middle_name></preferred_middle_name>
    SMSRecordTitle.xsl Define o texto usado para detalhes bibliográficos em SMS.
    style.xsl Letter Define o CSS usado para todas as cartas de e-mail.
    1. Back to top
    • Was this article helpful?

    Recommended articles

    1. Article type
      Topic
      Content Type
      Documentation
      Language
      Português
      Product
      Alma
    2. Tags
      This page has no tags.