Qué son las etiquetas de cartas

Puede usar las etiquetas para editar fácilmente una carta sin necesidad de editar la plantilla XSL real. Por ejemplo, si desea que la carta indique "Descripción del ejemplar" en lugar de solo "Descripción", lo puede cambiar en las etiquetas: 

Etiqueta en carta

Cómo configurar las etiquetas en cartas

Puede configurar las etiquetas para una carta específica como se describe a continuación. 

1. Seleccione Editar en la lista de acciones de la fila de la carta.
    
   
2. Seleccione el botón Etiquetas en la parte superior de la página.
    
   
3. Seleccione Personalizar del menú de acciones de fila. Puede actualizar lo siguiente:
   • Habilitado — Use este conmutador para activar/desactivar la etiqueta de uso en la carta.
   • Descripción — Actualice la descripción de la etiqueta que se muesta en la carta.
     Tenga en cuenta que no es compatible usar etiquetas HTML en el campo de Descripción.
   • Traducción — Si otro idioma está habilitado en Alma y está seleccionado en el menú desplegable de Filtro, puede editar la traducción.
      
     
      
   • Restaurar - Si la línea fue modificada, los campos Habilitado y Descripción se restauran a su valor por defecto.
   • Restaurar traducción - Si se habilita otro idioma en Alma y la etiqueta Traducción fue modificada, el campo se restaura a su valor por defecto.
4. Seleccione Personalizar todos para editar todas las filas.
5. Seleccione Restaurar todos para restaurar todas las filas a su configuración por defecto.
6. Seleccione Restaurar traducciones por defecto para restaurar todas las traducciones.
7. Cuando finalice, seleccione Guardar. Se guarda cualquier cambio hecho en la Lista de etiquetas, a pesar de la acción de Guardar/Cancelar seleccionada en la página principal de previsualización de la plantilla XSL.
8. Puede ver los cambios en el panel de la vista preliminar de las cartas.
    
   
9. Para deshabilitar una etiqueta, consultar el artículo de la base de conocimientos, ¿Cómo puedo deshabilitar una línea en una carta de correo electrónico de Alma?

Incluir ID de solicitud en la etiqueta de asunto

Algunas cartas pueden incluir la cadena %reqId% en la columna de descripción de la etiqueta Asunto. Esto se reemplazará con la ID de la solicitud cuando se genera la carta. Las cartas que incluyen esta opción son:

• Carta por correo electrónico de vencimiento de préstamo
• Carta obtenida externamente
• Carta de cancelación por correo electrónico
• Carta de correo electrónico saliente
• Carta de renovación por correo electrónico
• Carta por correo electrónico para solicitar devolución de un préstamo
• Carta de consulta para usuario

Cómo personalizar plantillas de cartas

El Soporte de Ex Libris se encuentra disponible para ayudar en asuntos relacionados con hojas de estilo XSL personalizadas. Sin embargo, sus esfuerzos de solución de problemas se encuentran dentro de los límites prácticos. Si una hoja de estilo está demasiado personalizada, identificar un error específico requerirá mucho tiempo de análisis. Soporte no puede proporcionar esta validación para todas las hojas de estilo personalizadas. En esta situación, la mejor práctica es eliminar una condición/prueba/sección a la vez para determinar lo que causa el problema.

Declaraciones condicionales

Para obtener una descripción de cómo usar declaraciones condicionales, consulte, How to use the if condition to configure a letter to not be sent under certain circumstances.docx.

Ejemplos generales de personalizaciones de XSL

Ejemplo de personalización de carta de consulta al usuario

Ejemplo de personalización de carta de actividad de préstamos

Este ejemplo muestra cómo hacer las personalizaciones al correo electrónico de la carta de actividad de préstamos.  Para ejemplos generales de lo que puede hacer con XSL para personalizar la salida de sus cartas, consulte Ejemplos generales de personalizaciones de XSL.

1. En la página Identificación de usuario (consultar Gestionar servicios a los usuarios), introducir el nombre de un usuario en el campo Escanear ID del usuario o buscar usuario y seleccionar Ir. Aparecerá la página de Servicios al usuario.

2. En el campo Escanear el código de barras del ejemplar, introducir el código de barras del ejemplar y seleccionar OK. El ejemplar se enumera en la pestaña Préstamos.

3. Seleccionar Enviar actividad para enviar el resultado XML en un correo electrónico.

4. Copiar y pegar la salida XML del correo electrónico a un fichero XML (tal como BorrowingActivityLetter.xml).

1. En la página de Configuración de cartas para la Carta de actividad de préstamos, edite el fichero XSL (en el panel de XML).

2. Usar el fichero XML que se creó anteriormente para determinar el nombre de la ruta completa del campo que contiene el nombre de la biblioteca.

   
   Campo del nombre de la biblioteca en salida XML
   Con base en los elementos anidados en la figura anterior, el nombre de la ruta completa a la biblioteca es el siguiente:
   /notification_data/overdue_loans_by_library/library_loans_for_display/item_loans/overdue_and_lost_loan_notification_display/item_loan/library_name
3. Buscar el marcador de posición @@loans@@ en el fichero XSL y añadir la cláusula xsl:if que se muestra abajo en texto en negrita:
   . . .
   <xsl:if test="notification_data/item_loans/item_loan">
   <xsl:if test="notification_data/item_loans/item_loan/library_name='Main Library'">
   <center>
   <span style="font-family:Arial; font-weight:bold">
   <FONT COLOR="#FF0000">
   <br></br><b> Please check due dates by logging in to your library.</b>
   </FONT>
   </span>
   </center>
   </xsl:if>
   <tr>
   <td>
   <b> @@loans@@ </b>
   </td>
   </tr>
   . . .
   Alma reemplaza los marcadores de posición con las etiquetas/traducciones que están definidas en la tabla de códigos de carta asociada.

4. Mientras sigue editando el fichero XSL, agregue la columna Tipo a la lista de préstamos. Debajo del marcador de posición @@loans@@ en el fichero XSL, agregue el texto en negrita como se muestra en la figura siguiente.

5. Seleccionar Guardar.
6. Pruebe sus cambios en el fichero XSL al cargar el fichero XML que creó previamente (consulte Actualizar y previsualizar cartas de ejemplo para pruebas).

Trabajar con nombres preferidos de usuario en notificaciones y cartas del sistema

Algunas notificaciones y cartas del sistema que incorporan información de nombres pueden actualizarse para utilizar el nombre preferido de un usuario. Para notificaciones y cartas del sistema que incorporan información del nombre, como el XSL de Carta de razón del envío, los nombres preferidos se pueden especificar con preferred_fist_name, preferred_middle_name, y preferred_last_name. Véase el siguiente ejemplo:

Vista general de las plantillas de cartas

Usar cartas de ejemplo para pruebas 

1. Navegue hasta Configuración > General > Cartas > Configuración de cartas.

2. Selecione Editar en el menú de acciones de la fila de la carta correspondiente.
3. Seleccione el botón Ejemplos de cartas.
    
   
    
4. Siempre hay una carta que aparece por defecto, pero puede agregar más ejemplos como se describe abajo.

1. En la página de Ejemplos de cartas, seleccione el botón Añadir desde las cartas del sistema. Tenga en cuenta que, si esta carta nunca se ha enviado en el pasado, como parte del flujo de Alma, el botón Añadir desde cartas del sistema no se mostrará. 
    
   
2. Aparece la página Cartas enviadas, que muestra hasta 10 de los XML más recientes de los últimos siete días.
3. Seleccione la carta a añadir.
   
4. La carta seleccionada aparece en la página de Ejemplos de cartas. 
   
5. Seleccione Guardar. Esta carta será ahora la que aparezca en el panel XML. 
6. Puede pasar de una carta a otra en el panel XML seleccionando la carta correspondiente en la lista desplegable.
   
    

