Info over Endpoint Registry Service
De dienst van de Registratie van het Eindpunt verstrekt de capaciteit om eindpunten programmatically te beheren. U kunt, bijvoorbeeld, de volgende types van eindpunten aan de dienst toevoegen:
EJB
SOAP
Controlemap
(Verouderd voor AEM formulieren) Verwijderen
Taakbeheer
SOAP, EJB, en (Vervangen voor AEM vormen op JEE) het verwijderen eindpunten worden automatisch gecreeerd voor elke geactiveerde dienst. De eindpunten SOAP en EJB laten ZEEP en EJB voor alle de dienstverrichtingen toe.
Een Remoting eindpunt laat de cliënten van Flex toe om verrichtingen op de dienst van AEM Forms aan te halen die het eindpunt aan wordt toegevoegd. Een bestemming van Flex met de zelfde naam zoals het eindpunt wordt gecreeerd en de cliënten van Flex kunnen tot RemoteObjects leiden die aan deze bestemming richten om verrichtingen op de relevante dienst aan te halen.
De e-mail, de Manager van de Taak, en de Gecontroleerde eindpunten van de Omslag stellen slechts een specifieke verrichting van de dienst bloot. Het toevoegen van deze eindpunten vereist een tweede configuratiestap om een methode te selecteren om te roepen, configuratieparameters te plaatsen, en input en outputparameterafbeeldingen te specificeren.
U kunt eindpunten TaskManager in groepen organiseren genoemd categorieën. Deze categorieën worden dan blootgesteld aan Werkruimte door TaskManager, met eind - de gebruikers zien de eindpunten TaskManager aangezien zij worden gecategoriseerd. In Workspace zien eindgebruikers deze categorieën in het navigatievenster. De eindpunten binnen elke categorie worden weergegeven als proceskaarten op de pagina Processen starten in Workspace.
U kunt deze taken verwezenlijken gebruikend de dienst van de Registratie van het Eindpunt:
EJB-eindpunten toevoegen. (Zie EJB-eindpunten toevoegen.)
Voeg de eindpunten van de ZEEP toe. (Zie SOAP-eindpunten toevoegen.)
Onderbrekingspunten van gecontroleerde mappen toevoegen (zie Toegevoegde eindpunten van mappen toevoegen.)
E-maileindpunten toevoegen. (Zie E-maileindpunten toevoegen.)
Voeg eindpunten voor verwijderen toe. (Zie Eindpunten toevoegen.)
Voeg eindpunten TaskManager toe (zie Het toevoegen van Eindpunten TaskManager.)
Eindpunten wijzigen (Zie Eindpunten wijzigen.)
Eindpunten verwijderen (zie Eindpunten verwijderen.)
Haal de informatie van de eindpuntschakelaar op (Zie Gegevens van eindpuntconnector ophalen.)
U kunt programmatically een eindpunt EJB aan de dienst toevoegen door AEM Forms Java API te gebruiken. Door een eindpunt EJB aan de dienst toe te voegen, laat u een cliënttoepassing toe om de dienst aan te halen door de wijze te gebruiken EJB. Met andere woorden, wanneer u verbindingseigenschappen instelt die nodig zijn om AEM Forms aan te roepen, kunt u de EJB-modus selecteren. (Zie Verbindingseigenschappen instellen.)
U kunt geen EJB eindpunt toevoegen door de Webdiensten te gebruiken.
Typisch, wordt een eindpunt EJB toegevoegd aan de dienst door gebrek, echter, kan een eindpunt EJB aan een proces worden toegevoegd dat programmatically wordt opgesteld of wanneer een eindpunt EJB werd verwijderd en opnieuw moet worden toegevoegd.
Om een eindpunt EJB aan de dienst toe te voegen, voer de volgende taken uit:
EndpointRegistry Client
-object.Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:
Zie Including AEM Forms Java-bibliotheekbestanden voor informatie over de locatie van deze JAR-bestanden.
Een EndpointRegistry-client-object maken
Voordat u een EJB-eindpunt programmatisch kunt toevoegen, moet u een EndpointRegistryClient
-object maken.
EJB-eindpuntkenmerken instellen
Om een EJB eindpunt voor de dienst tot stand te brengen, specificeer de volgende waarden:
EJB
op.*
). Nochtans, als u een specifieke verrichting in tegenstelling tot het aanhalen van alle de dienstverrichtingen wilt specificeren, specificeer de naam van de verrichting in plaats van het gebruiken van het vervangingskarakter ( *
).Een EJB-eindpunt maken
Nadat u EJB eindpuntattributen plaatst, kunt u een eindpunt EJB voor de dienst tot stand brengen.
Het eindpunt inschakelen
Nadat u een nieuw eindpunt creeert, moet u het toelaten. Nadat u het eindpunt toelaat, kan het worden gebruikt om de dienst aan te halen. Nadat u het eindpunt toelaat, kunt u het binnen beleidsconsole bekijken.
Zie ook
Een EJB-eindpunt toevoegen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Voeg een EJB eindpunt toe door Java API te gebruiken:
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project. (
Creeer een voorwerp van de Cliënt EndpointRegistry.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.EndpointRegistryClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.EJB-eindpuntkenmerken instellen.
CreateEndpointInfo
-object met de constructor ervan.setConnectorId
van het object CreateEndpointInfo
aan te roepen en de tekenreekswaarde EJB
door te geven.setDescription
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die het eindpunt beschrijft.setName
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de naam opgeeft.setServiceId
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de servicenaam opgeeft.setOperationName
van het object CreateEndpointInfo
aan te roepen en geef een tekenreekswaarde door die de naam van de bewerking opgeeft. Voor de eindpunten van de ZEEP en EJB, specificeer een vervangingskarakter ( *
), dat alle verrichtingen impliceert.Maak een EJB-eindpunt.
Maak het eindpunt door de methode createEndpoint
van het object EndpointRegistryClient
aan te roepen en het object CreateEndpointInfo
door te geven. Deze methode keert een Endpoint
voorwerp terug dat het nieuwe eindpunt EJB vertegenwoordigt.
Laat het eindpunt toe.
Schakel het eindpunt in door de methode Enable van het EndpointRegistryClient
-object aan te roepen en het object Endpoint
door te geven dat door de methode createEndpoint
is geretourneerd.
Zie ook
QuickStart: Een EJB-eindpunt toevoegen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
U kunt programmatically een eindpunt van de ZEEP aan de dienst toevoegen door AEM Forms Java API te gebruiken. Door een eindpunt van de ZEEP toe te voegen, laat u een cliënttoepassing toe om de dienst aan te halen door de wijze van de ZEEP te gebruiken. Met andere woorden, wanneer u verbindingseigenschappen instelt die nodig zijn om AEM Forms aan te roepen, kunt u de SOAP-modus selecteren.
U kunt geen eindpunt van de ZEEP toevoegen door de Webdiensten te gebruiken.
Typisch, wordt een eindpunt van de ZEEP toegevoegd aan de dienst door gebrek, echter, kan een eindpunt van de ZEEP aan een proces worden toegevoegd dat programmatically wordt opgesteld of wanneer een eindpunt van de ZEEP werd verwijderd en opnieuw moet worden toegevoegd.
Om een eindpunt van de ZEEP aan de dienst toe te voegen, voer de volgende taken uit:
EndpointRegistryClient
-object.Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u de proxybestanden opnemen.
De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:
Deze JAR-bestanden zijn vereist om een SOAP-eindpunt te maken. Nochtans, vereist u toevoegingsJAR dossiers als u het eindpunt van de ZEEP gebruikt om de dienst aan te halen. Zie AEM Forms Java-bibliotheekbestanden opnemen voor informatie over AEM Forms JAR-bestanden.
Een EndpointRegistry-client-object maken
Om een eindpunt van de ZEEP aan de dienst programmatically toe te voegen, moet u een EndpointRegistryClient
voorwerp tot stand brengen.
Kenmerken van SOAP-eindpunt instellen
Om een eindpunt van de ZEEP aan de dienst toe te voegen, specificeer de volgende waarden:
SOAP
.*
). Nochtans, als u een specifieke verrichting in tegenstelling tot het aanhalen van alle de dienstverrichtingen wilt specificeren, specificeer de naam van de verrichting in plaats van het gebruiken van het vervangingskarakter ( *
).Een SOAP-eindpunt maken
Nadat u de eigenschappen van het eindpunt van de ZEEP plaatst, kunt u een eindpunt van de ZEEP tot stand brengen.
Het eindpunt inschakelen
Nadat u een nieuw eindpunt creeert, moet u het toelaten. Wanneer het eindpunt wordt toegelaten, kan het worden gebruikt om de dienst aan te halen. Nadat u het eindpunt toelaat, kunt u het binnen beleidsconsole bekijken.
Zie ook
Een SOAP-eindpunt toevoegen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Voeg een eindpunt van de ZEEP aan de dienst toe door Java API te gebruiken:
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project.
Creeer een voorwerp van de Cliënt EndpointRegistry.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.EndpointRegistryClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Stel de kenmerken voor het SOAP-eindpunt in.
CreateEndpointInfo
-object met de constructor ervan.setConnectorId
van het object CreateEndpointInfo
aan te roepen en de tekenreekswaarde SOAP
door te geven.setDescription
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die het eindpunt beschrijft.setName
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de naam opgeeft.setServiceId
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de servicenaam opgeeft.setOperationName
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de naam van de bewerking aangeeft. Voor de eindpunten van de ZEEP en EJB, specificeer een vervangingskarakter ( *
), dat alle verrichtingen impliceert.Creeer een eindpunt van de ZEEP.
Maak het eindpunt door de methode createEndpoint
van het object EndpointRegistryClient
aan te roepen en het object CreateEndpointInfo
door te geven. Deze methode keert een Endpoint
voorwerp terug dat het nieuwe eindpunt van de ZEEP vertegenwoordigt.
Laat het eindpunt toe.
Schakel het eindpunt in door de methode Enable van het EndpointRegistryClient
-object aan te roepen en geef het object Endpoint
door dat door de methode createEndpoint
is geretourneerd.
Zie ook
QuickStart: Een SOAP-eindpunt toevoegen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
U kunt programmatically een Gecontroleerd eindpunt van de Omslag aan de dienst toevoegen door AEM Forms Java API te gebruiken. Als u een eindpunt van een gecontroleerde map toevoegt, kunnen gebruikers een bestand (zoals een PDF-bestand) in een map plaatsen. Wanneer het dossier in de omslag wordt geplaatst, wordt de gevormde dienst dan aangehaald en manipuleert het dossier. Nadat de service de opgegeven bewerking heeft uitgevoerd, wordt het gewijzigde bestand opgeslagen in een opgegeven uitvoermap. Een gecontroleerde map is geconfigureerd om te worden gescand met een vast interval of met een uitsnijdschema, zoals elke maandag, woensdag en vrijdag om 12.00 uur.
Voor programmatically het toevoegen van een Gecontroleerd eindpunt van de Omslag aan de dienst, overweeg het volgende kortstondige proces genoemd EncryptDocument. (Zie AEM Forms-processen begrijpen.)
Dit proces accepteert een onbeveiligd PDF-document als een invoerwaarde en geeft het onbeveiligde PDF-document vervolgens door aan de EncryptPDFUsingPassword
-bewerking van de Coderingsservice. Het PDF-document wordt versleuteld met een wachtwoord en het PDF-document met een wachtwoord is de uitvoerwaarde van dit proces. De naam van de invoerwaarde (het onbeveiligde PDF-document) is InDoc
en het gegevenstype is com.adobe.idp.Document
. De naam van de uitvoerwaarde (het met een wachtwoord gecodeerde PDF-document) is SecuredDoc
en het gegevenstype is com.adobe.idp.Document
.
U kunt geen Gecontroleerd eindpunt van de Omslag toevoegen door de Webdiensten te gebruiken.
Voer de volgende taken uit om een eindpunt van een gecontroleerde map aan de service toe te voegen:
EndpointRegistryClient
-object.Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u de proxybestanden opnemen.
De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:
Zie Including AEM Forms Java-bibliotheekbestanden voor informatie over de locatie van deze JAR-bestanden.
Een EndpointRegistry-client-object maken
Als u programmatisch een eindpunt van een gecontroleerde map wilt toevoegen, moet u een EndpointRegistryClient
-object maken.
Kenmerken voor het eindpunt van gecontroleerde mappen instellen
Om een Gecontroleerd eindpunt van de Omslag voor de dienst tot stand te brengen, specificeer de volgende waarden:
WatchedFolder
.EncryptDocument
.invoke
.Configuratiewaarden opgeven
U moet configuratiewaarden voor een Gecontroleerd eindpunt van de Omslag specificeren wanneer programmatically het toevoegen van een Gecontroleerd eindpunt van de Omslag aan de dienst. Deze configuratiewaarden worden gespecificeerd door een beheerder als een Gecontroleerd eindpunt van de Omslag door beleidsconsole wordt toegevoegd te gebruiken.
De volgende lijst specificeert configuratiewaarden die wanneer programmatically het toevoegen van een Gecontroleerd eindpunt van de Omslag aan de dienst worden geplaatst:
data*
is, worden niet alle bestanden en mappen opgehaald die overeenkomen met data*
. Dit omvat bestanden en mappen met de naam data1
, data2
enzovoort. Bovendien kan het patroon met vervangingspatronen worden aangevuld om dossierpatronen te specificeren. De gecontroleerde omslag wijzigt de regelmatige uitdrukking om vervangingspatronen zoals *.*
en *.pdf
te steunen. Deze jokertekenpatronen worden niet ondersteund door reguliere expressies.*
is, worden alle bestanden en mappen opgehaald die overeenkomen met input*
. Dit omvat bestanden en mappen met de naam input1
, input2
enzovoort. De standaardwaarde is *
. Deze waarde geeft alle bestanden en mappen aan. Bovendien kan het patroon met vervangingspatronen worden aangevuld om dossierpatronen te specificeren. De gecontroleerde omslag wijzigt de regelmatige uitdrukking om vervangingspatronen zoals *.*
en *.pdf
te steunen. Deze jokertekenpatronen worden niet ondersteund door reguliere expressies. Deze waarde is verplicht.result/%Y/%M/%D/
. Dit is de resultatenmap in de controlemap.preserve/%Y/%M/%D/
.failure/%Y/%M/%D/
.Invoerparameterwaarden definiëren
Wanneer u een eindpunt van een gecontroleerde map maakt, moet u parameterwaarden voor invoer definiëren. U moet dus de invoerwaarden beschrijven die worden doorgegeven aan de bewerking die wordt aangeroepen door de gecontroleerde map. Neem bijvoorbeeld het proces dat in dit onderwerp is geïntroduceerd. Het heeft één inputwaarde genoemd InDoc
en zijn gegevenstype is com.adobe.idp.Document
. Wanneer u een eindpunt van een gecontroleerde map voor dit proces maakt (nadat een proces is geactiveerd, wordt het een service), moet u de waarde van de invoerparameter definiëren.
Als u parameterwaarden voor invoer wilt definiëren die vereist zijn voor het eindpunt van een gecontroleerde map, geeft u de volgende waarden op:
Naam invoerparameter: De naam van de invoerparameter. De naam van een inputwaarde wordt gespecificeerd in Workbench voor een proces. Als de inputwaarde tot een de dienstverrichting (de dienst behoort die geen proces is dat in Workbench wordt gecreeerd), wordt de inputnaam gespecificeerd in het component.xml- dossier. De naam van de invoerparameter voor het proces dat in deze sectie wordt geïntroduceerd, is bijvoorbeeld InDoc
.
Type toewijzing: Gebruikt om de inputwaarden te vormen die worden vereist om de de dienstverrichting aan te halen. Er zijn twee typen toewijzingen:
Literal
: Het eindpunt van de Gecontroleerde Omslag gebruikt de waarde ingegaan op het gebied aangezien het wordt getoond. Alle basistypen van Java worden ondersteund. Als een API bijvoorbeeld invoer gebruikt zoals String, long, int en Boolean, wordt de tekenreeks omgezet in het juiste type en wordt de service aangeroepen.Variable
: De ingevoerde waarde is een bestandspatroon waarmee de gecontroleerde map de invoer kan selecteren. Als u bijvoorbeeld Variabele selecteert voor het toewijzingstype en het invoerdocument moet een PDF-bestand zijn, kunt u *.pdf
opgeven als toewijzingswaarde.Toewijzingswaarde: Hiermee wordt de waarde van het toewijzingstype opgegeven. Als u bijvoorbeeld een toewijzingstype Variable
selecteert, kunt u *.pdf
opgeven als bestandspatroon.
Gegevenstype: Hiermee wordt het gegevenstype van de invoerwaarde(n) opgegeven. Het gegevenstype van de invoerwaarde van het proces dat in deze sectie wordt geïntroduceerd, is bijvoorbeeld com.adobe.idp.Document
.
Een uitvoerparameterwaarde definiëren
Wanneer u een eindpunt van een gecontroleerde map maakt, moet u een uitvoerparameterwaarde definiëren. Namelijk moet u de outputwaarde beschrijven die door de dienst is teruggekeerd die door het Gecontroleerde eindpunt van de Omslag wordt aangehaald. Neem bijvoorbeeld het proces dat in dit onderwerp is geïntroduceerd. Het heeft een outputwaarde genoemd SecuredDoc
en zijn gegevenstype is com.adobe.idp.Document
. Wanneer het creëren van een Gecontroleerd eindpunt van de Omslag voor dit proces (nadat een proces wordt geactiveerd, wordt het een dienst), moet u de waarde van de outputparameter bepalen.
Geef de volgende waarden op om een uitvoerparameterwaarde te definiëren die vereist is voor het eindpunt van een gecontroleerde map:
Naam uitvoerparameter: De naam van de uitvoerparameter. De naam van een waarde voor de procesuitvoer wordt opgegeven in Workbench. Als de outputwaarde tot een de dienstverrichting (de dienst behoort die geen proces is dat in Workbench wordt gecreeerd), wordt de outputnaam gespecificeerd in het component.xml- dossier. De naam van de uitvoerparameter voor het proces dat in deze sectie wordt geïntroduceerd, is bijvoorbeeld SecuredDoc
.
Type toewijzing: Gebruikt om de output van de dienst en de verrichting te vormen. De volgende opties zijn beschikbaar:
%F.pdf
en is de bronbestemming sourcefilename.pdf. Het in deze sectie geïntroduceerde proces retourneert bijvoorbeeld één document. Als gevolg hiervan kan het toewijzingstype worden gedefinieerd als %F.pdf
( %F
betekent gebruik van de opgegeven bestandsnaam). Met het patroon %E
wordt de extensie van het invoerdocument aangegeven.Result\%F\
en is de bronbestemming Result\sourcefilename\source1 (uitvoer 1) en Result\sourcefilename\source2 (uitvoer 2).Result\%F\
en is de bronbestemming Result\sourcefilename\file1 and Result\sourcefilename\file2. Als de kaart meer dan één voorwerp heeft, is het patroon Result\%F.pdf
en de bronbestemming is Result\sourcefilename1.pdf (output 1), Result\sourcefilenam2.pdf (output 2), etc.Gegevenstype: Hiermee wordt het gegevenstype van de geretourneerde waarde opgegeven. Het gegevenstype van de geretourneerde waarde van het proces dat in deze sectie wordt geïntroduceerd, is bijvoorbeeld com.adobe.idp.Document
.
Een eindpunt van een gecontroleerde map maken
Nadat u de attributen van het eindpunt, configuratiewaarden, en de waarden van input en outputparameter plaatst, moet u het Gecontroleerde eindpunt van de Omslag tot stand brengen.
Het eindpunt inschakelen
Nadat u een Gecontroleerd eindpunt van de Omslag creeert, moet u het toelaten. Wanneer het eindpunt wordt toegelaten, kan het worden gebruikt om de dienst aan te halen. Nadat u het eindpunt toelaat, kunt u het binnen beleidsconsole bekijken.
Zie ook
Het eindpunt van een gecontroleerde map toevoegen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Voeg een Gecontroleerd eindpunt van de Omslag toe door AEM Forms Java API te gebruiken:
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project.
Creeer een voorwerp van de Cliënt EndpointRegistry.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.EndpointRegistryClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Attributen voor het eindpunt van gecontroleerde map instellen.
CreateEndpointInfo
-object met de constructor ervan.setConnectorId
van het object CreateEndpointInfo
aan te roepen en de tekenreekswaarde WatchedFolder
door te geven.setDescription
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die het eindpunt beschrijft.setName
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de naam opgeeft.setServiceId
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de servicenaam opgeeft.setOperationName
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de naam van de bewerking aangeeft. Typisch, wanneer het creëren van een Gecontroleerd eindpunt van de Omslag voor de dienst die uit een proces voortkwam dat in Workbench wordt gecreeerd, wordt de naam van de verrichting aangeroepen.Geef configuratiewaarden op.
Voor elke configuratiewaarde die voor het Gecontroleerde eindpunt van de Omslag moet worden geplaatst, moet u de CreateEndpointInfo
methode van het voorwerp setConfigParameterAsText
aanhalen. Als u bijvoorbeeld de configuratiewaarde url
wilt instellen, roept u de methode setConfigParameterAsText
van het object CreateEndpointInfo
op en geeft u de volgende tekenreekswaarden door:
url
configuratiewaarde, specificeer url
.url
de locatie van de gecontroleerde map op.Als u alle configuratiewaarden wilt zien die zijn ingesteld voor de EncryptDocument-service, raadpleegt u het Java-codevoorbeeld dat zich bevindt op QuickStart: Het toevoegen van een Gecontroleerd eindpunt van de Omslag gebruikend Java API.
Definieer invoerparameterwaarden.
Definieer een invoerparameterwaarde door de methode setInputParameterMapping
van het object CreateEndpointInfo
aan te roepen en de volgende waarden door te geven:
InDoc
.InDoc
is bijvoorbeeld com.adobe.idp.Document
.variable
opgeven.Roep de methode setInputParameterMapping
aan voor elke invoerparameterwaarde die moet worden gedefinieerd. Omdat het EncryptDocument-proces slechts één invoerparameter heeft, moet u deze methode eenmaal aanroepen.
Definieer een uitvoerparameterwaarde.
Definieer een uitvoerparameterwaarde door de methode setOutputParameterMapping
van het object CreateEndpointInfo
aan te roepen en de volgende waarden door te geven:
SecuredDoc
.SecuredDoc
is bijvoorbeeld com.adobe.idp.Document
.%F.pdf
opgeven.Creeer een Gecontroleerd eindpunt van de Omslag.
Maak het eindpunt door de methode createEndpoint
van het object EndpointRegistryClient
aan te roepen en het object CreateEndpointInfo
door te geven. Deze methode retourneert een Endpoint
-object dat het eindpunt van de gecontroleerde map vertegenwoordigt.
Laat het eindpunt toe.
Schakel het eindpunt in door de methode enable
van het object EndpointRegistryClient
aan te roepen en het object Endpoint
door te geven dat door de methode createEndpoint
is geretourneerd.
Zie ook
QuickStart: Een eindpunt van een gecontroleerde map toevoegen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
De QuickStart: Als u een eindpunt van een gecontroleerde map toevoegt met de Java API, wordt een constant bestand gebruikt dat deel moet uitmaken van uw Java-project om de snelle start te kunnen compileren. Dit constante dossier vertegenwoordigt configuratiewaarden die moeten worden geplaatst wanneer het toevoegen van een Gecontroleerd eindpunt van de Omslag. De volgende Java-code vertegenwoordigt het constante bestand.
/**
* 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";
}
U kunt programmatically een eindpunt E-mail aan de dienst toevoegen door AEM Forms Java API te gebruiken. Door een e-maileindpunt toe te voegen, laat u gebruikers toe om een e-mailbericht met één of meerdere dossiergehechtheid naar een gespecificeerde e-mailrekening te verzenden. Dan vormen de de dienstverrichting wordt aangehaald en manipuleert de dossiers. Nadat de service de opgegeven bewerking heeft uitgevoerd, stuurt het een e-mailbericht naar de afzender met de gewijzigde bestanden als bestandsbijlagen.
Voor programmatically het toevoegen van een E-maileindpunt aan de dienst, overweeg het volgende kortstondige proces genoemd MyApplication \ EncryptDocument. Zie AEM Forms-processen begrijpen voor informatie over kortstondige processen.
Dit proces accepteert een onbeveiligd PDF-document als een invoerwaarde en geeft het onbeveiligde PDF-document vervolgens door aan de EncryptPDFUsingPassword
-bewerking van de Coderingsservice. Met dit proces wordt het PDF-document versleuteld met een wachtwoord en wordt het met een wachtwoord gecodeerde PDF-document als de uitvoerwaarde geretourneerd. De naam van de invoerwaarde (het onbeveiligde PDF-document) is InDoc
en het gegevenstype is com.adobe.idp.Document
. De naam van de uitvoerwaarde (het met een wachtwoord gecodeerde PDF-document) is SecuredDoc
en het gegevenstype is com.adobe.idp.Document
.
U kunt geen eindpunt E-mail toevoegen door de Webdiensten te gebruiken.
Om een E-maileindpunt aan de dienst toe te voegen, voer de volgende taken uit:
EndpointRegistryClient
-object.Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u de proxybestanden opnemen.
De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:
Zie Including AEM Forms Java-bibliotheekbestanden voor informatie over de locatie van deze JAR-bestanden.
Een EndpointRegistry-client-object maken
Voordat u een e-maileindpunt kunt toevoegen, moet u een EndpointRegistryClient
-object maken.
Kenmerken voor e-maileindpunten instellen
Om een E-maileindpunt voor de dienst tot stand te brengen, specificeer de volgende waarden:
Email
op.EncryptDocument
op.invoke
.Configuratiewaarden opgeven
U moet configuratiewaarden voor een E-mail eindpunt specificeren wanneer programmatically het toevoegen van een E-mail eindpunt aan de dienst. Deze configuratiewaarden worden gespecificeerd door een beheerder als een E-maileindpunt gebruikend beleidsconsole wordt toegevoegd.
De e-mailrekening die wordt gecontroleerd is een speciale rekening die voor het E-maileindpunt slechts wordt gebruikt. Dit account is geen gewoon e-mailaccount voor gebruikers. Een e-mailaccount van een normale gebruiker mag niet worden geconfigureerd als de account die de e-mailprovider gebruikt, omdat de e-mailprovider e-mailberichten verwijdert uit het Postvak IN nadat deze zijn voltooid met de berichten.
De volgende configuratiewaarden worden geplaatst wanneer programmatically het toevoegen van een E-maileindpunt aan de dienst:
SuperAdmin
.DefaultDom
.adobe.com
wordt gebruikt, wordt alleen e-mail van adobe.com verwerkt en wordt e-mail van andere domeinen genegeerd.*
.sender
typt, worden de e-mailresultaten verzonden naar de afzender. Er worden maximaal 100 ontvangers ondersteund. Geef extra ontvangers op met e-mailadressen, die elk worden gescheiden door een komma. Laat deze waarde leeg als u deze optie wilt uitschakelen. In sommige gevallen wilt u wellicht een proces activeren en geen e-mailmelding van het resultaat. De standaardwaarde is sender
.sender
typt, worden de e-mailresultaten verzonden naar de afzender. Er worden maximaal 100 ontvangers ondersteund. Geef extra ontvangers op met e-mailadressen, die elk worden gescheiden door een komma. Laat deze waarde leeg als u deze optie wilt uitschakelen. De standaardwaarde is sender
.IMAP
of POP3
. De postserver van de inbox gastheer moet deze protocollen steunen.UTF-8
.Invoerparameterwaarden definiëren
Wanneer u een e-maileindpunt maakt, moet u parameterwaarden voor invoer definiëren. Namelijk moet u de inputwaarden beschrijven die tot de verrichting worden overgegaan die door het E-maileindpunt wordt aangehaald. Neem bijvoorbeeld het proces dat in dit onderwerp is geïntroduceerd. Het heeft één inputwaarde genoemd InDoc
en zijn gegevenstype is com.adobe.idp.Document
. Wanneer het creëren van een E-mail eindpunt voor dit proces (nadat een proces wordt geactiveerd, wordt het de dienst), moet u de waarde van de inputparameter bepalen.
Als u parameterwaarden voor invoer wilt definiëren die vereist zijn voor een e-maileindpunt, geeft u de volgende waarden op:
Naam invoerparameter: De naam van de invoerparameter. De naam van een inputwaarde wordt gespecificeerd in Workbench voor een proces. Als de inputwaarde tot een de dienstverrichting (de dienst van Forms die geen proces is in Workbench wordt gecreeerd) behoort, wordt de inputnaam gespecificeerd in het component.xml- dossier. De naam van de invoerparameter voor het proces dat in deze sectie wordt geïntroduceerd, is bijvoorbeeld InDoc
.
Type toewijzing: Gebruikt om de inputwaarden te vormen die worden vereist om de de dienstverrichting aan te halen. Er zijn twee soorten toewijzingstypen:
Literal
: Het eindpunt E-mail gebruikt de waarde ingegaan in het gebied aangezien het wordt getoond. Alle basistypen van Java worden ondersteund. Als een API bijvoorbeeld invoer gebruikt zoals String, long, int en Boolean, wordt de tekenreeks omgezet in het juiste type en wordt de service aangeroepen.Variable
: De ingevoerde waarde is een bestandspatroon waarmee het e-maileindpunt de invoer kiest. Als u bijvoorbeeld Variabele selecteert voor het toewijzingstype en het invoerdocument moet een PDF-bestand zijn, kunt u *.pdf
opgeven als toewijzingswaarde.Toewijzingswaarde: Hiermee wordt de waarde van het toewijzingstype opgegeven. Als u bijvoorbeeld een toewijzingstype Variabele selecteert, kunt u *.pdf
opgeven als bestandspatroon.
Gegevenstype: Hiermee geeft u het gegevenstype van de invoerwaarden op. Het gegevenstype van de invoerwaarde van het proces dat in deze sectie wordt geïntroduceerd, is bijvoorbeeld com.adobe.idp.Document.
Een uitvoerparameterwaarde definiëren
Wanneer u een e-maileindpunt maakt, moet u een uitvoerparameterwaarde definiëren. Namelijk moet u de outputwaarde beschrijven die door de dienst is teruggekeerd die door het E-maileindpunt wordt aangehaald. Neem bijvoorbeeld het proces dat in dit onderwerp is geïntroduceerd. Het heeft een outputwaarde genoemd SecuredDoc
en zijn gegevenstype is com.adobe.idp.Document
. Wanneer het creëren van een E-mail eindpunt voor dit proces (nadat een proces wordt geactiveerd, wordt het de dienst), moet u de waarde van de outputparameter bepalen.
Als u een uitvoerparameterwaarde wilt definiëren die voor een e-maileindpunt is vereist, geeft u de volgende waarden op:
Naam uitvoerparameter: De naam van de uitvoerparameter. De naam van een waarde voor de procesuitvoer wordt opgegeven in Workbench. Als de outputwaarde tot een de dienstverrichting (de dienst behoort die geen proces is dat in Workbench wordt gecreeerd), wordt de outputnaam gespecificeerd in het component.xml- dossier. De naam van de uitvoerparameter voor het proces dat in deze sectie wordt geïntroduceerd, is bijvoorbeeld SecuredDoc
.
Type toewijzing: Gebruikt om de output van de dienst en de verrichting te vormen. De volgende opties zijn beschikbaar:
%F.pdf
en is de bronbestemming sourcefilename.pdf. Het in deze sectie geïntroduceerde proces retourneert bijvoorbeeld één document. Als gevolg hiervan kan het toewijzingstype worden gedefinieerd als %F.pdf
( %F
betekent gebruik van de opgegeven bestandsnaam). Met het patroon %E
wordt de extensie van het invoerdocument aangegeven.Result\%F\
en is de bronbestemming Result\sourcefilename\source1 (uitvoer 1) en Result\sourcefilename\source2 (uitvoer 2).Result\%F\
en is de bronbestemming Result\sourcefilename\file1 and Result\sourcefilename\file2. Als de kaart meer dan één voorwerp heeft, is het patroon Result\%F.pdf
en de bronbestemming is Result\sourcefilename1.pdf (output 1), Result\sourcefilenam2.pdf (output 2), etc.Gegevenstype: Hiermee wordt het gegevenstype van de geretourneerde waarde opgegeven. Het gegevenstype van de geretourneerde waarde van het proces dat in deze sectie wordt geïntroduceerd, is bijvoorbeeld com.adobe.idp.Document
.
Het e-maileindpunt maken
Nadat u de kenmerken en configuratiewaarden van het e-maileindpunt hebt ingesteld en invoer- en uitvoerparameters hebt gedefinieerd, moet u het eindpunt E-mail maken.
Het eindpunt inschakelen
Nadat u een e-maileindpunt hebt gemaakt, moet u het inschakelen. Wanneer het eindpunt wordt toegelaten, kan het worden gebruikt om de dienst aan te halen. Nadat u het eindpunt toelaat, kunt u het binnen beleidsconsole bekijken.
Zie ook
Een e-maileindpunt toevoegen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Voeg een eindpunt E-mail toe door Java API te gebruiken:
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project.
Creeer een voorwerp van de Cliënt EndpointRegistry.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.EndpointRegistryClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Emaileindpuntkenmerken instellen.
CreateEndpointInfo
-object met de constructor ervan.setConnectorId
van het object CreateEndpointInfo
aan te roepen en de tekenreekswaarde Email
door te geven.setDescription
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die het eindpunt beschrijft.setName
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de naam opgeeft.setServiceId
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de servicenaam opgeeft.setOperationName
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de naam van de bewerking aangeeft. Typisch, wanneer het creëren van een E-mail eindpunt voor de dienst die van een proces voortkwam dat in Workbench wordt gecreeerd, wordt de naam van de verrichting gefactureerd.Geef configuratiewaarden op.
Voor elke configuratiewaarde die voor het E-maileindpunt moet worden ingesteld, moet u de methode setConfigParameterAsText
van het object CreateEndpointInfo
aanroepen. Als u bijvoorbeeld de configuratiewaarde smtpHost
wilt instellen, roept u de methode setConfigParameterAsText
van het object CreateEndpointInfo
op en geeft u de volgende waarden door:
smtpHost
configuratiewaarde, specificeer smtpHost
.smtpHost
configuratiewaarde, specificeer een koordwaarde die de naam van de server SMTP specificeert.Om alle configuratiewaarden te zien die voor de dienst EncryptDocument worden geplaatst die in deze sectie wordt geïntroduceerd, zie het de codevoorbeeld van Java dat bij QuickStart wordt gevestigd: Een e-maileindpunt toevoegen met de Java API.
Definieer invoerparameterwaarden.
Definieer een invoerparameterwaarde door de methode setInputParameterMapping
van het object CreateEndpointInfo
aan te roepen en de volgende waarden door te geven:
InDoc
.InDoc
is bijvoorbeeld com.adobe.idp.Document
.variable
opgeven.Roep de methode setInputParameterMapping
aan voor elke invoerparameterwaarde die moet worden gedefinieerd. Omdat het EncryptDocument-proces slechts één invoerparameter heeft, moet u deze methode eenmaal aanroepen.
Definieer een uitvoerparameterwaarde.
Definieer een uitvoerparameterwaarde door de methode CreateEndpointInfo
van het object setOutputParameterMapping
aan te roepen en de volgende waarden door te geven:
SecuredDoc
.SecuredDoc
is bijvoorbeeld com.adobe.idp.Document
.%F.pdf
opgeven.Maak het eindpunt E-mail.
Maak het eindpunt door de methode createEndpoint
van het object EndpointRegistryClient
aan te roepen en het object CreateEndpointInfo
door te geven. Deze methode retourneert een Endpoint
-object dat het eindpunt E-mail vertegenwoordigt.
Laat het eindpunt toe.
Schakel het eindpunt in door de methode enable
van het object EndpointRegistryClient
aan te roepen en het object Endpoint
door te geven dat door de methode createEndpoint
is geretourneerd.
Zie ook
QuickStart: Een eindpunt van een gecontroleerde map toevoegen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
De QuickStart: Als u een e-maileindpunt toevoegt met de Java API, wordt een constant bestand gebruikt dat deel moet uitmaken van uw Java-project om de snelle start te kunnen compileren. Dit constante dossier vertegenwoordigt configuratiewaarden die moeten worden geplaatst wanneer het toevoegen van een e-maileindpunt. De volgende Java-code vertegenwoordigt het constante bestand.
/**
* 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 API's zijn vervangen voor AEM formulieren op JEE.
U kunt programmatically een Remoting eindpunt aan de dienst toevoegen door AEM Forms Java API te gebruiken. Door een Remoting eindpunt toe te voegen, laat u een toepassing van Flex toe om de dienst aan te halen door het remoting te gebruiken. (Zie AEM Forms aanroepen met (Vervangen voor AEM formulieren) AEM Forms Remoting.)
Om programmatically een Remoting eindpunt aan de dienst toe te voegen, overweeg het volgende kortstondige proces genoemd EncryptDocument.
Dit proces accepteert een onbeveiligd PDF-document als een invoerwaarde en geeft het onbeveiligde PDF-document vervolgens door aan de EncryptPDFUsingPassword
-bewerking van de Coderingsservice. Het PDF-document wordt versleuteld met een wachtwoord en het PDF-document met een wachtwoord is de uitvoerwaarde van dit proces. De naam van de invoerwaarde (het onbeveiligde PDF-document) is InDoc
en het gegevenstype is com.adobe.idp.Document
. De naam van de uitvoerwaarde (het met een wachtwoord gecodeerde PDF-document) is SecuredDoc
en het gegevenstype is com.adobe.idp.Document
.
Om aan te tonen hoe te om een Remoting eindpunt aan de dienst toe te voegen, voegt deze sectie een Remoting eindpunt aan de dienst genoemd EncryptDocument toe.
U kunt geen eindpunt Remoting toevoegen door de Webdiensten te gebruiken.
Om een eindpunt uit de dienst te verwijderen, voer de volgende taken uit:
EndpointRegistryClient
-object.Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u de proxybestanden opnemen.
De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:
Zie Including AEM Forms Java-bibliotheekbestanden voor informatie over de locatie van deze JAR-bestanden.
Een EndpointRegistry-client-object maken
Om programmatically een Remoting eindpunt toe te voegen, moet u een EndpointRegistryClient
voorwerp tot stand brengen.
Kenmerken voor verwijderen van eindpunten instellen
Om een Remoting eindpunt voor de dienst tot stand te brengen, specificeer de volgende waarden:
Remoting
.EncryptDocument
.Een eindpunt voor verwijderen maken
Nadat u het Verwijderen eindpuntattributen plaatst, kunt u een Remoting eindpunt voor de dienst tot stand brengen.
Het eindpunt inschakelen
Nadat u een nieuw eindpunt creeert, moet u het toelaten. Wanneer een Remoting eindpunt wordt toegelaten, laat het een cliënt van Flex toe om de dienst aan te halen.
Zie ook
Een eindpunt voor Verwijderen toevoegen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Voeg een Remoting eindpunt toe door Java API te gebruiken:
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project.
Creeer een voorwerp van de Cliënt EndpointRegistry.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.EndpointRegistryClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Eindpuntkenmerken voor verwijderen instellen.
CreateEndpointInfo
-object met de constructor ervan.setConnectorId
van het object CreateEndpointInfo
aan te roepen en de tekenreekswaarde Remoting
door te geven.setDescription
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die het eindpunt beschrijft.setName
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de naam opgeeft.setServiceId
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de servicenaam opgeeft.setOperationName
van het object CreateEndpointInfo
en geef een tekenreekswaarde door die de naam van de bewerking opgeeft. Geef voor een eindpunt Verwijderen een jokerteken op (*).Maak een eindpunt Verwijderen.
Maak het eindpunt door de methode createEndpoint
van het object EndpointRegistryClient
aan te roepen en het object CreateEndpointInfo
door te geven. Deze methode retourneert een Endpoint
-object dat het nieuwe eindpunt Remoting vertegenwoordigt.
Laat het eindpunt toe.
Schakel het eindpunt in door de methode enable
van het object EndpointRegistryClient
aan te roepen en het object Endpoint
door te geven dat door de methode createEndpoint
is geretourneerd.
Zie ook
QuickStart: Een eindpunt voor Verwijderen toevoegen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
U kunt programmatically een eindpunt TaskManager aan de dienst toevoegen door AEM Forms Java API te gebruiken. Door een eindpunt TaskManager aan de dienst toe te voegen, laat u een gebruiker van de Werkruimte toe om de dienst aan te halen. Namelijk kan een gebruiker die in Werkruimte werkt een proces aanhalen dat een overeenkomstig eindpunt TaskManager heeft.
U kunt geen eindpunt TaskManager toevoegen door de Webdiensten te gebruiken.
Om een eindpunt TaskManager aan de dienst toe te voegen, voer de volgende taken uit:
EndpointRegistryClient
-object.Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u de proxybestanden opnemen.
De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:
Zie Including AEM Forms Java-bibliotheekbestanden voor informatie over de locatie van deze JAR-bestanden.
Een EndpointRegistry-client-object maken
Alvorens u een eindpunt kunt programmatically toevoegen TaskManager, moet u een EndpointRegistryClient
voorwerp tot stand brengen.
Een categorie voor het eindpunt maken
Categorieën worden gebruikt om services in Workspace te organiseren. Namelijk kan een gebruiker van de Werkruimte de dienst aanhalen die een eindpunt TaskManager door een categorie binnen Werkruimte te selecteren heeft. Wanneer het creëren van een eindpunt TaskManager, kunt u of van verwijzingen voorzien een bestaande categorie of programmatically tot een nieuwe categorie leiden.
Deze sectie leidt tot een nieuwe categorie als deel van het toevoegen van een eindpunt TaskManager aan de dienst.
De eindpuntattributen van TaskManager plaatsen
Om een eindpunt TaskManager voor de dienst tot stand te brengen, specificeer de volgende waarden:
TaskManagerConnector
.invoke
.Creeer een eindpunt TaskManager
Nadat u een taakmanager eindpuntattributen plaatst, kunt u een eindpunt TaskManager voor de dienst tot stand brengen.
Het eindpunt inschakelen
Nadat u een nieuw eindpunt creeert, moet u het toelaten. Wanneer het eindpunt wordt toegelaten, kan het worden gebruikt om de dienst van binnen Werkruimte aan te halen. Nadat u het eindpunt toelaat, kunt u het binnen beleidsconsole bekijken.
Zie ook
Een TaskManager-eindpunt toevoegen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Voeg een eindpunt TaskManager door Java API toe te gebruiken:
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project.
Creeer een voorwerp van de Cliënt EndpointRegistry.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.EndpointRegistryClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Maak een categorie voor het eindpunt.
Maak een CreateEndpointCategoryInfo
-object door de constructor ervan te gebruiken en de volgende waarden door te geven:
Maak de categorie door de methode createEndpointCategory
van het object EndpointRegistryClient
aan te roepen en het object CreateEndpointCategoryInfo
door te geven. Deze methode retourneert een EndpointCategory
-object dat de nieuwe categorie vertegenwoordigt.
Stel de eindpuntkenmerken van TaskManager in.
CreateEndpointInfo
-object met de constructor ervan.setConnectorId
van het object CreateEndpointInfo
aan te roepen en de tekenreekswaarde TaskManagerConnector
door te geven.setDescription
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die het eindpunt beschrijft.setName
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de naam opgeeft.setServiceId
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de servicenaam opgeeft.setCategoryId
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de categorie-id-waarde opgeeft. U kunt de methode getId
van het EndpointCategory
voorwerp aanhalen om de herkenningstekenwaarde van deze categorie te krijgen.setOperationName
van het object CreateEndpointInfo
aan te roepen en een tekenreekswaarde door te geven die de naam van de bewerking aangeeft. Typisch, wanneer het creëren van een TaskManager
eindpunt voor de dienst die uit een proces voortkwam dat in Workbench wordt gecreeerd, is de naam van de verrichting invoke
.Creeer een eindpunt TaskManager.
Maak het eindpunt door de methode createEndpoint
van het object EndpointRegistryClient
aan te roepen en het object CreateEndpointInfo
door te geven. Deze methode keert een Endpoint
voorwerp terug dat het nieuwe eindpunt TaskManager vertegenwoordigt.
Laat het eindpunt toe.
Schakel het eindpunt in door de methode enable
van het object EndpointRegistryClient
aan te roepen en het object Endpoint
door te geven dat door de methode createEndpoint
is geretourneerd.
Zie ook
QuickStart: Het toevoegen van een eindpunt TaskManager gebruikend Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
U kunt een bestaand eindpunt programmatically wijzigen door AEM Forms Java API te gebruiken. Door een eindpunt te wijzigen, kunt u het gedrag van het eindpunt veranderen. Denk bijvoorbeeld aan een eindpunt van een gecontroleerde map dat een map opgeeft die als controlemap wordt gebruikt. U kunt configuratiewaarden programmatically wijzigen die tot het Gecontroleerde eindpunt van de Omslag behoren, resulterend in een andere omslag die als gecontroleerde omslag functioneert. Voor informatie over configuratiewaarden die tot een Gecontroleerd eindpunt van de Omslag behoren, zie Toevoegend Gecontroleerde Eindpunten van de Omslag.
Om aan te tonen hoe te om een eindpunt te wijzigen, wijzigt deze sectie een Gecontroleerd eindpunt van de Omslag door de omslag te veranderen die zich als gecontroleerde omslag gedraagt.
U kunt een eindpunt niet wijzigen door de Webdiensten te gebruiken.
Om een eindpunt te wijzigen, voer de volgende taken uit:
EndpointRegistryClient
-object.Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u de proxybestanden opnemen.
De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:
Zie Including AEM Forms Java-bibliotheekbestanden voor informatie over de locatie van deze JAR-bestanden.
Een EndpointRegistry-client-object maken
Om een eindpunt programmatically te wijzigen, moet u een EndpointRegistryClient
voorwerp tot stand brengen.
Win het te wijzigen eindpunt terug
Alvorens u een eindpunt kunt wijzigen, moet u het terugwinnen. Om een eindpunt terug te winnen, moet u als gebruiker verbinden die tot een eindpunt kan toegang hebben. U wordt aangeraden verbinding te maken als beheerder. (Zie Verbindingseigenschappen instellen).
U kunt een eindpunt terugwinnen door een lijst van eindpunten terug te winnen. U kunt dan door de lijst herhalen, zoekend naar het specifieke eindpunt om te verwijderen. Bijvoorbeeld, kunt u van een eindpunt de plaats bepalen door de dienst te bepalen die aan het eindpunt en het type van eindpunt beantwoordt. Wanneer u van het eindpunt de plaats bepaalt, kunt u het wijzigen.
Nieuwe configuratiewaarden opgeven
Wanneer het wijzigen van een eindpunt, specificeer nieuwe configuratiewaarden. Bijvoorbeeld, om een Gecontroleerd eindpunt van de Omslag te wijzigen, terugstel alle Gecontroleerde waarden van de de eindpuntconfiguratie van de Omslag, niet alleen degenen die u wilt wijzigen. Voor informatie over configuratiewaarden die tot een Gecontroleerd eindpunt van de Omslag behoren, zie Toevoegend Gecontroleerde Eindpunten van de Omslag.
Voor informatie over configuratiewaarden die tot een E-maileindpunt behoren, zie Toevoegend E-maileindpunten.
U kunt niet de dienst wijzigen die door het eindpunt wordt aangehaald. Als u probeert om de dienst te wijzigen, wordt een uitzondering geworpen. Om de dienst te wijzigen verbonden aan een bepaald eindpunt, verwijder het eindpunt en creeer nieuwe. (Zie Eindpunten verwijderen.)
Zie ook
Een eindpunt wijzigen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Wijzig een eindpunt door Java API te gebruiken:
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project.
Creeer een voorwerp van de Cliënt EndpointRegistry.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.EndpointRegistryClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Haal het eindpunt op dat u wilt wijzigen.
getEndpoints
van het object EndpointRegistryClient
aan te roepen en een object PagingFilter
door te geven dat als filter fungeert. U kunt een waarde (PagingFilter)null
doorgeven om alle eindpunten terug te keren. Deze methode retourneert een java.util.List
-object waarbij elk element een Endpoint
-object is. Zie AEM Forms API Reference voor informatie over een PagingFilter
-object.java.util.List
om te bepalen of het eindpunten heeft. Als er eindpunten zijn, is elk element een EndPoint
instantie.EndPoint
methode getServiceId
van het voorwerp aan te halen. Deze methode retourneert een tekenreekswaarde die de servicenaam opgeeft.getConnectorId
van het object EndPoint
aan te roepen. Deze methode retourneert een tekenreekswaarde die het type eindpunt opgeeft. Bijvoorbeeld, als het eindpunt een Gecontroleerd eindpunt van de Omslag is, keert deze methode WatchedFolder
terug.Geef nieuwe configuratiewaarden op.
Maak een ModifyEndpointInfo
-object door de constructor ervan aan te roepen.
Voor elke configuratiewaarde die moet worden ingesteld, roept u de methode setConfigParameterAsText
van het object ModifyEndpointInfo
aan. Als u bijvoorbeeld de waarde voor de url-configuratie wilt instellen, roept u de methode setConfigParameterAsText
van het object ModifyEndpointInfo
op en geeft u de volgende waarden door:
url
wilt instellen, geeft u url
op.url
wilt definiëren, geeft u de locatie van de gecontroleerde map op.Roep de methode EndpointRegistryClient
van het object modifyEndpoint
aan en geef het object ModifyEndpointInfo
door.
Zie ook
QuickStart: Een eindpunt wijzigen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
U kunt een eindpunt uit de dienst programmatically verwijderen door AEM Forms Java API te gebruiken. Nadat u een eindpunt verwijdert, kan de dienst niet worden aangehaald door de aanroepingsmethode te gebruiken die het eindpunt toeliet. Bijvoorbeeld, als u een eindpunt van de ZEEP uit de dienst verwijdert, kunt u niet de dienst aanhalen door de wijze van de ZEEP te gebruiken.
Om aan te tonen hoe te om een eindpunt uit de dienst te verwijderen, verwijdert deze sectie een eindpunt EJB uit de dienst genoemd EncryptDocument.
U kunt geen eindpunt verwijderen door de Webdiensten te gebruiken.
Om een eindpunt uit de dienst te verwijderen, voer de volgende taken uit:
EndpointRegistryClient
-object.Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u de proxybestanden opnemen.
De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:
Zie Including AEM Forms Java-bibliotheekbestanden voor informatie over de locatie van deze JAR-bestanden.
Een EndpointRegistry-client-object maken
Als u een eindpunt programmatisch wilt verwijderen, moet u een EndpointRegistryClient
-object maken.
Het te verwijderen eindpunt ophalen
Voordat u een eindpunt kunt verwijderen, moet u het ophalen. Om een eindpunt terug te winnen, moet u als gebruiker verbinden die tot een eindpunt kan toegang hebben. U wordt aangeraden verbinding te maken als beheerder. (Zie Verbindingseigenschappen instellen).
U kunt een eindpunt terugwinnen door een lijst van eindpunten terug te winnen. U kunt dan door de lijst herhalen, zoekend naar het specifieke eindpunt om te verwijderen. Bijvoorbeeld, kunt u van een eindpunt de plaats bepalen door de dienst te bepalen die aan het eindpunt en het type van eindpunt beantwoordt. Wanneer u het eindpunt zoekt, kunt u het verwijderen.
Het eindpunt verwijderen
Nadat u een nieuw eindpunt creeert, moet u het toelaten. Wanneer het eindpunt wordt toegelaten, kan het worden gebruikt om de dienst aan te halen. Nadat u het eindpunt toelaat, kunt u het binnen beleidsconsole bekijken.
Zie ook
Een eindpunt verwijderen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Een eindpunt verwijderen met de Java API:
Inclusief projectbestanden.
Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project.
Creeer een voorwerp van de Cliënt EndpointRegistry.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.EndpointRegistryClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Haal het te verwijderen eindpunt op.
getEndpoints
van het object EndpointRegistryClient
aan te roepen en een object PagingFilter
door te geven dat als filter fungeert. U kunt (PagingFilter)null
doorgeven om alle eindpunten te retourneren. Deze methode retourneert een java.util.List
-object waarbij elk element een Endpoint
-object is.java.util.List
om te bepalen of het eindpunten heeft. Als er eindpunten zijn, is elk element een EndPoint
instantie.EndPoint
methode getServiceId
van het voorwerp aan te halen. Deze methode retourneert een tekenreekswaarde die de servicenaam opgeeft.getConnectorId
van het object EndPoint
aan te roepen. Deze methode retourneert een tekenreekswaarde die het type eindpunt opgeeft. Als het eindpunt bijvoorbeeld een EJB-eindpunt is, retourneert deze methode EJB
.Verwijder het eindpunt.
Verwijder het eindpunt door de methode remove
van het EndpointRegistryClient
-object aan te roepen en het object EndPoint
door te geven dat het te verwijderen eindpunt vertegenwoordigt.
Zie ook
QuickStart: Een eindpunt verwijderen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
U kunt informatie over eindpuntschakelaars programmatically terugwinnen gebruikend AEM Forms API. Een schakelaar laat een eindpunt toe om de dienst aan te halen gebruikend diverse aanroepingsmethodes. Bijvoorbeeld, laat een Gecontroleerde schakelaar van de Omslag een eindpunt toe om de dienst aan te halen gebruikend gecontroleerde omslagen. Door programmatically het terugwinnen van informatie over eindpuntschakelaars, kunt u configuratiewaarden terugwinnen verbonden aan een schakelaar zoals welke configuratiewaarden worden vereist en welke facultatieve zijn.
Om aan te tonen hoe te om informatie over eindpuntschakelaars terug te winnen, wint deze sectie informatie over een Gecontroleerde schakelaar van de Omslag terug. (Zie Toegestane eindpunten van mappen toevoegen.)
U kunt geen informatie over eindpunten terugwinnen door de Webdiensten te gebruiken.
Dit onderwerp gebruikt ConnectorRegistryClient
API om informatie over eindpuntschakelaars terug te winnen. (Zie AEM Forms API Reference.)
Om de informatie van de eindpuntschakelaar terug te winnen, voer de volgende taken uit:
ConnectorRegistryClient
-object.Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u de proxybestanden opnemen.
De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:
Als AEM Forms wordt geïmplementeerd op een ondersteunde J2EE-toepassingsserver die geen JBoss is, vervangt u adobe-utilities.jar en jbossall-client.jar door JAR-bestanden die specifiek zijn voor de J2EE-toepassingsserver waarop AEM Forms wordt geïmplementeerd. Zie Including AEM Forms Java-bibliotheekbestanden voor informatie over de locatie van alle AEM Forms JAR-bestanden.
Creeer een voorwerp van de Cliënt ConnectorRegistry
Om de informatie van de eindpuntschakelaar programmatically terug te winnen, creeer een ConnectorRegistryClient
voorwerp.
Geef het type aansluiting op
Specificeer het type van schakelaar waarvan om informatie terug te winnen. De volgende types van schakelaars bestaan:
Configuratiewaarden ophalen
Nadat u het schakelaartype specificeert, kunt u informatie over de schakelaar zoals gesteunde configuratiewaarde terugwinnen. Bijvoorbeeld, voor om het even welke schakelaar, kunt u bepalen welke configuratiewaarden worden vereist en die facultatief zijn.
Zie ook
Gegevens van eindpuntconnector ophalen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Haal de informatie van de eindpuntschakelaar door Java API te gebruiken terug:
Inclusief projectbestanden. .
Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project.
Creeer een voorwerp van de Cliënt ConnectorRegistry.
ServiceClientFactory
-object dat verbindingseigenschappen bevat.ConnectorRegistryClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Geef het type aansluiting op.
Specificeer het schakelaartype door de ConnectorRegistryClient
methode getEndpointDefinition
van het voorwerp aan te halen en een koordwaarde over te gaan die het schakelaartype specificeert. Als u bijvoorbeeld het type gecontroleerde mapconnector wilt opgeven, geeft u de tekenreekswaarde WatchedFolder
door. Deze methode keert een Endpoint
voorwerp terug dat aan het schakelaartype beantwoordt.
Haal configuratiewaarden op.
Endpoint
methode getConfigParameters
van het voorwerp aan te halen. Deze methode retourneert een array van ConfigParameter
-objecten.ConfigParameter
-object. U kunt bijvoorbeeld bepalen of de configuratiewaarde vereist of optioneel is door de methode ConfigParameter
van het object isRequired
aan te roepen. Als de configuratiewaarde wordt vereist, dan keert deze methode true
terug.Zie ook
QuickStart: Gegevens van eindpuntconnector ophalen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen