Configuring Alma Letters
This page provides an overview of working with letters including configuration, enabling/disabling letters, a list of all the letter types, etc. For specific information on topics such as the available options for overdue notices, the types of print slips and receipt notices that are available, support for sending ad-hoc messages to patrons or patron groups, etc., see Notices.
Per configurare la comunicazione, è necessario disporre di uno dei seguenti ruoli:
- Amministratore di Sistema Generale
- Amministratore lettere
Alma provides a letter system to send highly customizable messages to patrons, librarians, and vendors. I messaggio includono avvisi, conferme, notifiche, informazioni di riepilogo, Ordine, servizi richiesta e così via. Messages can be sent by email, SMS, ISO protocol, or other means, or they can by printed out via printer or an external system to be sent by mail. Ogni comunicazione che può essere inviata a una stampante o email può essere stampata utilizzando la Stampa Rapida.
Alma includes a list of letter types, where a single letter type can be used to send multiple letters that use the same structure. Alma costruisce una comunicazione combinando campi XML dinamici generati da Alma (dati), etichette (testo statico) e un template (formattazione). Le etichette statiche e il template (fogli di stile XSL) sono inclusi in Alma ma possono essere configurati dall'Utente. Per le istituzioni i cui utenti preferiscono una lingua diversa dall'inglese, i set di etichette sono forniti in più lingue.
La maggior parte delle comunicazioni viene inviata automaticamente da Alma nella fase appropriata di un flusso. Ad esempio, Alma invia una comunicazione a un utente dopo che una copia presa in prestito dall'utente è stata contrassegnata come In ritardo. Alcune comunicazioni possono essere inviate da un Utente in qualsiasi momento, come una ricerca a un Fornitore o a un utente.
Alma non utilizza il sottosistema di comunicazione per alcuni tipi di comunicazione specifici del protocollo con le entità di supporto, come gli ERP o altri ILS. Ad esempio, Alma può utilizzare lo scambio elettronico di dati (EDI) al posto della email per comunicare con il fornitore di supporto.
Per un video che mostra l'intero processo di configurazione della comunicazione in Alma, vedere Configurazione della comunicazione in Alma.
For an overview of configuring Alma letters watch the Configuring Letters in Almavideo (5:38 min.) andLetters Configuration (6 min.).
Accessing and Configuring Alma Letters
All Alma letters appear on the Letters Configuration page (Configuration Menu > General > Letters > Letters Configuration).
È possibile visualizzare gruppi specifici di comunicazione utilizzando i filtri sopra la Lista delle comunicazione.
The Description text is hard-coded and cannot be configured.
Inoltre, puoi eseguire le seguenti azioni:
- Enabling/disabling letters
- Setting retention periods
- Updating templates to set the content and formatting for letters
- Updating labels (fields/strings of text that are used in the letter and can be translated)
- Updating and Previewing Example Letters for Testing
- Contributing Letter Customizations to the Community Zone
You will need to assign the Letter Administrator role to users who will customize or maintain the email letters. For more information on assigning roles, see Adding Roles to Users.
If you are working in a sandbox environment or a pre-"Go Live" production environment, add the letter administrators' email addresses to the allowed email list (see Configuring Allowed Emails).
Enabling/Disabling Letters
Some letters can be activated for different types of notifications, for example SMS and email; the notification type of a letter is listed in the Channel column. Se la versione email di una comunicazione è disattivata, ad esempio, la comunicazione email viene disattivata per lo scenario pertinente.
Alma non invia comunicazioni disattivate. Tentare di inviare una comunicazione disabilitata potrebbe comportare una notifica di errore quando la comunicazione viene attivata.
Alcune notifiche potrebbero essere disabilitate per un Utente specifico o per un Set di Utenti. For more information, please see Configuring Library Notices Opt-In.
Select Restore Activation in the row actions menu for a specific letter, to restore the Enabled button to its Out of The Box (OTB) state. Se il pulsante è già nello stato OTB, questo pulsante non fa nulla.
Setting Letter Retention
To indicate that the configured letters are deleted after a certain number of days, add a retention period, in number of days, in the Retention Period field of email letters. If no retention period was defined, then letters sent by Alma are retained indefinitely. Those that are available on the Attachments tab of the User Details (see Managing User Attachments) will remain there indefinitely.
A weekly job,Letters Purge with Retention, deletes all enabled letters, if they were created more than the configured number of days ago.
Per Abilita il processo di eliminazione delle comunicazioni con conservazione, aprire un caso con il supporto Ex Libris.
Nella Lista comunicazioni, è possibile ripristinare il periodo di conservazione default per tutte le comunicazioni selezionando la tabella di conservazione 'Ripristina comunicazione'.
Using Labels to Update the Fields in the Letter
If you want to configure display labels for Primo VE, see Configuring Display Labels.
What are Letter Labels
Due tipi di dati vengono utilizzati dalla comunicazione prima di essere inviata all'utente, alla stampante, ecc.: etichette e dati XML. Le etichette sono stringhe di testo statiche che puoi aggiornare e tradurre. XML data is generated automatically by Alma, and can be updated by configuring the XSL template (see Customizing Letter Templates). Note that you can also use labels to add cc or bcc email addresses to letters. See Notices for more information.
You can use the labels to easily edit a letter without needing to edit the actual XSL template. Ad esempio, se desidera che la comunicazione riporti "descrizione copia" invece di solo "Descrizione", può modificarlo nelle etichette:
The labels affect the @@ codes in the XSL, and any change in a label is reflected immediately in the Preview. However, when customizing the letterName label, in order to see the updated Letter Name in the Preview you need to generate the letter again using the relevant business flow. Then, on the Letters Configuration page (Configuration > Letters Configuration > Letter Examples > Add from System Letters), select the XML (it contains the customized letter name in /notification_data/general_data/letter_name).
How to Configure Letter Labels
È possibile configurare le etichette per una comunicazione specifica come descritto di seguito.
Gli utenti della Network Zone possono gestire centralmente le etichette e distribuire le modifiche a tutti i membri. For more information, see Centrally Managing Letters in a Network Zone.
To configure letter labels:
- Select Edit on the row action list of the letter.

- Select the Labels button at the top of the page.

- Selezionare Personalizza dal menu riga Azione. Può aggiornare quanto segue:
- Enabled— Use this toggle to activate/deactivate the label for usage in the letter.
- Description— Update the label description that displays on the letter.
Si noti che l'utilizzo del tag HTML nel campo Descrizione non è supportato.
- Translation— If another language is enabled in Alma and it is selected in the Filter drop down, you can edit the translation.

- Restore— If the line was modified, the Enabled and Description fields are restored to their default.
- Restore Translation— If another language is enabled in Alma and its Translation label was modified, the field is restored to the default.
- Seleziona Personalizza tutto per modificare tutte le righe.
- Selezionare Ripristina tutto per ripristinare tutte le righe ai valori di default.
- Seleziona Ripristina Traduzioni default per ripristinare tutte le traduzioni.
- Al termine, selezioni Salva. Any changes made to the Labels List are saved, regardless of the Save/Cancel action selected on the main XSL Preview page.
- You can view the changes in the letter preview pane.

- To disable a label, see the knowledge base article How can I disable a line in an Alma email letter?
Including Request ID in the Subject Label
Alcune comunicazioni possono includere la stringa %reqId% nella colonna della descrizione dell'etichetta del soggetto (il soggetto dell'email che viene inviato all'Utente). This will be replaced with the request's ID when the letter is generated. Le comunicazioni che includono questa opzione sono:
- Comunicazione e-mail di ritardo del mutuatario
- Lettera email ottenuta esternamente
- Ful annulla comunicazione email
- Lettera in uscita
- E-mail Rinnovo Prestito
- Prestito richiamo email comunicazione
- ricerca per Patron comunicazione
Using Templates to Update Letter Formatting and Content
If you have reached this section of the online help while attempting to configure a copyright declaration, see Configuring Copyright Declarations. For information on configuring a resource sharing copyright declaration, see Configuring a Resource Sharing Copyright Declaration.
In addition to editing labels (see Configuring Letter Labels) you can edit the template (XSL style sheet). The XSL template determines which fields and text appear in the letter and is used to format the letter. You can use XSL conditional statements to make decisions about what appears in a letter, and even whether the letter is sent. For examples of how the xsl conditions are used see:How To documents about specific functions of letters configuration using the if condition.
How to Customize Letter Templates
Il supporto Ex Libris è disponibile per assistere con fascicoli relativi ai fogli di stile XSL personalizzati. However, their troubleshooting effort is within practical limits. Se un foglio di stile è molto personalizzato, potrebbe essere necessaria un'Analisi che richiede molto tempo per identificare un errore specifico. Tale convalida non può essere fornita dal Supporto per tutti i fogli di stile personalizzati. The best practice in these situations is for you to eliminate one condition/test/section at a time to determine what causes the problem.
To customize a letter's template (XSL style sheets):
- Select Edit on the row action list of the letter.
The XSL and XML information appear to the left of the letter.
- To the right of the XML/XSL panes is a preview pane of the actual letter output.
Changes in the XSL/XML are immediately reflected in the preview pane. Errors that are detected while editing the XSL/XML are marked with a red X on the relevant line.
Nota che, a causa di limitazioni tecniche, potrebbe esserci una discrepanza tra il numero di riga di errore riportato su XSL/XML e il numero di riga riportato nel riquadro di anteprima.
L'Editor contrassegna anche i segmenti XSL a colori e implementa il completamento automatico. Per trovare copia all'interno dell'editor è possibile usare Ctrl+f. - You can use Ctrl+Shift+f to implement Prettyprint (convert and present the XSL source code with line breaks and indentations to make the code easier to read).
- You can use Ctrl+Shift+H to provide the X-Path for a particular XML element when you click on that element within the XML editor textbox. This is especially useful when you need to copy an XML element into the XSL.

- You can maximize the XML/XSL windows using the full-screen icon.

- Update the labels associated with the letter (see Using Labels). Le modifiche alle etichette vengono visualizzate nel riquadro di anteprima.
- Selezioni Apri in una nuova tab per aprire l'anteprima in una tab separata del browser e modificare l'HTML utilizzando i plugin di accessibilità.
- Seleziona Visuale o HTML per alternare tra una vista visuale e una vista HTML.
- Selezioni un'altra lingua nel menu a discesa per visualizzare la comunicazione in una lingua diversa. The languages that appear depend on the settings configured in Alma.
Alcuni elementi, come il nome e il soggetto della comunicazione, vengono estratti dall'XML della comunicazione e pertanto non cambieranno quando si cambia la lingua della comunicazione di anteprima.
- Aggiorni la larghezza per visualizzare l'output così come verrà visualizzato su schermi stretti o stampanti. Utilizzi px per configurare la larghezza in pixel, ad esempio 500 px.
- Reusable components display in the preview pane (see Reusing Components Across Letters).
- Select Save Draft to save your customizations as a draft. Le modifiche apportate alla bozza non verranno applicate alla comunicazione reale. Selezionare Rimuovi bozza per cancellare la bozza e visualizzare l'ultimo XSL salvato. Select Restore to restore the XSL to its original state.