1. En la página de configuración de cartas, para la carta relevante, seleccione Editar en el menú de acciones de fila.
2. En el panel de XML, seleccione el botón Descragar.
3. Edite el fichero con un editor de XML para hacer cualquier cambio relevante.
    
   
   Descargar carta como fichero XML
   Se ha introducido un menú desplegable encima del editor XML, que muestra todos los ficheros XML de ejemplo de cartas disponibles. Los usuarios pueden cambiar entre los ficheros seleccionando una opción de este menú desplegable. Tras la selección, el contenido del editor XML se reemplaza con la información del fichero elegido y la vista previa de la carta se actualiza automáticamente.

1. En la página de Ejemplos de cartas, seleccione el botón Cargar ejemplo de carta (XML).
    
   
    
2. Vaya y seleccione el fichero XML y seleccione Cargar.
3. La carta añadida no está marcada para una vista previa por defecto a menos que la seleccione en la columna Vista previa por defecto  

Configurar la dirección From

La dirección From puede configurarse desde la etiqueta addressFrom o desde la página Unidad de organización, como se describe a continuación.

Configurar la dirección EnvelopeFrom con el Perfil de integración

1. En la página Lista de perfiles de integración (Configuración de Alma > General > Sistemas externos > Perfiles de integración), seleccionar Añadir perfil de integración. Alma permite definir solo un perfil de integración de gestión de correo. Si ya existe un perfil de integración de gestión de correo, seleccionar Editar en la lista de acciones de la fila para editar este perfil.
   
2. Introducir un código y nombre único para el perfil.
3. En el campo Tipo de integración, seleccionar Gestión de correo.
4. Seleccionar Siguiente. Aparecerá la segunda página del asistente. Por defecto, Activo está seleccionado.
   
   
5. Si desea continuar usando el servidor de correo de Alma:
   1. Seleccionar Enviar directamente desde Ex Libris (seleccionado por defecto).
   2. Introduzca una dirección de correo electrónico válida para SMTP EnvelopeFromaddress.
6. Para usar el servidor de relevo de correo de su institución:
   1. Seleccionar Enviar usando el relevo de correo de la institución. Aparecen varios campos adicionales.
   2. Introducir el nombre de dominio de la institución. Después de hacer esto, el nombre de dominio aparece después del campo dirección SMTP EnvelopeFrom como @<nombre de dominio>. El nombre de dominio puede contener hasta 63 caracteres alfanuméricos en minúsculas, guiones -, y puntos seguido de un punto y un dominio de nivel superior de dos a seis caracteres alfanuméricos en minúsculas.
   3. Introducir el nombre del servidor de relevo de correo SMTP de la institución. El nombre del servidor puede contener caracteres alfanuméricos en minúsculas así como cualquiera de los caracteres - ! # $ % & ' * + / = ? ^ _ ` { | } o ~ y un punto.
   4. La Dirección personalizada SMTP EnvelopeFrom está seleccionada por defecto. Introducir un nombre de usuario de la dirección en el campo sin etiqueta bajo esta opción. Esto establece EnvelopeFrom como <username>@<domain name>. El nombre de usuario puede contener los mismos caracteres que el Nombre del servidor de correo SMTP.
   5. Si el relevo de correo requiere un nombre de usuario y contraseña para aceptar correo electrónico de Ex Libris, introducir el nombre de usuario y la contraseña. Estos pueden ser caracteres ASCII.
   6. Si el servidor de correo requiere cifrado, seleccione Usar cifrado.
      El puerto de cifrado se establece para usted en 587.
7. (Nuevo en noviembre) Para enviar correo utilizando las API de MS Graph, seleccione Enviar utilizando las API de MS Graph y rellene los campos adicionales que aparecen.
8. Seleccionar Guardar.

Recomendación de Alma para retransmisión de correo y soporte de correo identificado por claves de dominio (DKIM) 

Cuando un servidor SMTP recibe un correo electrónico, se realizan varias verificaciones de seguridad para determinar si el mensaje es legítimo o sospechoso. Si un correo electrónico se marca como sospechoso, el servidor SMTP puede retrasar su entrega, marcarlo como "spam" o no entregarlo. Este artículo describe cómo garantizar que los correos electrónicos de la nube de Ex Libris no se marquen como sospechosos.

Los mensajes de correo electrónico se pueden enviar desde los productos Ex Libris de dos maneras:

