Neue, verbesserte Suche

QuickStart: Adding an EJB endpoint using the Java API

Hinzufügen eines EJB-Endpunkts mithilfe der Java-API

Fügen Sie mithilfe der Java-API einen EJB-Endpunkt hinzu:

Projektdateien einschließen.

Schließen Sie Client-JAR-Dateien wie adobe-livecycle-client.jar in den Klassenpfad Ihres Java-Projekts ein. (
Erstellen Sie ein EndpointRegistry-Client-Objekt.
- Erstellen Sie ein ServiceClientFactory-" -Objekt, das Verbindungseigenschaften enthält.
- Erstellen Sie eine EndpointRegistryClient -Objekt durch Verwendung seines Konstruktors und Übergabe des ServiceClientFactory -Objekt.
Festlegen von EJB-Endpunktattributen.
- Erstellen Sie ein Objekt CreateEndpointInfo, indem Sie den Konstruktor verwenden.
- Geben Sie den Wert der Connector-ID an, indem Sie die CreateEndpointInfo -Objekt setConnectorId -Methode und Übergeben des Zeichenfolgenwerts EJB.
- Geben Sie die Beschreibung des Endpunkts an, indem Sie die CreateEndpointInfo -Objekt setDescription -Methode verwenden und einen string -Wert übergeben, der den -Endpunkt beschreibt.
- Geben Sie den Namen des Endpunkts an, indem Sie die CreateEndpointInfo -Objekt setName -Methode verwenden und einen string -Wert übergeben, der den Namen angibt.
- Specify the service to which the endpoint belongs by invoking the CreateEndpointInfo object’s setServiceId method and passing a string value that specifies the service name.
- Specify the operation that is invoked by invoking the CreateEndpointInfo object’s setOperationName method and pass a string value that specifies the operation name. Geben Sie für SOAP- und EJB-Endpunkte ein Platzhalterzeichen ( *), was alle Vorgänge impliziert.
Erstellen Sie einen EJB-Endpunkt.

Erstellen Sie den Endpunkt durch Aufrufen der EndpointRegistryClient -Objekt createEndpoint -Methode und Übergabe der CreateEndpointInfo -Objekt. Diese Methode gibt eine Endpoint -Objekt, das den neuen EJB-Endpunkt darstellt.
Aktivieren Sie den -Endpunkt.

Enable the endpoint by invoking the EndpointRegistryClient object’s enable method and passing the Endpoint object that was returned by the createEndpoint method.

Siehe auch

Summary of steps

Hinzufügen eines SOAP-Endpunkts mithilfe der Java-API

Hinzufügen von SOAP-Endpunkten

Sie können einen SOAP-Endpunkt mithilfe der AEM Forms Java API programmgesteuert zu einem Dienst hinzufügen. By adding a SOAP endpoint, you enable a client application to invoke the service by using the SOAP mode. That is, when setting connection properties required to invoke AEM Forms, you can select the SOAP mode.

HINWEIS

Mit Webdiensten können Sie keinen SOAP-Endpunkt hinzufügen.

HINWEIS

Normalerweise wird ein SOAP-Endpunkt standardmäßig einem Dienst hinzugefügt. Ein SOAP-Endpunkt kann jedoch einem Prozess hinzugefügt werden, der programmgesteuert bereitgestellt wird oder wenn ein SOAP-Endpunkt entfernt wurde und erneut hinzugefügt werden muss.

Zusammenfassung der Schritte

Führen Sie die folgenden Aufgaben aus, um einem Dienst einen SOAP-Endpunkt hinzuzufügen:

Projektdateien einschließen.
Erstellen Sie eine EndpointRegistryClient -Objekt.
Festlegen von SOAP-Endpunktattributen.
Erstellen Sie einen SOAP-Endpunkt.
Aktivieren Sie den -Endpunkt.

Projektdateien einschließen

Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie eine Clientanwendung mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxy-Dateien einschließen.

Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (erforderlich, wenn AEM Forms auf JBoss Application Server bereitgestellt wird)
jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss Application Server bereitgestellt wird)

Diese JAR-Dateien sind erforderlich, um einen SOAP-Endpunkt zu erstellen. Sie benötigen jedoch zusätzliche JAR-Dateien, wenn Sie den SOAP-Endpunkt zum Aufrufen des Dienstes verwenden. Weitere Informationen zu AEM Forms-JAR-Dateien finden Sie unter Einschließen von AEM Forms-Java-Bibliotheksdateien.

Erstellen eines EndpointRegistry-Client-Objekts

Um einem Dienst programmgesteuert einen SOAP-Endpunkt hinzuzufügen, müssen Sie eine EndpointRegistryClient -Objekt.

SOAP-Endpunktattribute festlegen

Geben Sie die folgenden Werte an, um einem Dienst einen SOAP-Endpunkt hinzuzufügen:

Connector-ID-Wert: Gibt den Typ des zu erstellenden Endpunkts an. Um einen SOAP-Endpunkt zu erstellen, geben Sie SOAP.
Beschreibung: Gibt die Beschreibung des Endpunkts an.
Name: Gibt den Namen des Endpunkts an.
Dienstkennungswert: Gibt den Dienst an, zu dem der Endpunkt gehört.
Vorgangsname: Gibt den Namen des Vorgangs an, der mithilfe des -Endpunkts aufgerufen wird. Geben Sie beim Erstellen eines SOAP-Endpunkts ein Platzhalterzeichen ( *). Wenn Sie jedoch einen bestimmten Vorgang angeben möchten, anstatt alle Dienstvorgänge aufzurufen, geben Sie den Namen des Vorgangs an, anstatt das Platzhalterzeichen ( *).

SOAP-Endpunkt erstellen

Nachdem Sie SOAP-Endpunktattribute festgelegt haben, können Sie einen SOAP-Endpunkt erstellen.

Endpunkt aktivieren

Nachdem Sie einen neuen Endpunkt erstellt haben, müssen Sie ihn aktivieren. Wenn der Endpunkt aktiviert ist, kann er zum Aufrufen des Dienstes verwendet werden. Nachdem Sie den Endpunkt aktiviert haben, können Sie ihn in Administration Console anzeigen.

Siehe auch

Hinzufügen eines SOAP-Endpunkts mithilfe der Java-API

Fügen Sie mithilfe der Java-API einen SOAP-Endpunkt zu einem Dienst hinzu:

Projektdateien einschließen.

Schließen Sie Client-JAR-Dateien wie adobe-livecycle-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein EndpointRegistry-Client-Objekt.
- Erstellen Sie ein ServiceClientFactory-" -Objekt, das Verbindungseigenschaften enthält.
- Erstellen Sie eine EndpointRegistryClient -Objekt durch Verwendung seines Konstruktors und Übergabe des ServiceClientFactory -Objekt.
Festlegen von SOAP-Endpunktattributen.
- Erstellen Sie ein Objekt CreateEndpointInfo, indem Sie den Konstruktor verwenden.
- Geben Sie den Wert der Connector-ID an, indem Sie die CreateEndpointInfo -Objekt setConnectorId -Methode und Übergeben des Zeichenfolgenwerts SOAP.
- Geben Sie die Beschreibung des Endpunkts an, indem Sie die CreateEndpointInfo -Objekt setDescription -Methode verwenden und einen string -Wert übergeben, der den -Endpunkt beschreibt.
- Specify the name of the endpoint by invoking the CreateEndpointInfo object’s setName method and passing a string value that specifies the name.
- Specify the service to which the endpoint belongs by invoking the CreateEndpointInfo object’s setServiceId method and passing a string value that specifies the service name.
- Specify the operation that is invoked by invoking the CreateEndpointInfo object’s setOperationName method and passing a string value that specifies the operation name. For SOAP and EJB endpoints, specify a wildcard character ( *), which implies all operations.
Erstellen Sie einen SOAP-Endpunkt.

Create the endpoint by invoking the EndpointRegistryClient object’s createEndpoint method and passing the CreateEndpointInfo object. Diese Methode gibt eine Endpoint -Objekt, das den neuen SOAP-Endpunkt darstellt.
Aktivieren Sie den -Endpunkt.

Aktivieren Sie den Endpunkt, indem Sie die EndpointRegistryClient Die Methode enable des Objekts wird übergeben. Endpoint -Objekt, das von der createEndpoint -Methode.

Siehe auch

QuickStart: Hinzufügen eines SOAP-Endpunkts mithilfe der Java-API

Hinzufügen eines Endpunkts für überwachte Ordner mithilfe der Java-API

Endpunkte für überwachte Ordner hinzufügen

Sie können einen Endpunkt des Typs "Überwachter Ordner"mithilfe der AEM Forms Java-API programmgesteuert zu einem Dienst hinzufügen. Durch Hinzufügen eines Endpunkts des Typs "Überwachter Ordner"können Sie Benutzern das Platzieren einer PDF-Datei in einem Ordner ermöglichen. Wenn die Datei im Ordner abgelegt wird, wird der konfigurierte Dienst aufgerufen und die Datei bearbeitet. Nachdem der Dienst den vorgesehenen Vorgang ausgeführt hat, wird die geänderte Datei in einem angegebenen Ausgabeordner gespeichert. Ein überwachter Ordner ist so konfiguriert, dass er in einem festen Zeitintervall oder mit einem Cron-Zeitplan gescannt wird, z. B. jeden Montag, Mittwoch und Freitag um Mittag.

Um einem Dienst programmgesteuert einen Endpunkt des Typs "überwachter Ordner"hinzuzufügen, beachten Sie den folgenden kurzlebigen Prozess mit dem Namen EncryptDocument. (Siehe Grundlagen zu AEM Forms-Prozessen.

aw_aw_encryptdocumentprocess

Bei diesem Vorgang wird ein ungesichertes PDF-Dokument als Eingabewert akzeptiert und das ungesicherte PDF-Dokument dann an den Encryption-Dienst übergeben. EncryptPDFUsingPassword Vorgang. Das PDF-Dokument wird mit einem Kennwort verschlüsselt, und das kennwortverschlüsselte PDF-Dokument ist der Ausgabewert dieses Vorgangs. Der Name des Eingabewerts (das ungesicherte PDF-Dokument) lautet InDoc und der Datentyp com.adobe.idp.Document. Der Name des Ausgabewerts (das kennwortverschlüsselte PDF-Dokument) lautet SecuredDoc und der Datentyp com.adobe.idp.Document.

HINWEIS

Mit Webdiensten können Sie keinen Endpunkt des Typs "überwachter Ordner"hinzufügen.

Zusammenfassung der Schritte

Führen Sie die folgenden Aufgaben aus, um einem Dienst einen Endpunkt des Typs "überwachter Ordner"hinzuzufügen:

Projektdateien einschließen.
Erstellen Sie eine EndpointRegistryClient -Objekt.
Festlegen von Endpunktattributen für überwachte Ordner.
Geben Sie Konfigurationswerte an.
Definieren Sie Eingabeparameterwerte.
Definieren Sie einen Ausgabeparameterwert.
Erstellen Sie einen Endpunkt des Typs "Überwachter Ordner".
Aktivieren Sie den -Endpunkt.

Projektdateien einschließen

Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (erforderlich, wenn AEM Forms auf JBoss Application Server bereitgestellt wird)
jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss Application Server bereitgestellt wird)

Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen von AEM Forms-Java-Bibliotheksdateien.

