Info zum Endpunkt-Registrierungsdienst
Der Endpoint-Registrierungsdienst bietet die Möglichkeit, Endpunkte programmgesteuert zu verwalten. Sie können beispielsweise die folgenden Typen von Endpunkten zu einem Dienst hinzufügen:
EJB
SOAP
Überwachter Ordner
(Für AEM Formulare nicht mehr unterstützt) Remoting
Aufgabe Manager
SOAP-, EJB- und (für AEM Forms on JEE nicht mehr unterstützt) Remoting-Endpunkte werden automatisch für jeden aktivierten Dienst erstellt. Die SOAP- und EJB-Endpunkte ermöglichen SOAP und EJB für alle Dienstvorgänge.
Ein Remoting-Endpunkt ermöglicht es Flex-Clients, Vorgänge für den AEM Forms-Dienst aufzurufen, dem der Endpunkt hinzugefügt wird. Ein Flex-Ziel mit demselben Namen wie der Endpunkt wird erstellt, und Flex-Clients können RemoteObjects erstellen, die auf dieses Ziel verweisen, um Vorgänge für den betreffenden Dienst aufzurufen.
Die Endpunkte "E-Mail", "Aufgabe-Manager"und "Überwachter Ordner"stellen nur einen bestimmten Dienstvorgang bereit. Das Hinzufügen dieser Endpunkte erfordert einen zweiten Konfigurationsschritt, um eine Methode zum Aufrufen auszuwählen, Konfigurationsparameter festzulegen und Zuordnungen von Eingabe- und Ausgabeparametern festzulegen.
Sie können TaskManager-Endpunkte in Gruppen mit dem Namen Kategorien organisieren. Diese Kategorien werden dann Workspace über TaskManager angezeigt, wobei die TaskManager-Endpunkte den Endpunkten während der Kategorisierung angezeigt werden. Innerhalb von Workspace sehen Endbenutzer diese Kategorien im Navigationsbereich. Die Endpunkte in den einzelnen Kategorien werden als Prozesskarten auf der Seite "Beginn-Prozesse"in Workspace angezeigt.
Sie können diese Aufgaben mithilfe des Endpunktregistrierungsdiensts ausführen:
hinzufügen EJB-Endpunkte. (Siehe Hinzufügen von EJB-Endpunkten.)
hinzufügen SOAP-Endpunkte. (Siehe Hinzufügen von SOAP-Endpunkten.)
hinzufügen Endpunkte für überwachte Ordner (siehe Hinzufügen von Endpunkten für überwachte Ordner.)
hinzufügen E-Mail-Endpunkte. (Siehe Hinzufügen von E-Mail-Endpunkten.)
hinzufügen Remoting-Endpunkte. (Siehe Remoting-Endpunkte hinzufügen.)
hinzufügen TaskManager-Endpunkte (siehe Hinzufügen von TaskManager-Endpunkten.)
Endpunkte ändern (Siehe Endpunkte ändern.)
Entfernen Sie Endpunkte (siehe Entfernen von Endpunkten.)
Abrufen von Endpunktschnittstellenverbindungsinformationen (siehe Abrufen von Endpunktschnittstelleninformationen.)
Sie können einem Dienst programmgesteuert einen EJB-Endpunkt hinzufügen, indem Sie die AEM Forms Java API verwenden. Indem Sie einem Dienst einen EJB-Endpunkt hinzufügen, aktivieren Sie eine Clientanwendung, um den Dienst mithilfe des EJB-Modus aufzurufen. Das heißt, beim Festlegen der Verbindungseigenschaften, die zum Aufrufen von AEM Forms erforderlich sind, können Sie den EJB-Modus auswählen. (Siehe Einstellung von Verbindungseigenschaften.)
Mit Webdiensten können Sie keinen EJB-Endpunkt hinzufügen.
Normalerweise wird einem Dienst standardmäßig ein EJB-Endpunkt hinzugefügt. Ein EJB-Endpunkt kann jedoch einem programmgesteuert bereitgestellten Prozess hinzugefügt werden oder wenn ein EJB-Endpunkt entfernt wurde und erneut hinzugefügt werden muss.
So fügen Sie einem Dienst einen EJB-Endpunkt hinzu:
EndpointRegistry Client
-Objekt.Projektdateien einschließen
Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Die folgenden JAR-Dateien müssen dem Klassenpfad Ihres Projekts hinzugefügt werden:
Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen von AEM Forms Java-Bibliotheksdateien.
EndpointRegistry Client-Objekt erstellen
Bevor Sie einen EJB-Endpunkt programmgesteuert hinzufügen können, müssen Sie ein EndpointRegistryClient
-Objekt erstellen.
EJB-Endpunktattribute festlegen
Um einen EJB-Endpunkt für einen Dienst zu erstellen, geben Sie die folgenden Werte an:
EJB
an.*
) an. Wenn Sie jedoch einen bestimmten Vorgang angeben möchten, anstatt alle Dienstvorgänge aufzurufen, geben Sie den Namen des Vorgangs an, anstatt das Platzhalterzeichen ( *
) zu verwenden.Erstellen eines EJB-Endpunkts
Nachdem Sie EJB-Endpunktattribute festgelegt haben, können Sie einen EJB-Endpunkt für einen Dienst erstellen.
Endpunkt aktivieren
Nachdem Sie einen neuen Endpunkt erstellt haben, müssen Sie ihn aktivieren. Nachdem Sie den Endpunkt aktiviert haben, kann er zum Aufrufen des Dienstes verwendet werden. Nachdem Sie den Endpunkt aktiviert haben, können Sie ihn in Administration Console Ansicht haben.
Siehe auch
Hinzufügen eines EJB-Endpunkts mithilfe der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
hinzufügen eines EJB-Endpunkts mithilfe der Java-API:
Schließen Sie Projektdateien ein.
Schließen Sie Client-JAR-Dateien wie "adobe-livecycle-client.jar"im Klassenpfad Ihres Java-Projekts ein. (
Erstellen Sie ein EndpointRegistry Client-Objekt.
ServiceClientFactory
-" -Objekt, das Verbindungseigenschaften enthält.EndpointRegistryClient
-Objekt, indem Sie den Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Legen Sie EJB-Endpunktattribute fest.
CreateEndpointInfo
, indem Sie den Konstruktor verwenden.CreateEndpointInfo
-Methode des Objekts setConnectorId
aufrufen und den Zeichenfolgenwert EJB
übergeben.CreateEndpointInfo
-Methode des Objekts setDescription
aufrufen und einen Zeichenfolgenwert übergeben, der den Endpunkt beschreibt.CreateEndpointInfo
-Methode des Objekts setName
aufrufen und einen Zeichenfolgenwert übergeben, der den Namen angibt.setServiceId
-Methode des Objekts aufrufen und einen Zeichenfolgenwert übergeben, der den Dienstnamen angibt.CreateEndpointInfo
CreateEndpointInfo
-Objektmethode setOperationName
aufgerufen wird, und übergeben Sie einen Zeichenfolgenwert, der den Vorgangsnamen angibt. Geben Sie für SOAP- und EJB-Endpunkte ein Platzhalterzeichen ( *
) an, das alle Vorgänge umfasst.Erstellen Sie einen EJB-Endpunkt.
Erstellen Sie den Endpunkt, indem Sie die EndpointRegistryClient
-Methode des Objekts createEndpoint
aufrufen und das CreateEndpointInfo
-Objekt übergeben. Diese Methode gibt ein Endpoint
-Objekt zurück, das den neuen EJB-Endpunkt darstellt.
Aktivieren Sie den Endpunkt.
Aktivieren Sie den Endpunkt, indem Sie die enable-Methode des Objekts aufrufen und das Endpoint
-Objekt übergeben, das von der createEndpoint
-Methode zurückgegeben wurde.EndpointRegistryClient
Siehe auch
QuickStart: Hinzufügen eines EJB-Endpunkts mithilfe der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Sie können einem Dienst programmgesteuert einen SOAP-Endpunkt hinzufügen, indem Sie die AEM Forms Java API verwenden. Durch Hinzufügen eines SOAP-Endpunkts aktivieren Sie eine Clientanwendung, um den Dienst im SOAP-Modus aufzurufen. Das heißt, beim Festlegen der Verbindungseigenschaften, die zum Aufrufen von AEM Forms erforderlich sind, können Sie den SOAP-Modus auswählen.
Mit Webdiensten können Sie keinen SOAP-Endpunkt hinzufügen.
Normalerweise wird einem Dienst standardmäßig ein SOAP-Endpunkt hinzugefügt. Ein SOAP-Endpunkt kann jedoch einem programmgesteuert bereitgestellten Prozess hinzugefügt werden oder wenn ein SOAP-Endpunkt entfernt wurde und erneut hinzugefügt werden muss.
So fügen Sie einem Dienst einen SOAP-Endpunkt hinzu:
EndpointRegistryClient
-Objekt.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 Proxydateien einschließen.
Die folgenden JAR-Dateien müssen dem Klassenpfad Ihres Projekts hinzugefügt werden:
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.
EndpointRegistry Client-Objekt erstellen
Um einem Dienst programmgesteuert einen SOAP-Endpunkt hinzuzufügen, müssen Sie ein EndpointRegistryClient
-Objekt erstellen.
SOAP-Endpunktattribute festlegen
Um einem Dienst einen SOAP-Endpunkt hinzuzufügen, geben Sie die folgenden Werte an:
SOAP
an.*
) an. Wenn Sie jedoch einen bestimmten Vorgang angeben möchten, anstatt alle Dienstvorgänge aufzurufen, geben Sie den Namen des Vorgangs an, anstatt das Platzhalterzeichen ( *
) zu verwenden.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 für die Ansicht anzeigen.
Siehe auch
hinzufügen eines SOAP-Endpunkts mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
hinzufügen eines SOAP-Endpunkts zu einem Dienst mithilfe der Java-API:
Schließen Sie Projektdateien ein.
Schließen Sie Client-JAR-Dateien wie "adobe-livecycle-client.jar"im Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein EndpointRegistry Client-Objekt.
ServiceClientFactory
-" -Objekt, das Verbindungseigenschaften enthält.EndpointRegistryClient
-Objekt, indem Sie den Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Legen Sie SOAP-Endpunktattribute fest.
CreateEndpointInfo
, indem Sie den Konstruktor verwenden.CreateEndpointInfo
-Methode des Objekts setConnectorId
aufrufen und den Zeichenfolgenwert SOAP
übergeben.CreateEndpointInfo
-Methode des Objekts setDescription
aufrufen und einen Zeichenfolgenwert übergeben, der den Endpunkt beschreibt.CreateEndpointInfo
-Methode des Objekts setName
aufrufen und einen Zeichenfolgenwert übergeben, der den Namen angibt.setServiceId
-Methode des Objekts aufrufen und einen Zeichenfolgenwert übergeben, der den Dienstnamen angibt.CreateEndpointInfo
CreateEndpointInfo
-Methode des Objekts setOperationName
aufrufen und einen Zeichenfolgenwert übergeben, der den Vorgangsnamen angibt. Geben Sie für SOAP- und EJB-Endpunkte ein Platzhalterzeichen ( *
) an, das alle Vorgänge umfasst.Erstellen Sie einen SOAP-Endpunkt.
Erstellen Sie den Endpunkt, indem Sie die EndpointRegistryClient
-Methode des Objekts createEndpoint
aufrufen und das CreateEndpointInfo
-Objekt übergeben. Diese Methode gibt ein Endpoint
-Objekt zurück, das den neuen SOAP-Endpunkt darstellt.
Aktivieren Sie den Endpunkt.
Aktivieren Sie den Endpunkt, indem Sie die enable-Methode des Objekts aufrufen und das Endpoint
-Objekt übergeben, das von der createEndpoint
-Methode zurückgegeben wurde.EndpointRegistryClient
Siehe auch
QuickStart: Hinzufügen eines SOAP-Endpunkts mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Sie können einem Dienst programmgesteuert einen Endpunkt des Typs "Überwachter Ordner"hinzufügen, indem Sie die AEM Forms Java API verwenden. Durch Hinzufügen eines Endpunkts für den überwachten Ordner können Sie Benutzern das Platzieren einer Datei (z. B. einer PDF-Datei) in einem Ordner ermöglichen. Wenn die Datei im Ordner abgelegt wird, wird der konfigurierte Dienst aufgerufen und verarbeitet die Datei. 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 bestimmten Zeitintervall oder mit einem Cron-Zeitplan gescannt wird, z. B. jeden Montag, Mittwoch und Freitag um 12 Uhr.
Um einem Dienst programmgesteuert einen Endpunkt des Typs "Überwachter Ordner"hinzuzufügen, beachten Sie den folgenden Prozess mit kurzer Lebensdauer mit dem Namen EncryptDocument. (Siehe Die AEM Forms-Prozesse.)
Bei diesem Vorgang wird ein unbesichertes PDF-Dokument als Eingabewert akzeptiert und anschließend das unbesicherte PDF-Dokument an den Vorgang EncryptPDFUsingPassword
des Encryption-Dienstes weitergegeben. 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) ist InDoc
und der Datentyp ist com.adobe.idp.Document
. Der Name des Ausgabewerts (kennwortverschlüsseltes PDF-Dokument) ist SecuredDoc
und der Datentyp ist com.adobe.idp.Document
.
Mit Webdiensten können Sie keinen Endpunkt für den überwachten Ordner hinzufügen.
So fügen Sie einem Dienst einen Endpunkt des Typs "Überwachter Ordner"hinzu:
EndpointRegistryClient
-Objekt.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 Proxydateien einschließen.
Die folgenden JAR-Dateien müssen dem Klassenpfad Ihres Projekts hinzugefügt werden:
Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen von AEM Forms Java-Bibliotheksdateien.
EndpointRegistry Client-Objekt erstellen
Um programmgesteuert einen Endpunkt des Typs "Überwachter Ordner"hinzuzufügen, müssen Sie ein EndpointRegistryClient
-Objekt erstellen.
Endpunktattribute für überwachten Ordner festlegen
Geben Sie die folgenden Werte an, um einen Endpunkt des Typs "Überwachter Ordner"für einen Dienst zu erstellen:
WatchedFolder
an.EncryptDocument
an.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 mithilfe von Administration Console ein Endpunkt des Typs "Überwachter Ordner"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:
data*
ist, werden alle Dateien und Ordner, die data*
entsprechen, nicht aufgenommen. Dazu gehören Dateien und Ordner mit den Namen data1
, data2
usw. Zusätzlich kann das Muster durch Platzhaltermuster ergänzt werden, um Dateimuster anzugeben. Der überwachte Ausdruck ändert den regulären Ordner, um Platzhaltermuster wie *.*
und *.pdf
zu unterstützen. Diese Platzhaltermuster werden von normalen Ausdrücken nicht unterstützt.*
ist, werden alle Dateien und Ordner abgerufen, die input*
entsprechen. Dazu gehören Dateien und Ordner mit den Namen input1
, input2
usw. Der Standardwert ist *
. Dieser Wert gibt alle Dateien und Ordner an. Zusätzlich kann das Muster durch Platzhaltermuster ergänzt werden, um Dateimuster anzugeben. Der überwachte Ausdruck ändert den regulären Ordner, um Platzhaltermuster wie *.*
und *.pdf
zu unterstützen. Diese Platzhaltermuster werden von normalen Ausdrücken nicht unterstützt. Dieser Wert ist ein obligatorischer Wert.result/%Y/%M/%D/
. Dies ist der Ergebnisordner im überwachten Ordner.preserve/%Y/%M/%D/
.failure/%Y/%M/%D/
.Definieren von Eingabeparameterwerten
Beim Erstellen eines Endpunkts für überwachte 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 zum Beispiel den in diesem Thema eingeführten Prozess. Es hat einen Eingabewert mit dem Namen InDoc
und der Datentyp ist com.adobe.idp.Document
. Wenn Sie einen Endpunkt für den überwachten Ordner für diesen Prozess erstellen (nachdem ein Prozess aktiviert wurde, wird er zu einem Dienst), müssen Sie den Wert des Eingabeparameters definieren.
Geben Sie die folgenden Werte an, um Eingabeparameterwerte zu definieren, die für einen Endpunkt des Typs "Überwachter Ordner"erforderlich sind:
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 nicht in Workbench erstellt wurde), 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: Dient zum Konfigurieren der zum Aufrufen des Dienstvorgangs erforderlichen Eingabewerte. Es gibt zwei Arten von Zuordnungstypen:
Literal
: Der Endpunkt des Typs "Überwachter Ordner"verwendet den in das Feld eingegebenen Wert, wie er angezeigt wird. Alle grundlegenden Java-Typen werden unterstützt. Wenn eine API beispielsweise Eingaben 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 Eingabedateien eine PDF-Dokument sein muss, können Sie *.pdf
als Zuordnungswert angeben.Zuordnungswert: Gibt den Wert des Zuordnungstyps an. Wenn Sie beispielsweise den Zuordnungstyp Variable
auswählen, können Sie *.pdf
als Dateimuster angeben.
Datentyp: Gibt den Datentyp der eingegebenen Werte an. Der Datentyp des Eingabewerts des in diesem Abschnitt eingeführten Prozesses ist beispielsweise com.adobe.idp.Document
.
Definieren eines Ausgabeparameterwerts
Beim Erstellen eines Endpunkts für einen überwachten 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 des Typs "Überwachter Ordner"aufgerufen wird. Betrachten Sie zum Beispiel den in diesem Thema eingeführten Prozess. Es hat einen Ausgabewert mit dem Namen SecuredDoc
und der Datentyp ist com.adobe.idp.Document
. Wenn Sie einen Endpunkt für den überwachten Ordner für diesen Prozess erstellen (nachdem ein Prozess aktiviert wurde, wird er zu einem Dienst), müssen Sie den Wert des Ausgabeparameters definieren.
Um einen für einen Endpunkt des Typs "Überwachter Ordner"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 (einem Dienst, der nicht in Workbench erstellt wurde), 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: Dient zum Konfigurieren der Ausgabe des Dienstes und Vorgangs. Die folgenden Optionen sind verfügbar:
%F.pdf
und das Quellziel ist sourcefilename.pdf. Beispielsweise gibt der in diesem Abschnitt eingeführte Prozess ein einzelnes Dokument zurück. Daher kann der Zuordnungstyp als %F.pdf
definiert werden ( %F
bedeutet, dass Sie den angegebenen Dateinamen verwenden). Das Muster %E
gibt die Erweiterung des Eingabe-Dokuments an.Result\%F\
und das Quellziel lautet Result\sourcefilename\source1 (output 1) und Result\sourcefilename\source2 (output 2).Result\%F\
und das Quellziel ist Result\sourcefilename\file1 and Result\sourcefilename\file2. Wenn die Map über mehr als ein Objekt verfügt, ist das Muster Result\%F.pdf
und das Quellziel lautet Result\sourcefilename1.pdf (Ausgabe 1), Result\sourcefilenam2.pdf (Ausgabe 2) usw.Datentyp: Gibt den Datentyp des Rückgabewerts an. Der Datentyp des Rückgabewerts des in diesem Abschnitt eingeführten Prozesses ist beispielsweise com.adobe.idp.Document
.
Endpunkt des Typs "Überwachter Ordner"erstellen
Nachdem Sie die Attribute und Konfigurationswerte des Endpunkts festgelegt und Werte für Eingabe- und Ausgabeparameter 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 Ansicht haben.
Siehe auch
hinzufügen eines Endpunkts für einen überwachten Ordner mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
hinzufügen eines Endpunkts für den überwachten Ordner mithilfe der AEM Forms Java API:
Schließen Sie Projektdateien ein.
Schließen Sie Client-JAR-Dateien wie "adobe-livecycle-client.jar"im Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein EndpointRegistry Client-Objekt.
ServiceClientFactory
-" -Objekt, das Verbindungseigenschaften enthält.EndpointRegistryClient
-Objekt, indem Sie den Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Legen Sie Endpunktattribute für überwachte Ordner fest.
CreateEndpointInfo
, indem Sie den Konstruktor verwenden.CreateEndpointInfo
-Methode des Objekts setConnectorId
aufrufen und den Zeichenfolgenwert WatchedFolder
übergeben.CreateEndpointInfo
-Methode des Objekts setDescription
aufrufen und einen Zeichenfolgenwert übergeben, der den Endpunkt beschreibt.CreateEndpointInfo
-Methode des Objekts setName
aufrufen und einen Zeichenfolgenwert übergeben, der den Namen angibt.setServiceId
-Methode des Objekts aufrufen und einen Zeichenfolgenwert übergeben, der den Dienstnamen angibt.CreateEndpointInfo
CreateEndpointInfo
-Methode des Objekts setOperationName
aufrufen und einen Zeichenfolgenwert ü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
-Methode des Objekts aufrufen. setConfigParameterAsText
Um beispielsweise den Konfigurationswert url
festzulegen, rufen Sie die CreateEndpointInfo
-Methode des Objekts setConfigParameterAsText
auf und übergeben Sie die folgenden Zeichenfolgenwerte:
url
url
an.url
den Speicherort des überwachten Ordners an.Informationen zu allen für den EncryptDocument-Dienst festgelegten Konfigurationswerten finden Sie im Java-Codebeispiel unter QuickStart: Hinzufügen eines Endpunkts für den überwachten Ordner mit der Java-API.
Definieren Sie Eingabeparameterwerte.
Definieren Sie einen Eingabeparameterwert, indem Sie die CreateEndpointInfo
-Methode des Objekts setInputParameterMapping
aufrufen und die folgenden Werte übergeben:
InDoc
.InDoc
lautet beispielsweise com.adobe.idp.Document
.variable
angeben.Rufen Sie die setInputParameterMapping
-Methode für jeden zu definierenden Eingabeparameterwert auf. Da der EncryptDocument-Prozess nur einen Eingabeparameter hat, müssen Sie diese Methode einmal aufrufen.
Definieren Sie einen Ausgabeparameterwert.
Definieren Sie einen Ausgabeparameterwert, indem Sie die CreateEndpointInfo
-Methode des Objekts setOutputParameterMapping
aufrufen und die folgenden Werte übergeben:
SecuredDoc
.SecuredDoc
lautet beispielsweise com.adobe.idp.Document
.%F.pdf
angeben.Erstellen Sie einen Endpunkt des Typs "Überwachter Ordner".
Erstellen Sie den Endpunkt, indem Sie die EndpointRegistryClient
-Methode des Objekts createEndpoint
aufrufen und das CreateEndpointInfo
-Objekt übergeben. Diese Methode gibt ein Endpoint
-Objekt zurück, das den Endpunkt des Typs "Überwachter Ordner"darstellt.
Aktivieren Sie den Endpunkt.
Aktivieren Sie den Endpunkt, indem Sie die EndpointRegistryClient
-Methode des Objekts enable
aufrufen und das Endpoint
-Objekt übergeben, das von der createEndpoint
-Methode zurückgegeben wurde.
Siehe auch
QuickStart: Hinzufügen eines Endpunkts für einen überwachten Ordner mithilfe der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Der QuickStart: Beim Hinzufügen eines Endpunkts für den überwachten Ordner mit der Java-API wird eine Konstantendatei verwendet, die Teil Ihres Java-Projekts sein muss, um den schnellen Beginn zu kompilieren. Diese Konstantendatei stellt Konfigurationswerte dar, die beim Hinzufügen eines Endpunkts für den überwachten 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";
}
Sie können einem Dienst programmgesteuert einen E-Mail-Endpunkt hinzufügen, indem Sie die AEM Forms Java API verwenden. Durch Hinzufügen eines E-Mail-Endpunkts können Sie Benutzern das Senden einer E-Mail mit einer oder mehreren Dateianlagen an ein angegebenes E-Mail-Konto ermöglichen. Anschließend wird der Konfigurationsdienst aufgerufen und die Dateien werden verarbeitet. Nachdem der Dienst den angegebenen Vorgang ausgeführt hat, wird eine E-Mail-Nachricht mit den geänderten Dateien als Dateianlagen an den Absender gesendet.
Um einem Dienst programmgesteuert einen E-Mail-Endpunkt hinzuzufügen, beachten Sie den folgenden Prozess mit kurzer Lebensdauer mit dem Namen MyApplication\EncryptDocument. Informationen zu Prozessen mit kurzer Lebensdauer finden Sie unter Die AEM Forms-Prozesse.
Bei diesem Vorgang wird ein unbesichertes PDF-Dokument als Eingabewert akzeptiert und anschließend das unbesicherte PDF-Dokument an den Vorgang EncryptPDFUsingPassword
des Encryption-Dienstes weitergegeben. Dieser Vorgang verschlüsselt das PDF-Dokument mit einem Kennwort und gibt das kennwortverschlüsselte PDF-Dokument als Ausgabenwert zurück. Der Name des Eingabewerts (das ungesicherte PDF-Dokument) ist InDoc
und der Datentyp ist com.adobe.idp.Document
. Der Name des Ausgabewerts (kennwortverschlüsseltes PDF-Dokument) ist SecuredDoc
und der Datentyp ist com.adobe.idp.Document
.
Mit Webdiensten können Sie keinen E-Mail-Endpunkt hinzufügen.
So fügen Sie einem Dienst einen E-Mail-Endpunkt hinzu:
EndpointRegistryClient
-Objekt.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 Proxydateien einschließen.
Die folgenden JAR-Dateien müssen dem Klassenpfad Ihres Projekts hinzugefügt werden:
Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen von AEM Forms Java-Bibliotheksdateien.
EndpointRegistry Client-Objekt erstellen
Bevor Sie programmgesteuert einen E-Mail-Endpunkt hinzufügen können, müssen Sie ein EndpointRegistryClient
-Objekt erstellen.
E-Mail-Endpunktattribute festlegen
Um einen E-Mail-Endpunkt für einen Dienst zu erstellen, geben Sie die folgenden Werte an:
Email
an.EncryptDocument
an.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 angegeben, wenn ein E-Mail-Endpunkt über Administration Console hinzugefügt wird.
Das überwachte E-Mail-Konto ist ein besonderes 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 normalen 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 die Nachrichten abgeschlossen wurden.
Die folgenden Konfigurationswerte werden festgelegt, wenn einem Dienst programmgesteuert ein E-Mail-Endpunkt hinzugefügt wird:
SuperAdmin
.DefaultDom
.adobe.com
verwendet wird, werden nur E-Mails von adobe.com verarbeitet, E-Mails von anderen Domänen ignoriert.*
.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, die jeweils durch ein Komma getrennt werden. Um diese Option zu deaktivieren, lassen Sie diesen Wert leer. 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
.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, die jeweils durch ein Komma getrennt werden. Um diese Option zu deaktivieren, lassen Sie diesen Wert leer. Der Standardwert ist sender
.IMAP
oder POP3
. Der Hostmailserver des Posteingangs muss diese Protokolle unterstützen.UTF-8
.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 zum Beispiel den in diesem Thema eingeführten Prozess. Es hat einen Eingabewert mit dem Namen InDoc
und der Datentyp ist com.adobe.idp.Document
. Wenn Sie einen E-Mail-Endpunkt für diesen Prozess erstellen (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 nicht in Workbench erstellt wurde), 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: Dient zum Konfigurieren der zum Aufrufen des Dienstvorgangs erforderlichen Eingabewerte. Es gibt zwei Arten von Zuordnungstypen:
Literal
: Der E-Mail-Endpunkt verwendet den in das 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, das vom E-Mail-Endpunkt zum Auswählen der Eingabe verwendet wird. Wenn Sie beispielsweise Variable für den Zuordnungstyp auswählen und das Eingabedateien eine PDF-Dokument sein muss, können Sie *.pdf
als Zuordnungswert angeben.Zuordnungswert: Gibt den Wert des Zuordnungstyps an. Wenn Sie beispielsweise einen Variablenzuordnungstyp auswählen, können Sie *.pdf
als Dateimuster angeben.
Datentyp: Gibt den Datentyp der Eingabewerte an. Der Datentyp des Eingabewerts des in diesem Abschnitt eingeführten Prozesses ist beispielsweise com.adobe.idp.Dokument.
Definieren eines Ausgabeparameterwerts
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 zum Beispiel den in diesem Thema eingeführten Prozess. Es hat einen Ausgabewert mit dem Namen SecuredDoc
und der Datentyp ist com.adobe.idp.Document
. Wenn Sie einen E-Mail-Endpunkt für diesen Prozess erstellen (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 (einem Dienst, der nicht in Workbench erstellt wurde), 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: Dient zum Konfigurieren der Ausgabe des Dienstes und Vorgangs. Die folgenden Optionen sind verfügbar:
%F.pdf
und das Quellziel ist sourcefilename.pdf. Beispielsweise gibt der in diesem Abschnitt eingeführte Prozess ein einzelnes Dokument zurück. Daher kann der Zuordnungstyp als %F.pdf
definiert werden ( %F
bedeutet, dass Sie den angegebenen Dateinamen verwenden). Das Muster %E
gibt die Erweiterung des Eingabe-Dokuments an.Result\%F\
und das Quellziel lautet Result\sourcefilename\source1 (output 1) und Result\sourcefilename\source2 (output 2).Result\%F\
und das Quellziel ist Result\sourcefilename\file1 and Result\sourcefilename\file2. Wenn die Map über mehr als ein Objekt verfügt, ist das Muster Result\%F.pdf
und das Quellziel lautet Result\sourcefilename1.pdf (Ausgabe 1), Result\sourcefilenam2.pdf (Ausgabe 2) usw.Datentyp: Gibt den Datentyp des Rückgabewerts an. Der Datentyp des Rückgabewerts des in diesem Abschnitt eingeführten Prozesses ist beispielsweise com.adobe.idp.Document
.
E-Mail-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 Ansicht haben.
Siehe auch
hinzufügen eines E-Mail-Endpunkts mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
hinzufügen eines E-Mail-Endpunkts mithilfe der Java-API:
Schließen Sie Projektdateien ein.
Schließen Sie Client-JAR-Dateien wie "adobe-livecycle-client.jar"im Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein EndpointRegistry Client-Objekt.
ServiceClientFactory
-" -Objekt, das Verbindungseigenschaften enthält.EndpointRegistryClient
-Objekt, indem Sie den Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Festlegen von E-Mail-Endpunktattributen.
CreateEndpointInfo
, indem Sie den Konstruktor verwenden.CreateEndpointInfo
-Methode des Objekts setConnectorId
aufrufen und den Zeichenfolgenwert Email
übergeben.CreateEndpointInfo
-Methode des Objekts setDescription
aufrufen und einen Zeichenfolgenwert übergeben, der den Endpunkt beschreibt.CreateEndpointInfo
-Methode des Objekts setName
aufrufen und einen Zeichenfolgenwert übergeben, der den Namen angibt.setServiceId
-Methode des Objekts aufrufen und einen Zeichenfolgenwert übergeben, der den Dienstnamen angibt.CreateEndpointInfo
CreateEndpointInfo
-Methode des Objekts setOperationName
aufrufen und einen Zeichenfolgenwert ü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.
Damit jeder Konfigurationswert für den E-Mail-Endpunkt festgelegt wird, müssen Sie die setConfigParameterAsText
-Methode des Objekts aufrufen. CreateEndpointInfo
Um beispielsweise den Konfigurationswert smtpHost
festzulegen, rufen Sie die CreateEndpointInfo
-Methode des Objekts setConfigParameterAsText
auf und übergeben Sie die folgenden Werte:
smtpHost
smtpHost
an.smtpHost
einen Zeichenfolgenwert an, der den Namen des SMTP-Servers angibt.Um alle in diesem Abschnitt eingeführten Konfigurationswerte für den EncryptDocument-Dienst anzuzeigen, finden Sie im Java-Codebeispiel unter QuickStart: Hinzufügen eines E-Mail-Endpunkts mit der Java-API.
Definieren Sie Eingabeparameterwerte.
Definieren Sie einen Eingabeparameterwert, indem Sie die CreateEndpointInfo
-Methode des Objekts setInputParameterMapping
aufrufen und die folgenden Werte übergeben:
InDoc
.InDoc
lautet beispielsweise com.adobe.idp.Document
.variable
angeben.Rufen Sie die setInputParameterMapping
-Methode für jeden zu definierenden Eingabeparameterwert auf. Da der EncryptDocument-Prozess nur einen Eingabeparameter hat, müssen Sie diese Methode einmal aufrufen.
Definieren Sie einen Ausgabeparameterwert.
Definieren Sie einen Ausgabeparameterwert, indem Sie die CreateEndpointInfo
-Methode des Objekts setOutputParameterMapping
aufrufen und die folgenden Werte übergeben:
SecuredDoc
.SecuredDoc
lautet beispielsweise com.adobe.idp.Document
.%F.pdf
angeben.Erstellen Sie den E-Mail-Endpunkt.
Erstellen Sie den Endpunkt, indem Sie die EndpointRegistryClient
-Methode des Objekts createEndpoint
aufrufen und das CreateEndpointInfo
-Objekt übergeben. Diese Methode gibt ein Endpoint
-Objekt zurück, das den E-Mail-Endpunkt darstellt.
Aktivieren Sie den Endpunkt.
Aktivieren Sie den Endpunkt, indem Sie die EndpointRegistryClient
-Methode des Objekts enable
aufrufen und das Endpoint
-Objekt übergeben, das von der createEndpoint
-Methode zurückgegeben wurde.
Siehe auch
QuickStart: Hinzufügen eines Endpunkts für einen überwachten Ordner mithilfe der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Der QuickStart: Beim Hinzufügen eines E-Mail-Endpunkts mit der Java-API wird eine Konstantendatei verwendet, die Teil Ihres Java-Projekts sein muss, um den schnellen Beginn zu kompilieren. Diese Konstantendatei stellt Konfigurationswerte dar, die beim Hinzufügen eines E-Mail-Endpunkts festgelegt werden müssen. 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";
}
LiveCycle Remoting-APIs für AEM Forms on JEE nicht mehr unterstützt.
Sie können einem Dienst programmgesteuert einen Remoting-Endpunkt hinzufügen, indem Sie die AEM Forms Java API verwenden. Durch Hinzufügen eines Remoting-Endpunkts aktivieren Sie eine Flex-Anwendung, um den Dienst mithilfe von Remoting aufzurufen. (Siehe Aufrufen von AEM Forms mithilfe von (für AEM Formulare nicht mehr unterstützt) AEM Forms Remoting.)
Zum programmgesteuerten Hinzufügen eines Remoting-Endpunkts zu einem Dienst sollten Sie den folgenden Prozess mit kurzer Lebensdauer mit dem Namen EncryptDocument in Erwägung ziehen.
Bei diesem Vorgang wird ein unbesichertes PDF-Dokument als Eingabewert akzeptiert und anschließend das unbesicherte PDF-Dokument an den Vorgang EncryptPDFUsingPassword
des Encryption-Dienstes weitergegeben. 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) ist InDoc
und der Datentyp ist com.adobe.idp.Document
. Der Name des Ausgabewerts (kennwortverschlüsseltes PDF-Dokument) ist SecuredDoc
und der Datentyp ist com.adobe.idp.Document
.
Um zu zeigen, wie ein Remoting-Endpunkt zu einem Dienst hinzugefügt wird, wird in diesem Abschnitt ein Remoting-Endpunkt zu einem Dienst namens EncryptDocument hinzugefügt.
Mit Webdiensten können Sie keinen Remoting-Endpunkt hinzufügen.
So entfernen Sie einen Endpunkt aus einem Dienst:
EndpointRegistryClient
-Objekt.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 Proxydateien einschließen.
Die folgenden JAR-Dateien müssen dem Klassenpfad Ihres Projekts hinzugefügt werden:
Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen von AEM Forms Java-Bibliotheksdateien.
EndpointRegistry Client-Objekt erstellen
Um einen Remoting-Endpunkt programmgesteuert hinzuzufügen, müssen Sie ein EndpointRegistryClient
-Objekt erstellen.
Remoting-Endpunktattribute festlegen
Um einen Remoting-Endpunkt für einen Dienst zu erstellen, geben Sie die folgenden Werte an:
Remoting
an.EncryptDocument
an.Remoting-Endpunkt erstellen
Nachdem Sie 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, aktiviert er einen Flex-Client, um den Dienst aufzurufen.
Siehe auch
hinzufügen eines Remoting-Endpunkts mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
hinzufügen eines Remoting-Endpunkts mithilfe der Java-API:
Schließen Sie Projektdateien ein.
Schließen Sie Client-JAR-Dateien wie "adobe-livecycle-client.jar"im Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein EndpointRegistry Client-Objekt.
ServiceClientFactory
-" -Objekt, das Verbindungseigenschaften enthält.EndpointRegistryClient
-Objekt, indem Sie den Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Festlegen von Remoting-Endpunktattributen.
CreateEndpointInfo
, indem Sie den Konstruktor verwenden.CreateEndpointInfo
-Methode des Objekts setConnectorId
aufrufen und den Zeichenfolgenwert Remoting
übergeben.CreateEndpointInfo
-Methode des Objekts setDescription
aufrufen und einen Zeichenfolgenwert übergeben, der den Endpunkt beschreibt.CreateEndpointInfo
-Methode des Objekts setName
aufrufen und einen Zeichenfolgenwert übergeben, der den Namen angibt.setServiceId
-Methode des Objekts aufrufen und einen Zeichenfolgenwert übergeben, der den Dienstnamen angibt.CreateEndpointInfo
CreateEndpointInfo
-Methode des Objekts setOperationName
aufgerufen wird, und übergeben Sie einen Zeichenfolgenwert, der den Vorgangsnamen angibt. Geben Sie für einen Remoting-Endpunkt ein Platzhalterzeichen (*) an.Erstellen Sie einen Remoting-Endpunkt.
Erstellen Sie den Endpunkt, indem Sie die EndpointRegistryClient
-Methode des Objekts createEndpoint
aufrufen und das CreateEndpointInfo
-Objekt übergeben. Diese Methode gibt ein Endpoint
-Objekt zurück, das den neuen Remoting-Endpunkt darstellt.
Aktivieren Sie den Endpunkt.
Aktivieren Sie den Endpunkt, indem Sie die EndpointRegistryClient
-Methode des Objekts enable
aufrufen und das Endpoint
-Objekt übergeben, das von der createEndpoint
-Methode zurückgegeben wurde.
Siehe auch
QuickStart: Hinzufügen eines Remoting-Endpunkts mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Sie können einem Dienst programmgesteuert einen TaskManager-Endpunkt hinzufügen, indem Sie die AEM Forms Java API verwenden. Indem Sie einem Dienst einen TaskManager-Endpunkt hinzufügen, aktivieren Sie einen Workspace-Benutzer, um den Dienst aufzurufen. Das heißt, ein in Workspace arbeitender Benutzer kann einen Prozess aufrufen, der über einen entsprechenden TaskManager-Endpunkt verfügt.
Mit Webdiensten können Sie keinen TaskManager-Endpunkt hinzufügen.
So fügen Sie einem Dienst einen TaskManager-Endpunkt hinzu:
EndpointRegistryClient
-Objekt.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 Proxydateien einschließen.
Die folgenden JAR-Dateien müssen dem Klassenpfad Ihres Projekts hinzugefügt werden:
Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen von AEM Forms Java-Bibliotheksdateien.
EndpointRegistry Client-Objekt erstellen
Bevor Sie einen TaskManager-Endpunkt programmgesteuert hinzufügen können, müssen Sie ein EndpointRegistryClient
-Objekt erstellen.
Kategorie für den Endpunkt erstellen
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.
In diesem Abschnitt wird eine neue Kategorie erstellt, um einem Dienst einen TaskManager-Endpunkt hinzuzufügen.
TaskManager-Endpunktattribute festlegen
Um einen TaskManager-Endpunkt für einen Dienst zu erstellen, geben Sie die folgenden Werte an:
TaskManagerConnector
an.invoke
.TaskManager-Endpunkt erstellen
Nachdem Sie die TaskManager-Endpunktattribute festgelegt haben, können Sie einen TaskManager-Endpunkt für einen Dienst 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 in Workspace verwendet werden. Nachdem Sie den Endpunkt aktiviert haben, können Sie ihn in Administration Console Ansicht haben.
Siehe auch
hinzufügen eines TaskManager-Endpunkts mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
hinzufügen eines TaskManager-Endpunkts mithilfe der Java-API:
Schließen Sie Projektdateien ein.
Schließen Sie Client-JAR-Dateien wie "adobe-livecycle-client.jar"im Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein EndpointRegistry Client-Objekt.
ServiceClientFactory
-" -Objekt, das Verbindungseigenschaften enthält.EndpointRegistryClient
-Objekt, indem Sie den Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Erstellen Sie eine Kategorie für den Endpunkt.
Erstellen Sie ein CreateEndpointCategoryInfo
-Objekt, indem Sie den Konstruktor verwenden und die folgenden Werte übergeben:
Erstellen Sie die Kategorie, indem Sie die EndpointRegistryClient
-Objektmethode createEndpointCategory
aufrufen und das CreateEndpointCategoryInfo
-Objekt übergeben. Diese Methode gibt ein EndpointCategory
-Objekt zurück, das die neue Kategorie darstellt.
Legen Sie TaskManager-Endpunktattribute fest.
CreateEndpointInfo
, indem Sie den Konstruktor verwenden.CreateEndpointInfo
-Methode des Objekts setConnectorId
aufrufen und den Zeichenfolgenwert TaskManagerConnector
übergeben.CreateEndpointInfo
-Methode des Objekts setDescription
aufrufen und einen Zeichenfolgenwert übergeben, der den Endpunkt beschreibt.CreateEndpointInfo
-Methode des Objekts setName
aufrufen und einen Zeichenfolgenwert übergeben, der den Namen angibt.setServiceId
-Methode des Objekts aufrufen und einen Zeichenfolgenwert übergeben, der den Dienstnamen angibt.CreateEndpointInfo
setCategoryId
-Methode des Objekts aufrufen und einen Zeichenfolgenwert übergeben, der den Kategorien-ID-Wert angibt. CreateEndpointInfo
Sie können die EndpointCategory
-Objektmethode getId
aufrufen, um den Bezeichnerwert dieser Kategorie abzurufen.CreateEndpointInfo
-Methode des Objekts setOperationName
aufrufen und einen Zeichenfolgenwert übergeben, der den Vorgangsnamen angibt. Beim Erstellen eines TaskManager
-Endpunkts für einen Dienst, der aus einem in Workbench erstellten Prozess stammt, lautet der Name des Vorgangs in der Regel invoke
.Erstellen Sie einen TaskManager-Endpunkt.
Erstellen Sie den Endpunkt, indem Sie die EndpointRegistryClient
-Methode des Objekts createEndpoint
aufrufen und das CreateEndpointInfo
-Objekt übergeben. Diese Methode gibt ein Endpoint
-Objekt zurück, das den neuen TaskManager-Endpunkt darstellt.
Aktivieren Sie den Endpunkt.
Aktivieren Sie den Endpunkt, indem Sie die EndpointRegistryClient
-Methode des Objekts enable
aufrufen und das Endpoint
-Objekt übergeben, das von der createEndpoint
-Methode zurückgegeben wurde.
Siehe auch
QuickStart: Hinzufügen eines TaskManager-Endpunkts mithilfe der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Sie können einen vorhandenen Endpunkt programmgesteuert mithilfe der AEM Forms Java API ä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 überwachter Ordner funktioniert. Weitere Informationen zu Konfigurationswerten, die zu einem Endpunkt des Typs "Überwachter Ordner"gehören, finden Sie unter Hinzufügen von Endpunkten für überwachte Ordner.
Um zu zeigen, wie ein Endpunkt geändert wird, ändert dieser Abschnitt einen Endpunkt des Typs "Überwachter Ordner", indem der Ordner geändert wird, der sich wie der überwachte Ordner verhält.
Sie können einen Endpunkt nicht mithilfe von Webdiensten ändern.
So ändern Sie einen Endpunkt:
EndpointRegistryClient
-Objekt.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 Proxydateien einschließen.
Die folgenden JAR-Dateien müssen dem Klassenpfad Ihres Projekts hinzugefügt werden:
Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen von AEM Forms Java-Bibliotheksdateien.
EndpointRegistry Client-Objekt erstellen
Um einen Endpunkt programmgesteuert zu ändern, müssen Sie ein EndpointRegistryClient
-Objekt erstellen.
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 die Liste durchlaufen und nach dem zu entfernenden Endpunkt suchen. Sie können beispielsweise einen Endpunkt suchen, indem Sie den Dienst festlegen, der dem Endpunkt und dem Endpunkttyp entspricht. Wenn Sie den Endpunkt suchen, können Sie ihn ändern.
Geben Sie neue Konfigurationswerte an
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. Weitere Informationen zu Konfigurationswerten, die zu einem Endpunkt des Typs "Überwachter Ordner"gehören, finden Sie unter Hinzufügen von Endpunkten für überwachte Ordner.
Weitere Informationen zu Konfigurationswerten, die zu einem E-Mail-Endpunkt gehören, finden Sie unter Hinzufügen von E-Mail-Endpunkten.
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 einem bestimmten Endpunkt zugeordneten 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
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Ändern Sie einen Endpunkt mithilfe der Java-API:
Schließen Sie Projektdateien ein.
Schließen Sie Client-JAR-Dateien wie "adobe-livecycle-client.jar"im Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein EndpointRegistry Client-Objekt.
ServiceClientFactory
-" -Objekt, das Verbindungseigenschaften enthält.EndpointRegistryClient
-Objekt, indem Sie den Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Rufen Sie den zu ändernden Endpunkt ab.
getEndpoints
-Objektmethode aufrufen und ein PagingFilter
-Objekt übergeben, das als Filter fungiert. EndpointRegistryClient
Sie können einen (PagingFilter)null
-Wert übergeben, um alle Endpunkte zurückzugeben. Diese Methode gibt ein java.util.List
-Objekt zurück, wobei jedes Element ein Endpoint
-Objekt ist. Weitere Informationen zu einem PagingFilter
-Objekt finden Sie unter AEM Forms API-Referenz.java.util.List
-Objekt, um zu ermitteln, ob es Endpunkte enthält. Wenn Endpunkte vorhanden sind, ist jedes Element eine EndPoint
-Instanz.EndPoint
-Methode des Objekts getServiceId
aufrufen. Diese Methode gibt einen Zeichenfolgenwert zurück, der den Dienstnamen angibt.EndPoint
-Methode des Objekts getConnectorId
aufrufen. 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
zurück.Geben Sie neue Konfigurationswerte an.
Erstellen Sie ein ModifyEndpointInfo
-Objekt, indem Sie den Konstruktor aufrufen.
Rufen Sie für jeden festzulegenden Konfigurationswert die ModifyEndpointInfo
-Methode des Objekts setConfigParameterAsText
auf. Um beispielsweise den URL-Konfigurationswert festzulegen, rufen Sie die ModifyEndpointInfo
-Methode des Objekts setConfigParameterAsText
auf und übergeben Sie die folgenden Werte:
url
festzulegen, geben Sie url
an.url
zu definieren, geben Sie den Speicherort des überwachten Ordners an.Rufen Sie die modifyEndpoint
-Methode des Objekts auf und übergeben Sie das ModifyEndpointInfo
-Objekt.EndpointRegistryClient
Siehe auch
QuickStart: Ändern eines Endpunkts mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Sie können einen Endpunkt programmgesteuert aus einem Dienst entfernen, indem Sie die AEM Forms Java API verwenden. Nachdem Sie einen Endpunkt entfernt haben, kann der Dienst nicht mit der vom Endpunkt aktivierten Aufrufmethode aufgerufen werden. Wenn Sie beispielsweise einen SOAP-Endpunkt aus einem Dienst entfernen, können Sie den Dienst nicht im SOAP-Modus aufrufen.
Um zu demonstrieren, wie ein Endpunkt aus einem Dienst entfernt wird, entfernt dieser Abschnitt einen EJB-Endpunkt aus einem Dienst mit dem Namen EncryptDocument.
Ein Endpunkt kann nicht mithilfe von Webdiensten entfernt werden.
So entfernen Sie einen Endpunkt aus einem Dienst:
EndpointRegistryClient
-Objekt.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 Proxydateien einschließen.
Die folgenden JAR-Dateien müssen dem Klassenpfad Ihres Projekts hinzugefügt werden:
Informationen zum Speicherort dieser JAR-Dateien finden Sie unter Einschließen von AEM Forms Java-Bibliotheksdateien.
EndpointRegistry Client-Objekt erstellen
Um einen Endpunkt programmgesteuert zu entfernen, müssen Sie ein EndpointRegistryClient
-Objekt erstellen.
Den zu entfernenden Endpunkt abrufen
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).
Sie können einen Endpunkt abrufen, indem Sie eine Liste von Endpunkten abrufen. Anschließend können Sie die Liste durchlaufen und nach dem zu entfernenden Endpunkt suchen. Sie können beispielsweise einen Endpunkt suchen, indem Sie den Dienst festlegen, der dem Endpunkt und dem Endpunkttyp entspricht. Wenn Sie den Endpunkt suchen, können Sie ihn entfernen.
Endpunkt entfernen
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 Ansicht haben.
Siehe auch
Entfernen eines Endpunkts mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Entfernen Sie einen Endpunkt mithilfe der Java-API:
Schließen Sie Projektdateien ein.
Schließen Sie Client-JAR-Dateien wie "adobe-livecycle-client.jar"im Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein EndpointRegistry Client-Objekt.
ServiceClientFactory
-" -Objekt, das Verbindungseigenschaften enthält.EndpointRegistryClient
-Objekt, indem Sie den Konstruktor verwenden und das ServiceClientFactory
-Objekt übergeben.Rufen Sie den zu entfernenden Endpunkt ab.
getEndpoints
-Objektmethode aufrufen und ein PagingFilter
-Objekt übergeben, das als Filter fungiert. EndpointRegistryClient
Sie können (PagingFilter)null
übergeben, um alle Endpunkte zurückzugeben. Diese Methode gibt ein java.util.List
-Objekt zurück, wobei jedes Element ein Endpoint
-Objekt ist.java.util.List
-Objekt, um zu ermitteln, ob es Endpunkte enthält. Wenn Endpunkte vorhanden sind, ist jedes Element eine EndPoint
-Instanz.EndPoint
-Methode des Objekts getServiceId
aufrufen. Diese Methode gibt einen Zeichenfolgenwert zurück, der den Dienstnamen angibt.EndPoint
-Methode des Objekts getConnectorId
aufrufen. 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
zurück.Entfernen Sie den Endpunkt.
Entfernen Sie den Endpunkt, indem Sie die EndpointRegistryClient
-Methode des Objekts remove
aufrufen und das EndPoint
-Objekt übergeben, das den zu entfernenden Endpunkt darstellt.
Siehe auch
QuickStart: Entfernen eines Endpunkts mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Mit der AEM Forms API können Sie programmgesteuert Informationen zu Endpunktschnittstellen abrufen. Ein Connector ermöglicht es einem Endpunkt, einen Dienst mit verschiedenen Aufrufmethoden aufzurufen. Ein Connector für überwachte Ordner ermöglicht es beispielsweise einem Endpunkt, einen Dienst mit überwachten Ordnern aufzurufen. Durch programmgesteuertes Abrufen von Informationen zu Endpunktschnittstellen können Sie Konfigurationswerte abrufen, die mit einem Connector verknüpft sind, z. B. welche Konfigurationswerte erforderlich sind und welche optional sind.
In diesem Abschnitt wird veranschaulicht, wie Informationen zu Endpunktschnittstellen abgerufen werden, und es werden Informationen zu einem Connector für überwachte Ordner abgerufen. (Siehe Hinzufügen von Endpunkten für überwachte Ordner.)
Mit Webdiensten können Sie keine Informationen zu Endpunkten abrufen.
Dieses Thema verwendet die API ConnectorRegistryClient
, um Informationen zu Endpunktschnittstellen abzurufen. (Siehe AEM Forms API Reference.)
So rufen Sie Endpunktschnittstelleninformationen ab:
ConnectorRegistryClient
-Objekt.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 Proxydateien einschließen.
Die folgenden JAR-Dateien müssen dem Klassenpfad Ihres Projekts hinzugefügt werden:
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 für den J2EE-Anwendungsserver spezifisch 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.
ConnectorRegistry-Client-Objekt erstellen
Um Endpunktschnittstelleninformationen programmgesteuert abzurufen, erstellen Sie ein ConnectorRegistryClient
-Objekt.
Angeben des Connector-Typs
Geben Sie den Connector-Typ an, von dem Informationen abgerufen werden sollen. Die folgenden Arten von Connectors sind vorhanden:
Konfigurationswerte abrufen
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 und welche optional sind.
Siehe auch
Abrufen von Endpunktschnittstellenverbindungsinformationen mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen
Rufen Sie Endpunktschnittstellenverbindungsinformationen mithilfe der Java-API ab:
Schließen Sie Projektdateien ein. .
Schließen Sie Client-JAR-Dateien wie "adobe-livecycle-client.jar"im Klassenpfad Ihres Java-Projekts ein.
Erstellen Sie ein ConnectorRegistry-Client-Objekt.
ServiceClientFactory
-" -Objekt, das Verbindungseigenschaften enthält.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
-Methode des Objekts getEndpointDefinition
aufrufen und einen Zeichenfolgenwert übergeben, der den Connector-Typ angibt. Um beispielsweise den Connector-Typ für den überwachten Ordner anzugeben, übergeben Sie den Zeichenfolgenwert WatchedFolder
. Diese Methode gibt ein Endpoint
-Objekt zurück, das dem Connector-Typ entspricht.
Rufen Sie Konfigurationswerte ab.
getConfigParameters
-Methode des Objekts aufrufen. Endpoint
Diese Methode gibt ein Array von ConfigParameter
-Objekten zurück.ConfigParameter
-Objekt. Sie können beispielsweise bestimmen, ob der Konfigurationswert erforderlich oder optional ist, indem Sie die isRequired
-Methode des Objekts aufrufen. ConfigParameter
Wenn der Konfigurationswert erforderlich ist, gibt diese Methode true
zurück.Siehe auch
QuickStart: Abrufen von Endpunktschnittstellenverbindungsinformationen mit der Java-API
Einbeziehung von AEM Forms Java-Bibliotheksdateien
Verbindungseigenschaften festlegen