1. Con un dominio "De dirección" de @exlibrisgroup.com

2. Con una "Dirección del remitente" corporativa, por ejemplo @institucion.edu

Actualmente, DKIM es compatible con los dos métodos anteriores. Los correos electrónicos enviados desde nuestra nube con un dominio "De dirección" de @exlibrisgroup.com no deben marcarse como sospechosos, ya que están firmados utilizando DKIM y Ex Libris tiene una política DMARC. Tenga en cuenta que tanto la "Dirección del remitente" de SMTP Envelope como la "dirección header.from" deben utilizar el mismo dominio. La dirección remitente de SMTP Envelope se configura en el perfil de integración de Gestión de correo y la dirección header.from se configura en cada carta individual que se envía. Encontrará más información sobre la configuración del correo saliente aquí.

Si desea tener una configuración compatible con DKIM con un dominio personalizado, el método recomendado es configurar el perfil de integración de correo Alma con la opción "Enviar utilizando la retransmisión de correo electrónico de la institución" e implementar DKIM en su retransmisión de correo electrónico institucional. 

Los correos electrónicos enviados desde Ex Libris que llevan la marca del dominio de la institución pueden implementarse de forma segura de las dos maneras siguientes:

1. Configure la aplicación Ex Libris para pasar el correo electrónico directamente al servidor SMTP de la institución para que se autentique según las políticas de la institución (DKIM + DMARC).

   Para configurar la Plataforma Alma y pasar el correo electrónico a un servidor SMTP externo, consulte "configurar el perfil de integración de gestión de correo" en la documentación aquí. En función de la política de cortafuegos de la institución, es posible que el departamento de TI tenga que abrir el acceso desde la nube de Ex Libris al servidor SMTP para el puerto correspondiente. El rango de IP de salida para Alma, Primo VE y Primo Classic se puede encontrar aquí.

2. Configure el correo electrónico para que se envíe desde la nube de Ex Libris y se autentique utilizando el "Marco de trabajo de la política del remitente" (SPF) y DKIM.

   SPF es un método para permitir que la nube de Ex Libris envíe correos electrónicos en nombre de la institución. Cuando un servidor SMTP recibe un correo electrónico, se realiza una verificación de seguridad en la que se compara la IP que ha enviado el correo electrónico con las IP que figuran en el registro DNS del dominio "Dirección del remitente". Para configurar SPF, el administrador de DNS de la institución debe añadir las IP de retransmisión de correo de Ex Libris al dominio de la institución en un registro TXT. Las IP de retransmisión de correo de Ex Libris difieren en función de la región del cliente, por lo que debe elegirse la "Entrada de inclusión SPF" correspondiente. Las diferentes "Entrada de inclusión SPF" para las diferentes regiones se encuentran aquí.

   DKIM, o correo identificado por claves de dominio, es un método de autenticación de correo electrónico diseñado específicamente para identificar direcciones de remitentes fraudulentos en los correos electrónicos y abordar el problema de la suplantación de identidad en el correo electrónico. Una vez activada la funcionalidad DKIM para su institución, el perfil de integración de gestión de correo incluirá soporte para firmas digitales DKIM en los correos electrónicos salientes. Las instrucciones de configuración se encuentran aquí.

Para más información, véase Configuración de correos electrónicos salientes.

1. Marque la casilla de verificación Configuración de DKIM. Esto crea las claves y carga la clave pública en el DNS de Ex Libris. Aparecerá una ventana emergente con los detalles del CNAME.

2. Copie el CNAME de la ventana de diálogo y envíeselo a su TI para que lo añadan a su DNS.

3. Después de que su TI lo haya añadido al DNS, seleccione la opción Probar la configuración del DNS de DKIM para probarlo.  Si la prueba se ha superado, aparecerá un mensaje de éxito. Si la prueba falla por cualquier motivo, aparecerá un mensaje con los detalles del fallo.  

4. Una vez realizada la prueba con éxito, seleccione la casilla de verificación DKIM activo. A partir de este momento, los correos electrónicos salientes incluirán la firma DKIM.