Erstellen eines EndpointRegistry-Client-Objekts

Um einen Endpunkt des Typs "überwachter Ordner"programmgesteuert hinzuzufügen, müssen Sie einen EndpointRegistryClient -Objekt.

Festlegen von Endpunktattributen für überwachte Ordner

Geben Sie die folgenden Werte an, um einen Endpunkt des Typs "überwachter Ordner"für einen Dienst zu erstellen:

Connector-ID: Gibt den Typ des zu erstellenden Endpunkts an. Um einen Endpunkt des Typs "überwachter Ordner"zu erstellen, geben Sie WatchedFolder.
Beschreibung: Gibt die Beschreibung des Endpunkts an.
Name: Gibt den Namen des Endpunkts an.
Dienstkennung: Gibt den Dienst an, zu dem der Endpunkt gehört. Um beispielsweise einen Endpunkt des Typs "überwachter Ordner"zum in diesem Abschnitt eingeführten Prozess hinzuzufügen (ein Prozess wird zu einem Dienst, wenn er mithilfe von Workbench aktiviert wird), geben Sie EncryptDocument.
Vorgangsname: Gibt den Namen des Vorgangs an, der mithilfe des -Endpunkts aufgerufen wird. Beim Erstellen eines Endpunkts für einen überwachten Ordner für einen Dienst, der aus einem in Workbench erstellten Prozess stammt, lautet der Name des Vorgangs normalerweise invoke.

Konfigurationswerte angeben

Sie müssen Konfigurationswerte für einen Endpunkt des Typs "überwachter Ordner"angeben, wenn Sie einem Dienst programmgesteuert einen Endpunkt des Typs "überwachter Ordner"hinzufügen. Diese Konfigurationswerte werden von einem Administrator festgelegt, wenn ein Endpunkt des Typs "überwachter Ordner"mithilfe von Administration Console hinzugefügt wird.

Die folgende Liste gibt Konfigurationswerte an, die festgelegt werden, wenn einem Dienst programmgesteuert ein Endpunkt des Typs "überwachter Ordner"hinzugefügt wird:

url: Gibt den Speicherort des überwachten Ordners an. In einer Clusterumgebung muss dieser Wert auf einen freigegebenen Netzwerkordner verweisen, auf den von jedem Computer im Cluster zugegriffen werden kann.
asynchron: Identifiziert den Aufruftyp als asynchron oder synchron. Transiente und synchrone Prozesse können nur synchron aufgerufen werden. Der Standardwert lautet true. Asynchron wird empfohlen.
cronExpression: Wird von Quarz verwendet, um die Abfrage des Eingabeordners zu planen.
purgeDuration: Dies ist ein obligatorisches Attribut. Dateien und Ordner im Ergebnisordner werden gelöscht, wenn sie älter als dieser Wert sind. Dieser Wert wird in Tagen gemessen. Dieses Attribut ist nützlich, um sicherzustellen, dass der Ergebnisordner nicht voll wird. Ein Wert von „-1“ Tage bedeutet, dass der Ergebnisordner nie gelöscht wird. Der Standardwert ist -1.
repeatInterval: Das Intervall (in Sekunden) zum Überprüfen des überwachten Ordners auf Eingabe. Sofern "Einschränken"nicht aktiviert ist, sollte dieser Wert länger sein als die Verarbeitungszeit für einen durchschnittlichen Auftrag. Andernfalls kann das System überlastet werden. Der Standardwert ist 5.
repeatCount: Die Häufigkeit, mit der ein überwachter Ordner den Ordner oder Ordner überprüft. Der Wert „-1“ bedeutet uneingeschränktes Überprüfen („unendlich“). Der Standardwert ist -1.
throttleOn: Beschränkt die Anzahl der Aufträge für überwachte Ordner, die zu einem beliebigen Zeitpunkt verarbeitet werden können. Die maximale Anzahl von Aufträgen wird durch den Wert batchSize bestimmt.
userName: Der Benutzername, der beim Aufrufen eines Zieldienstes aus dem überwachten Ordner verwendet wird. Dieser Wert ist erforderlich. Der Standardwert ist „SuperAdmin“.
domainName: Die Domäne des Benutzers. Dieser Wert ist erforderlich. Der Standardwert ist „DefaultDom“.
batchSize: Die Anzahl der Dateien oder Ordner, die pro Überprüfung aufgenommen werden. Verwenden Sie diesen Wert, um eine Überlastung des Systems zu vermeiden. Das gleichzeitige Überprüfen zu vieler Dateien kann zu einem Absturz führen. Der Standardwert ist 2.
waitTime: Die Zeit in Millisekunden, die gewartet wird, bevor ein Ordner oder eine Datei nach der Erstellung überprüft wird. Wenn die Wartezeit beispielsweise 36.000.000 Millisekunden (eine Stunde) beträgt und die Datei vor einer Minute erstellt wurde, wird diese Datei aufgenommen, nachdem mindestens 59 Minuten vergangen sind. Dieses Attribut ist nützlich, um sicherzustellen, dass eine Datei oder ein Ordner vollständig in den Eingabeordner kopiert wurde. Wenn Sie beispielsweise eine große Datei verarbeiten müssen und das Herunterladen der Datei zehn Minuten dauert, legen Sie die Wartezeit auf 10*60 *1000 Millisekunden fest. Diese Einstellung verhindert, dass der überwachte Ordner die Datei überprüft, wenn er zehn Minuten lang nicht gewartet hat. Der Standardwert ist 0.
excludeFilePattern: Das Muster, das ein überwachter Ordner verwendet, um zu bestimmen, welche Dateien und Ordner überprüft und aufgenommen werden sollen. Dateien oder Ordner mit diesem Muster werden nicht zur Verarbeitung überprüft. Diese Einstellung ist nützlich, wenn die Eingabe ein Ordner ist, der mehrere Dateien enthält. Der Inhalt des Ordners kann in einen Ordner kopiert werden, der einen Namen hat, der vom überwachten Ordner aufgenommen wird. Dieser Schritt verhindert, dass der überwachte Ordner einen Ordner zur Verarbeitung aufnimmt, bevor der Ordner vollständig in den Eingabeordner kopiert wird. Wenn beispielsweise der Wert excludeFilePattern data*, alle Dateien und Ordner, die data* nicht abgeholt werden. Dazu gehören Dateien und Ordner namens data1, data2usw. Darüber hinaus kann das Muster durch Platzhaltermuster ergänzt werden, um Dateimuster anzugeben. Der überwachte Ordner ändert den regulären Ausdruck, um Platzhaltermuster wie *.* und *.pdf. Diese Platzhaltermuster werden von regulären Ausdrücken nicht unterstützt.
includeFilePattern: Das Muster, das der überwachte Ordner verwendet, um zu bestimmen, welche Ordner und Dateien überprüft und aufgenommen werden sollen. Wenn dieser Wert beispielsweise *, alle Dateien und Ordner, die input* abgeholt werden. Dazu gehören Dateien und Ordner namens input1, input2usw. Der Standardwert ist *. Dieser Wert zeigt alle Dateien und Ordner an. Darüber hinaus kann das Muster durch Platzhaltermuster ergänzt werden, um Dateimuster anzugeben. Der überwachte Ordner ändert den regulären Ausdruck, um Platzhaltermuster wie *.* und *.pdf. Diese Platzhaltermuster werden von regulären Ausdrücken nicht unterstützt. Dieser Wert ist ein Pflichtwert.
resultFolderName: Der Ordner, in dem die gespeicherten Ergebnisse gespeichert werden. Dieser Speicherort kann ein absoluter oder ein relativer Ordnerpfad sein. Wenn die Ergebnisse nicht in diesem Ordner angezeigt werden, überprüfen Sie den Fehlerordner. Schreibgeschützte Dateien werden nicht verarbeitet und im Fehlerordner gespeichert. Der Standardwert ist result/%Y/%M/%D/. Dies ist der Ergebnisordner im überwachten Ordner.
preserveFolderName: Der Speicherort, an dem Dateien nach erfolgreicher Überprüfung und Aufnahme gespeichert werden. Dieser Speicherort kann ein absoluter, relativer oder null Ordnerpfad sein. Der Standardwert ist preserve/%Y/%M/%D/.
failureFolderName: Der Ordner, in dem Fehlerdateien gespeichert werden. Dieser Speicherort ist stets relativ zum überwachten Ordner. Schreibgeschützte Dateien werden nicht verarbeitet und im Fehlerordner gespeichert. Der Standardwert ist failure/%Y/%M/%D/.
preserveOnFailure: Bewahren Sie Eingabedateien auf, falls der Vorgang für einen Dienst nicht ausgeführt werden kann. Der Standardwert lautet true.
overwriteDuplicateFilename: Wenn der Wert auf "true"gesetzt ist, werden Dateien im Ergebnisordner und im Aufbewahrungsordner überschrieben. Wenn der Wert auf "false"gesetzt ist, werden Dateien und Ordner mit dem Suffix "numeric Index"für den Namen verwendet. Der Standardwert lautet false.

Definieren von Eingabeparameterwerten

Beim Erstellen eines Endpunkts des Typs "überwachter Ordner"müssen Sie Eingabeparameterwerte definieren. Das heißt, Sie müssen die Eingabewerte beschreiben, die an den Vorgang übergeben werden, der vom überwachten Ordner aufgerufen wird. Betrachten Sie beispielsweise den in diesem Thema eingeführten Prozess. Sie hat einen Eingabewert mit dem Namen InDoc und der Datentyp com.adobe.idp.Document. Beim Erstellen eines Endpunkts des Typs "überwachter Ordner"für diesen Prozess (nachdem ein Prozess aktiviert wurde, wird er zu einem Dienst) müssen Sie den Eingabeparameterwert definieren.

Geben Sie die folgenden Werte an, um die für einen Endpunkt des Typs "überwachter Ordner"erforderlichen Eingabeparameterwerte zu definieren:

Name des Eingabeparameters: Der Name des Eingabeparameters. Der Name eines Eingabewerts wird in Workbench für einen Prozess angegeben. Wenn der Eingabewert zu einem Dienstvorgang gehört (einem Dienst, der kein in Workbench erstellter Prozess ist), wird der Eingabename in der Datei "component.xml"angegeben. Beispielsweise lautet der Name des Eingabeparameters für den in diesem Abschnitt eingeführten Prozess InDoc.

Zuordnungstyp: Wird zum Konfigurieren der zum Aufrufen des Dienstvorgangs erforderlichen Eingabewerte verwendet. Es gibt zwei Arten von Zuordnungen:

Literal: Der Endpunkt des Typs "Überwachter Ordner"verwendet den im Feld eingegebenen Wert so, wie er angezeigt wird. Alle grundlegenden Java-Typen werden unterstützt. Wenn eine API beispielsweise Eingabe wie String, long, int und Boolean verwendet, wird die Zeichenfolge in den richtigen Typ konvertiert und der Dienst aufgerufen.
Variable: Der eingegebene Wert ist ein Dateimuster, das vom überwachten Ordner zum Auswählen der Eingabe verwendet wird. Wenn Sie beispielsweise Variable für den Zuordnungstyp auswählen und das Eingabedokument eine PDF-Datei sein muss, können Sie *.pdfals Zuordnungswert.

