Lo Script Engine consente l’invio automatizzato di e-mail dall'interno di un Package.
A tal fine, IrionEDM mette a disposizione dell'utente il cmdlet Send-IrionDQMail. Esso accetta in input i parametri elencati nella seguente tabella.
Nome |
Descrizione |
---|---|
From |
Indirizzo e-mail del mittente. |
To |
Indirizzo e-mail del destinatario. È possibile anche specificare due o più destinatari mediante un array di indirizzi. |
ToList |
Indirizzo e-mail del destinatario, impostato attraverso la Distribution List definita a livello di Catalog. È possibile anche specificare due o più destinatari mediante un array di stringhe. |
Cc |
Indirizzo e-mail del destinatario della copia conoscenza. È possibile anche specificare due o più destinatari mediante un array di indirizzi. |
CcList |
Indirizzo e-mail del destinatario della copia conoscenza, impostato attraverso la Distribution List definita a livello di Catalog. È possibile anche specificare due o più destinatari mediante un array di stringhe. |
Bcc |
Indirizzo e-mail del destinatario della copia conoscenza nascosta. È possibile anche specificare due o più destinatari mediante un array di indirizzi. |
BccList |
Indirizzo e-mail del destinatario della copia conoscenza nascosta, impostato attraverso la Distribution List definita a livello di Catalog. È possibile anche specificare due o più destinatari mediante un array di stringhe. |
Attachments |
Percorso assoluto di un eventuale allegato. È possibile anche specificare due o più allegati mediante un array di path. |
Subject |
Oggetto della mail. |
Body |
Corpo della mail. |
BodyAsHtml |
Se presente forza la formattazione html del corpo della mail. |
Encoding |
Codifica da applicare al testo della mail (e.g. [System.Text.Encoding]::UTF8). |
Priority |
Priorità della mail. Può assumere i valori: ✓ [System.Net.Mail.MailPriority]::High ✓ [System.Net.Mail.MailPriority]::Normal ✓ [System.Net.Mail.MailPriority]::Low |
Default |
Parametro privo di valore. Se presente forza l'utilizzo di un server SMTP (Simple Mail Transfer Protocol) predefinito a livello di Catalog, nel tab Mail Servers dei Catalog Settings. |
SmtpServer |
Server SMTP. Non specificare in caso di presenza del parametro Default. |
Credential |
Oggetto PSCredential contenente Nome utente e password per l'accesso al server SMTP. Non specificare in caso di presenza del parametro Default. |
SmtpPort |
Porta SMTP. Non specificare in caso di presenza del parametro Default. |
UseSsl |
Parametro privo di valore. Se presente forza l'utilizzo del protocollo di sicurezza SSL (Secure Sockets Layer). |
Delivery Notification Options |
Opzioni relative alla ricevuta di ritorno. Può assumere i valori: ✓ [System.Net.Mail.MailPriority]::Delay (Notifica se la consegna è posticipata); ✓ [System.Net.Mail.MailPriority]::Never (Non viene inviata alcuna notifica); ✓ [System.Net.Mail.MailPriority]::OnFailure (Notifica se la consegna è fallita); ✓ [System.Net.Mail.MailPriority]::OnSuccess (Notifica se la consegnaha avuto successo); |
Il solo parametro in input obbligatorio è l'indirizzo e-mail del destinatario. |
ESEMPIO DI UTILIZZO Supponiamo di voler inviare una e-mail, corredata di oggetto e corpo del messaggio, mediante uno Script Engine. La sintassi corretta è: $from = 'sender@mydomain.com' $to = 'addressee@sample.com' $subject = 'Hello' $body = 'Hello, this is the message body.' Send-IrionDQMail -from $from ` -to $to ` -subject $subject ` -body $body ` -Default dove i termini preceduti da "$" identificano variabili PowerShell, mentre il carattere "`" (backtick: ALT + 96) consente la scrittura di comandi multi-linea. |