Konfigurieren von E-Mail-Endpunkten configuring-email-endpoints
E-Mail-Endpunkte ermöglichen es Benutzenden, einen Dienst durch Senden eines oder mehrerer Dokumente (als E-Mail-Anlage) an ein bestimmtes E-Mail-Konto aufzurufen. Der E-Mail-Posteingang fungiert als Sammelstelle für die Anlagen. Der Dienst überwacht den Posteingang und verarbeitet die Anlagen. Die Ergebnisse der Konvertierung werden an die Person weitergeleitet, die im Endpunkt festgelegt ist.
Für einen E-Mail-Endpunkt können autorisierte Benutzende einen Prozess aufrufen, indem Dateien per E-Mail an das entsprechende Konto gesendet werden. Die Ergebnisse werden an die Absenderin bzw. den Absender (Standard) oder an die in den Endpunkteinstellungen angegebene Person zurückgegeben.
Bevor Sie einen E-Mail-Endpunkt konfigurieren, erstellen Sie ein POP3- oder IMAP-E-Mail-Konto, das mit dem Endpunkt verwendet werden soll. Richten Sie für jede Konvertierungsart ein eigenes Konto ein. So kann beispielsweise ein Konto zum Generieren standardmäßiger PDF-Dokumente aus eingehenden E-Mail-Anlagen konfiguriert werden, während ein anderes Konto zum Generieren geschützter PDF-Dokumente eingerichtet werden kann.
Alle E-Mail-Endpunkte werden mit einem autorisierten Benutzernamen und Kennwort für den E-Mail-Posteingang konfiguriert. Diese Informationen müssen beim Aufrufen des Dienstes angegeben werden. Das E-Mail-Konto wird von dem E-Mail-Server-System geschützt, für das es konfiguriert ist.
Wenn Benutzer Dokumente mit westeuropäischen Sprachzeichen in Datei- und Konvertierungspfadnamen senden, müssen Sie eine E-Mail-Anwendung einsetzen, welche die erforderlichen Kodierungstypen (Latin1 [ISO-8859-1], Westeuropäisch [Windows] oder UTF-8) unterstützt. Weitere Informationen hierzu finden Sie im Dokument Installieren und Bereitstellen von AEM Forms für Ihren Anwendungs-Server.
Bevor Sie einen E-Mail-Endpunkt konfigurieren, richten Sie den E-Mail-Dienst ein. (Siehe Konfigurieren der Standardeinstellungen für E-Mail-Endpunkte.) Die Konfigurationsparameter des E-Mail-Dienstes haben zwei Verwendungszwecke:
- Konfigurieren von Attributen, die für alle E-Mail-Endpunkte gültig sind
- Bereitstellen von Standardwerten für alle E-Mail-Endpunkte
Konfigurieren von SSL für einen E-Mail-Endpunkt configure-ssl-for-an-email-endpoint
Sie können POP3, IMAP bzw. SMTP zum Verwenden von Secure Sockets Layer (SSL) für einen E-Mail-Endpunkt konfigurieren.
-
Aktivieren Sie auf dem E-Mail-Server gemäß der Dokumentation des Herstellers SSL für POP3, IMAP bzw. SMTP.
-
Exportieren Sie ein Client-Zertifikat vom E-Mail-Server.
-
Verwenden Sie das Programm Keytool, um die Client-Zertifikatdatei in den Java Virtual Machine(JVM)-Zertifikatspeicher des Anwendungs-Servers zu importieren. Das hierfür verwendete Verfahren ist von den JVM- und Client-Installationspfaden abhängig.
Wenn Sie beispielsweise eine standardmäßige Oracle WebLogic Server-Installation mit JDK 1.5.0 unter Microsoft Windows Server® 2003 verwenden, geben Sie an einer Eingabeaufforderung den folgenden Text ein:
keytool -import -file client_certificate -alias myalias -keystore BEA_HOME\jdk150_04\jre\security\cacerts
-
Geben Sie das Kennwort ein, wenn Sie dazu aufgefordert werden (für Java lautet das Standardkennwort
changeit
). In einer Meldung wird angezeigt, dass das Zertifikat erfolgreich importiert wurde. -
Verwenden Sie die Administrationskonsole, um dem Dienst den E-Mail-Endpunkt hinzuzufügen.
-
Erstellen Sie den E-Mail-Endpunkt in der Administrationskonsole. Aktivieren Sie beim Konfigurieren der Endpunkteinstellungen die Option „POP3/IMAP SSL aktiviert“ für eingehende Nachrichten und „SMTP SSL aktiviert“ für ausgehende Nachrichten und ändern Sie die Port-Eigenschaften entsprechend.
Konfigurieren der Standardeinstellungen für E-Mail-Endpunkte configure-default-email-endpoint-settings
Auf der Seite „Dienstverwaltung“ können Sie die Attribute konfigurieren, die allen E-Mail-Endpunkten gemeinsam sind, und Standardwerte für alle E-Mail-Endpunkte angeben.
Damit der Forms-Workflow eingehende E-Mail-Nachrichten von Benutzenden empfängt und verarbeitet, müssen Sie einen E-Mail-Endpunkt für den Complete Task-Dienst erstellen. Für diesen E-Mail-Endpunkt sind zusätzliche Einstellungen erforderlich, die unter Erstellen eines E-Mail-Endpunkts für den Complete Task-Dienst beschrieben werden.
Ändern der Standardwerte für E-Mail-Endpunkte change-the-default-values-for-email-endpoints
- Klicken Sie in der Administration-Console auf „Dienste“ > „Anwendungen und Dienste“ > „Dienstverwaltung“.
- Klicken Sie auf der Seite „Dienstverwaltung“ auf „E-Mail: 1.0“ (die Komponenten-ID lautet „com.adobe.idp.dsc.provider.service.email.Email“).
- Geben Sie auf der Registerkarte „Konfiguration“ die Standardeinstellungen für E-Mail-Endpunkte an und klicken Sie auf „Speichern“.
Standardeinstellungen für E-Mail-Endpunkte default-email-endpoint-settings
Cron-Ausdruck: Der Cron-Ausdruck, wie er von Quartz zur zeitlichen Planung des Abrufs des Eingabeordners verwendet wird.
Wiederholungsintervall: Die Häufigkeit, mit der der Ordner abgerufen wird. Der Standardwert für das Wiederholungsintervall in Sekunden, wenn in der Endpunktkonfiguration kein Wert angegeben ist. Der Standardwert ist 10. Dieser Wert kann nicht kleiner als „10“ sein.
Anzahl der Wiederholungen: Wie oft das Eingabeverzeichnis abgefragt wird. Der Standardwert für die Anzahl der Wiederholungen, der verwendet wird, wenn in der Endpunktkonfiguration kein Wert angegeben ist. Ein Wert von „-1“ bedeutet unbegrenztes Überprüfen des Ordners. Der Standardwert lautet -1.
Start des Auftrags verzögern: Der Standardwert in Sekunden für die Verzögerung, bevor der Auftrag beginnt, den Endpunkt zu überprüfen. Der Standardwert lautet 0.
Batch-Größe: Die Anzahl der E-Mails, die der Empfänger pro Überprüfung zur Optimierung der Leistung verarbeitet. Der Wert „-1“ bedeutet alle E-Mails. Der Standardwert lautet 2.
Asynchron: Gibt den Aufruftyp als asynchron oder synchron an. Transiente und synchrone Prozesse können nur synchron aufgerufen werden. Der Standardwert lautet „asynchron“.
Domain-Muster: Das Domain-Namensmuster, das zum Filtern eingehender E-Mails verwendet wird. Wenn beispielsweise adobe.com verwendet wird, werden nur E-Mails aus der Domain „adobe.com“ verarbeitet, während E-Mails aus anderen Domains ignoriert werden.
Dateimuster: Gibt die Muster für eingehende Dateianhänge an, die vom Anbieter akzeptiert werden. Hierzu gehören Dateien mit bestimmten Erweiterungen (*.dat, *.xml), Dateien mit bestimmten Namen (data) sowie Dateien mit zusammengesetzten Ausdrücken im Namen und in der Erweiterung (.[dD][aA]'port'). Der Standardwert lautet *.*.
Empfänger erfolgreicher Aufträge: Eine oder mehrere E-Mail-Adressen, an die Benachrichtigungen über erfolgreiche Aufträge per E-Mail gesendet werden. Standardmäßig wird immer eine Benachrichtigung über erfolgreiche Aufträge an die Absenderin bzw. den Absender des Ausgangsauftrags gesendet. Es werden bis zu 100 Empfänger unterstützt. Zum Deaktivieren dieser Einstellung lassen Sie das Feld leer.
Empfänger fehlgeschlagener Aufträge: Eine oder mehrere E-Mail-Adressen, an die Benachrichtigungen über fehlgeschlagene Aufträge per E-Mail gesendet werden. Standardmäßig wird immer eine Benachrichtigung über fehlgeschlagene Aufträge an die Absenderin bzw. den Absender des Ausgangsauftrags gesendet. Es werden bis zu 100 Empfänger unterstützt. Zum Deaktivieren dieser Einstellung lassen Sie das Feld leer.
Posteingang - Host: Der Host-Name oder die IP-Adresse für den Posteingang, der/die vom E-Mail-Anbieter überprüft werden soll.
Posteingang - Port: Die Port-Nummer für den Posteingang, die vom E-Mail-Anbieter überprüft werden soll. Wenn der Wert 0 ist, wird der IMAP- oder POP3-Standard-Port verwendet.
Posteingang - Protokoll: Das E-Mail-Protokoll, das vom E-Mail-Endpunkt zum Überprüfen des Posteingangs verwendet werden soll. Zur Auswahl stehen IMAP oder POP3. Der Host-Mailserver des Posteingangs muss diese Protokolle unterstützen.
Posteingang - Zeitüberschreitung: Gibt den Zeitraum an, den der Endpunkt beim Herstellen einer Verbindung mit dem Posteingang wartet, bevor der Vorgang abgebrochen wird. Wenn vor Erreichen des Zeitüberschreitungswerts keine Verbindung hergestellt werden konnte, wird der Posteingang nicht abgefragt.
Posteingang - Benutzer: Der Benutzername, der zum Anmelden beim E-Mail-Konto erforderlich ist. Je nach E-Mail-Server und Konfiguration kann dies nur der in der E-Mail-Adresse enthaltene Benutzername oder die vollständige E-Mail-Adresse sein.
Posteingang - Kennwort: Das Kennwort für den Posteingangsbenutzer.
POP3/IMAP SSL aktiviert: Durch Auswahl diese Option wird SSL aktiviert.
SMTP-Host: Der Host-Name des E-Mail-Servers, den der E-Mail-Anbieter zum Senden von Ergebnissen und Fehlermeldungen verwendet. Beispiel: mail.example.com.
SMTP-Port: Der Port, über den die Verbindung zum Mail-Server hergestellt wird. Der Standardwert ist 25.
SMTP-Benutzer: Das Benutzerkonto, das vom E-Mail-Anbieter zum Senden ausgehender E-Mails mit Ergebnissen und Fehlermeldungen verwendet werden soll.
SMTP-Kennwort: Das Kennwort für das SMTP-Konto. Einige E-Mail-Server benötigen kein SMTP-Kennwort.
Senden von: Die E-Mail-Adresse (z. B. benutzer@firma.com), die zum Senden von E-Mail-Benachrichtigungen zu Ergebnissen und Fehlern verwendet wird. Wenn Sie keinen Wert für „Senden von“ angeben, versucht der E-Mail-Server, die E-Mail-Adresse zu ermitteln, indem der für die Einstellung „SMTP-Benutzer“ festgelegte Wert mit einer auf dem E-Mail-Server konfigurierten Standard-Domain kombiniert wird. Wenn auf dem E-Mail-Server keine Standard-Domain konfiguriert ist und Sie keinen Wert für „Senden von“ angeben, können Fehler auftreten. Geben Sie daher einen Wert für die Einstellung „Senden von“ an, um sicherzustellen, dass die E-Mail-Nachrichten eine korrekte Absenderadresse haben.
SMTP SSL aktiviert: Durch Auswahl dieser Option wird SSL über SMTP aktiviert.
Ursprüngliche E-Mail-Nachricht als Anhang aufnehmen: Wenn Sie eine E-Mail an den Formular-Server senden, wird standardmäßig der ursprüngliche Text der Nachricht in das Textfeld der E-Mail eingefügt. Wählen Sie diese Option, um den Text stattdessen als Anhang beizufügen.
Ursprüngliche Betreffzeile für Ergebnis-E-Mails verwenden: Standardmäßig verwendet der Formular-Server die Werte, die in den Einstellungen „Betreff für Erfolgs-E-Mails“ und „Betreff für Fehler-E-Mails“ als Betreffzeile angegeben wurden, wenn E-Mail-Nachrichten zu Ergebnissen gesendet werden. Wenn Sie stattdessen dieselbe Betreffzeile wie in der ursprünglichen E-Mail, die an den Server gesendet wurde, verwenden möchten, wählen Sie diese Option.
Betreff für Erfolgs-E-Mails: Nachdem Sie eine E-Mail an einen E-Mail-Endpunkt gesendet haben, um einen Prozess zu beginnen oder fortzusetzen, erhalten Sie vom AEM-Formular-Server eine E-Mail-Nachricht mit einer Antwort. Wenn Ihre E-Mail erfolgreich gesendet wird, erhalten Sie eine Erfolgs-E-Mail. Wenn das Senden Ihrer E-Mail fehlschlägt, erhalten Sie eine Fehler-E-Mail, die Sie über den Grund für den Fehler informiert. Mit dieser Einstellung können Sie die Betreffzeile von Erfolgs-E-Mails angeben, die an diesen Endpunkt gesendet werden.
Nachricht für Erfolgs-E-Mails: Mit dieser Option können Sie den Text der E-Mail-Nachrichten zu Erfolgen angeben, die an diesen Endpunkt gesendet werden.
Betreffpräfix für Fehler-E-Mails: Mit dieser Option können Sie den Text am Anfang der Betreffzeile von E-Mail-Nachrichten zu Fehlern angeben, die an diesen Endpunkt gesendet werden.
Betreff für Fehler-E-Mails: Mit dieser Option können Sie die Betreffzeile von E-Mail-Nachrichten zu Fehlern angeben, die an diesen Endpunkt gesendet werden. Dieser Text wird nach dem Präfix des Fehler-E-Mail-Betreffs angezeigt.
Nachricht für Fehler-E-Mails: Mit dieser Option können Sie die erste Zeile im Nachrichtentext von Fehler-E-Mails angeben, die an diesen Endpunkt gesendet werden.
E-Mail-Übersichtsinfo: Jede Erfolgs- oder Fehlermeldung enthält einen Abschnitt mit dem ursprünglichen E-Mail-Text, den Sie an den Formular-Server gesendet haben. Diese Einstellung legt den Text fest, der oberhalb dieses Abschnitts angezeigt wird.
Posteingang prüfen, bevor dieser Endpunkt erstellt/aktualisiert wird: Wenn diese Option ausgewählt ist, prüft der Formular-Server, ob Ihre SMTP/POP3-Einstellungen korrekt sind, bevor der Endpunkt erstellt wird. Wenn Sie auf „Hinzufügen“ klicken, wird angezeigt, ob das Posteingangskonto gültig ist. Wenn diese Option nicht ausgewählt ist, erstellt der AEM-Formular-Server den Endpunkt, ohne den Posteingang zu überprüfen.
Zeichensatzkodierung: Das für die E-Mail-Nachricht zu verwendende Kodierungsformat. Der Standardwert ist UTF-8, der von den meisten Benutzenden außerhalb Japans verwendet wird. Benutzende in japanischen Umgebungen wählen eher ISO2022-JP.
Ordner für Fehler beim Senden von E-Mails: Gibt einen Ordner an, in dem Ergebnisse gespeichert werden, falls der SMTP-Mail-Server nicht betriebsbereit ist.
E-Mail-Endpunkteinstellungen email-endpoint-settings
Mithilfe der folgenden Einstellungen können Sie einen E-Mail-Endpunkt konfigurieren.
Name: Eine obligatorische Angabe zum Identifizieren des Endpunktes. Der Name darf kein <-Zeichen enthalten, weil dadurch die Anzeige des Namens in Workspace abgeschnitten wird. Wenn Sie eine URL als Name des Endpunktes angeben, vergewissern Sie sich, dass sie den in RFC1738 angegebenen Syntaxregeln entspricht.
Beschreibung: Eine Beschreibung des Endpunktes. Sie darf kein <-Zeichen enthalten, weil dadurch die Anzeige der Beschreibung in Workspace abgeschnitten wird.
Cron-Ausdruck: Geben Sie einen Cron-Ausdruck ein, wenn die E-Mail mithilfe eines Cron-Ausdrucks geplant werden muss.
Anzahl der Wiederholung: Wie oft der E-Mail-Endpunkt den Ordner oder das Verzeichnis überprüft. Der Wert „-1“ steht für eine uneingeschränkte („unendliche“) Überprüfung. Der Standardwert ist -1.
Wiederholungsintervall: Die Überprüfungsrate, mit der der Empfänger den Ordner auf eingehende E-Mails prüft.
Start des Auftrags verzögern: Die Zeitspanne, die nach dem Start des Schedulers mit dem Scannen abgewartet wird.
Batch-Größe: Die Anzahl von E-Mails, die der Empfänger pro Überprüfung zur Optimierung der Leistung verarbeitet. Der Wert „-1“ bedeutet alle E-Mails. Der Standardwert ist 2.
Benutzername: (Obligatorische Einstellung) Der Benutzername, mit dem ein Ziel-Service aus einer E-Mail heraus aufgerufen wird. Der Standardwert lautet „SuperAdmin“.
Domain-Name: (Obligatorische Einstellung) Die Domain des Benutzers. Der Standardwert lautet „DefaultDom“.
Domain-Muster: Gibt die Domain-Muster für eingehende E-Mails an, die vom Anbieter akzeptiert werden. Wenn beispielsweise „adobe.com“ verwendet wird, werden nur E-Mails aus der Domain „adobe.com“ verarbeitet, während E-Mails aus anderen Domains ignoriert werden.
Dateimuster: Gibt das Muster für eingehende Dateianhänge an, die vom Anbieter akzeptiert werden. Dazu gehören Dateien mit bestimmten Erweiterungen (*.dat, *.xml), bestimmte Namen (Daten) oder zusammengesetzte Ausdrücke im Namen und in der Erweiterung (*.[dD][aA]'port').
Empfänger erfolgreicher Aufträge: Eine E-Mail-Adresse, an die Benachrichtigungen über erfolgreiche Aufträge gesendet werden. Standardmäßig werden Benachrichtigungen über erfolgreiche Aufträge immer an den Absender gesendet. Wenn Sie „sender“ eingeben, werden E-Mail-Ergebnisse an den Absender gesendet. Es werden bis zu 100 Empfänger unterstützt. Geben Sie zusätzliche Empfängerinnen und Empfänger mit durch Kommas (,) getrennte E-Mail-Adressen an.
Zum Deaktivieren dieser Einstellung lassen Sie sie leer. Es kann Fälle geben, in denen Sie einen Prozess auslösen möchten, ohne eine Benachrichtigung per E-Mail zum Ergebnis zu erhalten.
Empfänger fehlgeschlagener Aufträge: Eine E-Mail-Adresse, an die Benachrichtigungen über fehlgeschlagene Aufträge gesendet werden. Standardmäßig werden Benachrichtigungen über fehlgeschlagene Aufträge immer an den Absender gesendet. Wenn Sie „sender“ eingeben, werden E-Mail-Ergebnisse an den Absender gesendet. Es werden bis zu 100 Empfänger unterstützt. Geben Sie zusätzliche Empfängerinnen und Empfänger mit durch Kommas (,) getrennte E-Mail-Adressen an.
Zum Deaktivieren dieser Einstellung lassen Sie sie leer. Es kann Fälle geben, in denen Sie einen Prozess auslösen möchten, ohne eine Benachrichtigung per E-Mail zum Ergebnis zu erhalten.
Posteingang - Host: Der Host-Name oder die IP-Adresse für den Posteingang, der/die vom E-Mail-Anbieter überprüft werden soll.
Posteingang - Port: Der Port, der vom E-Mail-Server verwendet wird. Der Standardwert ist für POP3 „110“ und für IMAP „143“. Wenn SSL aktiviert ist, lautet der Standardwert für POP3 „995“ und für IMAP „993“.
Posteingang - Protokoll: Das E-Mail-Protokoll, das vom E-Mail-Endpunkt zum Überprüfen des Posteingangs verwendet werden soll. Die Werte sind IMAP oder POP3. Der Host-Mailserver des Posteingangs muss diese Protokolle unterstützen.
Posteingang - Zeitüberschreitung: Das Zeitlimit in Sekunden, das der E-Mail-Anbieter auf Antworten des Posteingangs warten soll.
Posteingang - Benutzer: Der Benutzername, der zum Anmelden beim E-Mail-Konto erforderlich ist. Je nach E-Mail-Server und Konfiguration kann dies nur der in der E-Mail-Adresse enthaltene Benutzername oder die vollständige E-Mail-Adresse sein.
Posteingang - Kennwort: Das Kennwort für den Posteingangsbenutzer.
POP3/IMAP SSL aktiviert: Aktivieren Sie diese Einstellung, um den E-Mail-Anbieter zu zwingen, bei der Überprüfung des Posteingangs SSL zu verwenden. Vergewissern Sie sich, dass Ihr E-Mail-Server SSL unterstützt.
SMTP-Host: Der Host-Name des E-Mail-Servers, den der E-Mail-Anbieter zum Senden von Ergebnissen und Fehlermeldungen verwendet.
SMTP-Port: Der Standardwert für den SMTP-Anschluss ist 25.
SMTP-Benutzer: Das Benutzerkonto, das vom E-Mail-Anbieter zum Senden ausgehender E-Mail-Benachrichtigungen mit Ergebnissen und Fehlermeldungen verwendet werden soll.
SMTP-Kennwort: Das Kennwort für das SMTP-Konto. Einige E-Mail-Server benötigen kein SMTP-Kennwort.
Senden von: Die E-Mail-Adresse (z. B. benutzer@firma.com), die zum Senden von E-Mail-Benachrichtigungen zu Ergebnissen und Fehlern verwendet wird. Wenn Sie keinen Wert für „Senden von“ angeben, versucht der E-Mail-Server, die E-Mail-Adresse zu ermitteln, indem der für die Einstellung „SMTP-Benutzer“ festgelegte Wert mit einer auf dem E-Mail-Server konfigurierten Standard-Domain kombiniert wird. Wenn auf dem E-Mail-Server keine Standard-Domain konfiguriert ist und Sie keinen Wert für „Senden von“ angeben, können Fehler auftreten. Geben Sie daher einen Wert für die Einstellung „Senden von“ an, um sicherzustellen, dass die E-Mail-Nachrichten eine korrekte Absenderadresse haben.
SMTP SSL aktiviert: Aktivieren Sie diese Einstellung, um den E-Mail-Anbieter zu zwingen, bei der Überprüfung des Posteingangs SSL zu verwenden. Vergewissern Sie sich, dass Ihr E-Mail-Server SSL unterstützt.
Ordner für Fehler beim Senden von E-Mails: Gibt einen Ordner an, in dem Ergebnisse gespeichert werden, falls der SMTP-Mail-Server nicht betriebsbereit ist.
asynchron: Bei Festlegung auf „synchron“ werden alle Eingabedokumente verarbeitet und eine einzige Antwort wird zurückgegeben. Bei Festlegung auf „asynchron“ wird für jedes verarbeitete Dokument eine Antwort gesendet.
Beispielsweise wird für einen Dienst ein E-Mail-Endpunkt erstellt, der ein einzelnes Word-Dokument akzeptiert und das Dokument als PDF-Datei zurückgibt. An den Posteingang des Endpunkts kann eine E-Mail gesendet werden, die mehrere (3) Word-Dokumente enthält. Wenn nach der Verarbeitung aller drei Dokumente der Endpunkt als „synchron“ konfiguriert wird, wird eine E-Mail-Antwort mit allen drei Dokumenten als Anlage gesendet. Ist der Endpunkt dagegen „asynchron“, wird nach der Konvertierung jedes Word-Dokuments in PDF eine E-Mail-Antwort gesendet. Das heißt also, dass drei E-Mails mit jeweils einer einzelnen PDF-Anlage gesendet werden.
Der Standardwert ist „asynchron“.
Ursprüngliche E-Mail-Nachricht als Anhang aufnehmen: Wenn Sie eine E-Mail an den Formular-Server senden, wird standardmäßig der ursprüngliche Text der Nachricht in das Textfeld der E-Mail eingefügt. Um den Text stattdessen als Anhang beizufügen, wählen Sie diese Option.
Ursprüngliche Betreffzeile für Ergebnis-E-Mails verwenden: Standardmäßig verwendet der Formular-Server die Werte, die in den Einstellungen „Betreff für Erfolgs-E-Mails“ und „Betreff für Fehler-E-Mails“ als Betreffzeile angegeben wurden, wenn E-Mail-Nachrichten zu Ergebnissen gesendet werden. Wenn Sie stattdessen dieselbe Betreffzeile wie in der ursprünglichen E-Mail, die an den Server gesendet wurde, verwenden möchten, wählen Sie diese Option.
Betreff für Erfolgs-E-Mails: Nachdem Sie eine E-Mail an einen E-Mail-Endpunkt gesendet haben, um einen Prozess zu beginnen oder fortzusetzen, erhalten Sie vom AEM-Formular-Server eine E-Mail-Nachricht mit einer Antwort. Wenn Ihre E-Mail erfolgreich gesendet wird, erhalten Sie eine Erfolgs-E-Mail. Wenn das Senden Ihrer E-Mail fehlschlägt, erhalten Sie eine Fehler-E-Mail, die Sie über den Grund für den Fehler informiert. Mit dieser Einstellung können Sie die Betreffzeile von Erfolgs-E-Mails angeben, die an diesen Endpunkt gesendet werden.
Nachricht für Erfolgs-E-Mails: Mit dieser Option können Sie den Text der E-Mail-Nachrichten zu Erfolgen angeben, die an diesen Endpunkt gesendet werden.
Betreffpräfix für Fehler-E-Mails: Mit dieser Option können Sie den Text am Anfang der Betreffzeile von E-Mail-Nachrichten zu Fehlern angeben, die an diesen Endpunkt gesendet werden.
Betreff für Fehler-E-Mails: Mit dieser Option können Sie die Betreffzeile von E-Mail-Nachrichten zu Fehlern angeben, die an diesen Endpunkt gesendet werden. Dieser Text wird nach dem Präfix des Fehler-E-Mail-Betreffs angezeigt.
Nachricht für Fehler-E-Mails: Mit dieser Option können Sie die erste Zeile im Nachrichtentext von Fehler-E-Mails angeben, die an diesen Endpunkt gesendet werden.
E-Mail-Übersichtsinfo: Jede Erfolgs- oder Fehlermeldung enthält einen Abschnitt mit dem ursprünglichen E-Mail-Text, den Sie an den Formular-Server gesendet haben. Diese Einstellung legt den Text fest, der oberhalb dieses Abschnitts angezeigt wird.
Posteingang prüfen, bevor dieser Endpunkt erstellt/aktualisiert wird: Wenn diese Option ausgewählt ist, prüft der Formular-Server, ob Ihre SMTP/POP3-Einstellungen korrekt sind, bevor der Endpunkt erstellt wird. Wenn Sie auf „Hinzufügen“ klicken, wird angezeigt, ob das Posteingangskonto gültig ist. Wenn diese Option nicht ausgewählt ist, erstellt der AEM-Formular-Server den Endpunkt, ohne den Posteingang zu überprüfen.
Vorgangsname: Diese Einstellung ist obligatorisch. Eine Liste von Vorgängen, die dem E-Mail-Endpunkt zugewiesen werden können. Der Vorgang, den Sie hier auswählen, bestimmt, welche Felder in den Abschnitten „Zuordnungen von Eingabeparametern“ und „Zuordnungen von Ausgabeparametern“ angezeigt werden.
Zuordnungen von Eingabeparametern: Dient zur Konfiguration der Eingabe, die für die Verarbeitung des Service und der Operation erforderlich ist. Die beiden Eingabetypen sind „Literal“ und „Variable“.
Wörtlich: Die E-Mail verwendet den Wert, der in das Feld eingegeben wird, so wie er angezeigt wird.
Variable: Sie können eine Zeichenfolge aus dem E-Mail-Betreff, dem Textkörper, der Kopfzeile oder der E-Mail-Adresse des Absenders zuordnen. Verwenden Sie dazu eines der folgenden Schlüsselwörter: %SUBJECT%, %BODY%, %HEADER% oder %SENDER%. Wenn Sie z. B. %SUBJECT%, angeben, wird der Inhalt des E-Mail-Betreffs als Eingabeparameter verwendet. Zum Auswählen von Anhängen geben Sie ein Dateimuster ein, das vom E-Mail-Endpunkt zum Auswählen der angehängten Dokumente verwendet werden kann. Durch die Eingabe von „*.pdf“ werden beispielsweise alle angehängten Dokumente mit einer PDF-Dateinamenerweiterung ausgewählt. Die Eingabe von „*“ wählt ein angehängtes Dokument aus. Durch die Eingabe von „beispiel.pdf“ werden alle angehängten Dokumente namens „beispiel.pdf“ ausgewählt.
Zuordnungen von Ausgabeparametern: Wird zum Konfigurieren der Ausgabe des Dienstes und Vorgangs verwendet. Die folgenden Zeichen in den Zuordnungswerten von Ausgabeparametern werden im Dateinamen des Anhangs erweitert:
%F Stellt den Dateinamen der Quelldatei dar (ohne eine Erweiterung).
%E Steht für die Erweiterung der Quelldatei.
Alle Vorkommen von \ (Backslash) werden durch %% ersetzt.
***Hinweis *: Wenn die Service-Anforderungsnachricht mehrere Dateianhänge enthält, können die Parameter „%F“ und „%E“ nicht für die Eigenschaft „Zuordnungen von Ausgabeparametern“ des Endpunkts verwendet werden. Wenn die Dienstantwort mehrere Dateianhänge zurückgibt, können Sie nicht denselben Dateinamen für mehr als einen Anhang angeben. Wenn Sie diese Empfehlungen nicht befolgen, werden die Namen für die zurückgegebenen Dateien vom aufgerufenen Dienst erstellt und sind nicht vorhersehbar.
Die folgenden Werte sind verfügbar:
Einzelnes Objekt: Das Quellordnerziel ist beim E-Mail-Anbieter nicht vorhanden. Ergebnisse werden als Anhänge zurückgegeben. Das Muster ist „Result/%F.ps“ und gibt „Result%%Quelldateiname.ps“ als Dateinamenanhang zurück.
Liste: Das Muster ist „Result/%F/“ und gibt „Result%%Quelldateiname%%file1“ als Dateinamenanhang zurück.
Zuordnung: Das Muster ist „Result/%F/“ und das Quellziel ist „Result%%Quelldateiname%%file1“ and „Result%%Quelldateiname%%file2“. Wenn die Zuordnung mehr als ein Objekt enthält und das Muster „Result/%F.ps“ ist, sind die Antwortdateianhänge „Result%%Quelldateiname1.ps“ (Ausgabe 1) und „Result%%Quelldateiname2.ps“ (Ausgabe 2).
Erstellen eines E-Mail-Endpunkts für den Complete Task-Dienst create-an-email-endpoint-for-the-complete-task-service
Damit der Forms-Workflow eingehende E-Mail-Nachrichten von Benutzenden empfängt und verarbeitet, müssen Sie einen E-Mail-Endpunkt für den Complete Task-Dienst erstellen.
- Klicken Sie in der Administration-Console auf „Dienste“ > „Anwendungen und Dienste“ > „Dienstverwaltung“.
- Klicken Sie auf der Seite „Dienstverwaltung“ auf den Complete Task-Dienst.
- Wählen Sie auf der Registerkarte „Endpunkte“ in der Dropdown-Liste die Option „E-Mail“ aus und klicken Sie auf „Hinzufügen“.
- Geben Sie in das Feld „Posteingangs-Host“ den Host-Namen oder die IP-Adresse des E-Mail-Servers ein.
- Geben Sie in das Feld „Posteingangsbenutzer“ den Benutzernamen ein, der für die Anmeldung bei dem für die Verarbeitung von gesendeten Formularen erstellten E-Mail-Konto erforderlich ist. Je nach E-Mail-Server und Konfiguration kann dies der Benutzernamensteil der E-Mail-Adresse oder auch die vollständige E-Mail-Adresse sein.
- Geben Sie in das Feld „Posteingangskennwort“ das Kennwort für die Posteingangsbenutzerin bzw. den Posteingangsbenutzer ein.
- Geben Sie in das Feld „SMTP-Host“ den Host-Namen oder die IP-Adresse des E-Mail-Servers ein, von dem aus der E-Mail-Anbieter Ergebnisse und Fehlermeldungen sendet.
- Geben Sie in das Feld „SMTP-Benutzer“ das Benutzerkonto ein, das vom E-Mail-Anbieter verwendet werden soll, wenn ausgehende E-Mails mit Ergebnissen und Fehlermeldungen versendet werden. Dieses Benutzerkonto kann mit dem für „Posteingangsbenutzer“ verwendeten Wert identisch sein.
- Geben Sie in das Feld „SMTP-Kennwort“ das Kennwort für das SMTP-Konto ein.
- Wählen Sie in der Liste „Vorgangsname“ den Eintrag zum Aufrufen aus.
- Wählen Sie in der Liste „attachmentMap“ den Eintrag „Variable“ und geben Sie in das angrenzende Feld
*.*
ein. Hierdurch werden alle Anhänge eingehender E-Mails an eine Zuordnungsvariable für den Prozess „Aufgabe fertig stellen“ gesendet. - Wählen Sie in der Liste „mailBody“ den Eintrag „Variable“ und geben Sie in das angrenzende Feld
%BODY%
ein. - Wählen Sie in der Liste „mailFrom“ den Eintrag „Variable“ und geben Sie in das angrenzende Feld
%SENDER%
ein. Hierdurch wird die Absenderadresse den Daten des Prozesses „Aufgabe fertig stellen“ zugeordnet. - Geben Sie in das Ergebnisfeld
results
ein. Hierdurch gibt der Prozess „Aufgabe fertigstellen“ oder der Startprozess eine Ergebniszeichenfolge zurück. - Klicken Sie auf „Hinzufügen“.