Zuordnungswert: Gibt den Wert des Zuordnungstyps an. Wenn Sie beispielsweise eine Variable Zuordnungstyp: Sie können *.pdf als Dateimuster.

Datentyp: Gibt den Datentyp der Eingabewerte an. Beispielsweise lautet der Datentyp des Eingabewerts des in diesem Abschnitt eingeführten Prozesses . com.adobe.idp.Document.

Ausgabeparameterwert definieren

Beim Erstellen eines Endpunkts des Typs "überwachter Ordner"müssen Sie einen Ausgabeparameterwert definieren. Das heißt, Sie müssen den Ausgabewert beschreiben, der von dem Dienst zurückgegeben wird, der vom Endpunkt "Überwachter Ordner"aufgerufen wird. Betrachten Sie beispielsweise den in diesem Thema eingeführten Prozess. Sie hat einen Ausgabewert mit dem Namen SecuredDoc und der Datentyp com.adobe.idp.Document. Beim Erstellen eines Endpunkts des Typs "überwachter Ordner"für diesen Prozess (nachdem ein Prozess aktiviert wurde, wird er zu einem Dienst) müssen Sie den Wert des Ausgabeparameters definieren.

To define an output parameter value required for a Watched Folder endpoint, specify the following values:

Output parameter name: The name of the output parameter. Der Name eines Prozessausgabewerts wird in Workbench angegeben. Wenn der Ausgabewert zu einem Dienstvorgang gehört (ein Dienst, der kein in Workbench erstellter Prozess ist), wird der Ausgabename in der Datei "component.xml"angegeben. Beispielsweise lautet der Name des Ausgabeparameters für den in diesem Abschnitt eingeführten Prozess SecuredDoc.

Mapping type: Used to configure the output of the service and operation. Die folgenden Optionen sind verfügbar:

Wenn der Dienst ein einzelnes Objekt (ein einzelnes Dokument) zurückgibt, lautet das Muster %F.pdf und das Quellziel "sourcefilename.pdf"lautet. Beispielsweise gibt der in diesem Abschnitt eingeführte Prozess ein einzelnes Dokument zurück. Daher kann der Zuordnungstyp wie folgt definiert werden: %F.pdf ( %F verwendet den angegebenen Dateinamen). Das Muster %E gibt die Erweiterung des Eingabedokuments an.
Wenn der Dienst eine Liste zurückgibt, lautet das Muster Result\%F\, und das Quellziel ist Result\sourcefilename\source1 (Ausgabe 1) und Result\sourcefilename\source2 (Ausgabe 2).
Wenn der Dienst eine Zuordnung zurückgibt, lautet das Muster Result\%F\und das Quellziel "Result\sourcefilename\file1"und "Result\sourcefilename\file2"lautet. Wenn die Zuordnung mehr als ein Objekt enthält, lautet das Muster Result\%F.pdf und das Quellziel "Result\sourcefilename1.pdf"(Ausgabe 1), "Result\sourcefilenam2.pdf"(Ausgabe 2) usw. ist.

Datentyp: Gibt den Datentyp des Rückgabewerts an. Beispielsweise lautet der Datentyp des Rückgabewerts des in diesem Abschnitt eingeführten Prozesses . com.adobe.idp.Document.

Erstellen eines Endpunkts für überwachte Ordner

Nachdem Sie die Attribute und Konfigurationswerte des Endpunkts festgelegt und Eingabe- und Ausgabeparameterwerte definiert haben, müssen Sie den Endpunkt des Typs "Überwachter Ordner"erstellen.

Endpunkt aktivieren

Nachdem Sie einen Endpunkt des Typs "Überwachter Ordner"erstellt haben, müssen Sie ihn aktivieren. Wenn der Endpunkt aktiviert ist, kann er zum Aufrufen des Dienstes verwendet werden. Nachdem Sie den Endpunkt aktiviert haben, können Sie ihn in Administration Console anzeigen.

Siehe auch

Hinzufügen eines Endpunkts für überwachte Ordner mithilfe der Java-API

Fügen Sie mithilfe der AEM Forms Java-API einen Endpunkt des Typs "überwachter Ordner"hinzu:

Projektdateien einschließen.

Schließen Sie Client-JAR-Dateien wie adobe-livecycle-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein EndpointRegistry-Client-Objekt.
- Erstellen Sie ein ServiceClientFactory-" -Objekt, das Verbindungseigenschaften enthält.
- Erstellen Sie eine EndpointRegistryClient -Objekt durch Verwendung seines Konstruktors und Übergabe des ServiceClientFactory -Objekt.
Festlegen von Endpunktattributen für überwachte Ordner.
- Erstellen Sie ein Objekt CreateEndpointInfo, indem Sie den Konstruktor verwenden.
- Geben Sie den Wert der Connector-ID an, indem Sie die CreateEndpointInfo -Objekt setConnectorId -Methode und Übergeben des Zeichenfolgenwerts WatchedFolder.
- Geben Sie die Beschreibung des Endpunkts an, indem Sie die CreateEndpointInfo -Objekt setDescription -Methode verwenden und einen string -Wert übergeben, der den -Endpunkt beschreibt.
- Geben Sie den Namen des Endpunkts an, indem Sie die CreateEndpointInfo -Objekt setName -Methode verwenden und einen string -Wert übergeben, der den Namen angibt.
- Geben Sie den Dienst an, zu dem der Endpunkt gehört, indem Sie die CreateEndpointInfo -Objekt setServiceId -Methode verwenden und einen string -Wert übergeben, der den Dienstnamen angibt.
- Geben Sie den Vorgang an, der durch Aufrufen der CreateEndpointInfo -Objekt setOperationName -Methode verwenden und einen string -Wert übergeben, der den Vorgangsnamen angibt. Beim Erstellen eines Endpunkts für einen überwachten Ordner für einen Dienst, der aus einem in Workbench erstellten Prozess stammt, wird normalerweise der Name des Vorgangs aufgerufen.
Geben Sie Konfigurationswerte an.

Für jeden Konfigurationswert, der für den Endpunkt des Typs "überwachter Ordner"festgelegt wird, müssen Sie die CreateEndpointInfo -Objekt setConfigParameterAsText -Methode. Um beispielsweise die url Konfigurationswert, rufen Sie die CreateEndpointInfo -Objekt setConfigParameterAsText -Methode verwenden und die folgenden string-Werte übergeben:
- Ein string -Wert, der den Namen des Konfigurationswerts angibt. Wenn Sie url Konfigurationswert, geben Sie url.
- Ein string -Wert, der den Wert des Konfigurationswerts angibt. Wenn Sie url Konfigurationswert den Speicherort des überwachten Ordners angeben.
HINWEIS

Alle für den EncryptDocument-Dienst festgelegten Konfigurationswerte finden Sie im Java-Codebeispiel unter QuickStart: Hinzufügen eines Endpunkts für überwachte Ordner mithilfe der Java-API.
Definieren Sie Eingabeparameterwerte.

Definieren Sie einen Eingabeparameterwert durch Aufrufen der CreateEndpointInfo -Objekt setInputParameterMapping -Methode verwenden und die folgenden Werte übergeben:
- Ein string -Wert, der den Namen des Eingabeparameters angibt. Beispielsweise lautet der Name des Eingabeparameters für den EncryptDocument-Dienst . InDoc.
- Ein string -Wert, der den Datentyp des Eingabeparameters angibt. Beispielsweise der Datentyp der InDoc Eingabeparameter ist com.adobe.idp.Document.
- Ein string -Wert, der den Zuordnungstyp angibt. Sie können beispielsweise variable.
- Ein string -Wert, der den Wert des Zuordnungstyps angibt. Beispielsweise können Sie *.pdf als Dateimuster angeben.
HINWEIS

Rufen Sie die setInputParameterMapping -Methode für jeden zu definierenden Eingabeparameterwert. Da der EncryptDocument-Prozess nur einen Eingabeparameter hat, müssen Sie diese Methode einmal aufrufen.
Definieren Sie einen Ausgabeparameterwert.

Definieren Sie einen Ausgabeparameterwert durch Aufrufen der CreateEndpointInfo -Objekt setOutputParameterMapping -Methode verwenden und die folgenden Werte übergeben:
- Ein string -Wert, der den Namen des Ausgabeparameters angibt. Beispielsweise lautet der Name des Ausgabeparameters für den EncryptDocument-Dienst . SecuredDoc.
- Ein string -Wert, der den Datentyp des Ausgabeparameters angibt. Beispielsweise der Datentyp der SecuredDoc Ausgabeparameter ist com.adobe.idp.Document.
- Ein string -Wert, der den Zuordnungstyp angibt. Sie können beispielsweise %F.pdf.
Erstellen Sie einen Endpunkt des Typs "Überwachter Ordner".

Erstellen Sie den Endpunkt durch Aufrufen der EndpointRegistryClient -Objekt createEndpoint -Methode und Übergabe der CreateEndpointInfo -Objekt. Diese Methode gibt eine Endpoint -Objekt, das den Endpunkt des überwachten Ordners darstellt.
Aktivieren Sie den -Endpunkt.

Aktivieren Sie den Endpunkt, indem Sie die EndpointRegistryClient -Objekt enable -Methode und Übergabe der Endpoint -Objekt, das von der createEndpoint -Methode.

Siehe auch

QuickStart: Hinzufügen eines Endpunkts für überwachte Ordner mithilfe der Java-API

Hinzufügen eines E-Mail-Endpunkts mithilfe der Java-API

Konfigurationswerte für überwachte Ordner Konstante Datei

Die QuickStart: Hinzufügen eines Endpunkts für überwachte Ordner mithilfe der Java-API verwendet eine konstante Datei, die Teil Ihres Java-Projekts sein muss, um den Schnellstart zu kompilieren. Diese Konstantendatei stellt Konfigurationswerte dar, die beim Hinzufügen eines Endpunkts für überwachte Ordner festgelegt werden müssen. Der folgende Java-Code stellt die Konstantendatei dar.

 /**
     * This class contains constants that can be used when setting Watched Folder
     * configuration values
     */

 public final class WatchedFolderEndpointConfigConstants {

         public static final String PROPERTY_FILEPROVIDER_URL = "url";
         public static final String PROPERTY_PROPERTY_ASYNCHRONOUS = "asynchronous";
         public static final String PROPERTY_CRON_EXPRESSION = "cronExpression";
         public static final String PROPERTY_PURGE_DURATION = "purgeDuration";
         public static final String PROPERTY_REPEAT_INTERVAL = "repeatInterval";
         public static final String PROPERTY_REPEAT_COUNT = "repeatCount";
         public static final String PROPERTY_THROTTLE = "throttleOn";
         public static final String PROPERTY_USERNAMER = "userName";
         public static final String PROPERTY_DOMAINNAME = "domainName";
         public static final String PROPERTY_FILEPROVIDER_BATCH_SIZE = "batchSize";
         public static final String PROPERTY_FILEPROVIDER_WAIT_TIME = "waitTime";
         public static final String PROPERTY_EXCLUDE_FILE_PATTERN = "excludeFilePattern";
         public static final String PROPERTY_INCLUDE_FILE_PATTERN = "excludeFilePattern";
         public static final String PROPERTY_FILEPROVIDER_RESULT_FOLDER_NAME =  "resultFolderName";
         public static final String PROPERTY_FILEPROVIDER_PRESERVE_FOLDER_NAME = "preserveFolderName";
         public static final String PROPERTY_FILEPROVIDER_FAILURE_FOLDER_NAME = "failureFolderName";
         public static final String PROPERTY_FILEPROVIDER_PRESERVE_ON_FAILURE = "preserveOnFailure";
         public static final String PROPERTY_FILEPROVIDER_OVERWRITE_DUPLICATE_FILENAME = "overwriteDuplicateFilename";
        }

Hinzufügen von E-Mail-Endpunkten

Sie können einen E-Mail-Endpunkt mithilfe der AEM Forms Java-API programmgesteuert zu einem Dienst hinzufügen. Durch Hinzufügen eines E-Mail-Endpunkts können Benutzer eine E-Mail-Nachricht mit einem oder mehreren Dateianlagen an ein bestimmtes E-Mail-Konto senden. Anschließend wird der Vorgang zum Konfigurieren des Dienstes aufgerufen und die Dateien werden bearbeitet. Nachdem der Dienst den angegebenen Vorgang ausgeführt hat, sendet er eine E-Mail-Nachricht mit den geänderten Dateien als Dateianlagen an den Absender.

Um einem Dienst programmgesteuert einen E-Mail-Endpunkt hinzuzufügen, beachten Sie den folgenden kurzlebigen Prozess mit dem Namen MyApplication\EncryptDocument. Informationen zu kurzlebigen Prozessen finden Sie unter Grundlagen zu AEM Forms-Prozessen.

ae_ae_encryptdocumentprocess

Bei diesem Vorgang wird ein ungesichertes PDF-Dokument als Eingabewert akzeptiert und das ungesicherte PDF-Dokument dann an den Encryption-Dienst übergeben. EncryptPDFUsingPassword Vorgang. Dieser Prozess verschlüsselt das PDF-Dokument mit einem Kennwort und gibt das kennwortverschlüsselte PDF-Dokument als Ausgabewert zurück. Der Name des Eingabewerts (das ungesicherte PDF-Dokument) lautet InDoc und der Datentyp com.adobe.idp.Document. Der Name des Ausgabewerts (das kennwortverschlüsselte PDF-Dokument) lautet SecuredDoc und der Datentyp com.adobe.idp.Document.

HINWEIS

Über Webdienste können Sie keinen E-Mail-Endpunkt hinzufügen.

Zusammenfassung der Schritte

Führen Sie die folgenden Aufgaben aus, um einem Dienst einen E-Mail-Endpunkt hinzuzufügen:

Projektdateien einschließen.
Erstellen Sie eine EndpointRegistryClient -Objekt.
E-Mail-Endpunktattribute festlegen.
Geben Sie Konfigurationswerte an.
Definieren Sie Eingabeparameterwerte.
Definieren Sie einen Ausgabeparameterwert.
Erstellen Sie den E-Mail-Endpunkt.
Aktivieren Sie den -Endpunkt.

Projektdateien einschließen

Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (erforderlich, wenn AEM Forms auf JBoss Application Server bereitgestellt wird)
jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss Application Server bereitgestellt wird)

Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen von AEM Forms-Java-Bibliotheksdateien.

Erstellen eines EndpointRegistry-Client-Objekts

Bevor Sie einen E-Mail-Endpunkt programmgesteuert hinzufügen können, müssen Sie einen EndpointRegistryClient -Objekt.

E-Mail-Endpunktattribute festlegen

Geben Sie die folgenden Werte an, um einen E-Mail-Endpunkt für einen Dienst zu erstellen:

Connector-ID-Wert: Gibt den Typ des zu erstellenden Endpunkts an. Um einen E-Mail-Endpunkt zu erstellen, geben Sie Email.
Beschreibung: Gibt eine Beschreibung für den Endpunkt an.
Name: Gibt den Namen des Endpunkts an.
Dienstkennungswert: Gibt den Dienst an, zu dem der Endpunkt gehört. Um beispielsweise einen E-Mail-Endpunkt zum Prozess hinzuzufügen, der in diesem Abschnitt eingeführt wird (ein Prozess wird zu einem Dienst, wenn er mithilfe von Workbench aktiviert wird), geben Sie EncryptDocument.
Vorgangsname: Gibt den Namen des Vorgangs an, der mithilfe des -Endpunkts aufgerufen wird. Beim Erstellen eines E-Mail-Endpunkts für einen Dienst, der aus einem in Workbench erstellten Prozess stammt, lautet der Name des Vorgangs normalerweise invoke.

Konfigurationswerte angeben

Beim programmgesteuerten Hinzufügen eines E-Mail-Endpunkts zu einem Dienst müssen Sie Konfigurationswerte für einen E-Mail-Endpunkt angeben. Diese Konfigurationswerte werden von einem Administrator festgelegt, wenn ein E-Mail-Endpunkt über Administration Console hinzugefügt wird.

HINWEIS

Das überwachte E-Mail-Konto ist ein spezielles Konto, das nur für den E-Mail-Endpunkt verwendet wird. Dieses Konto ist kein normales E-Mail-Konto des Benutzers. Das E-Mail-Konto eines regulären Benutzers darf nicht als das Konto konfiguriert werden, das der E-Mail-Anbieter verwendet, da der E-Mail-Anbieter E-Mail-Nachrichten aus dem Posteingang löscht, nachdem er mit den Nachrichten fertig ist.

Beim programmgesteuerten Hinzufügen eines E-Mail-Endpunkts zu einem Dienst werden die folgenden Konfigurationswerte festgelegt:

cronExpression: Ein Cron-Ausdruck, wenn die E-Mail mithilfe eines Cron-Ausdrucks geplant werden muss.
repeatCount: Gibt an, wie oft der E-Mail-Endpunkt den Ordner oder das Verzeichnis überprüft. Der Wert „-1“ bedeutet uneingeschränktes Überprüfen („unendlich“). Der Standardwert ist -1.
repeatInterval: Die Scanrate in Sekunden, die der Empfänger für die Prüfung auf eingehende E-Mails verwendet. Der Standardwert ist 10.
startDelay: Die Zeit, die nach dem Start der Planung auf die Überprüfung gewartet wird. Die Standardzeit ist 0.
batchSize: The number of email messages the receiver processes per scan for optimum performance. Der Wert „-1“ bedeutet alle E-Mails. Der Standardwert ist 2.
userName: Der Benutzername, der beim Aufrufen eines Zieldiensts aus einer E-Mail verwendet wird. Der Standardwert ist SuperAdmin.
domainName: A mandatory configuration value. Der Standardwert ist DefaultDom.
domainPattern: Gibt die Domänenmuster der eingehenden E-Mail an, die der Provider akzeptiert. Wenn beispielsweise adobe.com verwendet wird, werden nur E-Mails von adobe.com verarbeitet, E-Mails von anderen Domänen werden ignoriert.
filePattern: Gibt die Muster für eingehende Dateianlagen an, die der Provider akzeptiert. Dazu gehören Dateien mit bestimmten Dateinamenerweiterungen (*.dat, *.xml), Dateien mit bestimmten Namen (data) und Dateien mit zusammengesetzten Ausdrücken im Namen und in der Erweiterung (*.[dD][aA][Tt]). Der Standardwert ist *.
recipientSuccessfulJob: Eine E-Mail-Adresse, an die Nachrichten gesendet werden, um erfolgreiche Aufträge anzuzeigen. Standardmäßig wird eine Benachrichtigung ü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änger mit E-Mail-Adressen an, von denen jeder durch ein Komma getrennt ist. Lassen Sie diesen Wert leer, um diese Option zu deaktivieren. In einigen Fällen möchten Sie möglicherweise einen Trigger durchführen und keine E-Mail-Benachrichtigung zum Ergebnis wünschen. Der Standardwert ist sender.
recipientFailedJob: Eine E-Mail-Adresse, an die Benachrichtigungen über fehlgeschlagene Aufträge gesendet werden. Standardmäßig wird immer eine Benachrichtigung über fehlgeschlagene Aufträge 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änger mit E-Mail-Adressen an, von denen jeder durch ein Komma getrennt ist. Lassen Sie diesen Wert leer, um diese Option zu deaktivieren. Der Standardwert ist sender.
inboxHost: Der Hostname oder die IP-Adresse des Posteingangs, die vom E-Mail-Anbieter überprüft werden sollen.
inboxPort: Der Anschluss, den der E-Mail-Server verwendet. Der Standardwert ist für POP3 „110“ und für IMAP „143“. Ist SSL aktiviert, ist der Standardwert für POP3 „995“ und für IMAP „993“.
inboxProtocol: Das E-Mail-Protokoll für den E-Mail-Endpunkt, das zum Überprüfen des Posteingangs verwendet werden soll. Die Optionen sind IMAP oder POP3. Der Hostmailserver des Posteingangs muss diese Protokolle unterstützen.
inboxTimeOut: Zeitüberschreitung in Sekunden, bis der E-Mail-Anbieter auf Antworten im Posteingang wartet. Der Standardwert ist 60.
inboxUser: Der Benutzername, der zum Anmelden beim E-Mail-Konto erforderlich ist. Je nach E-Mail-Server und Konfiguration kann dies nur der Benutzernamenteil der E-Mail-Adresse oder die vollständige E-Mail-Adresse sein.
inboxPassword: Das Kennwort für den Posteingangsbenutzer.
inboxSSLEnabled: Legen Sie diesen Wert fest, um den E-Mail-Anbieter zu zwingen, SSL beim Senden von Benachrichtigungen zu Ergebnissen oder Fehlern zu verwenden. Stellen Sie sicher, dass der IMAP- oder POP3-Host SSL unterstützt.
smtpHost: Der Hostname des E-Mail-Servers, an den der E-Mail-Anbieter Ergebnisse und Fehlermeldungen sendet.
smtpPort: Der Standardwert für den SMTP-Port ist 25.
smtpUser: Das Benutzerkonto, das der E-Mail-Anbieter verwenden soll, wenn er E-Mail-Benachrichtigungen zu Ergebnissen und Fehlern sendet.
smtpPassword: Das Kennwort für das SMTP-Konto. Einige E-Mail-Server benötigen kein SMTP-Kennwort.
charSet: Der vom E-Mail-Anbieter verwendete Zeichensatz. Der Standardwert ist UTF-8.
smtpSSLEnabled: Legen Sie diesen Wert fest, um den E-Mail-Anbieter zu zwingen, SSL beim Senden von Benachrichtigungen zu Ergebnissen oder Fehlern zu verwenden. Stellen Sie sicher, dass der SMTP-Host SSL unterstützt.
failedJobFolder: Gibt einen Ordner an, in dem Ergebnisse gespeichert werden sollen, wenn der SMTP-Mail-Server nicht betriebsbereit ist.
asynchron: Wenn "synchron"festgelegt ist, werden alle Eingabedokumente verarbeitet und eine einzelne Antwort zurückgegeben. Wenn "asynchron"festgelegt ist, wird für jedes verarbeitete Eingabedokument eine Antwort gesendet. Beispielsweise wird ein E-Mail-Endpunkt für den in dieses Thema eingeführten Prozess erstellt und eine E-Mail-Nachricht an den Posteingang des Endpunkts gesendet, die mehrere ungesicherte PDF-Dokumente enthält. Wenn alle PDF-Dokumente mit einem Kennwort verschlüsselt sind und der Endpunkt als synchron konfiguriert ist, wird eine einzige Antwort-E-Mail-Nachricht mit allen gesicherten angehängten PDF-Dokumenten gesendet. Wenn der Endpunkt als asynchron konfiguriert ist, wird für jedes gesicherte PDF-Dokument eine separate Antwort-E-Mail-Nachricht gesendet. Jede E-Mail-Nachricht enthält ein einzelnes PDF-Dokument als Anlage. Der Standardwert ist „asynchron“.

