Programmaticaal het leiden Eindpunten programmatically-managing-endpoints

Voorbeelden en voorbeelden in dit document gelden alleen voor AEM Forms in JEE-omgeving.

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
  • Gecontroleerde map
  • E-mail
  • (Verouderd voor AEM formulieren) Verwijderen
  • Taakbeheer
NOTE
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 van TaskManager organiseren in groepen 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 adding-ejb-endpoints

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.)

NOTE
U kunt geen EJB eindpunt toevoegen door de Webdiensten te gebruiken.
NOTE
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.

Overzicht van de stappen summary-of-steps

Om een eindpunt EJB aan de dienst toe te voegen, voer de volgende taken uit:

  1. Inclusief projectbestanden.
  2. Een EndpointRegistry Client object.
  3. EJB-eindpuntkenmerken instellen.
  4. Maak een EJB-eindpunt.
  5. Laat het eindpunt toe.

Projectbestanden opnemen

Neem de benodigde bestanden op in uw ontwikkelingsproject. De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)
  • jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)

Voor informatie over de locatie van deze JAR-bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.

Een EndpointRegistry-client-object maken

Voordat u een EJB-eindpunt kunt toevoegen, moet u een EndpointRegistryClient object.

EJB-eindpuntkenmerken instellen

Om een EJB eindpunt voor de dienst tot stand te brengen, specificeer de volgende waarden:

  • Connector-id: Geeft het type eindpunt op dat moet worden gemaakt. Om een EJB eindpunt tot stand te brengen, specificeer EJB.
  • Beschrijving: Geeft de beschrijving van het eindpunt aan.
  • Naam: Geeft de naam van het eindpunt op.
  • Service-id: Specificeert de dienst waartot het eindpunt behoort.
  • Handelingsnaam: Geeft de naam op van de bewerking die wordt aangeroepen door het eindpunt te gebruiken. Geef bij het maken van een EJB-eindpunt een jokerteken 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 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

Een EJB-eindpunt toevoegen met de Java API adding-an-ejb-endpoint-using-the-java-api

Voeg een EJB eindpunt toe door Java API te gebruiken:

  1. Inclusief projectbestanden.

    Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project. (

  2. Creeer een voorwerp van de Cliënt EndpointRegistry.

    • Een ServiceClientFactory object dat verbindingseigenschappen bevat.
    • Een EndpointRegistryClient object door de constructor ervan te gebruiken en de ServiceClientFactory object.
  3. EJB-eindpuntkenmerken instellen.

    • Een CreateEndpointInfo object met behulp van de constructor.
    • Specificeer de waarde van schakelaarherkenningsteken door te roepen CreateEndpointInfo object setConnectorId methode en het doorgeven van de tekenreekswaarde EJB.
    • Specificeer de beschrijving van het eindpunt door te roepen CreateEndpointInfo object setDescription methode en het overgaan van een koordwaarde die het eindpunt beschrijft.
    • Specificeer de naam van het eindpunt door te roepen CreateEndpointInfo object setName methode en het overgaan van een koordwaarde die de naam specificeert.
    • Specificeer de dienst waartot het eindpunt door behoort aan te halen CreateEndpointInfo object setServiceId methode en het overgaan van een koordwaarde die de de dienstnaam specificeert.
    • Geef de bewerking op die wordt aangeroepen door het CreateEndpointInfo object setOperationName methode en geef een tekenreekswaarde door die de naam van de bewerking aangeeft. Geef voor SOAP- en EJB-eindpunten een jokerteken op ( *), hetgeen alle verrichtingen impliceert.
  4. Maak een EJB-eindpunt.

    Maak het eindpunt door het EndpointRegistryClient object createEndpoint en het doorgeven van de CreateEndpointInfo object. Deze methode retourneert een Endpoint object dat het nieuwe EJB-eindpunt vertegenwoordigt.

  5. Laat het eindpunt toe.

    Laat het eindpunt toe door het aan te halen EndpointRegistryClient methode inschakelen van object en het doorgeven van Endpoint object dat is geretourneerd door de createEndpoint methode.

Zie ook

Overzicht van de stappen

QuickStart: een EJB-eindpunt toevoegen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

SOAP-eindpunten toevoegen adding-soap-endpoints

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.

NOTE
U kunt geen eindpunt van de ZEEP toevoegen door de Webdiensten te gebruiken.
NOTE
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.

Overzicht van de stappen summary_of_steps-1

Om een eindpunt van de ZEEP aan de dienst toe te voegen, voer de volgende taken uit:

  1. Inclusief projectbestanden.
  2. Een EndpointRegistryClient object.
  3. Stel de kenmerken voor het SOAP-eindpunt in.
  4. Creeer een eindpunt van de ZEEP.
  5. Laat het eindpunt toe.

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:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)
  • jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)

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 voor informatie over AEM Forms JAR-bestanden Inclusief AEM Forms Java-bibliotheekbestanden.

Een EndpointRegistry-client-object maken

Om een eindpunt van de ZEEP aan de dienst programmatically toe te voegen, moet u tot een EndpointRegistryClient object.

Kenmerken van SOAP-eindpunt instellen

Om een eindpunt van de ZEEP aan de dienst toe te voegen, specificeer de volgende waarden:

  • Waarde koppelings-id: Geeft het type eindpunt op dat moet worden gemaakt. Om een eindpunt van de ZEEP te creëren, specificeer SOAP.
  • Beschrijving: Geeft de beschrijving van het eindpunt aan.
  • Naam: Geeft de naam van het eindpunt op.
  • Service-id-waarde: Specificeert de dienst waartot het eindpunt behoort.
  • Handelingsnaam: Geeft de naam op van de bewerking die wordt aangeroepen door het eindpunt te gebruiken. Geef bij het maken van een SOAP-eindpunt een jokerteken 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 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 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

Een SOAP-eindpunt toevoegen met de Java API add-a-soap-endpoint-using-the-java-api

Voeg een eindpunt van de ZEEP aan de dienst toe door Java API te gebruiken:

  1. Inclusief projectbestanden.

    Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project.

  2. Creeer een voorwerp van de Cliënt EndpointRegistry.

    • Een ServiceClientFactory object dat verbindingseigenschappen bevat.
    • Een EndpointRegistryClient object door de constructor ervan te gebruiken en de ServiceClientFactory object.
  3. Stel de kenmerken voor het SOAP-eindpunt in.

    • Een CreateEndpointInfo object met behulp van de constructor.
    • Specificeer de waarde van schakelaarherkenningsteken door te roepen CreateEndpointInfo object setConnectorId methode en het doorgeven van de tekenreekswaarde SOAP.
    • Specificeer de beschrijving van het eindpunt door te roepen CreateEndpointInfo object setDescription methode en het overgaan van een koordwaarde die het eindpunt beschrijft.
    • Specificeer de naam van het eindpunt door te roepen CreateEndpointInfo object setName methode en het overgaan van een koordwaarde die de naam specificeert.
    • Specificeer de dienst waartot het eindpunt door behoort aan te halen CreateEndpointInfo object setServiceId methode en het overgaan van een koordwaarde die de de dienstnaam specificeert.
    • Geef de bewerking op die wordt aangeroepen door het CreateEndpointInfo object setOperationName methode en het overgaan van een koordwaarde die de verrichtingsnaam specificeert. Geef voor SOAP- en EJB-eindpunten een jokerteken op ( *), hetgeen alle verrichtingen impliceert.
  4. Creeer een eindpunt van de ZEEP.

    Maak het eindpunt door het EndpointRegistryClient object createEndpoint en het doorgeven van de CreateEndpointInfo object. Deze methode retourneert een Endpoint object dat het nieuwe SOAP-eindpunt vertegenwoordigt.

  5. Laat het eindpunt toe.

    Laat het eindpunt toe door het aan te halen EndpointRegistryClient methode inschakelen van object en de methode doorgeven Endpoint object dat is geretourneerd door de createEndpoint methode.