Note that while a draft is active, the Edit Draft and Remove Draft options are available in the row actions menu for the letter.
The draft watermark displays in the preview pane.
- Seleziona salva per applicare le modifiche alla comunicazione effettiva. Questo rimuove la bozza (se ne esiste una per questa comunicazione). Nota che dopo il salvataggio, la comunicazione rimane nella finestra di anteprima. Per tornare alla lista completa delle comunicazioni, selezioni Annulla.
- Per inviare un esempio tramite email, aggiungere un Indirizzo al campo Invia esempio tramite email e selezionare Invia.
- Può visualizzare esempi di comunicazione selezionando Esempi di comunicazione. Nella pagina Esempi di comunicazione può aggiungere esempi di comunicazione inviati da Esploro e caricarne di nuovi. See Updating and Previewing Example Letters for Testing.
If you use a tag to refer to an outside location such as a template or URL (for example,<xsl:include href="http://{$PathToWeb}/html/xsl/head.xsl">) and the outside source changes, refresh the XSL (by re-saving it) for the new information to be included in the letter.
Conditional Statements
For a description of how to use conditional statements, see How to use the if condition to configure a letter to not be sent under certain circumstances.pptx.
General Examples of XSL Customizations
I seguenti esempi mostrano cosa puoi fare con XSL per personalizzare l'output delle tue comunicazioni. For examples of specific letters see Example of Query to Patron Letter Customization and Example of Borrowing Activity Letter Customization.
Output Last Four Digits of a Code
Utilizzi le funzioni substring e string-length per ottenere le ultime quattro cifre di un codice:
<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>
Add Notes to Vendor and Rush Indicator to Order List Mail Letter
Aggiungere le note al fornitore (dalla riga dell'ordine di acquisto) e l'indicatore di urgenza alla lettera dell'elenco ordini:
<td><b>Notes To Vendor: </b><xsl:value-of select="/notification_data/po/po_line_list/po_line/vendor_note"/> </td>
</tr>
<tr>
<td><b>Is Rush? </b><xsl:value-of select="/notification_data/po/po_line_list/po_line/rush"/> </td>
</tr>
Add Condition for Notes that May Affect Loan
Assicurati che la riga nota che possono influire sul prestito appaia nella comunicazione Scaffale delle prenotazioni solo se c'è un blocco sull'utente:
<tr>
</tr>
<tr>
<td><xsl:value-of select="notification_data/request/system_notes"/></td>
</tr>
Include Phone Number in All Letters Using this Template
If the following snippet follows the address line in the SenderReceiver.xsl file, you can ensure that the user's phone number is included in all the letters that use this template.
<td><xsl:value-of select="notification_data/user_for_printing/phone"/></td>
</tr>
Include Template Name as Hidden Text
Have the name of the template appear as hidden text in the output by adding the following after the <html> tag:
L'output includerà qualcosa del genere:
<html data-filename=”FulLoanReceiptLetter”> ...
Remove an Element from a Letter
Per rimuovere un elemento da una comunicazione, trova l'elemento da rimuovere. Add comment indicators on either side of the line, such as,<!--<th>@@description@@</th>-->.
<!--<th>@@description@@</th>-->
<th>@@author@@</th>
<th>@@due_date@@</th>
<th>@@fine@@</th>
<th>@@library@@</th>
La tabella di output viene visualizzata senza la colonna della descrizione.
Suppress Letters to Users in Specific Group
Sopprimere una comunicazione inviata all'Utente in uno specifico gruppo di Utenti. Aggiunga una condizione di clausola di terminazione in questi due punti.
Il comando di terminazione non è supportato nel contesto degli SMS.
- Dopo le iniziali righe di inclusione nella parte superiore della comunicazione, come segue:
<table cellspacing="0" cellpadding="5" border="0">
<tr><td><xsl:for-each select="notification_data">
<xsl:if test="user_for_printing/user_group='STUDENT_GRADUATE'">
<xsl:message terminate="yes">user group is STUDENT_GRADUATE </xsl:message></xsl:if></xsl:for-each></td></tr>
</table> -
And below this line:<xsl:template match="/">
Nell'esempio sopra, la comunicazione non viene generata per l'Utente nel gruppo Utente Studente Laureato. For a more detailed explanation, see How to use the if condition to configure a letter to not be sent under certain circumstances.ppt.
For the Fine Fee Payment Receipt letter instead of "user_for_printing/user_group='STUDENT_GRADUATE'"you should use "user/user_group='STUDENT_GRADUATE'".
Example of Query to Patron Letter Customization
You can use the enhanced XSL Query to Patron letter to configure alternative versions of query letters that can be sent to patrons when library staff have questions about a particular resource-sharing borrowing request. For general examples of what you can do with XSL to customize the output of your letters, see General Examples of XSL Customizations.
You can define up to 30 versions of the letter, for example, one for a question about the requested item and another for a query about how to handle a problem that has arisen with regard to a request (see Configuring Patron Query Types).
Una volta configurati i tipi di ricerca del patron, un utente con il ruolo di amministratore comunicazione può modificare le etichette e il foglio di stile della ricerca in comunicazione patrono.
To modify the Query to Patron letter:
- Confirm that the Query to Patron letter is enabled (see Enabling/Disabling Letters).
- Scarica una copia della ricerca nel campo XML Patron, come segue:
- Add a borrowing request for an inventory item (make yourself the Requester; see Adding a Resource Sharing Borrowing Task From a Search).
- On the Resource Sharing Borrowing Requests page (Fulfillment > Resource Sharing > Borrowing Requests), in the row actions of the new request, select Send query to patron(see Managing Resource Sharing Borrowing Requests).
- Sotto template email, seleziona la comunicazione da inviare, quindi seleziona Invia email per inviarla.
- Modifica la ricerca in Patron comunicazione (Modifica dal menu Azione della riga).
- Selezionare il pulsante Esempi di comunicazione .
- Seleziona il pulsante Aggiungi da comunicazioni di Sistema .
- Selezioni la comunicazione che è stata inviata.
- Nella pagina Esempi di comunicazione, imposti questa comunicazione come Anteprima predefinita.
- Nel riquadro di anteprima XML, ora vedrai la nuova comunicazione.
- Selezionare Scarica per salvare la comunicazione XML in un file, ad esempio comunicazione.xml.
- Modifica le etichette:
- On the Letters Configuration page (Configuration Menu > General > Letters > Letters Configuration), locate the Query to Patron letter and open it for editing.
- Select the Labels button.
Entries whose Codes begin with Type_xx(Type_1, Type_2, Type_3, and so forth) will only be included in the versions of the Query to Patron letter whose patron query types correspond with those numbers (see Configuring Patron Query Types). For example, the Codes of the entries that will only be included in the Type_1_query_name version of the query letter begin with Type_1(e.g.,Type_1_header,Type_1_subject). - For each of the entries that are specific to the enabled patron query types, in the row actions, select Customize, and then enter the appropriate text in the Description column.

- Seleziona Salva.
- Modificare l'XSL:
- In the Xsl pane, modify the relevant XSL to change the format of your letter. Lo stesso file XSL viene utilizzato per Formato tutte le versioni della ricerca all'utente comunicazione. È possibile aggiungere etichette o campi dall'XML, utilizzare i valori di questi campi per definire condizioni e così via.
Ad esempio, una clausola condizionale appare in questo modo:
<xsl:when test="notification_data/query_type = 'Type_1_query_name'"> ... special configurations for type 1 queries .... </when>Il template default include solo le regole per i tipi di ricerca utente 1 e 2. Se il sistema ha più di due tipi definiti, è necessario aggiungere le regole per i tipi aggiuntivi al template prima di poterle configurare. Puoi farlo copiando una delle regole esistenti e modificando la copia secondo le necessità per ciascuna regola aggiuntiva.
- Select Save(or Save Draft as described in How to Customize Letter Templates).
- To test your changes, upload the XML (letter.xml) as described in Updating and Previewing Example Letters for Testing.
Example of Borrowing Activity Letter Customization
Questo esempio mostra come apportare le personalizzazioni alla comunicazione email dell'attività di prestito. For general examples of what you can do with XSL to customize the output of your letters, see General Examples of XSL Customizations.
Questo esempio descrive come fare quanto segue:
- Modifica il nome della comunicazione.
- Aggiunga un messaggio specifico della biblioteca.
- Visualizza il Tipo di materiale nell'Elenco dei prestiti.
To customize the Borrowing Activity letter:
- Cambia il nome della comunicazione in comunicazione di attività dell'utente:
- On the Letters Configuration page, find and edit the Borrowing Activity Letter(Configuration > General > Letters Configuration and select Edit from the row actions menu).
- Select the Labels button.

- Selezionare Inglese dall'elenco a discesa Filtro. Note that, in addition to changing the names of labels, you can also translate the labels for other languages.

- Select Customize in the row actions list containing the letterName code.
- Nel campo Descrizione, cambia il testo in comunicazione di attività dell'utente.
- Seleziona l'azione Salva della pagina per memorizzare i valori modificati.
- Configure the XML output and view the output in the preview pane.

- To send a sample letter, enter the email address in the Send Example by Email field in the preview pane and select Send.

- Seleziona Salva. Nota che dopo il salvataggio, la comunicazione rimane nella finestra di anteprima. Per tornare all'elenco completo delle comunicazioni, selezionare Annulla.
To loan an item to a patron:
- On the Patron Identification page (see Managing Patron Services), enter a patron's name in the Scan patron's ID or search for patron field and select Go. Viene visualizzata la pagina Servizi all’utente.
- In the Scan item barcode field, enter the item's barcode and select OK. The item is listed in the Loans tab.
- Select Send Activity to send the XML output in an email.
- Copia e incolla l'output XML dall'email in un file XML (ad esempio BorrowingActivityLetter.xml).
The receipt letter is triggered only when selecting Done to terminate a session with a patron.
Modify the XSL file to print a message for the Main Library only:
- On the Letters Configuration page for the Borrowing Activity Letter, edit the XSL file (in the XML pane).
-
Utilizzi il file XML creato in precedenza per determinare il nome completo del percorso del campo che contiene il nome della biblioteca.
In base agli elementi annidati nella figura soprastante, il percorso completo al nome della biblioteca è il seguente:
/dati_di_notifica/prestiti_in_ritardo_per_biblioteca/prestiti_in_biblioteca_da_visualizzare/prestiti_articolo/visualizzazione_notifica_prestito_in_ritardo_e_perso/prestito_articolo/nome_biblioteca
- Cerca il segnaposto @@loans@@ nel file XSL e aggiungi la clausola xsl:if, mostrata in grassetto di seguito:
. . .
<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 sostituisce i segnaposto con le etichette/traduzioni definite nelle tabelle dei codici di comunicazione associati.
- Mentre sta ancora modificando il file XSL, aggiunga la colonna Tipo all'elenco dei prestiti. Sotto il segnaposto @@loans@@ nel file XSL, aggiunga il testo in grassetto come mostrato nella figura seguente.
. . .
<b>@@loans@@</b>
</td>
</tr>
<tr>
<td>
<table cellpadding="5" class="listing">
<xsl:attribute name="style">
<xsl:call-template name="mainTableStyleCss" /> <!-- style.xsl -->
</xsl:attribute>
<tr>
<th>@@title@@</th>
<th>Type</th>
<th>@@due_date@@</th>
<th>@@fine@@</th>
<th>@@description@@</th>
</tr>
<xsl:for-each select="notification_data/item_loans/item_loan">
<tr><td><xsl:value-of select="title"/></td>
<td><xsl:value-of select="material_type"/></td>
<td><xsl:value-of select="due_date"/></td>
<td><xsl:value-of select="fine"/></td>
<td><xsl:value-of select="description"/></td>
</tr>
</xsl:for-each>
. . .The XML field for the material type was determined by examining the XML file.
Non è stato possibile utilizzare un segnaposto per la nuova intestazione di colonna perché il codice material_type non è configurabile nella tabella dei codici.
- Seleziona Salva.
- Test your changes to the XSL file by uploading the XML file that you created previously (see Updating and Previewing Example Letters for Testing).
Customizing the Lending Recall Email Letter
The Lending Recall Email Letter is sent to the borrowing partner when an item is recalled and must be returned, or when the recall is cancelled.
Institutions that have already customized this letter and want to support cancelled recalls (see Managing Borrowing Requests) must update the letter as below.
From This:
To This:
Working with User Preferred Names in System Notifications and Letters
Alcune notifiche di sistema e comunicazioni che includono informazioni sul nome possono essere aggiornate per utilizzare il nome preferito di un Utente. Per le notifiche di sistema e le comunicazioni che incorporano informazioni sul nome, come il Mail Reason comunicazione XSL, i nomi preferiti possono essere specificati utilizzando preferred_first_name, preferred_middle_name e preferred_last_name. Vedi il seguente esempio:
<xsl:value-of select="receivers/receiver/user/preferred_last_name"/>
For more information on preferred names, see Managing Users.
For more information on the mailReason.xsl letter, see Reusing Components Across Letters.
Reusing Components Across Letters
Può riutilizzare componenti come intestazioni e piè di pagina in tutta la comunicazione.
Per configurare i componenti, è necessario disporre di uno dei seguenti ruoli:
- Amministratore di Sistema Generale
- Amministratore lettere
Ogni comunicazione può contenere componenti comuni utilizzati tra le comunicazioni, come intestazioni, piè di pagina, ecc. Questo ti Abilita a Definisci (e aggiornare) i componenti comuni in un unico luogo. Ad esempio, è possibile definire un'intestazione comune per tutta la comunicazione, che includa un logo aziendale. In future if you change the formatting of the logo (such as its alignment) in the Components Configuration page, that change will automatically be applied to all the letters that use that component.
Le modifiche apportate ai componenti influiscono su tutta la comunicazione. Si consiglia pertanto di rivedere attentamente le modifiche prima di salvarle.
Accessing the Components Configuration Page
The Components Configuration page (Configuration Menu > General > Letters > Components Configuration) allows you to customize templates and other components shared between letters. Like letters, components are made up of labels (strings of static text) and the template (XSL style sheet for formatting and dynamic data).
Configuring Component Labels
È possibile utilizzare le etichette dei componenti per modificare una comunicazione senza dover modificare il template XSL effettivo. Ad esempio, se desidera che la comunicazione indichi "Contatta la biblioteca" anziché "Contattaci", può modificarlo nelle etichette.
How to update a label:
- In the Components Configuration page, select Edit on the row action list of the component.

- Seleziona il pulsante Etichette . Note that if the component does not have a label, the Labels button will be disabled.

- Select Customize for the label to edit.

- Aggiorni l'etichetta secondo necessità. Avete anche le seguenti opzioni:
- Language change- If another language is configured, the Translation field opens for editing.
- Restore- If the line was modified, the Enabled and Description fields are restored to their default.
- Restore Translation- If another language is configured and the Translation label was modified, the field is restored to the default.
- When done, select Save.

- È possibile abilitare o disabilitare l'etichetta selezionando l'interruttore nella colonna Abilitato .
Customizing Component Templates
You can view and edit the template (XSL style sheet) that is used to format the component and determine which fields and text appear in the letter. Configure the template to customize what labels and data appear in the letters, as well as how they display. In addition, you can use XSL conditional statements to make decisions about what appears in a letter, and even whether the letter is sent. For examples of how the xsl conditions are used see: How To documents about specific functions of letters configuration using the if condition.
To customize a component's template (XSL style sheets):
- Nella pagina Configurazione componenti, selezioni Modifica nel menu riga Azione per il componente pertinente.
- Edit the information in the XSL pane as needed.
The available fields on this page are in the labels associated with the component and the XML fields that are generated by Alma.
- Utilizzi le funzioni substring e string-length per ottenere le ultime quattro cifre di un codice:
<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> - If the following snippet follows the address line in the SenderReceiver.xsl file, you can ensure that the user's phone number is included in all the letters that use this template.
<tr>
<td><xsl:value-of select="notification_data/user_for_printing/phone"/></td>
</tr> - Have the name of the style sheet appear as hidden text in the output by adding the following after the <html> tag.
<html> <xsl:attribute name="data-filename"> <xsl:value-of select="/notification_data/general_data/letter_type"/> </xsl:attribute>
L'output includerà qualcosa del genere:
<html data-filename=”FulLoanReceiptLetter”> ...
- Utilizzi le funzioni substring e string-length per ottenere le ultime quattro cifre di un codice:
- You can use Ctrl+Shift+f to implement Prettyprint (convert and present the XSL source code with line breaks and indentations to make the code easier to read).
- Select Save Draft to save your customizations as a draft. Le modifiche apportate alla bozza non verranno applicate al componente finché non si seleziona Salva. The draft watermark displays in the XSL pane while in draft mode. Si noti che una volta selezionato Salva, le modifiche verranno applicate a tutte le comunicazioni che utilizzano questo componente. Select Remove Draft to erase the draft and display the last saved XSL. Select Restore to restore the XSL to its original state. Note that while a draft is active, the Edit Draft and Remove Draft options are available in the row actions menu for the component.
- Per visualizzare in anteprima le modifiche, visualizzi una comunicazione che utilizza questo componente.
- To preview changes that were made to a component draft:
- , Passi a una comunicazione che utilizza questo componente.
- In the letter, update the XSL by adding _DRAFT to the relevant <xsl:include href="" /> statement, as shown in the following example:<xsl:include heref="footer.xsl _DRAFT"/>
- Il riquadro di anteprima mostrerà ora il componente bozza (in questo esempio, il piè di pagina aggiornato), in modo che Lei possa rivedere le modifiche.
- When the changes are complete, remove the _DRAFT suffix from the include statement:<xsl:include heref="footer.xsl"/>
- Select Save to apply the changes to the component i.e., override the current XSL with the updates. Questo rimuoverà anche la filigrana della bozza. Le modifiche verranno ora applicate a tutte le comunicazioni che utilizzano questo componente. Si noti che dopo il salvataggio, la comunicazione rimane nella finestra di anteprima. Per tornare all'elenco completo delle comunicazioni, selezionare Annulla.
Component List
La seguente tabella elenca i componenti disponibili in Alma.
| Letter | Descrizione | ||||||
|---|---|---|---|---|---|---|---|
| checksum_calc.xsl | Per uso interno | ||||||
| footer.xsl |
Definisce il testo utilizzato nel piè di pagina per tutte le comunicazioni email. Define the following in General > General Configuration > Other Settings:
|
||||||
| header.xsl | Definisce il testo (ad esempio il logo della Sua istituzione, il nome della comunicazione e la data) utilizzato nell'intestazione di tutte le comunicazioni via email. | ||||||
| mailReason.xsl | Definisce il saluto (ad esempio Gentile Sig./Sig.ra) utilizzato nella maggior parte delle e-mail di comunicazione. Il seguente testo stamperebbe Gentile John Smith per un utente di nome John Smith:
<xsl:template name="toWhomIsConcerned"> |
||||||
| recordTitle.xsl | Definisce il testo utilizzato per i dettagli bibliografici nella comunicazione via e-mail. | ||||||
| senderReceiver.xsl |
Definisce le informazioni sull'Indirizzo per tutte le comunicazioni email. This component uses <xsl:value-of select="notification_data/user_for_printing/name"/>, which is populated according to the configuration in User Name Display. Tuttavia, user_for_printing include anche i valori del nome e del nome preferito, quindi può essere configurato diversamente. Ad esempio, dal report XML dell'attività user_for_printing: <first_name>Ford</first_name> |
||||||
| SMSRecordTitle.xsl | Definisce il testo utilizzato per i dettagli bibliografici nella comunicazione SMS. | ||||||
| style.xsl comunicazione | Definisce il CSS utilizzato per tutte le comunicazioni email. |
Updating and Previewing Example Letters for Testing
Overview of Letter Templates
Un template (foglio di stile XSL) non assomiglia molto alla comunicazione che è utilizzato per creare, ma contiene elementi variabili in un ordine particolare. Il template contiene testo e XML, oltre a comandi e variabili XSL. Il testo dipendente dalla lingua è tenuto fuori dal template.
I dati di comunicazione provengono dal campo XML generato internamente e dalle etichette. I valori delle etichette e i campi XML sono sostituiti nelle variabili nel modello. For example, if the page POLineClaimLetter contains the label greeting, the value you enter into this label is substituted into <xsl:variable name=greeting> in the POLineClaimLetter template.
If you store the XML output in a file that has an .xml suffix, you can use it to test changes to the letter (see How to download letters as XML files). A titolo di esempio, ecco parte dell'output XML utilizzato per generare una ricerca per la comunicazione del Patron.
<notification_data>
<general_data>
<address_c>None</address_c>
<address_c>None</address_c>
<address_from>nosuchmail@no.such.mail.com</address_from>
<current_date>01/08/2017</current_date>
<letter_channel_info></letter_channel_info>
<letter_name>Regarding your request</letter_name>
<letter_type>QueryToPatronLetter</letter_type>
<subject>Regarding your request</subject>
</general_data>
<languages>
<string>en</string>
</languages>
<letter_params>
<address_from>nosuchmail@no.such.mail.com</address_from>
<letter_name></letter_name>
<subject>Regarding your request</subject>
</letter_params>
<letter_texts></letter_texts>
<library>
<address>
<city>chicago</city>
<country>USA</country>
<country_display>United States</country_display>
<create_date>06/20/2014</create_date>
<entity_action></entity_action>
<library_id>12900830000541</library_id>
<library_unit_id></library_unit_id>
<line1>library 2</line1>
<line2></line2>
<line3></line3>
<line4></line4>
<line5></line5>
<note></note>
<originating_id></originating_id>
<postal_code>36500</postal_code>
<preferred>true</preferred>
<segment_types_display>
<string>Billing</string>
<string>Patron Communications</string>
<string>Primary</string>
<string>Shipping</string>
</segment_types_display>
<state_province>IL</state_province>
<user_address_types_display></user_address_types_display>
</address> <automatic_creation>false</automatic_creation>
<automatically_activate_locate_profile>false</automatically_activate_locate_profile>
<automatically_locate_resource>true</automatically_locate_resource>
<bibliographic_titles></bibliographic_titles>
<cancel_request_on_locate_failure>true</cancel_request_on_locate_failure>
<code>RES_SHARE</code>
<code_rfid></code_rfid>
<create_date></create_date>
<default_acq_loctaion_id></default_acq_loctaion_id>
<default_item_loctaion_id>12900870000541</default_item_loctaion_id>
<default_move_loctaion_id>12900850000541</default_move_loctaion_id>
<default_pickup_loctaion_id>12900830000541</default_pickup_loctaion_id>
<default_printer></default_printer>
<description>Temporarily manages inventory that is sent to or received from resource sharing partners</description>
<digital_objects></digital_objects>
<digital_storage_size></digital_storage_size>
<disable_call_number_calculation>false</disable_call_number_calculation>
<edi_code></edi_code>
<edi_type></edi_type>
<email>
<create_date>03/31/2013</create_date>
<description></description>
<email>nosuchmail@no.such.mail.com</email>
<entity_action></entity_action>
<external_id></external_id>
<library_id>12900830000541</library_id>
<library_unit_id></library_unit_id>
<originating_id></originating_id>
<preferred>true</preferred>
</email>
<entity_action></entity_action>
<ignore_electronic>false</ignore_electronic>
<itemless_library></itemless_library>
<leader_institution_id></leader_institution_id>
<library_id>12900830000541</library_id>
...
Using Example Letters for Testing
On the Letter Examples tab, you can use the available XML examples to preview letters and test changes.
It is recommended to first create a letter example using the regular Alma flow to more closely represent a real letter. Da questo esempio dovreste rimuovere qualsiasi informazione identificativa.
How to Access the Letter Examples:
-
Navigate to Configuration > General > Letters > Letters Configuration.
- Select Edit in the row actions menu for the relevant letter.
- Select the Letter Examples button.

- C'è sempre una comunicazione default che appare, ma è possibile aggiungere ulteriori esempi come descritto di seguito.
La comunicazione default (DefaultLetter.xml) è solo un esempio XML molto basilare e pronto all’uso, reso disponibile per consentire all’istituzione di testare comunicazioni personalizzate, anche quando non hanno ancora attivato la comunicazione nel flusso pertinente. However, once the actual letter has been generated and sent, it is recommended to use the letter-specific XML for any further testing and select it from the Add from system letters button.
How to add existing letters that were generated in your institution:
- In the Letter Examples page, select the Add from system letters button. Note that if this letter has never been sent in the past, as part of the Alma flow, then the Add from system letters button will not display.

- La pagina Comunicazioni inviate appare, mostrando fino a 10 degli XML più recenti degli ultimi 7 giorni.
- Select the letter to add.

- The selected letter appears in the Letter Examples page.

- Seleziona Salva. Questa comunicazione sarà ora quella visualizzata nel riquadro XML.
- You can switch between letters in the XML pane by selecting the relevant letter in the drop down list.

How to download letters as XML files:
- Nella pagina Configurazione comunicazioni, per la comunicazione pertinente selezionare Modifica nel menu Azione della riga.
- Nel riquadro XML, selezioni il pulsante Scarica .
- Edit the file in an XML editor to make any relevant changes.
A dropdown has been introduced above the XML editor, displaying all available example letters XML files. Gli utenti possono passare da un file all'altro selezionando un'opzione da questo menu a tendina. Al momento della selezione, il contenuto dell'Editor XML viene sostituito con le informazioni del file scelto e l'anteprima della comunicazione viene aggiornata automaticamente.
How to add letters that were downloaded as XML files:
- In the Letter Examples page select the Upload letter example (XML) button.

- Browse to and select the XM file and select Upload.
- The added letter is not marked for default preview unless you select it in the Default Preview column.
Questi esempi sono soggetti alla policy di conservazione dell'istituzione. The XML files saved in the system will be retained for seven days and will be removed by the weekly cleanup job. Gli esempi XML aggiunti alla Lista XML dal sistema sono persistenti e non verranno eliminati dal processo settimanale. Da questi esempi si dovrebbe rimuovere qualsiasi informazione identificativa.
Contributing Letter Customizations to the Community Zone
You can contribute XSL templates to the Community Zone and you can copy shared XSL templates from the CZ to your institution for local use. You can also preview how a template will work and look before copying it. This makes it much easier to share XSL templates between institutions.
To contribute XSL templates to the Community Zone:
- Access the letter you want to contribute to the Community Zone from the Letter Configuration page (Configuration > General > Letters > Letter Configuration).
- Select the ... icon in the XSL pane and then select Contribute.

- Add a description that will help other users in the Community Zone understand your edits to the configuration, and provide the contact information by which other users can contact you in case they have questions.
By default, your email address appears in the Contact person. You can change this information, for example, to another user's email address or a phone number.

- Select Confirm. The XSL template is contributed to the Community Zone.
- If you or others from your institution attempt to contribute this same XSL configuration again, you are prompted: "This letter was already contributed for this institution. Sei sicuro di voler sovrascrivere?». poiché il nuovo contributo sovrascrive il contributo precedente. Select Confirm to re-contribute.
- You can view contributed letters by selecting the ... icon in the XSL pane, and then selecting the Shared XSLs option.

In the row actions menu for the relevant letter, select the Preview option to view the letter. - If at some point your institution decides to stop sharing a letter, select the Shared XSLs on the XSL pane and find your letter version in the list of versions contributed by all the contributing institutions. Select Delete in the row actions to remove the letter.
To copy a contributed XSL template to your institution:
- Access the letter you want to copy from the Letter Configuration page (Configuration > General > Letters > Letter Configuration).
- In the XSL pane select the ... icon and then Shared XSLs. This displays all of the XSL versions contributed by multiple institutions.
- Select the relevant letter to copy to your institution and then use the Select button to add it.
The selected version now displays in the preview window. - Selezioni Salva per salvare la comunicazione localmente presso la Sua istituzione.
Configuring the From and EnvelopeFrom Addresses for Outgoing Email
Alma invia e-mail agli utenti, al personale della biblioteca e al fornitore.
Ogni email ha due indirizzi "mittente":
- Da: Compare nel lettore di posta dell'Utente (generalmente usato per determinare la risposta all'Indirizzo).
- SMTP EnvelopeFrom address Used internally by mail relay servers to determine the origin of the message. This field appears as From(without the colon :) at the very top of the email packet when you look at the packet source, but does not normally appear in the user's mail reader. You may want to configure this field in order to catch bounced emails. This field is configured in the mail handling integration profile (see Setting the EnvelopeFrom Address with the Integration Profile).
Setting the From Address
L'indirizzo From può essere configurato dall'etichetta addressFrom o dalla pagina dell'unità organizzativa, come descritto di seguito.
Setting the From Address with the addressFrom Label
È possibile configurare l'indirizzo Da: di ogni email in uscita configurando l'etichetta addressFrom della comunicazione. L'etichetta addressFrom deve contenere un indirizzo email valido. You can also specify an alias for the addressFrom parameter in the following format: alias <actual_email_ID@university.edu>. Note that for the General mail that you can send when managing a user (see Editing Users), the default From: address is set using the from_address parameter (see Configuring Other Settings).
Le notifiche di Ordine (PO) e dei reclami ignorano il campo IndirizzoFrom configurato nella comunicazione quando è Definisci un email nell'istituzione per la risposta all'Ordine o al reclamo, rispettivamente. See Configuring Institution/Library Contact Information and Communicating with Vendors.
Setting the From Address with the Library's Preferred Email Address
Some letters are sent with the From: address containing the library's preferred email address if this address is configured. If the address is not configured, the letters use the associated email as the From address. Questo si riferisce alla seguente comunicazione:
-
Interessato alla comunicazione - Utilizza Alma@exlibrisgroup.com
-
OrderListLetter - This uses ILL@exlibrisgroup.com(if any of the library's email addresses are of type 'Order response')
Setting the From Address for Resource Sharing Letters
For resource sharing letters, the From: address contains the library's preferred email address, if this address is configured. If the address is not configured, the letters use ILL@exlibrisgroup.com as the From address.
When rs_use_addressfrom_letter_param (Configuration > Fulfillment > General > Other Settings) is set to true(default is false), then some letters are sent from the letter configuration for addressFrom (Configuration > General > Letters > Letters Configuration) instead of being sent from the Preferred Email Address set in Configuration > General > Libraries > Add a Library or Edit Library Information > Contact Information tab > Add Address/Edit an existing address. For more information see Configuring Other Settings (Fulfillment).
From all the resource sharing letters, the following is the list of letters that rs_use_addressfrom_letter_param relates to.
- Email di comunicazione del reclamo del mutuatario
- Comunicazione e-mail di ritardo del mutuatario
- Il mutuatario riceve la comunicazione via e-mail.
- Mutuatario Ritorno e-mail di comunicazione
- Lettera email ottenuta esternamente
- Ful annulla comunicazione email
- Lettera copia danneggiata
- Comunicazione slip in arrivo Ful
- Lettera email ottenuta esternamente
- Ful annulla comunicazione email
- Lettera copia danneggiata
- Comunicazione slip in arrivo Ful
- Email di conferma registrazione del prestatore
- Prestito richiamo email comunicazione
- Il prestatore rifiuta la comunicazione via email
- Email di Risposta di Rinnovo da parte di chi presta
- Lettera e-mail di check-in del prestatore
- Il prestatore invia una comunicazione via email.
- Chi presta fornirà un'Email
- Prestito richiamo email comunicazione
- ricerca per Patron comunicazione
- Rapido member letter
- Email di risposta da parte di chi presta
- Il prestatore invia una comunicazione via email
- Chi presta fornirà un'Email
See also the documentation regarding Patron Notifications for Fulfillment Library Independence.
Lettera membro Rapido
Condivisione delle risorse richiesta conferma comunicazione Questo abilita gli utenti a rispondere alla biblioteca corretta. For all Patron Notification letters, if a Circulation communication type email address is configured on the owning library or institution’s contact information page, this will be used as the Reply to address instead of the letter’s addressFrom label.
For a list of patron notification letters, see Patron Notifications.
Setting the EnvelopeFrom Address with the Integration Profile
Il profilo di integrazione della gestione della posta può essere impostato con un indirizzo SMTP Envelope From. Puoi anche utilizzare il profilo d'integrazione della gestione della posta per fare in modo che Alma invii tutte le email tramite il server di inoltro della posta dell'istituzione. In questo caso, il server di inoltro della posta Set EnvelopeFrom sull'email in uscita.
Nota che se il server di email di un destinatario (per gli utenti e il personale, questo è generalmente un server gestito dalla tua istituzione) ha impostato un filtro antispam, il filtro verifica se le email ricevute sono effettivamente inviate dal dominio dell'indirizzo in EnvelopeFrom. Quando c'è una mancata corrispondenza, le email possono essere filtrate come spam. To prevent this from happening,EnvelopeFrom should remain <something>@exlibrisgroup.com(unless your institution's anti-spam filters and SPF records are configured properly so that this is not an issue). Se non ti preoccupi che le email vengano filtrate come spam, potresti voler configurare EnvelopeFrom per intercettare le email di rimbalzo. Le email catturate nel filtro antispam di un server di posta elettronica generalmente non causano email respinte. See Mail device configuration on Ex Libris servers and/or applications for more information.
For information, see Alma Recommendation for Mail Relay and Support Domain Keys Identified Mail (DKIM).
To configure the mail handling integration profile:
For more information on email handling in Alma, see the Alma Technical Requirements document.
-
On the Integration Profile List page (Configuration Menu > General > External Systems > Integration Profiles), select Add Integration Profile. Alma consente di definire un solo profilo d'integrazione per la gestione della posta. Se è già presente un profilo d'integrazione per la gestione della posta, selezioni Modifica nella lista azioni di riga per modificare il profilo.
-
Inserisci un codice univoco e un nome per il profilo.
-
Nel campo Tipo di integrazione, selezionare Gestione della Posta.
-
Seleziona Avanti. The second page of the wizard appears.Active is selected by default.

-
Se desidera continuare a utilizzare il server di posta di Alma:
-
Select Send directly from Ex Libris(selected by default).
-
Enter a valid email address for SMTP EnvelopeFrom address.
-
-
Per utilizzare il server di inoltro della posta della tua istituzione:
-
Selezionare Invia tramite relay di posta dell'istituzione. Appaiono diversi campi aggiuntivi.
-
Inserisci il nome del dominio dell’istituzione. After you do this, the domain name appears after the SMTP EnvelopeFrom address field as @<domain name>. The domain name can contain up to 63 lower case alphanumeric characters, dashes -, and periods followed by a period and a two to six character lower case alphabetic top-level domain.
-
Immettere il nome host del relay di posta SMTP dell'istituzione. The host name can contain lower case alphanumeric characters as well as any of the characters - ! # $ % & ' * + / = ? ^ _ ` { | } or ~ and a period.
-
L'indirizzo SMTP EnvelopeFrom personalizzato è selezionato per impostazione predefinita. Enter a username of the address in the unlabeled field below this option. This sets EnvelopeFrom to <username>@<domain name>. Il nome utente può contenere gli stessi caratteri del nome host del relay di posta SMTP.
-
Se il relay di posta richiede un nome utente e una password per accettare email da Ex Libris, inserire il nome utente e la password. Questi possono essere qualsiasi carattere ASCII.
-
Se il relay di posta richiede la crittografia, selezioni Usa crittografia. Encryption port is set to 587 for you.
-
-
To send mail using MS Graph APIs, select Send using MS Graph APIs and fill in the additional fields that appear:
-
Tenant ID - The Azure ID defined for the institution
-
Client ID - The Azure ID given to Alma for sending the email
-
Client Secret - The password generated by Azure to authenticate the user
-
User ID - The Azure user defined for sending the email For more information see Register an Application with Microsoft Identity Platform and Using Microsoft Graph API to Send Email from Alma.
-
-
Seleziona Salva.
After creating the mail handling integration profile, users are able to test the email configuration. When executed, an email is sent to the preferred email of the logged-in user. Nella sezione Definizioni di gestione della posta, inserisci l'email e seleziona salva e verifica.
Selecting Save and Test sends the Test Letter. In order to successfully send the letter, you need to customize the addressFrom label from the Out of the Box value Your.Department@organization.com to an email address of your institution (Configuration > General > Letters > Letters Configuration).
Alma Recommendation for Mail Relay and Support Domain Keys Identified Mail (DKIM)
Quando un'email viene ricevuta da un server SMTP, vengono eseguiti diversi controlli di sicurezza per determinare se l'email è legittima o sospetta. If an email is marked as suspicious the SMTP server may delay the delivery of the email, mark the email as ‘spam' or not deliver the email at all. Questo articolo descrive come garantire che le email dal cloud Ex Libris non vengano contrassegnate come sospette.
Le email possono essere inviate dai prodotti Ex Libris in uno dei due modi:
-
With a ‘From address' domain of @exlibrisgroup.com
-
With a branded ‘From address' for example @institution.edu
Per i clienti che utilizzano Primo Classic, consigliamo di modificare il valore default.email.form nella tabella dei codici 'Invia email e SMS' dal default "donotreply@exlibris.cloud" a un valore più appropriato per la propria istituzione, ovvero "donotreply@exlibrisgroup.com".
DKIM è attualmente supportato per entrambi i metodi sopra menzionati. Emails sent from our cloud with a ‘From address' domain of @exlibrisgroup.com should not be marked as suspicious as they are signed using DKIM and Ex Libris has a DMARC policy. Please note that both the SMTP Envelope ‘From address' as well as the ‘header.from address' must use the same domain. La busta SMTP dall’indirizzo è configurata nel profilo d’integrazione Gestione posta e l’intestazione da indirizzo è configurata su ogni singola comunicazione inviata. More information on configuring outgoing mail can be found here.
Since late 2023, email services like GMAIL are gradually encouraging DKIM/SPF compliance (see details here: https://support.google.com/a/answer/174124?hl=en&sjid=15453546060050396344-EU). This may impact your patron's user experience.
If you want to have a DKIM-compliant setup with a custom domain, the recommended method is to configure the Alma mail integration profile with the "Send using institution email relay" option and implement DKIM on your institutional email relay.
Emails sent from Ex Libris that are branded with the institution's domain can be implemented securely in the following two ways:
-
Configure the Ex Libris application to pass the email directly to the institution's SMTP server to be authenticated under the institution's policies (DKIM + DMARC).
To configure the Alma Platform to pass the email to an external SMTP server, please refer to ‘configure the mail handling integration profile' in the documentation here. A seconda della policy del firewall dell'istituzione, il Suo reparto IT potrebbe dover aprire l'accesso dal cloud Ex Libris al server SMTP per la porta pertinente. The outgoing IP range for Alma, Primo VE and Primo Classic can be found here.
-
Configurare l'email affinché venga inviata dal cloud Ex Libris e autenticata utilizzando il “Sender Policy Framework” (SPF) e DKIM.
SPF è un metodo che consente al cloud di Ex Libris di inviare email per conto dell'istituzione. When an email is received by a SMTP server, a security check is performed where the IP that had sent the email is compared to the IPs listed in the DNS record for the ‘From Address' domain. To configure SPF, the DNS administrator of the institution needs to add the Ex Libris mail relay IP's to the institution's domain in a TXT record. The Ex Libris mail relay IP's differ based on the region of the customer so the relevant ‘SPF Include Entry' should be chosen. The different ‘SPF Include Entries' for the different regions can be found here.
DKIM, o DomainKeys Identified Mail, è un metodo di autenticazione email specificamente progettato per identificare il mittente fraudolento nell'indirizzo email, e il fascicolo di spoofing . Una volta attivata la funzionalità DKIM per la Sua istituzione, il profilo d'integrazione Mail-Handling includerà il supporto per le firme digitali DKIM nella posta elettronica in uscita. Configuration instructions can be found here.
For more information, see Outgoing emails configuration.
To Enable DKIM:
-
Mark the DKIM Setup checkbox. This creates the keys and uploads the public key to the Ex Libris DNS. A pop-up window appears with the CNAME details.
-
Copia il CNAME dalla finestra di dialogo e inoltralo al Suo reparto IT, affinché lo aggiunga al Suo DNS.
-
After your IT has added it to the DNS, select the Test DKIM DNS Setup option to test it. Se il test è stato superato, apparirà un messaggio di successo. Se il test fallisce per qualsiasi motivo, verrà visualizzato un messaggio con i dettagli del fallimento.
-
After successful testing, select the DKIM Active checkbox. Da questo momento in poi, le email in uscita includeranno la firma DKIM.
Letter List
La seguente tabella elenca le comunicazioni disponibili in Alma.
Nota riguardante le seguenti colonne nella tabella delle comunicazioni di Alma qui sotto:
- La colonna Traduzione idonea corrisponde alla colonna Rivolta all'utente nella pagina di configurazione delle comunicazioni di Alma. In entrambi i casi, un sì o un segno di spunta in questa colonna indica che la comunicazione è idonea alla traduzione per ambienti che utilizzano lingue diverse dall'inglese.
Alcuni codici potrebbero non essere disponibili per default nelle tabelle dei codici rivolte all'utente; in tali casi, il sistema fornisce una descrizione e traduzioni default. Se necessario, aggiunga il codice richiesto alla tabella dei codici della tessera della biblioteca, insieme a una descrizione adeguata e alle traduzioni.
| Nome della lettera | Descrizione Lettera | Categoria | Canale | Traduzione idonea (flag 'Patron Facing' in Alma) |
|---|---|---|---|---|
| Analisi della comunicazione | Contiene un Report e statistiche che viene inviato agli abbonati del report. For more information see Scheduling and Subscribing to Reports and Dashboards. | Analitica | No | |
| Automatic Loans Renew Notice | Notifica l'utente quando è stato effettuato un rinnovo automatico del prestito. La notifica si applica a tutte le regole di rinnovo automatico. Notifications are only sent if th Notify Automatic Renewals checkbox is marked in the 'Send Courtesy Notices and Handle Renewals'job configuration (Configuration > Fulfillment > Fulfillment Jobs Configuration). | Servizi | Sì | |
| Preso in prestito oer Lettera | Inviato ai patroni per indicare che un utente delegato ha preso in prestito una copia per loro conto. For details on working with proxy users, see Managing Proxy Users. | Servizi | Sì | |
| Email di comunicazione del reclamo del mutuatario | For short loans-to-peer partners, the letter is sent when the Automatic Claim field is enabled on the borrowing request and the value of the Time to Claim (days) is reached. See Resource Sharing Partners. | Resource sharing | Sì | |
| Comunicazione e-mail di ritardo del mutuatario | Inviato dall'istituzione prestatrice al partner richiedente quando una risorsa è scaduta. Quando viene inviata tramite protocollo ISO, la richiesta sul lato del prestito viene automaticamente contrassegnata come scaduta. Nota che questa comunicazione viene inviata solo ai Partner email. I partner ISO ricevono esclusivamente un messaggio ISO. | Resource sharing | Sì | |
| Il mutuatario riceve la comunicazione via e-mail. | Inviato all'istituzione prestatrice quando la copia del prestito è stata Ricevuta presso l'istituzione richiedente. | Resource sharing | Sì | |
| Mutuatario Ritorno e-mail di comunicazione | Inviato all'istituzione prestatrice quando l'istituzione richiedente ha restituito la copia prestata. | Resource sharing | Sì | |
| Lettera Attività Prestiti |
Letter Subject: Patron Circulation Summary Summary: Sent to patrons with activity; contains a list of the patron's loans, overdue items, and active fines. Description: Sent either by a job (Notifications – Send Periodic Fulfillment Activity Report) or by request, for example, the Renew Selected and Renew All actions on the Loans tab of the Patron Services page. For details on configuring the Borrowing Activity Report, see Configuring Fulfillment Jobs. Questa comunicazione può essere attivata per attivare una funzione webhook. See Webhooks. Trigger specifici:
Jobs: Notifications > Send Periodic Fulfillment Activity Report Frequency: According to the schedule in the job configuration, under Configuration > Fulfillment > General > Fulfillment Jobs Configuration > Borrowing Activity Report Job. If the patron has more than 100 active loans, only the first 100 are included on the letter and a flag is added to the XML - |
Servizi | SMS | Sì |
| Modifica lettera di richiesta sessioni Rapido | A letter that notifies the patron if the terms that were defined by the previous lender were changed when the request is moved to a new lender.
For a full list of letters used by Rapido, see Rapido Letters. |
Resource sharing | Sì | |
| Utente IdP Cloud Comunicazione creata | Per uso futuro | Gestione dell'utente | Sì | |
| Lettera Contributo alla Collezione | Inviato agli Utenti come risposta iniziale a un contributo alla Community Zone. For detailed information, see Contributing Local Electronic Collections to the Community Zone. | Gestione delle risorse | No | |
| Lettera Aggiornamento Status Contribuzione a Collezione | Inviato agli utenti come seguito di un contributo alla Community Zone. | Gestione delle risorse | No | |
|
Inviato ai membri quando gli aggiornamenti della Network Zone vengono distribuiti loro dal Dashboard di Configurazione Centrale. See Centrally Managing Letters in a Network Zone. |
Consortia (Only relevant with a Network zone setup) |
No | ||
| Conversation Letter | Used to communicate with vendors. See Communicating with Vendors.
The customer parameter: conversation_send_from_logged_in_user_address enables conversation letters to be configured as being sent from the logged in user's email (as address "From") or the library's. See Customer Parameters Mapping Table. |
Acquisizione | No | |
|
Lettera di Cortesia |
Letter Subject: Courtesy Notice Summary: Sent to patrons in a nightly job; contains a list of the patron's loans that are due soon. Description: Generated when the Notifications - Send Courtesy Notices and Handle Loan Renewals job runs. Trigger specifici:
La configurazione del processo determina quanti giorni prima della data di scadenza la comunicazione viene inviata e se viene inviata una sola volta o ripetutamente. For short loans, a separate Short Loan Letter may be sent. Jobs: Notifications > Send Courtesy Notices and Handle Loan Renewals job Frequency: Daily The possible renewal status codes are listed below:
|
Servizi | email SMS | Sì |
| Lettera status della consegna della registrazione | Sent to patrons by email to notify them when they join the waitlist, when a resource becomes available, and when the grace period expires. | Digitale | Sì | |
| Lettera status della consegna della registrazione | Sent to patrons by SMS to notify them when they join the waitlist, when a resource becomes available, and when the grace period expires. | Digitale | SMS | Sì |
| Lettera di attività deposito | Indica lo stato del deposito attivo. For detailed information, see Configuring the Deposit Activity Report Job. | Digitale | Sì | |
| Lettera di aggiornamento status deposito | Inviato ai depositanti quando il loro Deposito è Sottomesso, approvato, rifiutato, restituito o ritirato.
I campi per il soggetto sono disponibili nel campo del soggetto. The field is set by entering your text within <> +deposit_title. The format is as follows: See Configuring Patron Deposit Templates. |
Digitale | Sì | |
|
Lettera di notifica di consegna documento |
Letter Subject: Notification Item Letter Description: When a patron has requested digital material and the send method on the request is Attach Documents - Link, this notification is sent to patrons to provide links to the file. Consulta l'allegato delle copie digitalizzate da inviare a un utente. In addition, for ISO Alma RS partners, this will be received by the borrower institution if the lender has "Document delivery - link" selected for Select digitization target in the Digitization and Copyright Rules page. <xsl:if test="notification_data/download_url_saml != ''">
<tr> <td>@@for_saml_users@@<a> <xsl:attribute name="href"> <xsl:value-of select="notification_data/download_url_saml" /> </xsl:attribute>@@click_here@@</a> </td> </tr> </xsl:if> Trigger specifici:
Jobs: None Frequency: None See Attaching Digitized Items To Be Sent To a Patron. |
Servizi | Sì | |
| Download Digital Titles Inventory Job Letter | Sent after running the Download Digital Titles Inventory job to download the files of a digital title into a zip file (see Download Files). Questa comunicazione La informa che il lavoro è stato completato. | Digitale | Sì | |
| Scarica rappresentazione comunicazione | Sent after running the Download Files job to download the files of a representation. | Digitale | Sì | |
| Email Records Letter | Sent to patrons when records are export to email in Primo VE. Questo template consente di configurare le seguenti informazioni nell'email: nome della comunicazione, soggetto e Indirizzo del mittente. For information regarding export actions, see Exporting Records from Primo VE. | Primo | Sì | |
| Lettera Esportazione Utente | Un modo per lo spostamento di file tramite FTP (il meccanismo di ricezione FTP delle comunicazioni) utilizzato dai processi del sistema informativo studentesco (SIS). Non contiene alcun campo.
For information about the jobs, see Student Information Systems. |
Gestione dell'utente | Sottomissione | No |
| Lettera email ottenuta esternamente | Inviato agli utenti; contiene un URL per un articolo richiesto ottenuto tramite il servizio CCC GetItNow.
See Adding a Request For a CCC GetItNow Resource. |
Resource sharing | Sì | |
| Lettera di ricevuta del pagamento commissione multa | Inviato agli utenti; indica che il Pagamento è stato Ricevuto.
See Viewing Fines and Fees and Receiving Payments. |
Servizi | Sì | |
| Lettera di segnalazione di multe e commissioni | Un rapporto delle transazioni di multe e commissioni effettuate in un periodo di 1–7 giorni. For details on configuring the fines and fees report, see Creating Fines and Fees Reports. | Servizi | Sì | |
| Ful Prestito Info comunicazione | Inviato agli utenti; indica se una copia di Servizi interbibliotecari prestata è stata rinnovata con successo.
See Managing Resource Sharing Borrowing Requests. |
Servizi | Sì | |
| Ful annulla comunicazione email | Indica che una richiesta di condivisione delle risorse è stata annullata. Inviato automaticamente ai Partner quando una Richiesta di prestito in uscita dei Servizi interbibliotecari viene inviata a un Partner il cui Tipo = email.
See Managing Resource Sharing Borrowing Requests. |
Servizi | Sì | |
|
Lettera di richiesta cancellazione |
Letter Subject: Request Cancellation Description: Sent to patrons; indicates that a request has been canceled and the reason for the cancellation. See Managing Active Hold Shelf Items and Pickup at Shelf. Questa comunicazione può essere attivata per attivare una funzione webhook. See Webhooks. Trigger specifici:
Jobs:
Frequenza: Quotidiana Questa comunicazione non verrà inviata se la data limite della richiesta è stata superata. |
Servizi |
Webhook |
email - sì Webhook - No |
| Ful citazione Slip comunicazione | Una ricevuta stampata dal personale della biblioteca per una citazione della lista di lettura, in modo che la copia possa essere recuperata dallo scaffale. For details on reading list citations, see Managing Citations. Puoi includere un'immagine stampabile del codice a barre in questa comunicazione. | Corsi | No | |
| Citazione completa comunicazione Slip | Una ricevuta stampata dal personale della biblioteca di tutte le citazioni della Reading list del corso in modo che le copie possano essere recuperate dallo scaffale. For details on reading list citations, see Managing Citations. | Corsi | No | |
| Lettera copia danneggiata | Inviato al Partner prestatore per notifica che una copia dei Servizi interbibliotecari è stata danneggiata. See Managing Resource Sharing Borrowing Requests. | Resource sharing | No | |
| Lettera di copia di notifica digitalizzazione |
Inviato a un utente che ha richiesto la digitalizzazione del materiale con il metodo di invio Document Delivery. La comunicazione informa l'utente che la richiesta di digitalizzazione è stata completata e informa l'utente dove è possibile visionare il materiale digitale. For details on configuring digitization departments for processing digitization requests, see Configuring Digitization Departments. If Alma automatically attempted to add the file to a citation, the email also includes the status of that attempt. Se la richiesta di digitalizzazione riguarda una citazione in una Reading list, viene anche notificato il bibliotecario assegnato alla Lista. Se si implementa Leganto, verrà notificato anche il bibliotecario configurato per assign_to. See Configuring Leganto Copyright-Related Procedures. <tr> <td>@@reading_list_name@@: <xsl:value-of select="notification_data/request/reading_list_name"/> </td> </tr> <tr> <td>@@citation_id@@: <xsl:value-of select="notification_data/request/reading_list_citation_id"/> </td> </tr> <tr> <td>@@request_creator@@: <xsl:value-of select="notification_data/request/request_creator"/> </td> </tr> |
Servizi | Sì | |
|
Comunicazione di notifica multe\commissioni Ful |
Inviato ai clienti da un processo per informarli delle multe o delle tasse che devono. |
Servizi |
SMS |
email - sì SMS - No |
| Ful Hold Scaffale richiesta Slip comunicazione | Quando abilitata, la comunicazione viene stampata sulla stampante del Banco di circolazione quando la copia viene posizionata sullo scaffale di attesa, indipendentemente dal fatto che sia già stata stampata una ricevuta di prelievo. Se la stampa fallisce, la copia viene comunque posizionata sullo scaffale di attesa, ma l'Utente riceve un messaggio di avviso che la stampa non è riuscita. In questo modo, è possibile configurare una ricevuta da utilizzare per la copia in attesa sullo scaffale, che sia diversa dalla ricevuta utilizzata per prelevare la copia dallo scaffale.
Di default, la comunicazione ha gli stessi attributi della comunicazione Pickup stampa Slip Report, ma può essere configurata secondo necessità. La comunicazione viene attivata quando si esegue la scansione di una copia e la si posiziona sullo scaffale prenotazioni e quando si seleziona la funzione Attiva successivo nella pagina dello scaffale prenotazioni scadute. |
Servizi | No | |
|
Comunicazione slip in arrivo Ful |
Una ricevuta che viene stampata dal personale della biblioteca dalla lista delle attività delle Richieste di prestito in entrata dei Servizi interbibliotecari quando devono recuperare una copia dallo scaffale per Inviare a un utente. Puoi includere un'immagine stampabile del codice a barre in questa comunicazione.
|
Resource sharing |
|
No |
| Email persa comunicazione | Inviato al partner prestatore per avvisarlo che una copia di condivisione delle risorse è stata persa. See Managing Resource Sharing Borrowing Requests. | Resource sharing | No | |
|
Lettera di prestito smarrito |
Letter Subject: Lost Item Bill Description: An invoice letter (for the replacement fee) sent to the borrowing patron when a loan is overdue and the item is declared lost, according to the criteria described in Adding an Overdue and Lost Loan Profile. Ogni comunicazione generata è per una singola copia. Trigger specifici:
Jobs:Loans - Overdue and Lost Item job Frequenza: Quotidiana |
Servizi |
SMS |
email - sì SMS - Sì |
|
Lettera di notifica prestito smarrito |
Letter Subject: Long Overdue Items Summary: A warning sent to patrons when a loan is overdue, before the item is declared lost, according to the criteria described in Adding an Overdue and Lost Loan Notification. Description: Sent by the Loans - Overdue and Lost Item job when the switch_to_overdue_and_lost_loan_new_job parameter is set to false(see Configuring Other Settings). Trigger specifici:
Jobs:Loans - Overdue and Lost Item job Frequenza: Quotidiana |
Servizi |
SMS |
email - sì SMS - Sì |
| Comunicazione di rimborso della commissione persa per il prestito | Inviato agli utenti quando viene ritrovato un prestito dichiarato smarrito. Include il rimborso se applicabile. | Servizi | Sì | |
| Lettera in uscita | La richiesta di prestito in uscita è stata inviata a un partner con profilo di tipo email. | Resource sharing | Sì | |
|
Lettera prestito in ritardo e smarrito |
Letter Subject: Lost Items Bill Summary: A notification letter, sent to the borrowing patron, listing all overdue loans that have been declared lost, according to the criteria described in "Adding an Overdue and Lost Loan Profile". Include la quota di sostituzione che deve essere pagata per la copia smarrita. Description: A message sent to the borrowing patron listing all overdue loans that have been declared lost, according to the criteria described in Adding an Overdue and Lost Loan Notification. It is sent to patrons by the Loans - Overdue and Lost Item job when the switch_to_overdue_and_lost_loan_new_job parameter is set to true(see Configuring Other Settings). Trigger specifici:
Jobs:Loans - Overdue and Lost Item job Frequenza: Quotidiana |
Servizi |
SMS |
email - sì SMS - Sì |
|
Lettera di notifica prestito in ritardo e smarrito |
Letter Subject: Long Overdue Items - Notification Summary: A warning sent to patrons listing all overdue loans before the items are declared lost, according to the criteria described in Adding an Overdue and Lost Loan Notification Description: Sent by the Loans - Overdue and Lost Item job when the switch_to_overdue_and_lost_loan_new_job parameter is set to Trigger specifici:
Jobs:Loans - Overdue and Lost Item job Frequenza: Quotidiana If rs_allow_actions_on_scan_in is set to 'true', RS borrowing items are shipped upon scan and the shipments letter is sent. |
Servizi |
SMS |
email - sì SMS - Sì |
| Lettera di consegna personale | Inviato a un utente quando una copia viene digitalizzata per l'accesso personale da un banco di circolazione che supporta l'accesso personale. | Servizi | Sì | |
| Ful Pickup stampa Report il report delle ricevute comunicazione | Inviato agli utenti. Contiene una Lista dettagliata delle Risorse (bibliografiche) da ritirare. | Servizi | Sì | |
| E-mail Rinnovo Prestito | Indica che una richiesta di Servizi interbibliotecari è stata rinnovata. Inviato automaticamente ai Partner quando una Richiesta di prestito in uscita dei Servizi interbibliotecari viene inviata a un Partner il cui Tipo = email. | Resource sharing | Sì | |
| Lettera di richieste report |
A patron report listing all request items, broken down by Not Active,In Process, and On Hold Shelf. For details on running the report for a single patron, see Managing Patron Services. For details on running the report on a schedule, see Configuring Fulfillment Jobs.
|
Servizi | Sì | |
| Risorsa completa richiesta Slip comunicazione |
Una ricevuta stampata dal personale della biblioteca dalla pagina "Raccogli Risorse richieste" quando deve recuperare una copia dallo scaffale. For details on pickup up items from the shelf, see Pickup at Shelf. Puoi includere un'immagine stampabile del codice a barre in questa comunicazione. Il codice a barre viene generato per le richieste a livello di copia, non per le richieste a livello di Titolo. Per le richieste a livello di titolo, potrebbero esserci più articoli possibili, quindi i codici a barre appaiono come facoltativi e non come un codice a barre specifico collegato alla richiesta. Questa comunicazione viene stampata anche quando viene restituita una copia che aveva una richiesta di prenotazione. |
Servizi | No | |
| Ful Transit Slip Letter | Sent by the Create Physical Item Move Requests job when Print Transit Letter is set to Yes. Puoi includere un'immagine stampabile del codice a barre in questa comunicazione.
Questa comunicazione viene anche stampata dal personale della biblioteca e aggiunta a una copia quando viene spedita da un luogo all'altro. |
Inventory | No | |
| Generale Assegna a comunicazione | Questa opzione viene utilizzata quando un membro dello staff assegna un record a un altro membro dello staff e seleziona l'opzione Invia come email. Possibili esempi di questo sono:
|
Gestione dell'utente | No | |
| Email con Messaggio Generico | Un'email inviata al partner della Biblioteca per avvisarli di un nuovo messaggio generale inserito nella richiesta. | Resource sharing | Sì | |
|
Sent to the patron when the expiry date of an item on hold shelf is changed. Ciò abilita gli utenti a essere a conoscenza delle modifiche apportate dal personale della biblioteca al periodo sullo scaffale prenotazioni. (See also Updating the Expiry Date for Requests and On Hold Shelf Reminder Letter.) |
Servizi | Sì | ||
| Email ILL all'utente |
Inviato manualmente dalla pagina Dettagli Utente. Questa comunicazione non può essere personalizzata. |
Gestione dell'utente | No | |
| Interested In Letter |
Notifies users who are listed on the Interested Users tab of a PO line and meet one or both of the following criteria:
The notification is triggered when a physical item is received or an electronic item is activated, and/or when a PO line is cancelled. For more information, see Manually Creating a PO Line. L'orario di arrivo viene aggiunto alla comunicazione (al momento della ricezione) solo se la biblioteca della copia è diversa dalla biblioteca del dipartimento. |
Acquisizione | Sì | |
| Utenti interessati a lettera | Elenca gli utenti interessati quando si seleziona Stampa Lista Utenti interessati nella pagina Ricevere Nuovo Materiale. For more information, see Receiving Material. | Acquisizione | No | |
|
Lettera Pagamento fattura |
Il processo di Gestione contabile esportazione richiede di Attiva la comunicazione di Pagamento della Fattura. Questa comunicazione non può essere personalizzata. |
Acquisizione |
Sottomissione |
No |
| Item Change Due Date Letter | Un messaggio SMS inviato agli utenti per segnalare le modifiche alla data di scadenza. For details on managing patron activities, see Managing Patron Services. For the email version of this letter, see Loan Status Notice. | Servizi | SMS | Sì |
| Lettera di ricevute del deposito legale annuale |
Questo report presenta una panoramica annuale degli abbonamenti, indicando quali fascicoli sono stati ricevuti nell'anno in corso e quali sono ancora in sospeso e in attesa di sollecito. Questo Abilita i clienti a tracciare lo stato di accesso dei loro materiali serializzati. For more information, see Working With Legal Deposits. |
Acquisizione | No | |
| Lettera Sollecito Deposito Legale | Inviato al Fornitore per ricordare loro una precedente richiesta di una copia come richiesto dalla legge. Se questa comunicazione è attivata, viene inviata anche quando il tipo di ordine è LEGAL_DEPOSIT_NOLETTER.
For more information, see Working With Legal Deposits. |
Acquisizione | No | |
| Lettera Ordine Deposito legale | Inviato ai Fornitori per una richiesta di una copia come richiesto dalla legge.
For more information, see Working With Legal Deposits. |
Acquisizione | No | |
| Lettera di Ricezione Deposito legale | Inviato ai fornitori per confermare la ricezione di una copia di un articolo richiesto come previsto dalla legge.
For more information, see Working With Legal Deposits. |
Acquisizione | No | |
|
Link Leganto contrassegnato come lettera non funzionante |
Sent to the library when a user marks a link as broken. Inoltre, la comunicazione è disponibile anche nella lista Allegati dell'Utente. To configure that email notifications are sent to specific email addresses (such as a generic helpdesk), configure the mark_as_broken_email_notification parameter, using a comma to enter multiple entries. È possibile inviare notifiche email sia a un Utente specifico che a un Indirizzo email specifico. When either the mark_as_broken_email_notification parameter or the mark_as_broken_user_notification parameter is configured, an email is sent to that address each time a link or file is marked as broken. Quando più Utenti segnalano lo stesso link come non funzionante, nella tab Avviso viene aggiunto un CONTATORE che indica quanti Utenti hanno segnalato il link come non funzionante. |
Leganto |
|
Sì |
|
Leganto Crea lista - e-mail promemoria |
Un promemoria email per il docente per creare una lista. If the librarian selects the Leganto create list - reminder email action for a course that has the No list expected checkbox checked, the librarian can still send the reminder email, but an alert appears indicating that This course is marked as 'No list expected'. |
Leganto |
|
Sì |
|
Lettera di Leganto contrassegnata come risolta per interruzione |
Each user who reported the broken link receives the Leganto Marked As Broken Resolved Letter. This letter is enabled by default. If no template is enabled in Configuration > Leganto > Features > Broken Link Notification Template Name, the Leganto Marked As Broken Resolved Letter is sent without the Note to user text. |
Leganto |
|
Sì |
|
Leganto Detailed Notifications Email Letter |
Sent to instructors when notifications are waiting for them in Leganto. It aggregates the pending notifications by list for a given course into a single letter. Appears only if Leganto is enabled in your institution. |
Leganto |
|
Sì |
| Leganto Full Detailed Notifications Email Letter | The letter includes details about annotations, notifications, including the specific tags, comments, and due dates. Quando abilitato e sono disponibili nuove notifiche, la comunicazione viene inviata via email agli Utenti. | Leganto | No | |
| Leganto Notifiche email per le prossime scadenze | Inviato agli studenti nove giorni prima di una data di scadenza imminente. Inviato solo se il valore email_notifications_group è impostato su ALL. | Leganto | Sì | |
| Lettera e-mail di check-in del prestatore | Inviato al Partner mutuatario quando una copia è stata registrata presso l'istituzione di prestito. | Resource sharing | Sì | |
| Il prestatore rifiuta la comunicazione via email | Inviato al Partner mutuatario quando il Partner prestatore ha rifiutato una Richiesta di prestito in entrata. | Resource sharing | Sì | |
| Email di Risposta di Rinnovo da parte di chi presta | Inviato al partner mutuatario quando il partner prestatore risponde a una richiesta di rinnovo. | Resource sharing | Sì | |
| Il prestatore invia una comunicazione via email. | Letter Subject: Lender Ship Email Letter
Summary: Sent to the borrowing partner to indicate that the requested item has been shipped. Trigger specifici:
If rs_allow_actions_on_scan_in is set to 'true', RS borrowing items are shipped upon scan and the shipment letter is sent. |
Resource sharing | Sì | |
| Chi presta fornirà un'Email | Inviato al partner richiedente quando lo stato di una richiesta di condivisione delle risorse cambia in Sarà Fornito. | Resource sharing | Sì | |
| Prestito richiamo email comunicazione | Inviato al partner di prestito quando una copia è richiamata e deve essere restituita. | Resource sharing | Sì | |
| Richiesta di prestito Report Slip di comunicazione | Uno scontrino stampato dal personale della biblioteca per la richiesta selezionata nell'elenco delle attività di prestito che indica la disponibilità della copia affinché possa essere prelevata dallo scaffale e inviata al richiedente.
For more information see Managing Resource Sharing Lending Requests. |
Resource sharing | Sì | |
| Lettera di stampa licenza | Usato quando si stampa una licenza. See Printing Licenses or Amendments. | Gestione delle risorse | No | |
|
Lettera di ricevuta prestito |
This letter is generated for patrons after items are loaned from the circulation desk, renewed, or have their due dates changed when using the Patron Services workbench, as well as when fulfilling a personal delivery request, with automatic background recording of the loan (see Supporting Personal Delivery for Requests). Qualsiasi modifica apportata al prestito di un Utente genera una Ricevuta di Prestito (oltre a qualsiasi altra comunicazione "designata" che viene inviata). Ad esempio, modificare la data di scadenza di un prestito attiva l'avviso Stato del prestito. Selecting Done then initiates a Loan Receipt for the updated loan. |
Servizi |
|
Sì |
|
Letter Subject: Due Date Change for Item(s) Summary: Sent to patrons; indicates changes in the status of a loan or the due date. Trigger specifici:
Jobs: None Frequency: None Non viene inviata alcuna comunicazione per i richiami attivati al momento del prestito, ad esempio se la copia prestata è già stata richiesta. For the SMS version of this letter, see Item Change Due Date Letter. For details on managing patron activities, see Managing Patron Services. Questa comunicazione può essere attivata per attivare una funzione webhook. See Webhooks. |
Servizi |
Webhook |
email - sì Webhook - No |
|
| Login Using One Time Token Letter | comunicazione email che viene inviata a un utente per un accesso singolo a Primo o Alma. See Primo Login Using Email and Social and Email Login. Note that this letter is also used by the MFA setup (see Ex Libris Identity Service). | Primo | Sì | |
| Lettera di notifica scadenza E-Attivazione | Sent by the Notify E-Activation Due Task job to the assigned operator when an electronic activation task's due date has passed. For more information on the e-activation due date, see Manually Creating a PO Line, Managing Electronic Resource Activation, and Configuring Other Settings. | Acquisizione | No | |
| Lettera Notifica di Rinnovo | Inviato a un Utente quando una riga continua di ordine di acquisto con inventario viene inviata per il rinnovo manuale. For more information see Interested Users. | Acquisizione | No | |
|
Scaffale in attesa comunicazione |
Letter Subject: On Hold Shelf Description: Sent to patrons; indicates that an item is ready for pickup at the hold shelf. For details on picking up items from the hold shelf, see Managing the Hold Shelf. Questa comunicazione può essere attivata per attivare una funzione webhook. See Webhooks. Trigger specifici:
Jobs: None Frequency: None For information on customizing the On Hold Shelf letter to display the Notes that may affect loan line only if there is a block on the patron, see Customizing Letter Templates. |
Servizi |
SMS Webhook |
email - sì SMS - Sì Webhook - No |
| On Hold Shelf Reminder Letter | Sent to the patron after a set number of days. La lettera viene inviata dal processo Invia promemoria dello scaffale prenotazioni. It is possible to configure how many days after being placed on the hold shelf the reminder will be sent, and whether the reminder will continue to be sent at the configured interval until the Hold Shelf expiry (see Hold Shelf Update Expiry Letter). | Servizi | Sì | |
| Lettera Lista Ordini | Inviato ai Fornitori; contiene una Lista di copie ordinate. See Approving and Sending POs.
Questa comunicazione non viene utilizzata se l'Ordine viene effettuato tramite EDI o un altro sistema automatico. |
Acquisizione | No | |
| Ordina ora la comunicazione | Inviato allo staff utente che seleziona Ordina ora, avviando un Ordine immediato che bypassa la procedura abituale. La comunicazione indica se l'Ordine è riuscito. See Manually Creating a PO Line, Reviewing PO Lines, and Packaging PO Lines into a PO. | Acquisizione | No | |
|
Avviso di comunicazione in ritardo |
Letter Subject: Due Items Description: Sent to patrons; contains a list of all the patron's loans due that day. Sent in a nightly job (Notifications – Send Due Date Reminders). Specific Triggers: Daily job Jobs:Notifications – Send Due Date Reminders Frequenza: Quotidiana I dettagli della copia in questa comunicazione rappresentano la copia al momento del prestito. |
Servizi |
SMS |
email - sì SMS - Sì |
| Lettera Analisi Sovrapposizioni | Inviato a un membro dello staff che esegue un lavoro di analisi di sovrapposizione e raccolta. La comunicazione indica che il lavoro di analisi di sovrapposizione e raccolta è stato completato. For more information regarding overlap and collection analysis, see to Working with Overlap and Collection Analysis. | Gestione delle risorse | No | |
| Lettera abbonamento proprietario | Inviato a un docente quando viene aggiunto come proprietario di una reading list. For more information, see Managing Reading List Owners and Collaborators. | Corsi | No | |
| Lettera fattura partner | Inviare un'e-mail ai partner rilevanti specificando i costi per la richiesta. For more information, see Managing Rapido Lending Requests. | Resource sharing | No | |
| Partner smarrito/danneggiato Fattura comunicazione | Emailed to relevant partners when a lender uses the Send Invoice Lost/Damaged Invoice action. The letter contains the invoice number, request identifier, and the lost/damaged charge for the request. | Resource sharing | No | |
|
Patron Welcome Letter |
Letter Subject: Patron Welcome Letter Description: This letter is sent when adding a patron role to a user, whether manually, through a job, or using SIS. La comunicazione non viene inviata quando il Ruolo utente viene aggiunto tramite un'unione o una migrazione. If you do not want to send the letter if the patron role was added by a linked account, add a condition to the XSL file to prevent sending the letter in this case. L'XML della comunicazione include un Indicatore (di campo) se il Ruolo è stato aggiunto da un account collegato. Questa indicazione può essere utilizzata per impedire che la comunicazione invii il documento. For examples of how the xsl conditions are used see: How To documents about specific functions of letters configuration using the if condition. Trigger specifici:
Jobs: Update/Notify Users > Add role "Patron" Frequency: None |
Gestione dell'utente | Sì | |
| Lettera soglia PDA |
Inviato al responsabile del PDA (contatto PDA) quando l'uso del PDA raggiunge la soglia di Alert. See Patron Driven Acquisitions. |
Amministrazione | No | |
|
Personal Information Letter |
Sent to patrons with an attached file containing the complete XML record of the data stored about the patron in their user accounts, including attachments. Il messaggio viene inviato all'indirizzo email preferito dell'utente. In order to send a Personal Information Letter to a patron, the parameter Send Patron Information Letter must be enabled under Circulation Desk roles'. The parameter Send Patron Information Letter is activated for users with a Circulation Desk role by default. If it is not activated or you wish to deactivate it, open a ticket with Ex Libris support. |
Gestione dell'utente |
|
No |
| Lettera di generazione codice PIN | Inviato ai patroni quando viene impostato un codice PIN nelle pagine di gestione utente. For details on configuring user details, see Adding Users. | Gestione dell'utente | Sì | |
| PO Line Cancellation Letter | Inviato al fornitore, richiesta di annullamento di un ordine. For details on canceling a PO line, see Canceling PO Lines. | Acquisizione | No | |
|
Lettera solleciti aggregati linea d’ordine |
Sent to vendors when an order does not arrive by the expected date (see Processing Claims), when claims for multiple PO lines are combined into a single letter (i.e., when the claim_aggregated_letter Customer Parameter is set to TRUE). Se tutte le Linee d'ordine (POL) dichiarate provengono dalla stessa biblioteca proprietaria, viene utilizzato l'Indirizzo del mittente della biblioteca (anziché dell'istituzione). If claim_aggregated_letter is set to TRUE, but the PO Line Aggregated Claim Letter letter is disabled, no claim letter is sent to the vendor. Questo parametro non influisce sulla comunicazione della richiesta di deposito legale. |
Acquisizione |
|
No |
|
PO Line Claim Letter |
Sent to vendors when an order does not arrive by the expected date (see Processing Claims), when claims for multiple PO lines are not combined into a single letter (i.e., when the claim_aggregated_letter Customer Parameter is set to FALSE). Il campo per il soggetto è disponibile nel campo new_subject . The field is set by entering your text within <> + field name. Il formato è il seguente: <My Title Text: > title <My Ref Num Text: > poline_reference_number <My Item Desc Text: > item_description Di seguito sono elencati i campi che possono essere utilizzati all'interno del campo soggetto:
|
Acquisizione |
|
No |
| Lettera di rinnovo Linea PO | Inviato ai Fornitori, richiedendo il rinnovo di un abbonamento. This requires the po_line_send_notification_to_vendor_on_renewal parameter to be set to true on the Mapping Table page for Other Settings (Configuration Menu > Acquisitions > General > Other Settings).
For details on renewing PO lines, see Renewal Workflow. |
Acquisizione | No | |
| Lettera di completamento processo Bib Export | Inviato a un utente staff, per segnalare che è terminata un'esportazione bibliografica. For details on exporting bibliographic records, see Export bibliographic records in Running Manual Jobs on Defined Sets. | Gestione delle risorse | No | |
| Creazione del processo |
Sent upon successfully scheduling some user-submitted jobs — for example, jobs run on the Run a Job page (see Running Manual Jobs on Defined Sets). Questa comunicazione non può essere personalizzata. |
Amministrazione | No | |
| Lettera di status richiesta acquisto | Inviato al richiedente di una Richiesta d'acquisto quando la richiesta viene approvata o respinta.
For more information, see Purchase Requests. |
Acquisizione | Sì | |
| Lettera di processo di sistema PZ | Un report inviato all'indirizzo email specificato nella richiesta API, che riassume le informazioni dai lavori di Caricamento del portfolio e Importazione MD che sono stati attivati tramite il lavoro di Zona del fornitore. | Gestione delle risorse | No | |
| Lettera domanda all'utente | Sent to patrons when the user selects Send query to patron from a resource-sharing borrowing request. See Managing Resource Sharing Borrowing Requests.
This letter is only used when the institution is using patron query types; see Configuring Patron Queries. To configure, see Example of Letter Customization: The Query to Patron Letter. |
Resource sharing | Sì | |
| ricerca al richiedente comunicazione | Inviato al richiedente di una Richiesta d'acquisto quando il bibliotecario lo contatta per ulteriori informazioni.
For more information, see Purchase Requests. |
Acquisizione | Sì | |
| Comunicazione del membro Rapido | Questa comunicazione è inviata ai potenziali Partner con la richiesta di unirsi al loro gruppo di Servizi interbibliotecari. | Resource sharing | No | |
| Lettera Richiesta Rapido Nuova Partnership | This letter is used to contact an identified partner within the directory from the Find Partner workflow, using the Send Rapido Request action, to begin the process of adding the potential partner as a new partner. | Resource sharing | Sì | |
| Ricevimento lettera di ricevuta | Una ricevuta stampata dal personale della biblioteca con le informazioni sulla copia che viene inserita in una nuova copia quando arriva in biblioteca. Puoi includere un'immagine stampabile del codice a barre in questa comunicazione. | Valuta | No | |
| Lettera Segnala un problema | A feedback sent from a Primo VE user to the feedback administrator. Dopo aver aperto lo strumento di feedback, gli utenti devono specificare il tipo di problema e includere una descrizione facoltativa del problema e un indirizzo e-mail per la risposta. Le email includono i dettagli del feedback, l'URL della pagina da cui è stato inviato il feedback e il tipo di dispositivo utilizzato per inviarlo. | Discovery | No | |
| Resend Notification Letter | Inviato manualmente a un utente se l'utente non ha Ricevuto un allegato. For more information, see User Attachments. | Servizi | Sì | |
| Lettera di reimpostazione della password |
Letter Subject: Reset Password Description: Sent from various workflows, and includes a link to a page which allows the recipient to change (or create) his or her password. Trigger specifici:
Jobs: Update/Notify Users job > Send notification to user > Identity Service mail Frequency: None When the Reset Password letter is sent by the Update/Notify Users job or from the Send Message drop-down list, the link is active for twenty-four hours. Quando la comunicazione viene inviata dalla sezione Password dimenticata? link, è attivo per un'ora. |
Gestione dell'utente | Sì | |
| Resource Sharing Borrowing Request Slip Letter |
A slip that is printed manually when the resource sharing operator uses the Print Slip action (in the resource sharing request list). Mainly intended for Japanese customers using the integration with the NACSIS-ILL system. Printing the slips is possible from the borrowing task list. |
Resource sharing | Sì | |
| Resource Sharing Conversation Letter |
invia un'e-mail a un partner direttamente dalla lista delle attività di prestito richieste. This letter is for Rapido and Alma users. For more information see Configuring Rapido Letters and Managing Rapido Borrowing Workflows. |
Resource sharing | No | |
|
Condivisione delle risorse Ricevi comunicazione con Slip |
Una ricevuta che viene stampata automaticamente quando si seleziona l'opzione Stampa ricevuta automatica in Ricezione copie. Puoi includere un'immagine stampabile del codice a barre in questa comunicazione. Sono state aggiunte etichette NACSIS per gli utenti dell'integrazione NACSIS-ILL. |
Resource sharing |
|
Sì |
| Email di risposta da parte di chi presta | When configured, Alma sends a confirmation email when a request is placed to confirm with the patron that their request has been placed. Per default, questa comunicazione è disattivata. | Resource sharing | Sì | |
| Il prestatore invia una comunicazione via email | Stampabile quando si restituisce una copia presa in prestito alla Biblioteca fornitrice. È possibile includere un'immagine stampabile del codice a barre su questa comunicazione. La stampa della comunicazione avverrà se:
La comunicazione non è rilevante per la transazione NCIP. Sono state aggiunte etichette NACSIS per gli utenti dell'integrazione NACSIS-ILL. |
Resource sharing | Sì | |
| Chi presta fornirà un'Email |
Sent to a user when the user selects the Ship Item link for a lending request and then selects Automatically Print Slip = Yes on the Shipping Items page. Puoi includere un'immagine stampabile del codice a barre in questa comunicazione. See Shipping Items.
|
Resource sharing | No | |
| Lettera di accesso limitato IP | Inviato ai responsabili quando viene effettuato un tentativo di accesso da un indirizzo IP ristretto. For more information, see Security. | Amministrazione | No | |
| Lettera di ricezione restituzione | Inviato agli utenti dopo che le copie sono state restituite al banco di circolazione. For details on returning items to the circulation desk, see Returning Items. | Servizi | Sì | |
| Lettera di notifica Scadenza certificato SAML |
Inviato agli Utenti con il Ruolo di amministratore dei sistemi generale per ricordare loro che il certificato SAML sta per scadere e consigliare di consultare il Servizio IT in merito alla necessità potenziale di sostituirlo. Sent approximately 60 days and 30 days before expiration. See Replacing a Signed Certificate. |
Amministrazione | No | |
|
Lettera di ricerche salvate |
Questa comunicazione è una comunicazione settimanale attivata dal processo pianificato Avviso sulle ricerche salvate, che invia i nuovi risultati della ricerca Primo VE salvata all'utente. Le opzioni di configurazione per questa comunicazione sono sul lato di Primo (VE). The labels can be found in Discovery > Labels > Send Email and SMS Labels. |
Primo |
|
No |
| Lettera Invia richiesta Rapido | Rapido invia una richiesta a una Biblioteca fornitrice per una nuova collaborazione di Servizi interbibliotecari. For more information about Rapido letter, see Send Rapido Request Letter | Amministrazione | No | |
| Short Loan Letter |
Letter Subject: Courtesy Notice Description: Sent to a patron when loaning an item for a short period (a number of minutes/ hours), informing the patron of the due date and the fine policy. For details on loaning items, see Loaning Items. Questa comunicazione dipende dall'impostazione del parametro short_loan_courtesy_reminder e viene attivata in base alla data e all'ora di scadenza, meno il valore del parametro. See also Configuring Short Term Loans. |
Servizi | Sì | |
|
Lettera di Anticipazione Data di scadenza |
Inviato agli utenti per avvisarli che la data di scadenza del loro prestito è stata ridotta. Questo avviene al momento del prestito o del rinnovo. Tuttavia, al momento del rinnovo, la comunicazione viene attivata solo se il rinnovo viene effettuato dal personale tramite la pagina Gestisci Servizi Utente. Se il rinnovo viene effettuato dall'utente in Primo, la data di scadenza abbreviata viene visualizzata immediatamente all'utente. I dati della comunicazione contengono l'oggetto del prestito e il messaggio. I possibili messaggi sono:
For setting the parameter,shortened_due_date_notifications, see Configuring Other Settings. |
Servizi |
SMS |
email - sì SMS - Sì |
| Lettera di account allegato al Social login | Inviato dopo aver collegato un account Utente a un fornitore di logica sociale. Per il personale della biblioteca, l'email include un link che può essere utilizzato per accedere rapidamente ad Alma. | Gestione dell'utente | Sì | |
| Lettera invito al social login | Un email inviata al personale utente invitandolo a utilizzare gli accessi ai social network anziché l'accesso standard ad Alma. For more information, see Social and Email Login. | Gestione dell'utente | Sì | |
| Lavoro di sistema comunicazione | Inviata quando i processi avviati in Alma iniziano e si completano (la comunicazione viene inviata all'Utente che ha avviato il processo). For details on configuring Alma jobs (processes), see Managing Jobs. | Amministrazione | No | |
| Lettera di test stampante | Inviato solo per verificare se è possibile inviare l'email. Nel profilo d'integrazione della gestione della posta è presente un pulsante Test che lo invia. | Amministrazione | No | |
| Lettera Trials | Contiene una richiesta di valutare una risorsa elettronica. For details on evaluating resources, see Evaluation Workflow. | Acquisizione | Sì | |
| Lettera Aggiormento Contributo a Collezione | Inviato all'Utente dopo che ha aggiornato una raccolta e l'ha nuovamente contribuita alla Community Zone. For more information, see Contributing Local Electronic Collections to the Community Zone. | Gestione delle risorse | No | |
| Comunicazione di eliminazione utente | Sent to a patron before the patron is deleted, containing details of the patron's active fines and fees. See Deleting Users. | Gestione dell'utente | Sì | |
| Lettera di notifiche utente (Nuovo Gen) | Questa comunicazione disciplina le notifiche di Titolo Alert ed è inviata agli Utenti Rialto che hanno optato per ricevere notifiche via email tramite l'interfaccia Notifiche. | Amministrazione | Sì | |
| Lettera di notifiche utente |
Letter Subject: Library Notice Description: Sent to users using the Update/Notify Users job. For more information, see Configuring User Notification Types. Specific Triggers: Update/Notify Users job Jobs: Update/Notify Users job > Send notification to user Frequency: None For more information, see Configuring User Notification Types. |
Gestione dell'utente | Sì | |
| Lettera Registrazione Utente | Non in uso | Gestione dell'utente | No | |
| Lettera di fallimento webhook | Inviato a tutti i contatti email definiti in un profilo d'integrazione webhook se un messaggio webhook non viene inviato correttamente dopo 4 tentativi (nell'arco di 10 ore) quando viene ricevuta una risposta HTTP 5XX. Per ulteriori informazioni sul meccanismo di ripetizione dei tentativi, consultare la Developer Network. | Amministrazione | No |