Definieren von Eingabeparameterwerten

Beim Erstellen eines E-Mail-Endpunkts müssen Sie Eingabeparameterwerte definieren. Das heißt, Sie müssen die Eingabewerte beschreiben, die an den Vorgang übergeben werden, der vom E-Mail-Endpunkt aufgerufen wird. Betrachten Sie beispielsweise den in diesem Thema eingeführten Prozess. Sie hat einen Eingabewert mit dem Namen InDoc und der Datentyp com.adobe.idp.Document. Beim Erstellen eines E-Mail-Endpunkts für diesen Prozess (nachdem ein Prozess aktiviert wurde, wird er zu einem Dienst) müssen Sie den Eingabeparameterwert definieren.

Geben Sie die folgenden Werte an, um die für einen E-Mail-Endpunkt erforderlichen Eingabeparameterwerte zu definieren:

Name des Eingabeparameters: Der Name des Eingabeparameters. Der Name eines Eingabewerts wird in Workbench für einen Prozess angegeben. Wenn der Eingabewert zu einem Dienstvorgang gehört (einem Forms-Dienst, der kein in Workbench erstellter Prozess ist), wird der Eingabename in der Datei "component.xml"angegeben. Beispielsweise lautet der Name des Eingabeparameters für den in diesem Abschnitt eingeführten Prozess InDoc.

Zuordnungstyp: Wird zum Konfigurieren der zum Aufrufen des Dienstvorgangs erforderlichen Eingabewerte verwendet. Es gibt zwei Arten von Zuordnungstypen:

Literal: Der E-Mail-Endpunkt verwendet den im Feld eingegebenen Wert, wie er angezeigt wird. Alle grundlegenden Java-Typen werden unterstützt. Wenn eine API beispielsweise Eingaben wie String, Long, Int oder Boolean verwendet, wird die Zeichenfolge in einen ordnungsgemäßen Typ konvertiert und der Dienst aufgerufen.
Variable: Der eingegebene Wert ist ein Dateimuster, mit dem der E-Mail-Endpunkt die Eingabe auswählt. Wenn Sie beispielsweise Variable für den Zuordnungstyp auswählen und das Eingabedokument eine PDF-Datei sein muss, können Sie *.pdf als Zuordnungswert.

Zuordnungswert: Gibt den Wert des Zuordnungstyps an. Wenn Sie beispielsweise einen Variablenzuordnungstyp auswählen, können Sie *.pdf als Dateimuster.

Datentyp: Gibt den Datentyp der Eingabewerte an. Beispielsweise lautet der Datentyp des Eingabewerts des in diesem Abschnitt eingeführten Prozesses com.adobe.idp.Document.

Ausgabeparameterwert definieren

Beim Erstellen eines E-Mail-Endpunkts müssen Sie einen Ausgabeparameterwert definieren. Das heißt, Sie müssen den Ausgabewert beschreiben, der von dem Dienst zurückgegeben wird, der vom E-Mail-Endpunkt aufgerufen wird. Betrachten Sie beispielsweise den in diesem Thema eingeführten Prozess. Sie hat einen Ausgabewert mit dem Namen SecuredDoc und der Datentyp com.adobe.idp.Document. Beim Erstellen eines E-Mail-Endpunkts für diesen Prozess (nachdem ein Prozess aktiviert wurde, wird er zu einem Dienst) müssen Sie den Wert des Ausgabeparameters definieren.

Um einen für einen E-Mail-Endpunkt erforderlichen Ausgabeparameterwert zu definieren, geben Sie die folgenden Werte an:

Name des Ausgabeparameters: Der Name des Ausgabeparameters. Der Name eines Prozessausgabewerts wird in Workbench angegeben. Wenn der Ausgabewert zu einem Dienstvorgang gehört (ein Dienst, der kein in Workbench erstellter Prozess ist), wird der Ausgabename in der Datei "component.xml"angegeben. Beispielsweise lautet der Name des Ausgabeparameters für den in diesem Abschnitt eingeführten Prozess SecuredDoc.

Zuordnungstyp: Wird zum Konfigurieren der Ausgabe des Dienstes und Vorgangs verwendet. Die folgenden Optionen sind verfügbar:

Wenn der Dienst ein einzelnes Objekt (ein einzelnes Dokument) zurückgibt, lautet das Muster %F.pdf und das Quellziel "sourcefilename.pdf"lautet. Beispielsweise gibt der in diesem Abschnitt eingeführte Prozess ein einzelnes Dokument zurück. Daher kann der Zuordnungstyp wie folgt definiert werden: %F.pdf ( %F verwendet den angegebenen Dateinamen). Das Muster %E gibt die Erweiterung des Eingabedokuments an.
Wenn der Dienst eine Liste zurückgibt, lautet das Muster Result\%F\, und das Quellziel ist Result\sourcefilename\source1 (Ausgabe 1) und Result\sourcefilename\source2 (Ausgabe 2).
Wenn der Dienst eine Zuordnung zurückgibt, lautet das Muster Result\%F\und das Quellziel "Result\sourcefilename\file1"und "Result\sourcefilename\file2"lautet. Wenn die Zuordnung mehr als ein Objekt enthält, lautet das Muster Result\%F.pdf und das Quellziel "Result\sourcefilename1.pdf"(Ausgabe 1), "Result\sourcefilenam2.pdf"(Ausgabe 2) usw. ist.

Datentyp: Gibt den Datentyp des Rückgabewerts an. Beispielsweise lautet der Datentyp des Rückgabewerts des in diesem Abschnitt eingeführten Prozesses . com.adobe.idp.Document.

Email-Endpunkt erstellen

Nachdem Sie die E-Mail-Endpunktattribute und Konfigurationswerte festgelegt und Eingabe- und Ausgabeparameterwerte definiert haben, müssen Sie den E-Mail-Endpunkt erstellen.

Endpunkt aktivieren

Nachdem Sie einen E-Mail-Endpunkt erstellt haben, müssen Sie ihn aktivieren. Wenn der Endpunkt aktiviert ist, kann er zum Aufrufen des Dienstes verwendet werden. Nachdem Sie den Endpunkt aktiviert haben, können Sie ihn in Administration Console anzeigen.

Siehe auch

QuickStart: Hinzufügen eines Endpunkts für überwachte Ordner mithilfe der Java-API

Hinzufügen eines E-Mail-Endpunkts mithilfe der Java-API

Fügen Sie mithilfe der Java-API einen E-Mail-Endpunkt hinzu:

Projektdateien einschließen.

Schließen Sie Client-JAR-Dateien wie adobe-livecycle-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein EndpointRegistry-Client-Objekt.
- Erstellen Sie ein ServiceClientFactory-" -Objekt, das Verbindungseigenschaften enthält.
- Erstellen Sie eine EndpointRegistryClient -Objekt durch Verwendung seines Konstruktors und Übergabe des ServiceClientFactory -Objekt.
E-Mail-Endpunktattribute festlegen.
- Erstellen Sie ein Objekt CreateEndpointInfo, indem Sie den Konstruktor verwenden.
- Geben Sie den Wert der Connector-ID an, indem Sie die CreateEndpointInfo -Objekt setConnectorId -Methode und Übergeben des Zeichenfolgenwerts Email.
- Geben Sie die Beschreibung des Endpunkts an, indem Sie die CreateEndpointInfo -Objekt setDescription -Methode verwenden und einen string -Wert übergeben, der den -Endpunkt beschreibt.
- Geben Sie den Namen des Endpunkts an, indem Sie die CreateEndpointInfo -Objekt setName -Methode verwenden und einen string -Wert übergeben, der den Namen angibt.
- Geben Sie den Dienst an, zu dem der Endpunkt gehört, indem Sie die CreateEndpointInfo -Objekt setServiceId -Methode verwenden und einen string -Wert übergeben, der den Dienstnamen angibt.
- Geben Sie den Vorgang an, der durch Aufrufen der CreateEndpointInfo -Objekt setOperationName -Methode verwenden und einen string -Wert übergeben, der den Vorgangsnamen angibt. Beim Erstellen eines E-Mail-Endpunkts für einen Dienst, der aus einem in Workbench erstellten Prozess stammt, wird normalerweise der Name des Vorgangs aufgerufen.
Geben Sie Konfigurationswerte an.

Für jeden Konfigurationswert, der für den E-Mail-Endpunkt festgelegt werden soll, müssen Sie die CreateEndpointInfo -Objekt setConfigParameterAsText -Methode. Um beispielsweise die smtpHost Konfigurationswert, rufen Sie die CreateEndpointInfo -Objekt setConfigParameterAsText -Methode verwenden und die folgenden Werte übergeben:
- Ein string -Wert, der den Namen des Konfigurationswerts angibt. Wenn Sie smtpHost Konfigurationswert, geben Sie smtpHost.
- Ein string -Wert, der den Wert des Konfigurationswerts angibt. Wenn Sie smtpHost Konfigurationswert einen string -Wert angeben, der den Namen des SMTP-Servers angibt.
HINWEIS

Um alle in diesem Abschnitt eingeführten Konfigurationswerte für den EncryptDocument-Dienst anzuzeigen, lesen Sie das Java-Codebeispiel unter QuickStart: Hinzufügen eines E-Mail-Endpunkts mit der Java-API.
Definieren Sie Eingabeparameterwerte.

Definieren Sie einen Eingabeparameterwert durch Aufrufen der CreateEndpointInfo -Objekt setInputParameterMapping -Methode verwenden und die folgenden Werte übergeben:
- Ein string -Wert, der den Namen des Eingabeparameters angibt. Beispielsweise lautet der Name des Eingabeparameters für den EncryptDocument-Dienst . InDoc.
- Ein string -Wert, der den Datentyp des Eingabeparameters angibt. Beispielsweise der Datentyp der InDoc Eingabeparameter ist com.adobe.idp.Document.
- Ein string -Wert, der den Zuordnungstyp angibt. Sie können beispielsweise variable.
- Ein string -Wert, der den Wert des Zuordnungstyps angibt. Beispielsweise können Sie *.pdf als Dateimuster angeben.
HINWEIS

Rufen Sie die setInputParameterMapping -Methode für jeden zu definierenden Eingabeparameterwert. Da der EncryptDocument-Prozess nur einen Eingabeparameter hat, müssen Sie diese Methode einmal aufrufen.
Definieren Sie einen Ausgabeparameterwert.

