Programmaticaal het leiden Eindpunten

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

  • E-mail

  • (Verouderd voor AEM formulieren) Verwijderen

  • Taakbeheer

    OPMERKING

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

EJB-eindpunten toevoegen

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

OPMERKING

U kunt geen EJB eindpunt toevoegen door de Webdiensten te gebruiken.

OPMERKING

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

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

  1. Inclusief projectbestanden.
  2. Maak 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)

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:

  • Connector-id: Geeft het type eindpunt op dat moet worden gemaakt. Als u een EJB-eindpunt wilt maken, geeft u EJB op.
  • Omschrijving: Specificeert de eindpuntbeschrijving.
  • Naam: Specificeert de naam van het eindpunt.
  • Service-id: Specificeert de dienst waartot het eindpunt behoort.
  • Bewerkingsnaam: Specificeert de naam van de verrichting die door het eindpunt te gebruiken wordt aangehaald. Wanneer het creëren van een eindpunt EJB, specificeer een vervangingskarakter ( *). 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

Een EJB-eindpunt toevoegen met de 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.

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

    • Maak een CreateEndpointInfo-object met de constructor ervan.
    • Geef de waarde van de connector-id op door de methode setConnectorId van het object CreateEndpointInfo aan te roepen en de tekenreekswaarde EJB door te geven.
    • Geef de beschrijving van het eindpunt op door de methode setDescription van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die het eindpunt beschrijft.
    • Geef de naam van het eindpunt op door de methode setName van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die de naam opgeeft.
    • Geef de service op waartoe het eindpunt behoort door de methode setServiceId van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die de servicenaam opgeeft.
    • Geef de bewerking op die wordt aangeroepen door de methode 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.
  4. 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.

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

Overzicht van de stappen

QuickStart: Een EJB-eindpunt toevoegen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

SOAP-eindpunten toevoegen

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.

OPMERKING

U kunt geen eindpunt van de ZEEP toevoegen door de Webdiensten te gebruiken.

OPMERKING

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

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

  1. Inclusief projectbestanden.
  2. Maak 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 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:

  • Waarde koppelings-id: Geeft het type eindpunt op dat moet worden gemaakt. Om een eindpunt van de ZEEP tot stand te brengen, specificeer SOAP.
  • Omschrijving: Specificeert de eindpuntbeschrijving.
  • Naam: Hiermee geeft u de eindpuntnaam op.
  • Service-id-waarde: Specificeert de dienst waartot het eindpunt behoort.
  • Bewerkingsnaam: Specificeert de naam van de verrichting die door het eindpunt te gebruiken wordt aangehaald. Wanneer het creëren van een eindpunt van de ZEEP, specificeer een vervangingskarakter ( *). 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

Een SOAP-eindpunt toevoegen met de 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.

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

    • Maak een CreateEndpointInfo-object met de constructor ervan.
    • Geef de waarde van de connector-id op door de methode setConnectorId van het object CreateEndpointInfo aan te roepen en de tekenreekswaarde SOAP door te geven.
    • Geef de beschrijving van het eindpunt op door de methode setDescription van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die het eindpunt beschrijft.
    • Geef de naam van het eindpunt op door de methode setName van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die de naam opgeeft.
    • Geef de service op waartoe het eindpunt behoort door de methode setServiceId van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die de servicenaam opgeeft.
    • Geef de bewerking op die wordt aangeroepen door de methode 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.
  4. 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.

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

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

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

aw_aw_encryptdocumentprocess

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.

OPMERKING

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