Zie ook

Overzicht van de stappen

QuickStart: een SOAP-eindpunt toevoegen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Eindpunten van gecontroleerde mappen toevoegen adding-watched-folder-endpoints

U kunt programmatically een Gecontroleerd eindpunt van de Omslag aan de dienst toevoegen door AEM Forms Java API te gebruiken. Door een Gecontroleerd eindpunt van de Omslag toe te voegen, laat u gebruikers toe om een dossier (zoals een dossier van PDF) in een omslag te 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.)

aw_aw_encryptdocumentprocess

Tijdens dit proces wordt een onbeveiligd PDF-document geaccepteerd als een invoerwaarde en wordt het onbeveiligde PDF-document vervolgens doorgegeven aan de Encryption Service EncryptPDFUsingPassword -bewerking. Het PDF-document wordt versleuteld met een wachtwoord en de met een wachtwoord gecodeerde PDF 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.

NOTE
U kunt geen Gecontroleerd eindpunt van de Omslag toevoegen door de Webdiensten te gebruiken.

Overzicht van de stappen summary_of_steps-2

Voer de volgende taken uit om een eindpunt van een gecontroleerde map aan de service toe te voegen:

  1. Inclusief projectbestanden.
  2. Een EndpointRegistryClient object.
  3. Attributen voor het eindpunt van gecontroleerde map instellen.
  4. Geef configuratiewaarden op.
  5. Definieer invoerparameterwaarden.
  6. Definieer een uitvoerparameterwaarde.
  7. Maak een eindpunt van een gecontroleerde map.
  8. Laat het eindpunt toe.

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:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)
  • jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)

Voor informatie over de locatie van deze JAR-bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.

Een EndpointRegistry-client-object maken

Als u programmatisch een gecontroleerd mapeindpunt wilt toevoegen, moet u een EndpointRegistryClient object.

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:

  • Connector-id: Geeft het type eindpunt op dat wordt gemaakt. Als u een eindpunt van een gecontroleerde map wilt maken, geeft u WatchedFolder.
  • Beschrijving: Geeft de beschrijving van het eindpunt aan.
  • Naam: Geeft de naam van het eindpunt op.
  • Service-id: Specificeert de dienst waartot het eindpunt behoort. Bijvoorbeeld, om een Gecontroleerd eindpunt van de Omslag aan het proces toe te voegen dat in deze sectie wordt geïntroduceerd (een proces wordt de dienst wanneer geactiveerd gebruikend Workbench), specificeer EncryptDocument.
  • Handelingsnaam: Geeft de naam op van de bewerking die wordt aangeroepen door het eindpunt te gebruiken. 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, is de naam van de verrichting invoke.

Configuratiewaarden opgeven

Specificeer configuratiewaarden voor een Gecontroleerd eindpunt van de Omslag 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:

  • url: Geeft de locatie van de gecontroleerde map aan. In een gegroepeerd milieu, moet deze waarde aan een gedeelde netwerkomslag richten die van elke computer in de cluster toegankelijk is.
  • asynchroon: Identificeert het aanroepingstype als asynchroon of synchroon. De voorbijgaande en synchrone processen kunnen slechts synchroon worden aangehaald. De standaardwaarde is true. Asynchroon wordt aanbevolen.
  • cronExpression: Wordt gebruikt door kwarts om de opiniepeiling van de invoermap te plannen.
  • purgeDuration: Dit is een verplicht kenmerk. Bestanden en mappen in de resultaatmap worden gewist wanneer ze ouder zijn dan deze waarde. Deze waarde wordt gemeten in dagen. Dit kenmerk is handig om ervoor te zorgen dat de resultaatmap niet vol wordt. De waarde -1 dagen geeft aan dat u de resultatenmap nooit wilt verwijderen. De standaardwaarde is -1.
  • repeatInterval: Het interval, in seconden, voor het scannen van de Gecontroleerde map op invoer. Tenzij de vertraging wordt toegelaten, zou deze waarde langer dan de tijd moeten zijn om een gemiddelde baan te verwerken; anders, kan het systeem overbelast worden. De standaardwaarde is 5.
  • repeatCount: Het aantal keren dat een gecontroleerde map de map of map scant. De waarde -1 geeft aan dat een scanbewerking voor onbepaalde tijd wordt uitgevoerd. De standaardwaarde is -1.
  • throttleOn: hiermee wordt het aantal taken voor gecontroleerde mappen beperkt dat op een bepaald moment kan worden verwerkt. Het maximumaantal banen wordt bepaald door de batchSize waarde.
  • userName: De gebruikersnaam die wordt gebruikt bij het aanroepen van een doelservice vanuit de gecontroleerde map. Deze waarde is verplicht. De standaardwaarde is SuperAdmin.
  • domainName: Het domein van de gebruiker. Deze waarde is verplicht. De standaardwaarde is DefaultDom.
  • batchSize: Het aantal bestanden of mappen dat per scan moet worden opgehaald. Gebruik deze waarde om overbelasting op het systeem te voorkomen. Als u te veel bestanden tegelijk scant, kan dit tot gevolg hebben dat de toepassing vastloopt. De standaardwaarde is 2.
  • waitTime: De tijd in milliseconden die moet worden gewacht voordat een map of bestand wordt gescand nadat het is gemaakt. Als de wachttijd bijvoorbeeld 36.000.000 milliseconden (één uur) is en het bestand een minuut geleden is gemaakt, wordt dit bestand opgepakt nadat 59 minuten zijn verstreken. Dit kenmerk is handig om ervoor te zorgen dat een bestand of map volledig naar de invoermap wordt gekopieerd. Als u bijvoorbeeld een groot bestand hebt dat moet worden verwerkt en het downloaden van het bestand duurt tien minuten, stelt u de wachttijd in op 10*60 *1000 milliseconden. Met deze instelling voorkomt u dat de gecontroleerde map het bestand scant als het nog tien minuten niet heeft gewacht. De standaardwaarde is 0.
  • excludeFilePattern: Het patroon waarmee een gecontroleerde map bepaalt welke bestanden en mappen worden gescand en opgehaald. Bestanden of mappen met dit patroon worden niet gescand voor verwerking. Deze instelling is handig wanneer de invoer een map is die meerdere bestanden bevat. De inhoud van de map kan worden gekopieerd naar een map met een naam die wordt opgepakt door de gecontroleerde map. Met deze stap wordt voorkomen dat de gecontroleerde map een map opneemt die moet worden verwerkt voordat de map volledig is gekopieerd naar de invoermap. Als de waarde excludeFilePattern bijvoorbeeld data*, alle bestanden en mappen die overeenkomen data* niet worden opgepikt. 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 te steunen *.* en *.pdf. Deze jokertekenpatronen worden niet ondersteund door reguliere expressies.
  • includeFilePattern: Het patroon dat in de gecontroleerde map wordt gebruikt om te bepalen welke mappen en bestanden moeten worden gescand en opgehaald. Als deze waarde bijvoorbeeld *, alle bestanden en mappen die overeenkomen input* worden opgepakt. 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 te steunen *.* en *.pdf. Deze jokertekenpatronen worden niet ondersteund door reguliere expressies. Deze waarde is verplicht.
  • resultFolderName: De map waarin de opgeslagen resultaten zijn opgeslagen. Deze locatie kan een absoluut of relatief mappad zijn. Als de resultaten niet in deze map worden weergegeven, controleert u de map met foutmeldingen. Alleen-lezen bestanden worden niet verwerkt en worden opgeslagen in de map met foutmeldingen. De standaardwaarde is result/%Y/%M/%D/. Dit is de resultatenmap in de controlemap.
  • preserveFolderName: De locatie waar bestanden worden opgeslagen nadat bestanden zijn gescand en opgehaald. Deze locatie kan een absoluut, relatief of null-mappad zijn. De standaardwaarde is preserve/%Y/%M/%D/.
  • failureFolderName: De map waarin bestanden met fouten worden opgeslagen. Deze locatie is altijd relatief ten opzichte van de gecontroleerde map. Alleen-lezen bestanden worden niet verwerkt en worden opgeslagen in de map met foutmeldingen. De standaardwaarde is failure/%Y/%M/%D/.
  • preserveOnFailed: Invoerbestanden behouden als de bewerking niet kan worden uitgevoerd op een service. De standaardwaarde is true.
  • overwriteDuplicateFilename: Als de waarde true is, worden bestanden in de resultatenmap en de opslagmap overschreven. Als deze optie is ingesteld op false, worden bestanden en mappen met een numeriek indexachtervoegsel gebruikt voor de naam. De standaardwaarde is false.