Definieren Sie einen Ausgabeparameterwert durch Aufrufen der CreateEndpointInfo -Objekt setOutputParameterMapping -Methode verwenden und die folgenden Werte übergeben:
- Ein string -Wert, der den Namen des Ausgabeparameters angibt. Beispielsweise lautet der Name des Ausgabeparameters für den EncryptDocument-Dienst . SecuredDoc.
- Ein string -Wert, der den Datentyp des Ausgabeparameters angibt. Beispielsweise der Datentyp der SecuredDoc Ausgabeparameter ist com.adobe.idp.Document.
- A string value that specifies the mapping type. Sie können beispielsweise %F.pdf.
Erstellen Sie den E-Mail-Endpunkt.

Erstellen Sie den Endpunkt durch Aufrufen der EndpointRegistryClient -Objekt createEndpoint -Methode und Übergabe der CreateEndpointInfo -Objekt. Diese Methode gibt eine Endpoint -Objekt, das den E-Mail-Endpunkt darstellt.
Aktivieren Sie den -Endpunkt.

Enable the endpoint by invoking the EndpointRegistryClient object’s enable method and passing the Endpoint object that was returned by the createEndpoint method.

Siehe auch

Summary of steps

Hinzufügen eines Remoting-Endpunkts mithilfe der Java-API

Konfigurationswerte für E-Mails - Konstante Datei

Die QuickStart: Hinzufügen eines E-Mail-Endpunkts mit der Java-API verwendet eine konstante Datei, die Teil Ihres Java-Projekts sein muss, um den Schnellstart zu kompilieren. This constant file represents configuration values that must be set when adding an email endpoint. Der folgende Java-Code stellt die Konstantendatei dar.

 /**
     * This class contains constants that can be used when setting email endpoint
     * configuration values
     */
 public class EmailEndpointConfigConstants {

     public static final String PROPERTY_EMAILPROVIDER_CRON_EXPRESSION = "cronExpression";
     public static final String PROPERTY_EMAILPROVIDER_REPREAT_COUNT = "repeatCount";
     public static final String PROPERTY_EMAILPROVIDER_REPREAT_INTERVAL = "repeatInterval";
     public static final String PROPERTY_EMAILPROVIDER_START_DELAY = "startDelay";
     public static final String PROPERTY_EMAILPROVIDER_BATCH_SIZE = "batchSize";
     public static final String PROPERTY_EMAILPROVIDER_USERNAME = "userName";
     public static final String PROPERTY_EMAILPROVIDER_DOMAINNAME = "domainName";
     public static final String PROPERTY_EMAILPROVIDER_DOMAINPATTERN = "domainPattern";
     public static final String PROPERTY_EMAILPROVIDER_FILEPATTERN = "filePattern";
     public static final String PROPERTY_EMAILPROVIDER_RECIPIENT_SUCCESSFUL_JOB = "recipientSuccessfulJob";
     public static final String PROPERTY_EMAILPROVIDER_RECIPIENT_FAILED_JOB = "recipientFailedJob";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_HOST = "inboxHost";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_PORT = "inboxPort";
     public static final String PROPERTY_EMAILPROVIDER_PROTOCOL = "inboxProtocol";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_TIMEOUT = "inboxTimeOut";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_USER = "inboxUser";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_PASSWORD = "inboxPassword";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_SSL = "inboxSSLEnabled";
     public static final String PROPERTY_EMAILPROVIDER_SMTP_HOST = "smtpHost";
     public static final String PROPERTY_EMAILPROVIDER_SMTP_PORT = "smtpPort";
     public static final String PROPERTY_EMAILPROVIDER_SMTP_USER = "smtpUser";
     public static final String PROPERTY_EMAILPROVIDER_SMTP_PASSWORD = "smtpPassword";
     public static final String PROPERTY_EMAILPROVIDER_CHARSET = "charSet";
     public static final String PROPERTY_EMAILPROVIDER_SMTP_SSL = "smtpSSLEnabled";
     public static final String PROPERTY_EMAILPROVIDER_FAILED_FOLDER = "failedJobFolder";
     public static final String PROPERTY_EMAILPROVIDER_ASYNCHRONOUS = "asynchronous";
 }

Hinzufügen von Remoting-Endpunkten

HINWEIS

LiveCycle Remoting-APIs werden für AEM Forms on JEE nicht mehr unterstützt.

You can programmatically add a Remoting endpoint to a service by using the AEM Forms Java API. Durch Hinzufügen eines Remoting-Endpunkts aktivieren Sie eine Flex-Anwendung, um den Dienst mithilfe von Remoting aufzurufen. (See Invoking AEM Forms Using (Deprecated for AEM forms) AEM Forms Remoting.)

Um einem Dienst programmgesteuert einen Remoting-Endpunkt hinzuzufügen, beachten Sie den folgenden kurzlebigen Prozess mit dem Namen EncryptDocument.

ar_ar_encryptdocumentprocess

Um zu demonstrieren, wie Sie einem Dienst einen Remoting-Endpunkt hinzufügen, wird in diesem Abschnitt ein Remoting-Endpunkt zu einem Dienst namens EncryptDocument hinzugefügt.

HINWEIS

Mit Webdiensten können Sie keinen Remoting-Endpunkt hinzufügen.

Zusammenfassung der Schritte

Führen Sie die folgenden Aufgaben aus, um einen Endpunkt aus einem Dienst zu entfernen:

Projektdateien einschließen.
Erstellen Sie eine EndpointRegistryClient -Objekt.
Festlegen von Remoting-Endpunktattributen.
Erstellen Sie einen Remoting-Endpunkt.
Aktivieren Sie den -Endpunkt.

Projektdateien einschließen

Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (erforderlich, wenn AEM Forms auf JBoss Application Server bereitgestellt wird)
jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss Application Server bereitgestellt wird)

Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen von AEM Forms-Java-Bibliotheksdateien.

Erstellen eines EndpointRegistry-Client-Objekts

Um einen Remoting-Endpunkt programmgesteuert hinzuzufügen, müssen Sie einen EndpointRegistryClient -Objekt.

Festlegen von Remoting-Endpunktattributen

Geben Sie die folgenden Werte an, um einen Remoting-Endpunkt für einen Dienst zu erstellen:

Connector-ID-Wert: Gibt den Typ des zu erstellenden Endpunkts an. Um einen Remoting-Endpunkt zu erstellen, geben Sie Remoting.
Beschreibung: Gibt die Beschreibung des Endpunkts an.
Name: Gibt den Namen des Endpunkts an.
Dienstkennungswert: Gibt den Dienst an, zu dem der Endpunkt gehört. Um beispielsweise einen Remoting-Endpunkt zum Prozess hinzuzufügen, der in diesem Abschnitt eingeführt wird (ein Prozess wird zu einem Dienst, wenn er in Workbench aktiviert wird), geben Sie EncryptDocument.
Vorgangsname: Gibt den Namen des Vorgangs an, der mithilfe des -Endpunkts aufgerufen wird. Geben Sie beim Erstellen eines Remoting-Endpunkts ein Platzhalterzeichen (*) an.

Remoting-Endpunkt erstellen

Nachdem Sie die Remoting-Endpunktattribute festgelegt haben, können Sie einen Remoting-Endpunkt für einen Dienst erstellen.

Endpunkt aktivieren

Nachdem Sie einen neuen Endpunkt erstellt haben, müssen Sie ihn aktivieren. Wenn ein Remoting-Endpunkt aktiviert ist, ermöglicht es einem Flex-Client, den Dienst aufzurufen.

Siehe auch

Hinzufügen eines Remoting-Endpunkts mithilfe der Java-API

Fügen Sie mithilfe der Java-API einen Remoting-Endpunkt hinzu:

Projektdateien einschließen.

Schließen Sie Client-JAR-Dateien wie adobe-livecycle-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein EndpointRegistry-Client-Objekt.
- Erstellen Sie ein ServiceClientFactory-" -Objekt, das Verbindungseigenschaften enthält.
- Erstellen Sie eine EndpointRegistryClient -Objekt durch Verwendung seines Konstruktors und Übergabe des ServiceClientFactory -Objekt.
Festlegen von Remoting-Endpunktattributen.
- Erstellen Sie ein Objekt CreateEndpointInfo, indem Sie den Konstruktor verwenden.
- Geben Sie den Wert der Connector-ID an, indem Sie die CreateEndpointInfo -Objekt setConnectorId -Methode und Übergeben des Zeichenfolgenwerts Remoting.
- Geben Sie die Beschreibung des Endpunkts an, indem Sie die CreateEndpointInfo -Objekt setDescription -Methode verwenden und einen string -Wert übergeben, der den -Endpunkt beschreibt.
- Geben Sie den Namen des Endpunkts an, indem Sie die CreateEndpointInfo -Objekt setName -Methode verwenden und einen string -Wert übergeben, der den Namen angibt.
- Geben Sie den Dienst an, zu dem der Endpunkt gehört, indem Sie die CreateEndpointInfo -Objekt setServiceId -Methode verwenden und einen string -Wert übergeben, der den Dienstnamen angibt.
- Geben Sie den Vorgang an, der vom CreateEndpointInfo -Objekt setOperationName -Methode verwenden und einen string -Wert übergeben, der den Vorgangsnamen angibt. Geben Sie für einen Remoting-Endpunkt ein Platzhalterzeichen (*) an.
Erstellen Sie einen Remoting-Endpunkt.

Erstellen Sie den Endpunkt durch Aufrufen der EndpointRegistryClient -Objekt createEndpoint -Methode und Übergabe der CreateEndpointInfo -Objekt. Diese Methode gibt eine Endpoint -Objekt, das den neuen Remoting-Endpunkt darstellt.
Aktivieren Sie den -Endpunkt.

Aktivieren Sie den Endpunkt, indem Sie die EndpointRegistryClient -Objekt enable -Methode und Übergabe der Endpoint -Objekt, das von der createEndpoint -Methode.

Siehe auch

QuickStart: Hinzufügen eines Remoting-Endpunkts mit der Java-API

Add a TaskManager endpoint using the Java API

Hinzufügen von TaskManager-Endpunkten

Sie können einen TaskManager-Endpunkt programmgesteuert einem Dienst hinzufügen, indem Sie die AEM Forms Java-API verwenden. Durch Hinzufügen eines TaskManager-Endpunkts zu einem Dienst aktivieren Sie einen Workspace-Benutzer, um den Dienst aufzurufen. Das heißt, ein Benutzer, der in Workspace arbeitet, kann einen Prozess aufrufen, der über einen entsprechenden TaskManager-Endpunkt verfügt.

HINWEIS

Mit Webdiensten können Sie keinen TaskManager-Endpunkt hinzufügen.

Zusammenfassung der Schritte

Führen Sie die folgenden Aufgaben aus, um einem Dienst einen TaskManager-Endpunkt hinzuzufügen:

Projektdateien einschließen.
Erstellen Sie eine EndpointRegistryClient -Objekt.
Erstellen Sie eine Kategorie für den Endpunkt.
Festlegen von TaskManager-Endpunktattributen.
Erstellen Sie einen TaskManager-Endpunkt.
Aktivieren Sie den -Endpunkt.

Projektdateien einschließen

Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (erforderlich, wenn AEM Forms auf JBoss Application Server bereitgestellt wird)
jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss Application Server bereitgestellt wird)

Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen von AEM Forms-Java-Bibliotheksdateien.

Erstellen eines EndpointRegistry-Client-Objekts