Overzicht van de stappen

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

  1. Inclusief projectbestanden.
  2. Maak een EndpointRegistryClient-object.
  3. Attributen voor het eindpunt van gecontroleerde map instellen.
  4. Geef configuratiewaarden op.
  5. Definieer invoerparameterwaarden.
  6. Definieer een uitvoerparameterwaarde.
  7. Creeer een Gecontroleerd eindpunt van de Omslag.
  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)

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:

  • Connector-id: Geeft het type eindpunt op dat wordt gemaakt. Om een Gecontroleerd eindpunt van de Omslag tot stand te brengen, specificeer WatchedFolder.
  • Omschrijving: Specificeert de beschrijving van het eindpunt.
  • Naam: Specificeert de naam van het eindpunt.
  • 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 (een proces wordt de dienst wanneer geactiveerd gebruikend Workbench) wordt geïntroduceerd, specificeer EncryptDocument.
  • Bewerkingsnaam: Specificeert de naam van de verrichting die door het eindpunt te gebruiken wordt aangehaald. 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

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:

  • URL: Hier geeft u de locatie van de gecontroleerde map op. 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. Als vertraging niet is ingeschakeld, moet deze waarde langer zijn dan de tijd die nodig is om een gemiddelde taak te verwerken. anders kan het systeem overbelast raken . 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 beperkt u het aantal taken voor gecontroleerde mappen dat op een bepaald moment kan worden verwerkt. Het maximumaantal banen wordt bepaald door de batchSize waarde.
  • userName: De gebruikersnaam die wordt gebruikt wanneer een doelservice wordt aangeroepen 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; te veel bestanden tegelijk scannen kan tot gevolg hebben dat de toepassing vastloopt. De standaardwaarde is 2.
  • waitTime: De tijd, in milliseconden, om te wachten alvorens een omslag of een dossier na verwezenlijking af te tasten. 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 dat in een gecontroleerde map wordt gebruikt om te bepalen welke bestanden en mappen moeten 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 voor excludeFilePattern bijvoorbeeld 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.
  • includeFilePattern: Het patroon dat in de gecontroleerde map wordt gebruikt om te bepalen welke mappen en bestanden worden gescand en opgehaald. Als deze waarde bijvoorbeeld * 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.
  • resultFolderName: De map waarin de opgeslagen resultaten worden 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 op een service wordt uitgevoerd. De standaardwaarde is true.
  • overwriteDuplicateFilename: Als deze optie is ingesteld op true, worden bestanden in de resultatenmap en de bewaarmap 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. 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 *.pdfopgeven 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:

  • Als de service één object (één document) retourneert, is het patroon %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.
  • Als de service een lijst retourneert, is het patroon Result\%F\ en is de bronbestemming Result\sourcefilename\source1 (uitvoer 1) en Result\sourcefilename\source2 (uitvoer 2).
  • Als de service een kaart retourneert, is het patroon 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

Het eindpunt van een gecontroleerde map toevoegen met de 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.

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

    • Maak een CreateEndpointInfo-object met de constructor ervan.
    • Geef de waarde van de connector-id op door de methode setConnectorId van het object CreateEndpointInfo aan te roepen en de tekenreekswaarde WatchedFolder door te geven.
    • Geef de beschrijving van het eindpunt op door de methode setDescription van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die het eindpunt beschrijft.
    • Geef de naam van het eindpunt op door de methode setName van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die de naam opgeeft.
    • Geef de service op waartoe het eindpunt behoort door de methode setServiceId van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die de servicenaam opgeeft.
    • Geef de bewerking op die wordt aangeroepen door de methode 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.
  4. 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:

    • Een tekenreekswaarde die de naam van de configuratiewaarde opgeeft. Wanneer het plaatsen van de url configuratiewaarde, specificeer url.
    • Een tekenreekswaarde die de waarde van de configuratiewaarde opgeeft. Geef bij het instellen van de configuratiewaarde url de locatie van de gecontroleerde map op.
    OPMERKING

    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.

  5. Definieer invoerparameterwaarden.

    Definieer een invoerparameterwaarde door de methode setInputParameterMapping van het object CreateEndpointInfo aan te roepen en de volgende waarden door te geven:

    • Een tekenreekswaarde die de naam van de invoerparameter opgeeft. De naam van de invoerparameter voor de EncryptDocument-service is bijvoorbeeld InDoc.
    • Een tekenreekswaarde die het gegevenstype van de invoerparameter opgeeft. Het gegevenstype van de invoerparameter InDoc is bijvoorbeeld com.adobe.idp.Document.
    • Een tekenreekswaarde die het toewijzingstype aangeeft. U kunt bijvoorbeeld variable opgeven.
    • Een tekenreekswaarde die de waarde van het toewijzingstype opgeeft. U kunt bijvoorbeeld *.pdf opgeven als bestandspatroon.
    OPMERKING

    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.

  6. Definieer een uitvoerparameterwaarde.

    Definieer een uitvoerparameterwaarde door de methode setOutputParameterMapping van het object CreateEndpointInfo aan te roepen en de volgende waarden door te geven:

    • Een tekenreekswaarde die de naam van de uitvoerparameter opgeeft. De naam van de uitvoerparameter voor de EncryptDocument-service is bijvoorbeeld SecuredDoc.
    • Een tekenreekswaarde die het gegevenstype van de uitvoerparameter opgeeft. Het gegevenstype van de uitvoerparameter SecuredDoc is bijvoorbeeld com.adobe.idp.Document.
    • Een tekenreekswaarde die het toewijzingstype aangeeft. U kunt bijvoorbeeld %F.pdf opgeven.
  7. 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.

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

Overzicht van de stappen

QuickStart: Een eindpunt van een gecontroleerde map toevoegen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Configuratiewaarden van gecontroleerde map, constant bestand

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";
        }