Invoerparameterwaarden definiëren

Wanneer u een eindpunt van een gecontroleerde map maakt, moet u parameterwaarden voor invoer definiëren. Dat wil zeggen dat u de invoerwaarden moet 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. Er is één invoerwaarde genaamd InDoc en het 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 in deze sectie geïntroduceerde proces 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 map gebruikt de waarde die in het veld is ingevoerd terwijl deze wordt weergegeven. 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 *.pdfals de toewijzingswaarde.

Toewijzingswaarde: Geeft de waarde van het toewijzingstype op. Als u bijvoorbeeld een Variable toewijzingstype, kunt u specificeren *.pdf als het bestandspatroon.

Gegevenstype: Geeft het gegevenstype van de invoerwaarde(n) 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 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. Er is een uitvoerwaarde met de naam SecuredDoc en het 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 voor het eindpunt van een gecontroleerde map is vereist:

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 in deze sectie geïntroduceerde proces is bijvoorbeeld SecuredDoc.

Type toewijzing: Gebruikt om de output van de dienst en de verrichting te vormen. De volgende opties zijn beschikbaar:

  • Als de service één object (één document) retourneert, is het patroon %F.pdf en de bronbestemming is sourceFileName.pdf. Het in deze sectie geïntroduceerde proces retourneert bijvoorbeeld één document. Hierdoor kan het toewijzingstype worden gedefinieerd als %F.pdf ( %F betekent gebruik van de opgegeven bestandsnaam). Het patroon %E geeft de extensie van het invoerdocument aan.
  • Als de dienst een lijst terugkeert, is het patroon Result\%F\en de bronbestemming is Result\sourcefilename\source1 (uitvoer 1) en Result\sourcefilename\source2 (uitvoer 2).
  • Als de dienst een kaart terugkeert, is het patroon Result\%F\en de bronbestemming is Result\sourcefilename\file1 en Result\sourcefilename\file2. Als de kaart meerdere objecten bevat, is het patroon Result\%F.pdf en de bronbestemming is Result\sourcefilename1.pdf (uitvoer 1), Result\sourcefilenam2.pdf (uitvoer 2), enzovoort.

Gegevenstype: Geeft het gegevenstype van de geretourneerde waarde op. Het gegevenstype van de geretourneerde waarde van het in deze sectie geïntroduceerde proces is bijvoorbeeld com.adobe.idp.Document.

Een eindpunt van een gecontroleerde map maken

Nadat u de attributen, de configuratiewaarden van het eindpunt plaatst, en input en outputparameterwaarden bepaalt, 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

Het eindpunt van een gecontroleerde map toevoegen met de Java API add-a-watched-folder-endpoint-using-the-java-api

Voeg een Gecontroleerd eindpunt van de Omslag toe door AEM Forms Java API te gebruiken:

  1. Inclusief projectbestanden.

    Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project.

  2. Creeer een voorwerp van de Cliënt EndpointRegistry.

    • Een ServiceClientFactory object dat verbindingseigenschappen bevat.
    • Een EndpointRegistryClient object door de constructor ervan te gebruiken en de ServiceClientFactory object.
  3. Attributen voor het eindpunt van gecontroleerde map instellen.

    • Een CreateEndpointInfo object met behulp van de constructor.
    • Specificeer de waarde van schakelaarherkenningsteken door te roepen CreateEndpointInfo object setConnectorId methode en het doorgeven van de tekenreekswaarde WatchedFolder.
    • Specificeer de beschrijving van het eindpunt door te roepen CreateEndpointInfo object setDescription methode en het overgaan van een koordwaarde die het eindpunt beschrijft.
    • Specificeer de naam van het eindpunt door te roepen CreateEndpointInfo object setName methode en het overgaan van een koordwaarde die de naam specificeert.
    • Specificeer de dienst waartot het eindpunt door behoort aan te halen CreateEndpointInfo object setServiceId methode en het overgaan van een koordwaarde die de de dienstnaam specificeert.
    • Geef de bewerking op die wordt aangeroepen door het CreateEndpointInfo object setOperationName methode en het overgaan van een koordwaarde die de verrichtingsnaam specificeert. 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.
  4. Geef configuratiewaarden op.

    Voor elke configuratiewaarde die voor het Gecontroleerde eindpunt van de Omslag moet worden geplaatst, moet u het CreateEndpointInfo object setConfigParameterAsText methode. Als u bijvoorbeeld de opdracht url configuratiewaarde, activeert de CreateEndpointInfo object setConfigParameterAsText en geeft de volgende tekenreekswaarden door:

    • Een tekenreekswaarde die de naam van de configuratiewaarde opgeeft. Wanneer u het url configuratiewaarde, opgeven url.
    • Een tekenreeks die de waarde van de configuratiewaarde opgeeft. Wanneer u het url configuratiewaarde, geeft u de locatie van de gecontroleerde map op.
    note note
    NOTE
    Als u alle configuratiewaarden wilt zien die zijn ingesteld voor de EncryptDocument-service, raadpleegt u het Java-codevoorbeeld in QuickStart: een eindpunt voor een gecontroleerde map toevoegen met de Java API.
  5. Definieer invoerparameterwaarden.

    Definieer een invoerparameterwaarde door het CreateEndpointInfo object setInputParameterMapping en geeft de volgende waarden door:

    • Een tekenreekswaarde die de naam van de invoerparameter opgeeft. De naam van de invoerparameter voor de EncryptDocument-service is bijvoorbeeld InDoc.
    • Een tekenreeks die het gegevenstype van de invoerparameter opgeeft. Het gegevenstype van het InDoc invoerparameter is com.adobe.idp.Document.
    • Een tekenreekswaarde die het toewijzingstype aangeeft. U kunt bijvoorbeeld variable.
    • Een tekenreekswaarde die de toewijzingswaarde opgeeft. U kunt bijvoorbeeld *.pdf opgeven als bestandspatroon.
    note note
    NOTE
    De setInputParameterMapping methode voor elke invoerparameterwaarde die moet worden gedefinieerd. Omdat het EncryptDocument-proces slechts één invoerparameter heeft, moet u deze methode eenmaal aanroepen.
  6. Definieer een uitvoerparameterwaarde.

    Definieer een uitvoerparameterwaarde door het CreateEndpointInfo object setOutputParameterMapping en geeft de volgende waarden door:

    • Een tekenreekswaarde die de naam van de uitvoerparameter opgeeft. De naam van de uitvoerparameter voor de EncryptDocument-service is bijvoorbeeld SecuredDoc.
    • Een tekenreeks die het gegevenstype van de uitvoerparameter opgeeft. Het gegevenstype van het SecuredDoc uitvoerparameter is com.adobe.idp.Document.
    • Een tekenreekswaarde die het toewijzingstype aangeeft. U kunt bijvoorbeeld %F.pdf.
  7. Maak een eindpunt van een gecontroleerde map.

    Maak het eindpunt door het EndpointRegistryClient object createEndpoint en het doorgeven van de CreateEndpointInfo object. Deze methode retourneert een Endpoint object dat het eindpunt van de gecontroleerde map vertegenwoordigt.

  8. Laat het eindpunt toe.

    Laat het eindpunt toe door het aan te halen EndpointRegistryClient object enable en het doorgeven van de Endpoint object dat is geretourneerd door de createEndpoint methode.

Zie ook

Overzicht van de stappen

QuickStart: een eindpunt voor een gecontroleerde map toevoegen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Configuratiewaarden van gecontroleerde map, constant bestand watched-folder-configuration-values-constant-file

De QuickStart: een eindpunt voor een gecontroleerde map toevoegen met de Java API gebruikt een constant dossier dat deel van uw project van Java moet uitmaken om de snelle aanvang te 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";
        }

E-maileindpunten toevoegen adding-email-endpoints

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. Voor informatie over kortstondige processen raadpleegt u AEM Forms-processen begrijpen.

ae_ae_encryptdocumentprocess

Tijdens dit proces wordt een onbeveiligd PDF-document geaccepteerd als een invoerwaarde en wordt het onbeveiligde PDF-document vervolgens doorgegeven aan de Encryption Service EncryptPDFUsingPassword -bewerking. Met dit proces wordt het PDF-document versleuteld met een wachtwoord en wordt het met een wachtwoord gecodeerde PDF als 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.

NOTE
U kunt geen eindpunt E-mail toevoegen door de Webdiensten te gebruiken.

Overzicht van de stappen summary_of_steps-3

Om een E-maileindpunt aan de dienst toe te voegen, voer de volgende taken uit:

  1. Inclusief projectbestanden.
  2. Een EndpointRegistryClient object.
  3. Emaileindpuntkenmerken instellen.
  4. Geef configuratiewaarden op.
  5. Definieer invoerparameterwaarden.
  6. Definieer een uitvoerparameterwaarde.
  7. Maak het eindpunt E-mail.
  8. Laat het eindpunt toe.

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:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)
  • jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)

Voor informatie over de locatie van deze JAR-bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.

Een EndpointRegistry-client-object maken

Voordat u een e-maileindpunt kunt toevoegen, moet u een EndpointRegistryClient object.

Kenmerken voor e-maileindpunten instellen

Om een E-maileindpunt voor de dienst tot stand te brengen, specificeer de volgende waarden:

  • Waarde koppelings-id: Geeft het type eindpunt op dat wordt gemaakt. Als u een e-maileindpunt wilt maken, geeft u Email.
  • Beschrijving: Geeft een beschrijving voor het eindpunt op.
  • Naam: Geeft de naam van het eindpunt op.
  • Service-id-waarde: Specificeert de dienst waartot het eindpunt behoort. Bijvoorbeeld, om een E-maileindpunt aan het proces toe te voegen dat in deze sectie wordt geïntroduceerd (een proces wordt de dienst wanneer geactiveerd gebruikend Workbench), specificeer EncryptDocument.
  • Handelingsnaam: Geeft de naam op van de bewerking die wordt aangeroepen door het eindpunt te gebruiken. Typisch, wanneer het creëren van een E-mail eindpunt voor de dienst die van een proces voortkwam dat in Workbench wordt gecreeerd, is de naam van de verrichting invoke.

Configuratiewaarden opgeven

Specificeer configuratiewaarden voor een E-mail eindpunt 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.

NOTE
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:

  • cronExpression: Een uitsnijdexpressie als de e-mail moet worden gepland met een uitsnijdexpressie.
  • repeatCount: Het aantal keren dat het e-maileindpunt de map of map scant. De waarde -1 geeft aan dat een scanbewerking voor onbepaalde tijd wordt uitgevoerd. De standaardwaarde is -1.
  • repeatInterval: De scansnelheid in seconden die de ontvanger gebruikt om inkomende e-mail te controleren. De standaardwaarde is 10.
  • startDelay: De tijd om te wachten om na het plannerbegin af te tasten. De standaardtijd is 0.
  • batchSize: Het aantal e-mailberichten dat de ontvanger per scan verwerkt voor optimale prestaties. De waarde -1 geeft alle e-mails aan. De standaardwaarde is 2.
  • userName: De gebruikersnaam die wordt gebruikt wanneer een doelservice via e-mail wordt aangeroepen. De standaardwaarde is SuperAdmin.
  • domainName: Een verplichte configuratiewaarde. De standaardwaarde is DefaultDom.
  • domainPattern: Geeft de domeinpatronen aan van binnenkomende e-mail die de provider accepteert. Als adobe.com wordt gebruikt, alleen e-mail van adobe.com wordt verwerkt, e-mail van andere domeinen wordt genegeerd.
  • filePattern: Geeft de inkomende patronen voor bestandsbijlagen op die de provider accepteert. Dit omvat bestanden met specifieke bestandsextensies (*.dat, *.xml), bestanden met specifieke namen (gegevens) en bestanden met samengestelde expressies in de naam en extensie (*…[dD][aA]'port'). De standaardwaarde is *.
  • receivingSuccessfulJob: Een e-mailadres waarnaar berichten worden verzonden om aan te geven dat taken zijn geslaagd. Standaard wordt altijd een bericht met een geslaagde taak naar de afzender verzonden. Als u sender, worden de e-mailresultaten naar de afzender verzonden. 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.
  • receivingFailedJob: Een e-mailadres waarnaar berichten worden verzonden om mislukte taken aan te geven. Standaard wordt een mislukte taakbericht altijd naar de afzender verzonden. Als u sender, worden de e-mailresultaten naar de afzender verzonden. 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.
  • inboxHost: De hostnaam of het IP-adres in het Postvak IN van de e-mailprovider die moet worden gescand.
  • inboxPort: De poort die de e-mailserver gebruikt. De standaardwaarde voor POP3 is 110 en de standaardwaarde voor IMAP is 143. Als SSL wordt toegelaten, is de standaardwaarde voor POP3 995 en de standaardwaarde voor IMAP is 993.
  • inboxProtocol: Het e-mailprotocol voor het e-maileindpunt dat moet worden gebruikt om de Postvak IN te scannen. De opties zijn IMAP of POP3. De postserver van de inbox gastheer moet deze protocollen steunen.
  • inboxTimeOut: Time-out in seconden zodat de e-mailprovider wacht op reacties in het postvak. De standaardwaarde is 60.
  • inboxUser: De gebruikersnaam die is vereist voor aanmelding bij het e-mailaccount. Afhankelijk van de e-mailserver en configuratie is dit mogelijk alleen het gedeelte met de gebruikersnaam van de e-mail of het volledige e-mailadres.
  • inboxPassword: Het wachtwoord voor de inbox-gebruiker.
  • inboxSSLEnabled: Stel deze waarde in om de e-mailprovider te dwingen SSL te gebruiken bij het verzenden van berichten over resultaten of fouten. Zorg ervoor dat de IMAP- of POP3-host SSL ondersteunt.
  • smtpHost: De hostnaam van de mailserver waarnaar de e-mailprovider resultaten en foutberichten verzendt.
  • smtpPort: De standaardwaarde voor de SMTP-poort is 25.
  • smtpUser: De gebruikersaccount voor de e-mailprovider die moet worden gebruikt wanneer deze e-mailmeldingen met resultaten en fouten verzendt.
  • smtpPassword: Het wachtwoord voor de SMTP-account. Voor sommige mailservers is geen SMTP-wachtwoord vereist.
  • charSet: De tekenset die door de e-mailprovider wordt gebruikt. De standaardwaarde is UTF-8.
  • smtpSSLEnabled: Stel deze waarde in om de e-mailprovider te dwingen SSL te gebruiken bij het verzenden van berichten over resultaten of fouten. Zorg ervoor dat de SMTP-host SSL ondersteunt.
  • failedJobFolder: Geeft een map op waarin de resultaten moeten worden opgeslagen wanneer de SMTP-mailserver niet operationeel is.
  • asynchroon: Wanneer ingesteld op synchroon, worden alle invoerdocumenten verwerkt en wordt één reactie geretourneerd. Wanneer ingesteld op asynchroon, wordt een reactie verzonden voor elk invoerdocument dat wordt verwerkt. Bijvoorbeeld, wordt een E-mail eindpunt gecreeerd voor het proces dat in dit onderwerp wordt geïntroduceerd, en een e-mailbericht wordt verzonden naar inbox van het eindpunt dat veelvoudige onbeveiligde documenten van PDF bevat. Wanneer alle documenten van PDF met een wachtwoord worden gecodeerd, en als het eindpunt synchroon wordt gevormd, wordt één enkel antwoord e-mailbericht verzonden met alle beveiligde documenten van PDF in bijlage. Als het eindpunt asynchroon wordt gevormd, wordt een afzonderlijk antwoord e-mailbericht verzonden voor elk beveiligd document van PDF. Elk e-mailbericht bevat één PDF-document als bijlage. De standaardwaarde is asynchroon.

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. Er is één invoerwaarde genaamd InDoc en het 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 in deze sectie geïntroduceerde proces 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 die in het veld wordt ingevoerd terwijl deze wordt weergegeven. 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 kan selecteren. Als u bijvoorbeeld Variabele selecteert voor het toewijzingstype en het invoerdocument moet een PDF-bestand zijn, kunt u *.pdf als de toewijzingswaarde.

Toewijzingswaarde: Geeft de waarde van het toewijzingstype op. Als u bijvoorbeeld een toewijzingstype Variabele selecteert, kunt u *.pdf als het bestandspatroon.

Gegevenstype: Geeft 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. Er is een uitvoerwaarde met de naam SecuredDoc en het 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 in deze sectie geïntroduceerde proces is bijvoorbeeld SecuredDoc.

Type toewijzing: Gebruikt om de output van de dienst en de verrichting te vormen. De volgende opties zijn beschikbaar:

  • Als de service één object (één document) retourneert, is het patroon %F.pdf en de bronbestemming is sourceFileName.pdf. Het in deze sectie geïntroduceerde proces retourneert bijvoorbeeld één document. Hierdoor kan het toewijzingstype worden gedefinieerd als %F.pdf ( %F betekent gebruik van de opgegeven bestandsnaam). Het patroon %E geeft de extensie van het invoerdocument aan.
  • Als de dienst een lijst terugkeert, is het patroon Result\%F\en de bronbestemming is Result\sourcefilename\source1 (uitvoer 1) en Result\sourcefilename\source2 (uitvoer 2).
  • Als de dienst een kaart terugkeert, is het patroon Result\%F\en de bronbestemming is Result\sourcefilename\file1 en Result\sourcefilename\file2. Als de kaart meerdere objecten bevat, is het patroon Result\%F.pdf en de bronbestemming is Result\sourcefilename1.pdf (uitvoer 1), Result\sourcefilenam2.pdf (uitvoer 2), enzovoort.

Gegevenstype: Geeft het gegevenstype van de geretourneerde waarde op. Het gegevenstype van de geretourneerde waarde van het in deze sectie geïntroduceerde proces 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 eindpunt E-mail 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 e-maileindpunt toevoegen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Een e-maileindpunt toevoegen met de Java API add-an-email-endpoint-using-the-java-api

Voeg een eindpunt E-mail toe door Java API te gebruiken:

  1. Inclusief projectbestanden.

    Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project.

  2. Creeer een voorwerp van de Cliënt EndpointRegistry.

    • Een ServiceClientFactory object dat verbindingseigenschappen bevat.
    • Een EndpointRegistryClient object door de constructor ervan te gebruiken en de ServiceClientFactory object.
  3. Emaileindpuntkenmerken instellen.

    • Een CreateEndpointInfo object met behulp van de constructor.
    • Specificeer de waarde van schakelaarherkenningsteken door te roepen CreateEndpointInfo object setConnectorId methode en het doorgeven van de tekenreekswaarde Email.
    • Specificeer de beschrijving van het eindpunt door te roepen CreateEndpointInfo object setDescription methode en het overgaan van een koordwaarde die het eindpunt beschrijft.
    • Specificeer de naam van het eindpunt door te roepen CreateEndpointInfo object setName methode en het overgaan van een koordwaarde die de naam specificeert.
    • Specificeer de dienst waartot het eindpunt door behoort aan te halen CreateEndpointInfo object setServiceId methode en het overgaan van een koordwaarde die de de dienstnaam specificeert.
    • Geef de bewerking op die wordt aangeroepen door het CreateEndpointInfo object setOperationName methode en het overgaan van een koordwaarde die de verrichtingsnaam specificeert. 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.
  4. Geef configuratiewaarden op.

    Voor elke configuratiewaarde om voor het E-maileindpunt te plaatsen, moet u aanhalen CreateEndpointInfo object setConfigParameterAsText methode. Als u bijvoorbeeld de opdracht smtpHost configuratiewaarde, activeert de CreateEndpointInfo object setConfigParameterAsText en geeft de volgende waarden door:

    • Een tekenreekswaarde die de naam van de configuratiewaarde opgeeft. Wanneer u het smtpHost configuratiewaarde, opgeven smtpHost.
    • Een tekenreeks die de waarde van de configuratiewaarde opgeeft. Wanneer u het smtpHost configuratiewaarde, specificeer een koordwaarde die de naam van de server SMTP specificeert.
    note note
    NOTE
    Om alle configuratiewaarden te zien die voor de dienst EncryptDocument worden geplaatst die in deze sectie wordt geïntroduceerd, zie het codevoorbeeld van Java dat bij wordt gevestigd QuickStart: een e-maileindpunt toevoegen met de Java API.
  5. Definieer invoerparameterwaarden.

    Definieer een invoerparameterwaarde door het CreateEndpointInfo object setInputParameterMapping en geeft de volgende waarden door:

    • Een tekenreekswaarde die de naam van de invoerparameter opgeeft. De naam van de invoerparameter voor de EncryptDocument-service is bijvoorbeeld InDoc.
    • Een tekenreeks die het gegevenstype van de invoerparameter opgeeft. Het gegevenstype van het InDoc invoerparameter is com.adobe.idp.Document.
    • Een tekenreekswaarde die het toewijzingstype aangeeft. U kunt bijvoorbeeld variable.
    • Een tekenreekswaarde die de toewijzingswaarde opgeeft. U kunt bijvoorbeeld *.pdf opgeven als bestandspatroon.
    note note
    NOTE
    De setInputParameterMapping methode voor elke invoerparameterwaarde die moet worden gedefinieerd. Omdat het EncryptDocument-proces slechts één invoerparameter heeft, moet u deze methode eenmaal aanroepen.
  6. Definieer een uitvoerparameterwaarde.

    Definieer een uitvoerparameterwaarde door het CreateEndpointInfo object setOutputParameterMapping en geeft de volgende waarden door:

    • Een tekenreekswaarde die de naam van de uitvoerparameter opgeeft. De naam van de uitvoerparameter voor de EncryptDocument-service is bijvoorbeeld SecuredDoc.
    • Een tekenreeks die het gegevenstype van de uitvoerparameter opgeeft. Het gegevenstype van het SecuredDoc uitvoerparameter is com.adobe.idp.Document.
    • Een tekenreekswaarde die het toewijzingstype aangeeft. U kunt bijvoorbeeld %F.pdf.
  7. Maak het eindpunt E-mail.

    Maak het eindpunt door het EndpointRegistryClient object createEndpoint en het doorgeven van de CreateEndpointInfo object. Deze methode retourneert een Endpoint object dat het eindpunt E-mail vertegenwoordigt.

  8. Laat het eindpunt toe.

    Laat het eindpunt toe door het aan te halen EndpointRegistryClient object enable en het doorgeven van de Endpoint object dat is geretourneerd door de createEndpoint methode.

Zie ook

Overzicht van de stappen

QuickStart: een eindpunt voor een gecontroleerde map toevoegen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Constante bestand voor waarden van e-mailconfiguratie email-configuration-values-constant-file

De QuickStart: een e-maileindpunt toevoegen met de Java API gebruikt een constant dossier dat deel van uw project van Java moet uitmaken om de snelle aanvang te 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";
 }

Eindpunten verwijderen toevoegen adding-remoting-endpoints

NOTE
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 verwijderen.)

Voor programmatically het toevoegen van een Remoting eindpunt aan de dienst, overweeg het volgende kortstondige proces genoemd EncryptDocument.

ar_ar_encryptdocumentprocess

Tijdens dit proces wordt een onbeveiligd PDF-document geaccepteerd als een invoerwaarde en wordt het onbeveiligde PDF-document vervolgens doorgegeven aan de Encryption Service EncryptPDFUsingPassword -bewerking. Het PDF-document wordt versleuteld met een wachtwoord en de met een wachtwoord gecodeerde PDF 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.

NOTE
U kunt geen eindpunt Remoting toevoegen door de Webdiensten te gebruiken.

Overzicht van de stappen summary_of_steps-4

Om een eindpunt uit de dienst te verwijderen, voer de volgende taken uit:

  1. Inclusief projectbestanden.
  2. Een EndpointRegistryClient object.
  3. Eindpuntkenmerken voor verwijderen instellen.
  4. Maak een eindpunt Verwijderen.
  5. Laat het eindpunt toe.

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:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)
  • jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)

Voor informatie over de locatie van deze JAR-bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.

Een EndpointRegistry-client-object maken

Om een Remoting eindpunt programmatically toe te voegen, moet u tot een EndpointRegistryClient object.

Kenmerken voor verwijderen van eindpunten instellen

Om een Remoting eindpunt voor de dienst tot stand te brengen, specificeer de volgende waarden:

  • Waarde koppelings-id: Geeft het type eindpunt op dat wordt gemaakt. Om een Remoting eindpunt tot stand te brengen, specificeer Remoting.
  • Beschrijving: Geeft de beschrijving van het eindpunt aan.
  • Naam: Geeft de naam van het eindpunt op.
  • Service-id-waarde: Specificeert de dienst waartot het eindpunt behoort. Bijvoorbeeld, om een Remoting eindpunt aan het proces toe te voegen dat in deze sectie wordt geïntroduceerd (een proces wordt de dienst wanneer het binnen Workbench wordt geactiveerd), specificeer EncryptDocument.
  • Handelingsnaam: Geeft de naam op van de bewerking die wordt aangeroepen door het eindpunt te gebruiken. Geef bij het maken van een eindpunt Remoting een jokerteken op (*).

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 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

Een eindpunt voor Verwijderen toevoegen met de Java API add-a-remoting-endpoint-using-the-java-api

Voeg een Remoting eindpunt toe door Java API te gebruiken:

  1. Inclusief projectbestanden.

    Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project.

  2. Creeer een voorwerp van de Cliënt EndpointRegistry.

    • Een ServiceClientFactory object dat verbindingseigenschappen bevat.
    • Een EndpointRegistryClient object door de constructor ervan te gebruiken en de ServiceClientFactory object.
  3. Eindpuntkenmerken voor verwijderen instellen.

    • Een CreateEndpointInfo object met behulp van de constructor.
    • Specificeer de waarde van schakelaarherkenningsteken door te roepen CreateEndpointInfo object setConnectorId methode en het doorgeven van de tekenreekswaarde Remoting.
    • Specificeer de beschrijving van het eindpunt door te roepen CreateEndpointInfo object setDescription methode en het overgaan van een koordwaarde die het eindpunt beschrijft.
    • Specificeer de naam van het eindpunt door te roepen CreateEndpointInfo object setName methode en het overgaan van een koordwaarde die de naam specificeert.
    • Specificeer de dienst waartot het eindpunt door behoort aan te halen CreateEndpointInfo object setServiceId methode en het overgaan van een koordwaarde die de de dienstnaam specificeert.
    • Geef de bewerking op die door de CreateEndpointInfo object setOperationName methode en het overgaan van een koordwaarde die de verrichtingsnaam specificeert. Geef voor een eindpunt Verwijderen een jokerteken op (*).
  4. Maak een eindpunt Verwijderen.

    Maak het eindpunt door het EndpointRegistryClient object createEndpoint en het doorgeven van de CreateEndpointInfo object. Deze methode retourneert een Endpoint object dat het nieuwe eindpunt Remoting vertegenwoordigt.

  5. Laat het eindpunt toe.

    Laat het eindpunt toe door het aan te halen EndpointRegistryClient object enable en het doorgeven van de Endpoint object dat is geretourneerd door de createEndpoint methode.

Zie ook

Overzicht van de stappen

QuickStart: een eindpunt voor verwijderen toevoegen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

TaskManager-eindpunten toevoegen adding-taskmanager-endpoints

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.

NOTE
U kunt geen eindpunt TaskManager toevoegen door de Webdiensten te gebruiken.

Overzicht van de stappen summary_of_steps-5

Om een eindpunt TaskManager aan de dienst toe te voegen, voer de volgende taken uit:

  1. Inclusief projectbestanden.
  2. Een EndpointRegistryClient object.
  3. Maak een categorie voor het eindpunt.
  4. Stel de eindpuntkenmerken van TaskManager in.
  5. Creeer een eindpunt TaskManager.
  6. Laat het eindpunt toe.

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:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)
  • jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)

Voor informatie over de locatie van deze JAR-bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.

Een EndpointRegistry-client-object maken

Alvorens u een eindpunt kunt programmatically toevoegen TaskManager, moet u tot een EndpointRegistryClient object.

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 categorie leiden.

NOTE
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:

  • Connector-id: Geeft het type eindpunt op dat wordt gemaakt. Om een eindpunt te creëren TaskManager, specificeer TaskManagerConnector.
  • Beschrijving: Geeft de beschrijving van het eindpunt aan.
  • Naam: Geeft de naam van het eindpunt op.
  • Service-id: Specificeert de dienst waartot het eindpunt behoort.
  • Categorie: Geeft een categorie-id-waarde op die aan het TaskManager-eindpunt is gekoppeld.
  • Handelingsnaam: Typisch, wanneer het creëren van een eindpunt TaskManager voor de dienst die uit een proces voortkwam dat in Workbench wordt gecreeerd, is de naam van de verrichting 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 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

Een TaskManager-eindpunt toevoegen met de Java API add-a-taskmanager-endpoint-using-the-java-api

Voeg een eindpunt TaskManager door Java API toe te gebruiken:

  1. Inclusief projectbestanden.

    Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project.

  2. Creeer een voorwerp van de Cliënt EndpointRegistry.

    • Een ServiceClientFactory object dat verbindingseigenschappen bevat.
    • Een EndpointRegistryClient object door de constructor ervan te gebruiken en de ServiceClientFactory object.
  3. Maak een categorie voor het eindpunt.

    • Een CreateEndpointCategoryInfo -object door de constructor ervan te gebruiken en de volgende waarden door te geven:

      • Een tekenreekswaarde die de id-waarde van de categorie opgeeft
      • Een tekenreekswaarde die de beschrijving van de categorie opgeeft
    • Maak de categorie door de EndpointRegistryClient object createEndpointCategory en het doorgeven van de CreateEndpointCategoryInfo object. Deze methode retourneert een EndpointCategory object dat de nieuwe categorie vertegenwoordigt.

  4. Stel de eindpuntkenmerken van TaskManager in.

    • Een CreateEndpointInfo object met behulp van de constructor.
    • Specificeer de waarde van schakelaarherkenningsteken door te roepen CreateEndpointInfo object setConnectorId methode en het doorgeven van de tekenreekswaarde TaskManagerConnector.
    • Specificeer de beschrijving van het eindpunt door te roepen CreateEndpointInfo object setDescription methode en het overgaan van een koordwaarde die het eindpunt beschrijft.
    • Specificeer de naam van het eindpunt door te roepen CreateEndpointInfo object setName methode en het overgaan van een koordwaarde die de naam specificeert.
    • Specificeer de dienst waartot het eindpunt door behoort aan te halen CreateEndpointInfo object setServiceId methode en het overgaan van een koordwaarde die de de dienstnaam specificeert.
    • Specificeer de categorie waartot het eindpunt behoort door te roepen CreateEndpointInfo object setCategoryId methode en het overgaan van een koordwaarde die de categorie herkenningstekenwaarde specificeert. U kunt de EndpointCategory object getId methode om de id-waarde van deze categorie op te halen.
    • Geef de bewerking op die wordt aangeroepen door het CreateEndpointInfo object setOperationName methode en het overgaan van een koordwaarde die de verrichtingsnaam specificeert. Meestal bij het maken van een TaskManager eindpunt voor de dienst die van een proces voortkwam dat in Workbench wordt gecreeerd, is de naam van de verrichting invoke.
  5. Creeer een eindpunt TaskManager.

    Maak het eindpunt door het EndpointRegistryClient object createEndpoint en het doorgeven van de CreateEndpointInfo object. Deze methode retourneert een Endpoint voorwerp dat het nieuwe eindpunt TaskManager vertegenwoordigt.

  6. Laat het eindpunt toe.

    Laat het eindpunt toe door het aan te halen EndpointRegistryClient object enable en het doorgeven van de Endpoint object dat is geretourneerd door de createEndpoint methode.

Zie ook

Overzicht van de stappen

QuickStart: een TaskManager-eindpunt toevoegen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Eindpunten wijzigen modifying-endpoints

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 Eindpunten van gecontroleerde mappen toevoegen.

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.

NOTE
U kunt een eindpunt niet wijzigen door de Webdiensten te gebruiken.

Overzicht van de stappen summary_of_steps-6

Om een eindpunt te wijzigen, voer de volgende taken uit:

  1. Inclusief projectbestanden.
  2. Een EndpointRegistryClient object.
  3. Haal het eindpunt op.
  4. Geef nieuwe configuratiewaarden op.

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:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)
  • jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)

Voor informatie over de locatie van deze JAR-bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.

Een EndpointRegistry-client-object maken

Om een eindpunt programmatically te wijzigen, moet u tot een EndpointRegistryClient object.

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 Eindpunten van gecontroleerde mappen toevoegen.

NOTE
Voor informatie over configuratiewaarden die tot een E-maileindpunt behoren, zie E-maileindpunten toevoegen.
NOTE
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 één. (Zie Eindpunten verwijderen.)

Zie ook

Een eindpunt wijzigen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Een eindpunt wijzigen met de Java API modifying-an-endpoint-using-the-java-api

Wijzig een eindpunt door Java API te gebruiken:

  1. Inclusief projectbestanden.

    Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project.

  2. Creeer een voorwerp van de Cliënt EndpointRegistry.

    • Een ServiceClientFactory object dat verbindingseigenschappen bevat.
    • Een EndpointRegistryClient object door de constructor ervan te gebruiken en de ServiceClientFactory object.
  3. Haal het eindpunt op dat u wilt wijzigen.

    • Hiermee wordt een lijst opgehaald met alle eindpunten waartoe de huidige gebruiker (opgegeven in de eigenschappen van de verbinding) toegang heeft door het EndpointRegistryClient object getEndpoints methode en een PagingFilter -object dat als filter fungeert. U kunt een (PagingFilter)null waarde om alle eindpunten te retourneren. Deze methode retourneert een java.util.List object waarbij elk element een Endpoint object. Voor informatie over een PagingFilter object, zie AEM Forms API-naslag.
    • Doorlopen java.util.List -object om te bepalen of het eindpunten heeft. Als er eindpunten zijn, is elk element een EndPoint -instantie.
    • Bepaal de dienst die aan een eindpunt beantwoordt door te roepen EndPoint object getServiceId methode. Deze methode retourneert een tekenreekswaarde die de servicenaam opgeeft.
    • Bepaal het type van eindpunt door te roepen EndPoint object getConnectorId methode. Deze methode retourneert een tekenreekswaarde die het type eindpunt opgeeft. Bijvoorbeeld, als het eindpunt een Gecontroleerd eindpunt van de Omslag is, keert deze methode terug WatchedFolder.
  4. Geef nieuwe configuratiewaarden op.

    • Een ModifyEndpointInfo object door de constructor ervan aan te roepen.

    • Voor elke configuratiewaarde die moet worden ingesteld, roept u de ModifyEndpointInfo object setConfigParameterAsText methode. Als u bijvoorbeeld de waarde voor de url-configuratie wilt instellen, roept u de ModifyEndpointInfo object setConfigParameterAsText en geeft de volgende waarden door:

      • Een tekenreekswaarde die de naam van de configuratiewaarde opgeeft. Als u bijvoorbeeld de opdracht url configuratiewaarde, opgeven url.
      • Een tekenreeks die de waarde van de configuratiewaarde opgeeft. Een waarde definiëren voor de url configuratiewaarde, geeft u de locatie van de gecontroleerde map op.
    • De EndpointRegistryClient object modifyEndpoint en geeft de ModifyEndpointInfo object.

Zie ook

Overzicht van de stappen

QuickStart: een eindpunt wijzigen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Eindpunten verwijderen removing-endpoints

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 EJB eindpunt uit een genoemde dienst EncryptDocument.

NOTE
U kunt geen eindpunt verwijderen door de Webdiensten te gebruiken.

Overzicht van de stappen summary_of_steps-7

Om een eindpunt uit de dienst te verwijderen, voer de volgende taken uit:

  1. Inclusief projectbestanden.
  2. Een EndpointRegistryClient object.
  3. Haal het eindpunt op.
  4. Verwijder het eindpunt.

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:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)
  • jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)

Voor informatie over de locatie van deze JAR-bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.

Een EndpointRegistry-client-object maken

Om een eindpunt programmatically te verwijderen, moet u tot een EndpointRegistryClient object.

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 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 removing-an-endpoint-using-the-java-api

Een eindpunt verwijderen met de Java API:

  1. Inclusief projectbestanden.

    Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project.

  2. Creeer een voorwerp van de Cliënt EndpointRegistry.

    • Een ServiceClientFactory object dat verbindingseigenschappen bevat.
    • Een EndpointRegistryClient object door de constructor ervan te gebruiken en de ServiceClientFactory object.
  3. Haal het te verwijderen eindpunt op.

    • Hiermee wordt een lijst opgehaald met alle eindpunten waartoe de huidige gebruiker (opgegeven in de eigenschappen van de verbinding) toegang heeft door het EndpointRegistryClient object getEndpoints methode en een PagingFilter -object dat als filter fungeert. U kunt (PagingFilter)null om alle eindpunten te retourneren. Deze methode retourneert een java.util.List object waarbij elk element een Endpoint object.
    • Doorlopen java.util.List -object om te bepalen of het eindpunten heeft. Als er eindpunten zijn, is elk element een EndPoint -instantie.
    • Bepaal de dienst die aan een eindpunt beantwoordt door te roepen EndPoint object getServiceId methode. Deze methode retourneert een tekenreekswaarde die de servicenaam opgeeft.
    • Bepaal het type van eindpunt door te roepen EndPoint object getConnectorId methode. Deze methode retourneert een tekenreekswaarde die het type eindpunt opgeeft. Als het eindpunt bijvoorbeeld een EJB-eindpunt is, retourneert deze methode EJB.
  4. Verwijder het eindpunt.

    Verwijder het eindpunt door het aan te halen EndpointRegistryClient object remove en het doorgeven van de EndPoint object dat het eindpunt vertegenwoordigt dat moet worden verwijderd.

Zie ook

Overzicht van de stappen

QuickStart: een eindpunt verwijderen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Gegevens eindpuntconnector ophalen retrieving-endpoint-connector-information

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 Eindpunten van gecontroleerde mappen toevoegen.)

NOTE
U kunt geen informatie over eindpunten terugwinnen door de Webdiensten te gebruiken.
NOTE
Dit onderwerp gebruikt ConnectorRegistryClient API om informatie over eindpuntschakelaars terug te winnen. (Zie AEM Forms API-naslag.)

Overzicht van de stappen summary_of_steps-8

Om de informatie van de eindpuntschakelaar terug te winnen, voer de volgende taken uit:

  1. Inclusief projectbestanden.
  2. Een ConnectorRegistryClient object.
  3. Geef het type aansluiting op.
  4. Haal configuratiewaarden op.

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:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)
  • jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)

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. Voor informatie over de locatie van alle AEM Forms JAR-bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.

Creeer een voorwerp van de Cliënt ConnectorRegistry

Om de informatie van de eindpuntschakelaar programmatically terug te winnen, creeer a ConnectorRegistryClient object.

Geef het type aansluiting op

Specificeer het type van schakelaar waarvan om informatie terug te winnen. De volgende types van schakelaars bestaan:

  • EJB: Laat een cliënttoepassing toe om de dienst aan te halen gebruikend de wijze EJB.
  • SOAP: Laat een cliënttoepassing toe om de dienst aan te halen gebruikend de wijze van de ZEEP.
  • Gecontroleerde map: Schakelt gecontroleerde mappen in staat een service aan te roepen.
  • E-mail: Laat e-mailberichten toe om de dienst aan te halen.
  • Verwijderen: Laat een Flex cliënttoepassing toe om de dienst aan te halen.
  • TaskManagerConnector: Laat een gebruiker van de Werkruimte toe om de dienst van binnen Werkruimte aan te halen.

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

Gegevens van eindpuntconnector ophalen met de Java API retrieve-endpoint-connector-information-using-the-java-api

Haal de informatie van de eindpuntschakelaar door Java API te gebruiken terug:

  1. Inclusief projectbestanden.

    Neem client-JAR-bestanden, zoals adobe-livecycle-client.jar, op in het klassenpad van uw Java-project.

  2. Creeer een voorwerp van de Cliënt ConnectorRegistry.

    • Een ServiceClientFactory object dat verbindingseigenschappen bevat.
    • Een ConnectorRegistryClient object door de constructor ervan te gebruiken en de ServiceClientFactory object.
  3. Geef het type aansluiting op.

    Specificeer het schakelaartype door het ConnectorRegistryClient object getEndpointDefinition methode en het overgaan van een koordwaarde die het schakelaartype specificeert. Als u bijvoorbeeld het type gecontroleerde mapconnector wilt opgeven, geeft u de tekenreekswaarde door WatchedFolder. Deze methode retourneert een Endpoint -object dat overeenkomt met het type aansluiting.

  4. Haal configuratiewaarden op.

    • Haal configuratiewaarden terug die binnen dit eindpunt door te halen worden geassocieerd Endpoint object getConfigParameters methode. Deze methode retourneert een array met ConfigParameter objecten.
    • Haal informatie over elke configuratiewaarde op door elk element binnen de serie terug te winnen. Elk element is een ConfigParameter object. U kunt bijvoorbeeld bepalen of de configuratiewaarde verplicht of optioneel is door het aanroepen van de ConfigParameter object isRequired methode. Als de configuratiewaarde wordt vereist, dan keert deze methode terug true.

Zie ook

Overzicht van de stappen

QuickStart: informatie over eindpuntaansluiting ophalen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2