Bevor Sie einen TaskManager-Endpunkt programmgesteuert hinzufügen können, müssen Sie einen EndpointRegistryClient -Objekt.

Erstellen einer Kategorie für den Endpunkt

Kategorien werden verwendet, um Dienste in Workspace zu organisieren. Das heißt, ein Workspace-Benutzer kann einen Dienst mit einem TaskManager-Endpunkt aufrufen, indem er eine Kategorie in Workspace auswählt. Beim Erstellen eines TaskManager-Endpunkts können Sie entweder auf eine vorhandene Kategorie verweisen oder programmgesteuert eine neue Kategorie erstellen.

HINWEIS

In diesem Abschnitt wird eine neue Kategorie beim Hinzufügen eines TaskManager-Endpunkts zu einem Dienst erstellt.

TaskManager-Endpunktattribute festlegen

Um einen TaskManager-Endpunkt für einen Dienst zu erstellen, geben Sie die folgenden Werte an:

Connector-ID: Gibt den Typ des zu erstellenden Endpunkts an. Um einen TaskManager-Endpunkt zu erstellen, geben Sie TaskManagerConnector.
Beschreibung: Gibt die Beschreibung des Endpunkts an.
Name: Gibt den Namen des Endpunkts an.
Dienstkennung: Gibt den Dienst an, zu dem der Endpunkt gehört.
Kategorie: Gibt einen Kategoriekennungswert an, der mit dem TaskManager-Endpunkt verknüpft ist.
Vorgangsname: Beim Erstellen eines TaskManager-Endpunkts für einen Dienst, der aus einem in Workbench erstellten Prozess stammt, lautet der Name des Vorgangs normalerweise invoke.

TaskManager-Endpunkt erstellen

After you set a TaskManager endpoint attributes, you can create a TaskManager endpoint for a service.

Endpunkt aktivieren

Nachdem Sie einen neuen Endpunkt erstellt haben, müssen Sie ihn aktivieren. When the endpoint is enabled, it can be used to invoke the service from within Workspace. Nachdem Sie den Endpunkt aktiviert haben, können Sie ihn in Administration Console anzeigen.

Siehe auch

Hinzufügen eines TaskManager-Endpunkts mithilfe der Java-API

Fügen Sie mithilfe der Java-API einen TaskManager-Endpunkt hinzu:

Projektdateien einschließen.

Schließen Sie Client-JAR-Dateien wie adobe-livecycle-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein EndpointRegistry-Client-Objekt.
- Erstellen Sie ein ServiceClientFactory-" -Objekt, das Verbindungseigenschaften enthält.
- Erstellen Sie eine EndpointRegistryClient -Objekt durch Verwendung seines Konstruktors und Übergabe des ServiceClientFactory -Objekt.
Erstellen Sie eine Kategorie für den Endpunkt.
- Erstellen Sie eine CreateEndpointCategoryInfo -Objekt mithilfe des -Konstruktors und Übergabe der folgenden Werte:
  - A string value that specifies the identifier value of the category
  - Ein string -Wert, der die Beschreibung der Kategorie angibt
- Erstellen Sie die Kategorie durch Aufrufen der EndpointRegistryClient -Objekt createEndpointCategory -Methode und Übergabe der CreateEndpointCategoryInfo -Objekt. Diese Methode gibt eine EndpointCategory -Objekt, das die neue Kategorie darstellt.
Festlegen von TaskManager-Endpunktattributen.
- Erstellen Sie ein Objekt CreateEndpointInfo, indem Sie den Konstruktor verwenden.
- Geben Sie den Wert der Connector-ID an, indem Sie die CreateEndpointInfo -Objekt setConnectorId -Methode und Übergeben des Zeichenfolgenwerts TaskManagerConnector.
- Geben Sie die Beschreibung des Endpunkts an, indem Sie die CreateEndpointInfo -Objekt setDescription -Methode verwenden und einen string -Wert übergeben, der den -Endpunkt beschreibt.
- Geben Sie den Namen des Endpunkts an, indem Sie die CreateEndpointInfo -Objekt setName -Methode verwenden und einen string -Wert übergeben, der den Namen angibt.
- Geben Sie den Dienst an, zu dem der Endpunkt gehört, indem Sie die CreateEndpointInfo -Objekt setServiceId -Methode verwenden und einen string -Wert übergeben, der den Dienstnamen angibt.
- Geben Sie die Kategorie an, zu der der Endpunkt gehört, indem Sie die CreateEndpointInfo -Objekt setCategoryId -Methode verwenden und einen string -Wert übergeben, der den Kategoriekennungswert angibt. Sie können die EndpointCategory -Objekt getId -Methode, um den Bezeichnerwert dieser Kategorie abzurufen.
- Geben Sie den Vorgang an, der durch Aufrufen der CreateEndpointInfo -Objekt setOperationName -Methode verwenden und einen string -Wert übergeben, der den Vorgangsnamen angibt. In der Regel beim Erstellen einer TaskManager Endpunkt eines Dienstes, der aus einem in Workbench erstellten Prozess stammt, lautet der Name des Vorgangs invoke.
Erstellen Sie einen TaskManager-Endpunkt.

Erstellen Sie den Endpunkt durch Aufrufen der EndpointRegistryClient -Objekt createEndpoint -Methode und Übergabe der CreateEndpointInfo -Objekt. Diese Methode gibt eine Endpoint -Objekt, das den neuen TaskManager-Endpunkt darstellt.
Aktivieren Sie den -Endpunkt.

Aktivieren Sie den Endpunkt, indem Sie die EndpointRegistryClient -Objekt enable -Methode und Übergabe der Endpoint -Objekt, das von der createEndpoint -Methode.

Siehe auch

QuickStart: Hinzufügen eines TaskManager-Endpunkts mithilfe der Java-API

Ändern eines Endpunkts mit der Java-API

Ändern von Endpunkten

Sie können einen vorhandenen Endpunkt mithilfe der AEM Forms Java-API programmgesteuert ändern. Durch Ändern eines Endpunkts können Sie das Verhalten des Endpunkts ändern. Betrachten Sie beispielsweise einen Endpunkt des Typs "Überwachter Ordner", der einen Ordner angibt, der als überwachter Ordner verwendet wird. Sie können Konfigurationswerte, die zum Endpunkt des Typs "überwachter Ordner"gehören, programmgesteuert ändern, sodass ein anderer Ordner als der überwachte Ordner funktioniert. Informationen zu Konfigurationswerten, die zu einem Endpunkt des Typs "überwachter Ordner"gehören, finden Sie unter Endpunkte für überwachte Ordner hinzufügen.

Um zu demonstrieren, wie Sie einen Endpunkt ändern, ändert dieser Abschnitt einen Endpunkt des Typs "Überwachter Ordner", indem der Ordner geändert wird, der sich wie der überwachte Ordner verhält.

HINWEIS

Sie können einen Endpunkt nicht mithilfe von Webdiensten ändern.

Zusammenfassung der Schritte

Führen Sie die folgenden Aufgaben aus, um einen Endpunkt zu ändern:

Projektdateien einschließen.
Erstellen Sie eine EndpointRegistryClient -Objekt.
Rufen Sie den -Endpunkt ab.
Geben Sie neue Konfigurationswerte an.

Projektdateien einschließen

Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (erforderlich, wenn AEM Forms auf JBoss Application Server bereitgestellt wird)
jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss Application Server bereitgestellt wird)

Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen von AEM Forms-Java-Bibliotheksdateien.

Erstellen eines EndpointRegistry-Client-Objekts

Um einen Endpunkt programmgesteuert zu ändern, müssen Sie eine EndpointRegistryClient -Objekt.

Abrufen des zu ändernden Endpunkts

Bevor Sie einen Endpunkt ändern können, müssen Sie ihn abrufen. Um einen Endpunkt abzurufen, müssen Sie eine Verbindung als Benutzer herstellen, der auf einen Endpunkt zugreifen kann. Es wird empfohlen, eine Verbindung als Administrator herzustellen. (Siehe Einstellung von Verbindungseigenschaften).

Sie können einen Endpunkt abrufen, indem Sie eine Liste von Endpunkten abrufen. Anschließend können Sie durch die Liste navigieren und nach dem jeweiligen zu entfernenden Endpunkt suchen. Sie können beispielsweise einen Endpunkt suchen, indem Sie den Dienst bestimmen, der dem Endpunkt und dem Endpunkttyp entspricht. Wenn Sie den Endpunkt suchen, können Sie ihn ändern.

Angeben neuer Konfigurationswerte

Geben Sie beim Ändern eines Endpunkts neue Konfigurationswerte an. Um beispielsweise einen Endpunkt des Typs "Überwachter Ordner"zu ändern, setzen Sie alle Konfigurationswerte des Endpunkts "Überwachter Ordner"zurück, nicht nur die, die Sie ändern möchten. Informationen zu Konfigurationswerten, die zu einem Endpunkt des Typs "überwachter Ordner"gehören, finden Sie unter Endpunkte für überwachte Ordner hinzufügen.

HINWEIS

Informationen zu Konfigurationswerten, die zu einem E-Mail-Endpunkt gehören, finden Sie unter Hinzufügen von E-Mail-Endpunkten.

HINWEIS

Sie können den Dienst, der vom -Endpunkt aufgerufen wird, nicht ändern. Wenn Sie versuchen, den Dienst zu ändern, wird eine Ausnahme ausgelöst. Um den mit einem bestimmten Endpunkt verknüpften Dienst zu ändern, entfernen Sie den Endpunkt und erstellen Sie einen neuen. (Siehe Entfernen von Endpunkten.

Siehe auch

Ändern eines Endpunkts mit der Java-API

Ändern Sie einen Endpunkt mithilfe der Java-API:

Projektdateien einschließen.

Schließen Sie Client-JAR-Dateien wie adobe-livecycle-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein EndpointRegistry-Client-Objekt.
- Erstellen Sie ein ServiceClientFactory-" -Objekt, das Verbindungseigenschaften enthält.
- Erstellen Sie eine EndpointRegistryClient -Objekt durch Verwendung seines Konstruktors und Übergabe des ServiceClientFactory -Objekt.
Rufen Sie den zu ändernden Endpunkt ab.
- Rufen Sie eine Liste aller Endpunkte ab, auf die der aktuelle Benutzer (angegeben in den Verbindungseigenschaften) zugreifen kann, indem Sie die EndpointRegistryClient -Objekt getEndpoints -Methode und Übergeben einer PagingFilter -Objekt, das als Filter dient. Sie können eine (PagingFilter)null -Wert, um alle Endpunkte zurückzugeben. Diese Methode gibt eine java.util.List -Objekt, bei dem jedes Element Endpoint -Objekt. Informationen zu einer PagingFilter -Objekt, siehe AEM Forms API-Referenz.
- Iteration durch die java.util.List -Objekt, um zu bestimmen, ob es Endpunkte enthält. Wenn Endpunkte vorhanden sind, ist jedes Element ein EndPoint -Instanz.
- Bestimmen Sie den Dienst, der einem Endpunkt entspricht, indem Sie die EndPoint -Objekt getServiceId -Methode. Diese Methode gibt einen Zeichenfolgenwert zurück, der den Dienstnamen angibt.
- Bestimmen des Endpunkttyps durch Aufrufen der EndPoint -Objekt getConnectorId -Methode. Diese Methode gibt einen Zeichenfolgenwert zurück, der den Typ des Endpunkts angibt. Wenn der Endpunkt beispielsweise ein Endpunkt des Typs "überwachter Ordner"ist, gibt diese Methode WatchedFolder.
Geben Sie neue Konfigurationswerte an.
- Erstellen Sie eine ModifyEndpointInfo -Objekt durch Aufrufen seines Konstruktors.
- Rufen Sie für jeden festzulegenden Konfigurationswert die ModifyEndpointInfo -Objekt setConfigParameterAsText -Methode. Um beispielsweise den URL-Konfigurationswert festzulegen, rufen Sie die ModifyEndpointInfo -Objekt setConfigParameterAsText -Methode verwenden und die folgenden Werte übergeben:
  - Ein string -Wert, der den Namen des Konfigurationswerts angibt. Um beispielsweise die url Konfigurationswert, geben Sie url.
  - Ein string -Wert, der den Wert des Konfigurationswerts angibt. So definieren Sie einen Wert für url Konfigurationswert den Speicherort des überwachten Ordners angeben.
- Rufen Sie die EndpointRegistryClient -Objekt modifyEndpoint -Methode und übergeben Sie die ModifyEndpointInfo -Objekt.

Siehe auch

QuickStart: Ändern eines Endpunkts mit der Java-API

Entfernen eines Endpunkts mit der Java-API

Entfernen von Endpunkten

Sie können einen Endpunkt mithilfe der AEM Forms Java-API programmgesteuert aus einem Dienst entfernen. Nachdem Sie einen Endpunkt entfernt haben, kann der Dienst nicht mit der Aufrufmethode aufgerufen werden, die der Endpunkt aktiviert hat. Wenn Sie beispielsweise einen SOAP-Endpunkt aus einem Dienst entfernen, können Sie den Dienst nicht im SOAP-Modus aufrufen.

Um zu demonstrieren, wie Sie einen Endpunkt aus einem Dienst entfernen, entfernt dieser Abschnitt einen EJB-Endpunkt aus einem Dienst mit dem Namen EncryptDocument.

HINWEIS

Mit Webdiensten können Sie einen Endpunkt nicht entfernen.

Zusammenfassung der Schritte

Führen Sie die folgenden Aufgaben aus, um einen Endpunkt aus einem Dienst zu entfernen:

Projektdateien einschließen.
Erstellen Sie eine EndpointRegistryClient -Objekt.
Rufen Sie den -Endpunkt ab.
Entfernen Sie den Endpunkt.

Projektdateien einschließen

Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (erforderlich, wenn AEM Forms auf JBoss Application Server bereitgestellt wird)
jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss Application Server bereitgestellt wird)

Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen von AEM Forms-Java-Bibliotheksdateien.

Erstellen eines EndpointRegistry-Client-Objekts

Um einen Endpunkt programmgesteuert zu entfernen, müssen Sie eine EndpointRegistryClient -Objekt.

Abrufen des zu entfernenden Endpunkts

Bevor Sie einen Endpunkt entfernen können, müssen Sie ihn abrufen. Um einen Endpunkt abzurufen, müssen Sie eine Verbindung als Benutzer herstellen, der auf einen Endpunkt zugreifen kann. Es wird empfohlen, eine Verbindung als Administrator herzustellen. (Siehe Einstellung von Verbindungseigenschaften).

Endpunkt entfernen

Siehe auch

Entfernen eines Endpunkts mit der Java-API

Entfernen Sie einen Endpunkt mithilfe der Java-API:

Projektdateien einschließen.

Schließen Sie Client-JAR-Dateien wie adobe-livecycle-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein EndpointRegistry-Client-Objekt.
- Erstellen Sie ein ServiceClientFactory-" -Objekt, das Verbindungseigenschaften enthält.
- Erstellen Sie eine EndpointRegistryClient -Objekt durch Verwendung seines Konstruktors und Übergabe des ServiceClientFactory -Objekt.
Rufen Sie den zu entfernenden Endpunkt ab.
- Rufen Sie eine Liste aller Endpunkte ab, auf die der aktuelle (in den Verbindungseigenschaften angegebene) Benutzer Zugriff hat, indem Sie die EndpointRegistryClient -Objekt getEndpoints -Methode und Übergeben einer PagingFilter -Objekt, das als Filter dient. Sie können (PagingFilter)null , um alle Endpunkte zurückzugeben. Diese Methode gibt eine java.util.List -Objekt, bei dem jedes Element Endpoint -Objekt.
- Iteration durch die java.util.List -Objekt, um zu bestimmen, ob es Endpunkte enthält. Wenn Endpunkte vorhanden sind, ist jedes Element ein EndPoint -Instanz.
- Bestimmen Sie den Dienst, der einem Endpunkt entspricht, indem Sie die EndPoint -Objekt getServiceId -Methode. Diese Methode gibt einen Zeichenfolgenwert zurück, der den Dienstnamen angibt.
- Bestimmen des Endpunkttyps durch Aufrufen der EndPoint -Objekt getConnectorId -Methode. Diese Methode gibt einen Zeichenfolgenwert zurück, der den Typ des Endpunkts angibt. Wenn der Endpunkt beispielsweise ein EJB-Endpunkt ist, gibt diese Methode EJB.
Entfernen Sie den Endpunkt.

Entfernen Sie den Endpunkt, indem Sie die EndpointRegistryClient -Objekt remove -Methode und Übergabe der EndPoint -Objekt, das den zu entfernenden Endpunkt darstellt.

Siehe auch

QuickStart: Entfernen eines Endpunkts mit der Java-API

Abrufen von Endpunkt-Connector-Informationen mithilfe der Java-API

Abrufen von Endpoint-Connector-Informationen

Sie können mithilfe der AEM Forms-API programmgesteuert Informationen zu Endpunkt-Connectoren abrufen. Ein Connector ermöglicht es einem Endpunkt, einen Dienst mithilfe verschiedener Aufrufmethoden aufzurufen. Ein Connector für überwachte Ordner ermöglicht es beispielsweise einem Endpunkt, einen Dienst mithilfe überwachter Ordner aufzurufen. Durch das programmgesteuerte Abrufen von Informationen zu Endpunkt-Connectoren können Sie Konfigurationswerte abrufen, die mit einem Connector verknüpft sind, z. B. welche Konfigurationswerte erforderlich sind und welche optional sind.

Um zu demonstrieren, wie Sie Informationen zu Endpunkt-Connectoren abrufen, ruft dieser Abschnitt Informationen zu einem Connector für überwachte Ordner ab. (Siehe Endpunkte für überwachte Ordner hinzufügen.

HINWEIS

Mit Webdiensten können Sie keine Informationen zu Endpunkten abrufen.

HINWEIS

Dieses Thema verwendet die ConnectorRegistryClient API zum Abrufen von Informationen zu Endpunkt-Connectoren. (Siehe AEM Forms API-Referenz.

Zusammenfassung der Schritte

Führen Sie die folgenden Aufgaben aus, um Endpunkt-Connector-Informationen abzurufen:

Projektdateien einschließen.
Erstellen Sie eine ConnectorRegistryClient -Objekt.
Geben Sie den Connector-Typ an.
Rufen Sie Konfigurationswerte ab.

Projektdateien einschließen

Die folgenden JAR-Dateien müssen zum Klassenpfad Ihres Projekts hinzugefügt werden:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (erforderlich, wenn AEM Forms auf JBoss Application Server bereitgestellt wird)
jbossall-client.jar (erforderlich, wenn AEM Forms auf JBoss Application Server bereitgestellt wird)

Wenn AEM Forms auf einem unterstützten J2EE-Anwendungsserver bereitgestellt wird, der nicht JBoss ist, ersetzen Sie adobe-utilities.jar und jbossall-client.jar durch JAR-Dateien, die spezifisch für den J2EE-Anwendungsserver sind, auf dem AEM Forms bereitgestellt wird. Informationen zum Speicherort aller AEM Forms-JAR-Dateien finden Sie unter Einschließen von AEM Forms-Java-Bibliotheksdateien.

Erstellen eines ConnectorRegistry-Client-Objekts

To programmatically retrieve endpoint connector information, create a ConnectorRegistryClient object.

Connector-Typ angeben

Geben Sie den Typ des Connectors an, von dem aus Informationen abgerufen werden sollen. The following types of connectors exist:

EJB: Ermöglicht es einer Client-Anwendung, einen Dienst im EJB-Modus aufzurufen.
SOAP: Ermöglicht es einer Client-Anwendung, einen Dienst im SOAP-Modus aufzurufen.
Überwachter Ordner: Ermöglicht überwachten Ordnern das Aufrufen eines Dienstes.
Email: Aktiviert E-Mail-Nachrichten zum Aufrufen eines Dienstes.
Remoting: Aktiviert eine Flex-Clientanwendung zum Aufrufen eines Dienstes.
TaskManagerConnector: Ermöglicht es einem Workspace-Benutzer, einen Dienst aus Workspace aufzurufen.

Abrufen von Konfigurationswerten

Nachdem Sie den Connector-Typ angegeben haben, können Sie Informationen zum Connector abrufen, z. B. den unterstützten Konfigurationswert. Beispielsweise können Sie für jeden Connector festlegen, welche Konfigurationswerte erforderlich sind und welche optional sind.

Siehe auch

Abrufen von Endpunkt-Connector-Informationen mithilfe der Java-API

Rufen Sie Endpunkt-Connector-Informationen mithilfe der Java-API ab:

Projektdateien einschließen. .

Schließen Sie Client-JAR-Dateien wie adobe-livecycle-client.jar in den Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein Client-Objekt vom Typ ConnectorRegistry .
- Erstellen Sie ein ServiceClientFactory-" -Objekt, das Verbindungseigenschaften enthält.
- Erstellen Sie ein ConnectorRegistryClient-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory-Objekt übergeben.
Geben Sie den Connector-Typ an.

Geben Sie den Connector-Typ an, indem Sie die ConnectorRegistryClient -Objekt getEndpointDefinition -Methode verwenden und einen string -Wert übergeben, der den Connector-Typ angibt. Um beispielsweise den Connector-Typ "Überwachter Ordner"anzugeben, übergeben Sie den Zeichenfolgenwert WatchedFolder. Diese Methode gibt eine Endpoint -Objekt, das dem Connector-Typ entspricht.
Rufen Sie Konfigurationswerte ab.
- Rufen Sie Konfigurationswerte ab, die mit diesem Endpunkt verknüpft sind, indem Sie die Endpoint -Objekt getConfigParameters -Methode. Diese Methode gibt ein Array von ConfigParameter Objekte.
- Rufen Sie Informationen zu den einzelnen Konfigurationswerten ab, indem Sie jedes Element im Array abrufen. Jedes Element ist eine ConfigParameter -Objekt. Sie können beispielsweise feststellen, ob der Konfigurationswert erforderlich oder optional ist, indem Sie die ConfigParameter -Objekt isRequired -Methode. Wenn der Konfigurationswert erforderlich ist, gibt diese Methode true.

Siehe auch

QuickStart: Abrufen von Endpunkt-Connector-Informationen mithilfe der Java-API