E-maileindpunten toevoegen

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.

ae_ae_encryptdocumentprocess

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.

OPMERKING

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

Overzicht van de stappen

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

  1. Inclusief projectbestanden.
  2. Maak 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)

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:

  • Waarde koppelings-id: Geeft het type eindpunt op dat wordt gemaakt. Als u een e-maileindpunt wilt maken, geeft u Email op.
  • Omschrijving: Specificeert een beschrijving voor het eindpunt.
  • Naam: Specificeert de naam van het eindpunt.
  • Service-id-waarde: Specificeert de dienst waartot het eindpunt behoort. Als u bijvoorbeeld een e-maileindpunt wilt toevoegen aan het proces dat in deze sectie wordt geïntroduceerd (een proces wordt een service wanneer het wordt geactiveerd met Workbench), geeft u EncryptDocument op.
  • Bewerkingsnaam: Specificeert de naam van de verrichting die door het eindpunt te gebruiken wordt aangehaald. Typisch, wanneer het creëren van een E-maileindpunt voor de dienst die van een proces voortkwam dat in Workbench wordt gecreeerd, is de naam van de verrichting 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.

OPMERKING

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 uitsnede als de e-mail moet worden gepland door een uitsnijduitdrukking te gebruiken.
  • repeatCount: Aantal tijden het e-maileindpunt scant de omslag of de folder. 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 te controleren op inkomende e-mail. De standaardwaarde is 10.
  • startDelay: De tijd om te wachten om na de planner begint te aftasten. De standaardtijd is 0.
  • batchSize: Het aantal e-mailberichten dat de ontvanger verwerkt per scan voor optimale prestaties. De waarde -1 geeft alle e-mails aan. De standaardwaarde is 2.
  • userName: De gebruikersnaam die wordt gebruikt wanneer een doelservice wordt aangeroepen via e-mail. De standaardwaarde is SuperAdmin.
  • domainName: Een verplichte configuratiewaarde. De standaardwaarde is DefaultDom.
  • domainPattern: Geeft de domeinpatronen aan van binnenkomende e-mailberichten die de provider accepteert. Als bijvoorbeeld adobe.com wordt gebruikt, wordt alleen e-mail van adobe.com verwerkt en wordt e-mail van andere domeinen genegeerd.
  • filePattern: Hiermee worden de inkomende patronen voor bestandsbijlagen opgegeven die de provider accepteert. Hiertoe behoren bestanden met specifieke bestandsextensies (*.dat, *.xml), bestanden met specifieke namen (gegevens) en bestanden met samengestelde expressies in de naam en extensie (*…[dD][aA][Tt]). De standaardwaarde is *.
  • receivingSuccessfulJob: Een e-mailadres waarnaar berichten worden verzonden om aan te geven dat taken zijn gelukt. Standaard wordt altijd een bericht met een geslaagde taak naar de afzender verzonden. Als u 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.
  • 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 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.
  • 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 inbox te scannen. De opties zijn IMAP of POP3. De postserver van de inbox gastheer moet deze protocollen steunen.
  • inboxTimeOut: De time-out (in seconden) die de e-mailprovider nodig heeft om te wachten op reacties in het Postvak IN. De standaardwaarde is 60.
  • inboxUser: De gebruikersnaam die is vereist om u aan te melden bij de 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 haven SMTP 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 het 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: Specificeert een folder waarin om resultaten op te slaan wanneer de SMTP postserver niet operationeel is.
  • asynchroon: Wanneer deze optie is 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-maileindpunt 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 PDF documenten bevat. Wanneer alle PDF-documenten met een wachtwoord zijn gecodeerd en als het eindpunt synchroon is geconfigureerd, wordt één e-mailbericht met reacties verzonden met alle beveiligde PDF-documenten als bijlage. Als het eindpunt asynchroon is geconfigureerd, wordt voor elk beveiligd PDF-document een afzonderlijk e-mailantwoordbericht verzonden. 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. 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:

  • Als de service één object (één document) retourneert, is het patroon %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.
  • Als de service een lijst retourneert, is het patroon Result\%F\ en is de bronbestemming Result\sourcefilename\source1 (uitvoer 1) en Result\sourcefilename\source2 (uitvoer 2).
  • Als de service een kaart retourneert, is het patroon 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

Een e-maileindpunt toevoegen met de 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.

    • Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
    • Maak een EndpointRegistryClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.
  3. Emaileindpuntkenmerken instellen.

    • Maak een CreateEndpointInfo-object met de constructor ervan.
    • Geef de waarde van de connector-id op door de methode setConnectorId van het object CreateEndpointInfo aan te roepen en de tekenreekswaarde Email door te geven.
    • Geef de beschrijving van het eindpunt op door de methode setDescription van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die het eindpunt beschrijft.
    • Geef de naam van het eindpunt op door de methode setName van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die de naam opgeeft.
    • Geef de service op waartoe het eindpunt behoort door de methode setServiceId van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die de servicenaam opgeeft.
    • Geef de bewerking op die wordt aangeroepen door de methode 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.
  4. 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:

    • Een tekenreekswaarde die de naam van de configuratiewaarde opgeeft. Wanneer het plaatsen van de smtpHost configuratiewaarde, specificeer smtpHost.
    • Een tekenreekswaarde die de waarde van de configuratiewaarde opgeeft. Wanneer het plaatsen van de smtpHost configuratiewaarde, specificeer een koordwaarde die de naam van de server SMTP specificeert.
    OPMERKING

    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.

  5. Definieer invoerparameterwaarden.

    Definieer een invoerparameterwaarde door de methode setInputParameterMapping van het object CreateEndpointInfo aan te roepen en de volgende waarden door te geven:

    • Een tekenreekswaarde die de naam van de invoerparameter opgeeft. De naam van de invoerparameter voor de EncryptDocument-service is bijvoorbeeld InDoc.
    • Een tekenreekswaarde die het gegevenstype van de invoerparameter opgeeft. Het gegevenstype van de invoerparameter InDoc is bijvoorbeeld com.adobe.idp.Document.
    • Een tekenreekswaarde die het toewijzingstype aangeeft. U kunt bijvoorbeeld variable opgeven.
    • Een tekenreekswaarde die de waarde van het toewijzingstype opgeeft. U kunt bijvoorbeeld *.pdf opgeven als bestandspatroon.
    OPMERKING

    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.

  6. Definieer een uitvoerparameterwaarde.

    Definieer een uitvoerparameterwaarde door de methode CreateEndpointInfo van het object setOutputParameterMapping aan te roepen en de volgende waarden door te geven:

    • Een tekenreekswaarde die de naam van de uitvoerparameter opgeeft. De naam van de uitvoerparameter voor de EncryptDocument-service is bijvoorbeeld SecuredDoc.
    • Een tekenreekswaarde die het gegevenstype van de uitvoerparameter opgeeft. Het gegevenstype van de uitvoerparameter SecuredDoc is bijvoorbeeld com.adobe.idp.Document.
    • Een tekenreekswaarde die het toewijzingstype aangeeft. U kunt bijvoorbeeld %F.pdf opgeven.
  7. 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.

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

Overzicht van de stappen

QuickStart: Een eindpunt van een gecontroleerde map toevoegen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Constante bestand voor waarden van e-mailconfiguratie

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";
 }

Eindpunten verwijderen toevoegen

OPMERKING

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.

ar_ar_encryptdocumentprocess

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.

OPMERKING

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

Overzicht van de stappen

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

  1. Inclusief projectbestanden.
  2. Maak 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)

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:

  • Waarde koppelings-id: Geeft het type eindpunt op dat wordt gemaakt. Om een Remoting eindpunt tot stand te brengen, specificeer Remoting.
  • Omschrijving: Specificeert de beschrijving van het eindpunt.
  • Naam: Specificeert de naam van het eindpunt.
  • 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.
  • Bewerkingsnaam: Specificeert de naam van de verrichting die door het eindpunt te gebruiken wordt aangehaald. 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 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

Een eindpunt voor Verwijderen toevoegen met de 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.

    • Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
    • Maak een EndpointRegistryClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.
  3. Eindpuntkenmerken voor verwijderen instellen.

    • Maak een CreateEndpointInfo-object met de constructor ervan.
    • Geef de waarde van de connector-id op door de methode setConnectorId van het object CreateEndpointInfo aan te roepen en de tekenreekswaarde Remoting door te geven.
    • Geef de beschrijving van het eindpunt op door de methode setDescription van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die het eindpunt beschrijft.
    • Geef de naam van het eindpunt op door de methode setName van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die de naam opgeeft.
    • Geef de service op waartoe het eindpunt behoort door de methode setServiceId van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die de servicenaam opgeeft.
    • Geef de bewerking op die wordt aangeroepen door de methode 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 (*).
  4. 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.

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

Overzicht van de stappen

QuickStart: Een eindpunt voor Verwijderen toevoegen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

TaskManager-eindpunten toevoegen

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.

OPMERKING

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

Overzicht van de stappen

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

  1. Inclusief projectbestanden.
  2. Maak 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)

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.

OPMERKING

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 tot stand te brengen TaskManager, specificeer TaskManagerConnector.
  • Omschrijving: Specificeert de beschrijving van het eindpunt.
  • Naam: Specificeert de naam van het eindpunt.
  • Service-id: Specificeert de dienst waartot het eindpunt behoort.
  • Categorie: Specificeert een waarde van categorieherkenningsteken die met het eindpunt TaskManager wordt geassocieerd.
  • Bewerkingsnaam: 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 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

Een TaskManager-eindpunt toevoegen met de 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.

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

    • Maak 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 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.

  4. Stel de eindpuntkenmerken van TaskManager in.

    • Maak een CreateEndpointInfo-object met de constructor ervan.
    • Geef de waarde van de connector-id op door de methode setConnectorId van het object CreateEndpointInfo aan te roepen en de tekenreekswaarde TaskManagerConnector door te geven.
    • Geef de beschrijving van het eindpunt op door de methode setDescription van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die het eindpunt beschrijft.
    • Geef de naam van het eindpunt op door de methode setName van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die de naam opgeeft.
    • Geef de service op waartoe het eindpunt behoort door de methode setServiceId van het object CreateEndpointInfo aan te roepen en een tekenreekswaarde door te geven die de servicenaam opgeeft.
    • Geef de categorie op waartoe het eindpunt behoort door de methode 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.
    • Geef de bewerking op die wordt aangeroepen door de methode 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.
  5. 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.

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

Overzicht van de stappen

QuickStart: Het toevoegen van een eindpunt TaskManager gebruikend Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Eindpunten wijzigen

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.

OPMERKING

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

Overzicht van de stappen

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

  1. Inclusief projectbestanden.
  2. Maak 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)

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.

OPMERKING

Voor informatie over configuratiewaarden die tot een E-maileindpunt behoren, zie Toevoegend E-maileindpunten.

OPMERKING

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

Een eindpunt wijzigen met de 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.

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

    • Hiermee wordt een lijst opgehaald van alle eindpunten waartoe de huidige gebruiker (opgegeven in de eigenschappen van de verbinding) toegang heeft door de methode 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.
    • Doorloop het object java.util.List 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 de EndPoint methode getServiceId van het voorwerp aan te halen. Deze methode retourneert een tekenreekswaarde die de servicenaam opgeeft.
    • Bepaal het type eindpunt door de methode 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.
  4. 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:

      • Een tekenreekswaarde die de naam van de configuratiewaarde opgeeft. Als u bijvoorbeeld de configuratiewaarde url wilt instellen, geeft u url op.
      • Een tekenreekswaarde die de waarde van de configuratiewaarde opgeeft. Als u een waarde voor de configuratiewaarde 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

Overzicht van de stappen

QuickStart: Een eindpunt wijzigen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Eindpunten verwijderen

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.

OPMERKING

U kunt geen eindpunt verwijderen door de Webdiensten te gebruiken.

Overzicht van de stappen

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

  1. Inclusief projectbestanden.
  2. Maak 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)

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

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.

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

    • Hiermee wordt een lijst opgehaald van alle eindpunten waartoe de huidige gebruiker (opgegeven in de verbindingseigenschappen) toegang heeft door de methode 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.
    • Doorloop het object java.util.List 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 de EndPoint methode getServiceId van het voorwerp aan te halen. Deze methode retourneert een tekenreekswaarde die de servicenaam opgeeft.
    • Bepaal het type eindpunt door de methode 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.
  4. 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

Overzicht van de stappen

QuickStart: Een eindpunt verwijderen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Gegevens eindpuntconnector ophalen

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

OPMERKING

U kunt geen informatie over eindpunten terugwinnen door de Webdiensten te gebruiken.

OPMERKING

Dit onderwerp gebruikt ConnectorRegistryClient API om informatie over eindpuntschakelaars terug te winnen. (Zie AEM Forms API Reference.)

Overzicht van de stappen

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

  1. Inclusief projectbestanden.
  2. Maak 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. 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:

  • 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: Hiermee kunnen gecontroleerde mappen een service aanroepen.
  • 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

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.

    • Maak een ServiceClientFactory-object dat verbindingseigenschappen bevat.
    • Maak een ConnectorRegistryClient-object door de constructor ervan te gebruiken en het object ServiceClientFactory door te geven.
  3. 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.

  4. Haal configuratiewaarden op.

    • Haal configuratiewaarden op die binnen dit eindpunt worden geassocieerd door de Endpoint methode getConfigParameters van het voorwerp aan te halen. Deze methode retourneert een array van 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 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

Overzicht van de stappen

QuickStart: Gegevens van eindpuntconnector ophalen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Op deze pagina