Show Menu
ARGOMENTI×

Gestione programmatica degli endpoint

Informazioni su Endpoint Registry Service
Il servizio del Registro di sistema degli endpoint consente di gestire gli endpoint a livello di programmazione. Ad esempio, potete aggiungere i seguenti tipi di endpoint a un servizio:
  • EJB
  • SOAP
  • Cartella esaminata
  • E-mail
  • (obsoleto per i moduli AEM) Remoting
  • Task Manager
I punti finali SOAP, EJB e (obsoleti per i moduli AEM su JEE) Remoting vengono creati automaticamente per ciascun servizio attivato. Gli endpoint SOAP ed EJB consentono SOAP ed EJB per tutte le operazioni di servizio.
Un endpoint remoto consente ai client Flex di richiamare le operazioni sul servizio AEM Forms a cui viene aggiunto l'endpoint. Viene creata una destinazione Flex con lo stesso nome dell'endpoint e i client Flex possono creare RemoteObjects che puntano a questa destinazione per richiamare le operazioni sul servizio pertinente.
Gli endpoint E-mail, Task Manager e Cartella esaminata mostrano solo un'operazione specifica del servizio. L'aggiunta di questi endpoint richiede un secondo passaggio di configurazione per selezionare un metodo da richiamare, impostare i parametri di configurazione e specificare le mappature dei parametri di input e output.
È possibile organizzare gli endpoint di TaskManager in gruppi denominati categorie . Queste categorie vengono quindi esposte a Workspace tramite TaskManager, con gli utenti finali che visualizzano gli endpoint di TaskManager man mano che vengono classificati. In Workspace, gli utenti finali visualizzano queste categorie nel riquadro di navigazione. Gli endpoint all'interno di ciascuna categoria vengono visualizzati come schede di processo nella pagina Processi iniziali di Workspace.
È possibile eseguire le seguenti attività utilizzando il servizio del Registro di sistema di Endpoint:

Aggiunta di endpoint EJB

Puoi aggiungere a livello di programmazione un endpoint EJB a un servizio utilizzando l'API Java AEM Forms. Aggiungendo un endpoint EJB a un servizio, si sta abilitando un'applicazione client per richiamare il servizio utilizzando la modalità EJB. In altre parole, quando si impostano le proprietà di connessione necessarie per richiamare AEM Forms, è possibile selezionare la modalità EJB. (Vedere Impostazione delle proprietà di connessione.)
Non è possibile aggiungere un endpoint EJB utilizzando i servizi Web.
In genere, un endpoint EJB viene aggiunto a un servizio per impostazione predefinita. Tuttavia, un endpoint EJB può essere aggiunto a un processo distribuito a livello di programmazione o quando un endpoint EJB è stato rimosso e deve essere aggiunto di nuovo.

Riepilogo dei passaggi

Per aggiungere un endpoint EJB a un servizio, eseguire le operazioni seguenti:
  1. Includere i file di progetto.
  2. Creare un EndpointRegistry Client oggetto.
  3. Impostate gli attributi dell’endpoint EJB.
  4. Create un endpoint EJB.
  5. Abilitate l’endpoint.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (richiesto se i AEM Forms sono distribuiti su JBoss Application Server)
  • jbossall-client.jar (richiesto se i AEM Forms sono distribuiti in JBoss Application Server)
Per informazioni sulla posizione di questi file JAR, vedere Inclusione di file libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Prima di poter aggiungere un endpoint EJB a livello di programmazione, è necessario creare un EndpointRegistryClient oggetto.
Impostazione degli attributi dell’endpoint EJB
Per creare un endpoint EJB per un servizio, specificate i seguenti valori:
  • Identificatore del connettore: Specifica il tipo di endpoint da creare. Per creare un endpoint EJB, specificate EJB .
  • Descrizione : Specifica la descrizione dell'endpoint.
  • Nome : Specifica il nome dell'endpoint.
  • Identificatore servizio: Specifica il servizio a cui appartiene l'endpoint.
  • Nome operazione: Specifica il nome dell'operazione richiamata utilizzando l'endpoint. Quando create un endpoint EJB, specificate un carattere jolly ( * ). Tuttavia, se si desidera specificare un'operazione specifica invece di richiamare tutte le operazioni del servizio, specificare il nome dell'operazione invece di utilizzare il carattere jolly ( * ).
Creare un endpoint EJB
Dopo aver impostato gli attributi dell'endpoint EJB, potete creare un endpoint EJB per un servizio.
Abilitare l'endpoint
Dopo aver creato un nuovo endpoint, è necessario abilitarlo. Dopo aver abilitato l'endpoint, può essere utilizzato per richiamare il servizio. Dopo aver attivato l’endpoint, potete visualizzarlo nella console di amministrazione.
Consulta anche

Aggiunta di un endpoint EJB tramite l'API Java

Aggiungete un endpoint EJB utilizzando l'API Java:
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java. (
  2. Creare un oggetto Client EndpointRegistry.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un EndpointRegistryClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Impostate gli attributi dell’endpoint EJB.
    • Creare un CreateEndpointInfo oggetto utilizzando il relativo costruttore.
    • Specificare il valore dell'identificatore del connettore richiamando il metodo dell' CreateEndpointInfo oggetto setConnectorId e passando il valore della stringa EJB .
    • Specificate la descrizione dell'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setDescription e passando un valore di stringa che descrive l'endpoint.
    • Specificare il nome dell'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setName e passando un valore di stringa che specifica il nome.
    • Specificare il servizio al quale appartiene l'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setServiceId e passando un valore di stringa che specifica il nome del servizio.
    • Specificare l'operazione richiamata richiamando il metodo dell' CreateEndpointInfo oggetto setOperationName e passare un valore di stringa che specifica il nome dell'operazione. Per gli endpoint SOAP ed EJB, specificate un carattere jolly ( * ), che implica tutte le operazioni.
  4. Create un endpoint EJB.
    Creare l'endpoint richiamando il metodo dell' EndpointRegistryClient oggetto createEndpoint e passando l' CreateEndpointInfo oggetto. Questo metodo restituisce un Endpoint oggetto che rappresenta il nuovo endpoint EJB.
  5. Abilitate l’endpoint.
    Abilitare l'endpoint richiamando il metodo enable dell' EndpointRegistryClient oggetto e passando l' Endpoint oggetto restituito dal createEndpoint metodo.
Consulta anche

Aggiunta di endpoint SOAP

È possibile aggiungere a livello di programmazione un endpoint SOAP a un servizio utilizzando l'API Java AEM Forms. Aggiungendo un endpoint SOAP, si abilita un'applicazione client per richiamare il servizio utilizzando la modalità SOAP. In altre parole, quando si impostano le proprietà di connessione necessarie per richiamare AEM Forms, è possibile selezionare la modalità SOAP.
Non è possibile aggiungere un endpoint SOAP utilizzando i servizi Web.
In genere, un endpoint SOAP viene aggiunto a un servizio per impostazione predefinita, tuttavia, un endpoint SOAP può essere aggiunto a un processo distribuito a livello di programmazione o quando un endpoint SOAP è stato rimosso e deve essere aggiunto di nuovo.

Riepilogo dei passaggi

Per aggiungere un endpoint SOAP a un servizio, eseguire le operazioni seguenti:
  1. Includere i file di progetto.
  2. Creare un EndpointRegistryClient oggetto.
  3. Impostate gli attributi dell'endpoint SOAP.
  4. Creare un endpoint SOAP.
  5. Abilitate l’endpoint.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (richiesto se i AEM Forms sono distribuiti su JBoss Application Server)
  • jbossall-client.jar (richiesto se i AEM Forms sono distribuiti in JBoss Application Server)
Questi file JAR sono necessari per creare un endpoint SOAP. Tuttavia, è necessario aggiungere file JAR se si utilizza l'endpoint SOAP per richiamare il servizio. Per informazioni sui file JAR AEM Forms, vedere Inclusione di file libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Per aggiungere a livello di programmazione un endpoint SOAP a un servizio, è necessario creare un EndpointRegistryClient oggetto.
Imposta attributi endpoint SOAP
Per aggiungere un endpoint SOAP a un servizio, specificate i seguenti valori:
  • Valore identificatore connettore: Specifica il tipo di endpoint da creare. Per creare un endpoint SOAP, specificare SOAP .
  • Descrizione : Specifica la descrizione dell'endpoint.
  • Nome : Specifica il nome dell'endpoint.
  • Valore ID servizio: Specifica il servizio a cui appartiene l'endpoint.
  • Nome operazione: Specifica il nome dell'operazione richiamata utilizzando l'endpoint. Quando create un endpoint SOAP, specificate un carattere jolly ( * ). Tuttavia, se si desidera specificare un'operazione specifica invece di richiamare tutte le operazioni del servizio, specificare il nome dell'operazione invece di utilizzare il carattere jolly ( * ).
Creare un endpoint SOAP
Dopo aver impostato gli attributi dell'endpoint SOAP, potete creare un endpoint SOAP.
Abilitare l'endpoint
Dopo aver creato un nuovo endpoint, è necessario abilitarlo. Quando l'endpoint è abilitato, può essere utilizzato per richiamare il servizio. Dopo aver attivato l’endpoint, potete visualizzarlo nella console di amministrazione.
Consulta anche

Aggiunta di un endpoint SOAP tramite l'API Java

Aggiungete un endpoint SOAP a un servizio utilizzando l'API Java:
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto Client EndpointRegistry.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un EndpointRegistryClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Impostate gli attributi dell'endpoint SOAP.
    • Creare un CreateEndpointInfo oggetto utilizzando il relativo costruttore.
    • Specificare il valore dell'identificatore del connettore richiamando il metodo dell' CreateEndpointInfo oggetto setConnectorId e passando il valore della stringa SOAP .
    • Specificate la descrizione dell'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setDescription e passando un valore di stringa che descrive l'endpoint.
    • Specificare il nome dell'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setName e passando un valore di stringa che specifica il nome.
    • Specificare il servizio al quale appartiene l'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setServiceId e passando un valore di stringa che specifica il nome del servizio.
    • Specificare l'operazione richiamata richiamando il metodo dell' CreateEndpointInfo oggetto setOperationName e passando un valore di stringa che specifica il nome dell'operazione. Per gli endpoint SOAP ed EJB, specificate un carattere jolly ( * ), che implica tutte le operazioni.
  4. Creare un endpoint SOAP.
    Creare l'endpoint richiamando il metodo dell' EndpointRegistryClient oggetto createEndpoint e passando l' CreateEndpointInfo oggetto. Questo metodo restituisce un Endpoint oggetto che rappresenta il nuovo endpoint SOAP.
  5. Abilitate l’endpoint.
    Abilitare l'endpoint richiamando il metodo enable dell' EndpointRegistryClient oggetto e passando l' Endpoint oggetto restituito dal createEndpoint metodo.
Consulta anche

Aggiunta di endpoint cartelle esaminate

È possibile aggiungere a livello di programmazione un endpoint di cartelle esaminate a un servizio utilizzando l'API Java AEM Forms. Aggiungendo un endpoint cartella esaminata, gli utenti possono inserire un file (ad esempio un file PDF) in una cartella. Quando il file viene inserito nella cartella, viene richiamato il servizio configurato e manipolato il file. Dopo che il servizio ha eseguito l'operazione specificata, salva il file modificato in una cartella di output specificata. Una cartella esaminata è configurata per essere analizzata a un intervallo di frequenza fissa o con una pianificazione cron, ad esempio ogni lunedì, mercoledì e venerdì a mezzogiorno.
Per aggiungere in modo programmatico un endpoint di una cartella esaminata a un servizio, è consigliabile seguire il seguente processo di breve durata denominato EncryptDocument . (Vedere Informazioni sui processi AEM Forms.)
Questo processo accetta un documento PDF non protetto come valore di input e quindi passa il documento PDF non protetto all'operazione del servizio EncryptPDFUsingPassword di cifratura. Il documento PDF è crittografato con una password e il documento PDF crittografato con password è il valore di output di questo processo. Il nome del valore di input (il documento PDF non protetto) è InDoc e il tipo di dati è com.adobe.idp.Document . Il nome del valore di output (il documento PDF crittografato con password) è SecuredDoc e il tipo di dati è com.adobe.idp.Document .
Non è possibile aggiungere un endpoint cartella esaminata utilizzando i servizi Web.

Riepilogo dei passaggi

Per aggiungere a un servizio un endpoint della cartella esaminata, eseguire le operazioni seguenti:
  1. Includere i file di progetto.
  2. Creare un EndpointRegistryClient oggetto.
  3. Impostate gli attributi endpoint cartella esaminata.
  4. Specificate i valori di configurazione.
  5. Definire i valori dei parametri di input.
  6. Definire un valore di parametro di output.
  7. Crea un endpoint cartella esaminata.
  8. Abilitate l’endpoint.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (richiesto se i AEM Forms sono distribuiti su JBoss Application Server)
  • jbossall-client.jar (richiesto se i AEM Forms sono distribuiti in JBoss Application Server)
Per informazioni sulla posizione di questi file JAR, vedere Inclusione di file libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Per aggiungere a livello di programmazione un endpoint Cartella osservata, è necessario creare un EndpointRegistryClient oggetto.
Imposta attributi endpoint cartella esaminata
Per creare un endpoint della cartella esaminata per un servizio, specificate i seguenti valori:
  • Identificatore del connettore: Specifica il tipo di endpoint creato. Per creare un endpoint cartella esaminata, specificate WatchedFolder .
  • Descrizione : Specifica la descrizione dell'endpoint.
  • Nome : Specifica il nome dell'endpoint.
  • Identificatore servizio: Specifica il servizio a cui appartiene l'endpoint. Ad esempio, per aggiungere un endpoint cartella esaminata al processo introdotto in questa sezione (un processo diventa un servizio quando attivato tramite Workbench), specificare EncryptDocument .
  • Nome operazione: Specifica il nome dell'operazione richiamata utilizzando l'endpoint. In genere, durante la creazione di un endpoint di tipo Cartella esaminata per un servizio originato da un processo creato in Workbench, il nome dell'operazione è invoke .
Specificare i valori di configurazione
È necessario specificare i valori di configurazione per un endpoint di una cartella esaminata quando si aggiunge a livello di programmazione un endpoint di una cartella esaminata a un servizio. Questi valori di configurazione vengono specificati da un amministratore se un endpoint della cartella esaminata viene aggiunto utilizzando la console di amministrazione.
L'elenco seguente specifica i valori di configurazione impostati durante l'aggiunta a livello di programmazione di un endpoint di una cartella esaminata a un servizio:
  • url : Specifica il percorso della cartella esaminata. In un ambiente cluster, questo valore deve puntare a una cartella di rete condivisa accessibile da ogni computer del cluster.
  • asincrono : Identifica il tipo di chiamata come asincrono o sincrono. I processi transitori e sincroni possono essere invocati solo in modo sincrono. Il valore predefinito è true. È consigliabile l'impostazione asincrona.
  • cronExpression : Utilizzato da quarzo per pianificare il polling della directory di input. Per informazioni dettagliate sulla configurazione dell'espressione cron, vedere https://quartz.sourceforge.net/javadoc/org/quartz/CronTrigger.html .
  • purgeDuration : Si tratta di un attributo obbligatorio. I file e le cartelle nella cartella dei risultati vengono eliminati quando sono più vecchi di questo valore. Questo valore viene misurato in giorni. Questo attributo è utile per evitare che la cartella dei risultati diventi piena. Un valore pari a -1 giorni indica di non eliminare mai la cartella dei risultati. Il valore predefinito è -1.
  • repeatInterval : L’intervallo, in secondi, per la scansione della cartella esaminata per l’input. A meno che non sia abilitata la limitazione, questo valore deve essere maggiore del tempo necessario per elaborare un processo medio; in caso contrario, il sistema potrebbe sovraccaricarsi. Il valore predefinito è 5.
  • repeatCount : Il numero di volte in cui una cartella esaminata esegue la scansione della cartella o della directory. Il valore -1 indica una scansione indefinita. Il valore predefinito è -1.
  • throttleOn : Limita il numero di processi delle cartelle esaminate che possono essere elaborati in un dato momento. Il numero massimo di processi è determinato dal valore batchSize.
  • userName : Nome utente utilizzato per richiamare un servizio di destinazione dalla cartella esaminata. Questo valore è obbligatorio. Il valore predefinito è SuperAdmin.
  • domainName : Il dominio dell’utente. Questo valore è obbligatorio. Il valore predefinito è DefaultDom.
  • batchSize : Numero di file o cartelle da raccogliere per scansione. utilizzare questo valore per evitare un sovraccarico del sistema; la scansione di troppi file alla volta può causare un arresto anomalo. Il valore predefinito è 2.
  • waitTime : Tempo, in millisecondi, di attesa prima della scansione di una cartella o di un file dopo la creazione. Ad esempio, se il tempo di attesa è di 36.000.000 millisecondi (un'ora) e il file è stato creato un minuto fa, questo file viene recuperato dopo che sono passati 59 o più minuti. Questo attributo è utile per garantire che un file o una cartella venga copiato completamente nella cartella di input. Ad esempio, se si dispone di un file di grandi dimensioni da elaborare e il file richiede dieci minuti per il download, impostare il tempo di attesa su 10*60 *1000 millisecondi. Questa impostazione impedisce alla cartella esaminata di eseguire la scansione del file se non è stato in attesa per dieci minuti. Il valore predefinito è 0.
  • excludeFilePattern : Il pattern utilizzato da una cartella esaminata per determinare quali file e cartelle acquisire. I file o le cartelle con questo pattern non verranno analizzati per l'elaborazione. Questa impostazione è utile quando l’input è una cartella che contiene più file. Il contenuto della cartella può essere copiato in una cartella con un nome che verrà scelto dalla cartella esaminata. Questo passaggio impedisce alla cartella esaminata di raccogliere una cartella da elaborare prima che la cartella venga completamente copiata nella cartella di input. Ad esempio, se il valore excludeFilePattern è data* , tutti i file e le cartelle corrispondenti non data* vengono prelevati. Sono inclusi file e cartelle denominati data1 , data2 e così via. Inoltre, il pattern può essere completato con pattern di caratteri jolly per specificare i pattern di file. La cartella esaminata modifica l'espressione regolare per supportare pattern con caratteri jolly quali *.* e *.pdf . Questi pattern carattere jolly non sono supportati dalle espressioni regolari.
  • includeFilePattern : Il pattern utilizzato dalla cartella esaminata per determinare quali cartelle e file acquisire e acquisire. Ad esempio, se questo valore è * , input* vengono raccolti tutti i file e le cartelle corrispondenti. Sono inclusi file e cartelle denominati input1 , input2 e così via. Il valore predefinito è * . Questo valore indica tutti i file e le cartelle. Inoltre, il pattern può essere completato con pattern di caratteri jolly per specificare i pattern di file. La cartella esaminata modifica l'espressione regolare per supportare pattern con caratteri jolly quali *.* e *.pdf . Questi pattern carattere jolly non sono supportati dalle espressioni regolari. Questo valore è obbligatorio.
  • resultFolderName : La cartella in cui sono memorizzati i risultati salvati. Questo percorso può essere assoluto o relativo. Se i risultati non vengono visualizzati in questa cartella, controllare la cartella degli errori. I file di sola lettura non vengono elaborati e verranno salvati nella cartella degli errori. Il valore predefinito è result/%Y/%M/%D/ . Si tratta della cartella dei risultati all’interno della cartella esaminata.
  • preserveFolderName : Posizione in cui vengono memorizzati i file dopo l'esito positivo della scansione e del prelievo. Questa posizione può essere assoluta, relativa o null. Il valore predefinito è preserve/%Y/%M/%D/ .
  • failureFolderName : La cartella in cui vengono salvati i file di errore. Questo percorso è sempre relativo alla cartella esaminata. I file di sola lettura non vengono elaborati e verranno salvati nella cartella degli errori. Il valore predefinito è failure/%Y/%M/%D/ .
  • preserveOnFailed : Mantieni i file di input in caso di mancata esecuzione dell'operazione su un servizio. Il valore predefinito è true.
  • overwriteDuplicateFilename : Se è impostato su true, i file nella cartella dei risultati e nella cartella preserve vengono sovrascritti. Se è impostata su false, per il nome vengono utilizzati file e cartelle con un suffisso indice numerico. Il valore predefinito è false.
Definire i valori dei parametri di input
Quando si crea un endpoint della cartella esaminata, è necessario definire i valori dei parametri di input. È quindi necessario descrivere i valori di input passati all'operazione richiamata dalla cartella esaminata. Ad esempio, prendete in considerazione il processo introdotto in questo argomento. Ha un valore di input denominato InDoc e il suo tipo di dati è com.adobe.idp.Document . Quando create un endpoint della cartella esaminata per questo processo (dopo che un processo è stato attivato, diventa un servizio), dovete definire il valore del parametro di input.
Per definire i valori dei parametri di input richiesti per l’endpoint di una cartella esaminata, specificate i seguenti valori:
Nome del parametro di input: Nome del parametro di input. Il nome di un valore di input è specificato in Workbench per un processo. Se il valore di input appartiene a un'operazione di servizio (un servizio che non è un processo creato in Workbench), il nome di input è specificato nel file component.xml. Ad esempio, il nome del parametro di input per il processo introdotto in questa sezione è InDoc .
Tipo mapping: Utilizzato per configurare i valori di input necessari per richiamare l'operazione del servizio. Esistono due tipi di mapping:
  • Literal : L’endpoint Cartella osservata utilizza il valore immesso nel campo così come viene visualizzato. Sono supportati tutti i tipi Java di base. Ad esempio, se un'API utilizza input quali String, long, int e Boolean, la stringa viene convertita nel tipo corretto e il servizio viene richiamato.
  • Variable : Il valore immesso è un pattern di file utilizzato dalla cartella esaminata per selezionare l'input. Ad esempio, se si seleziona Variabile per il tipo di mappatura e il documento di input deve essere un file PDF, è possibile specificare *.pdf come valore di mappatura.
Valore mappatura: Specifica il valore del tipo di mappatura. Ad esempio, se si seleziona un tipo di Variable mapping, è possibile specificare *.pdf come pattern di file.
Tipo di dati: Specifica il tipo di dati dei valori di input. Ad esempio, il tipo di dati del valore immesso per il processo introdotto in questa sezione è com.adobe.idp.Document .
Definire un valore di parametro di output
Quando create un endpoint cartella esaminata, dovete definire un valore di parametro di output. È quindi necessario descrivere il valore di output restituito dal servizio richiamato dall'endpoint Cartella osservata. Ad esempio, prendete in considerazione il processo introdotto in questo argomento. Il valore di output è denominato SecuredDoc e il tipo di dati è com.adobe.idp.Document . Quando create un endpoint della cartella esaminata per questo processo (dopo che un processo è attivato, diventa un servizio), dovete definire il valore del parametro di output.
Per definire un valore del parametro di output richiesto per un endpoint di una cartella esaminata, specificate i seguenti valori:
Nome del parametro di output: Nome del parametro di output. Il nome di un valore di output del processo è specificato in Workbench. Se il valore di output appartiene a un'operazione di servizio (un servizio che non è un processo creato in Workbench), il nome di output è specificato nel file component.xml. Ad esempio, il nome del parametro di output per il processo introdotto in questa sezione è SecuredDoc .
Tipo mapping: Utilizzato per configurare l'output del servizio e l'operazione. Sono disponibili le seguenti opzioni:
  • Se il servizio restituisce un singolo oggetto (un singolo documento), il pattern è uguale a quello della destinazione di origine è sourcefilename.pdf. %F.pdf Ad esempio, il processo introdotto in questa sezione restituisce un singolo documento. Di conseguenza, il tipo di mappatura può essere definito come %F.pdf ( %F ovvero utilizzare il nome file specificato). Il pattern %E specifica l'estensione del documento di input.
  • Se il servizio restituisce un elenco, il pattern è Result\%F\ e la destinazione di origine è Result\sourcefilename\source1 (output 1) e Result\sourcefilename\source2 (output 2).
  • Se il servizio restituisce una mappa, il pattern è Result\%F\ e la destinazione di origine è Result\sourcefilename\file1 and Result\sourcefilename\file2. Se la mappa ha più di un oggetto, il pattern è uguale Result\%F.pdf e la destinazione di origine è Result\sourcefilename1.pdf (output 1), Result\sourcefilenam2.pdf (output 2) e così via.
Tipo di dati: Specifica il tipo di dati del valore restituito. Ad esempio, il tipo di dati del valore restituito dal processo introdotto in questa sezione è com.adobe.idp.Document .
Creare un endpoint cartella esaminata
Dopo aver impostato gli attributi dell’endpoint, i valori di configurazione e i valori dei parametri di input e output, dovete creare l’endpoint della cartella esaminata.
Abilitare l'endpoint
Dopo aver creato un endpoint cartella esaminata, è necessario attivarlo. Quando l'endpoint è abilitato, può essere utilizzato per richiamare il servizio. Dopo aver attivato l’endpoint, potete visualizzarlo nella console di amministrazione.
Consulta anche

Aggiunta di un endpoint cartella esaminata tramite l'API Java

Aggiungete un endpoint cartella esaminata utilizzando l'API Java AEM Forms:
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto Client EndpointRegistry.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un EndpointRegistryClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Impostate gli attributi endpoint cartella esaminata.
    • Creare un CreateEndpointInfo oggetto utilizzando il relativo costruttore.
    • Specificare il valore dell'identificatore del connettore richiamando il metodo dell' CreateEndpointInfo oggetto setConnectorId e passando il valore della stringa WatchedFolder .
    • Specificate la descrizione dell'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setDescription e passando un valore di stringa che descrive l'endpoint.
    • Specificare il nome dell'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setName e passando un valore di stringa che specifica il nome.
    • Specificare il servizio al quale appartiene l'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setServiceId e passando un valore di stringa che specifica il nome del servizio.
    • Specificare l'operazione richiamata richiamando il metodo dell' CreateEndpointInfo oggetto setOperationName e passando un valore di stringa che specifica il nome dell'operazione. In genere, durante la creazione di un endpoint di tipo Cartella esaminata per un servizio originato da un processo creato in Workbench, viene richiamato il nome dell'operazione.
  4. Specificate i valori di configurazione.
    Per ogni valore di configurazione da impostare per l'endpoint della cartella esaminata, è necessario richiamare il CreateEndpointInfo metodo dell' setConfigParameterAsText . Ad esempio, per impostare il valore di url configurazione, richiamare il metodo dell' CreateEndpointInfo oggetto setConfigParameterAsText e passare i seguenti valori stringa:
    • Un valore di stringa che specifica il nome del valore di configurazione. Quando impostate il valore di url configurazione, specificate url .
    • Un valore di stringa che specifica il valore del valore di configurazione. Quando impostate il valore di url configurazione, specificate il percorso della cartella esaminata.
    Per visualizzare tutti i valori di configurazione impostati per il servizio EncryptDocument, vedere l'esempio di codice Java disponibile in QuickStart: Aggiunta di un endpoint cartella esaminata tramite l'API Java.
  5. Definire i valori dei parametri di input.
    Definire un valore del parametro di input richiamando il metodo dell' CreateEndpointInfo oggetto setInputParameterMapping e passando i seguenti valori:
    • Un valore di stringa che specifica il nome del parametro di input. Ad esempio, il nome del parametro di input per il servizio EncryptDocument è InDoc .
    • Una stringa che specifica il tipo di dati del parametro di input. Ad esempio, il tipo di dati del parametro di InDoc input è com.adobe.idp.Document .
    • Un valore di stringa che specifica il tipo di mapping. For example, you can specify variable .
    • Un valore di stringa che specifica il valore del tipo di mappatura. Ad esempio, è possibile specificare *.pdf come pattern di file.
    Richiama il setInputParameterMapping metodo da definire per ogni valore del parametro di input. Poiché il processo EncryptDocument ha un solo parametro di input, è necessario richiamare questo metodo una volta.
  6. Definire un valore di parametro di output.
    Definire un valore del parametro di output richiamando il metodo dell' CreateEndpointInfo oggetto setOutputParameterMapping e passando i seguenti valori:
    • Un valore di stringa che specifica il nome del parametro di output. Ad esempio, il nome del parametro di output per il servizio EncryptDocument è SecuredDoc .
    • Una stringa che specifica il tipo di dati del parametro di output. Ad esempio, il tipo di dati del parametro di SecuredDoc output è com.adobe.idp.Document .
    • Un valore di stringa che specifica il tipo di mapping. For example, you can specify %F.pdf .
  7. Crea un endpoint cartella esaminata.
    Creare l'endpoint richiamando il metodo dell' EndpointRegistryClient oggetto createEndpoint e passando l' CreateEndpointInfo oggetto. Questo metodo restituisce un oggetto Endpoint che rappresenta l’endpoint della cartella esaminata.
  8. Abilitate l’endpoint.
    Abilitare l'endpoint richiamando il metodo dell' EndpointRegistryClient oggetto enable e passando l' Endpoint oggetto restituito dal createEndpoint metodo.
Consulta anche

File costante dei valori di configurazione delle cartelle esaminate

Avvio rapido: L'aggiunta di un endpoint di cartelle esaminate tramite l'API Java utilizza un file costante che deve far parte del progetto Java per compilare il rapido avvio. Questo file costante rappresenta i valori di configurazione che devono essere impostati quando si aggiunge un endpoint cartella esaminata. Il seguente codice Java rappresenta il file costante.
 /**
     * 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";
        }

Aggiunta di endpoint e-mail

Puoi aggiungere un endpoint e-mail a un servizio a livello di programmazione utilizzando l'API Java AEM Forms. Aggiungendo un endpoint e-mail, gli utenti possono inviare un messaggio e-mail contenente uno o più file allegati a un account e-mail specificato. Quindi, viene richiamata l’operazione di configurazione del servizio e vengono modificati i file. Dopo che il servizio ha eseguito l'operazione specificata, invia un messaggio e-mail al mittente con i file modificati come allegati di file.
Ai fini dell'aggiunta programmatica di un endpoint e-mail a un servizio, tenere in considerazione il seguente processo di breve durata denominato MyApplication\EncryptDocument . Per informazioni sui processi di breve durata, vedere Informazioni sui processi AEM Forms.
Questo processo accetta un documento PDF non protetto come valore di input e quindi passa il documento PDF non protetto all'operazione del servizio EncryptPDFUsingPassword di cifratura. In questo modo il documento PDF viene crittografato con una password e il documento PDF crittografato con password viene restituito come valore di output. Il nome del valore di input (il documento PDF non protetto) è InDoc e il tipo di dati è com.adobe.idp.Document . Il nome del valore di output (il documento PDF crittografato con password) è SecuredDoc e il tipo di dati è com.adobe.idp.Document .
Non potete aggiungere un endpoint e-mail utilizzando i servizi Web.

Riepilogo dei passaggi

Per aggiungere un endpoint e-mail a un servizio, eseguite le seguenti operazioni:
  1. Includere i file di progetto.
  2. Creare un EndpointRegistryClient oggetto.
  3. Impostate gli attributi dell’endpoint e-mail.
  4. Specificate i valori di configurazione.
  5. Definire i valori dei parametri di input.
  6. Definire un valore di parametro di output.
  7. Create l’endpoint e-mail.
  8. Abilitate l’endpoint.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (richiesto se i AEM Forms sono distribuiti su JBoss Application Server)
  • jbossall-client.jar (richiesto se i AEM Forms sono distribuiti in JBoss Application Server)
Per informazioni sulla posizione di questi file JAR, vedere Inclusione di file libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Prima di poter aggiungere un endpoint e-mail a livello di programmazione, è necessario creare un EndpointRegistryClient oggetto.
Impostare gli attributi dell’endpoint e-mail
Per creare un endpoint e-mail per un servizio, specificate i seguenti valori:
  • Valore identificatore connettore: Specifica il tipo di endpoint creato. Per creare un endpoint e-mail, specificate Email .
  • Descrizione : Specifica una descrizione per l'endpoint.
  • Nome : Specifica il nome dell'endpoint.
  • Valore ID servizio: Specifica il servizio a cui appartiene l'endpoint. Ad esempio, per aggiungere un endpoint e-mail al processo introdotto in questa sezione (un processo diventa un servizio quando attivato tramite Workbench), specificare EncryptDocument .
  • Nome operazione: Specifica il nome dell'operazione richiamata utilizzando l'endpoint. In genere, quando si crea un endpoint e-mail per un servizio originato da un processo creato in Workbench, il nome dell'operazione è invoke .
Specificare i valori di configurazione
È necessario specificare i valori di configurazione per un endpoint e-mail quando si aggiunge programmaticamente un endpoint e-mail a un servizio. Questi valori di configurazione vengono specificati da un amministratore se un endpoint e-mail viene aggiunto utilizzando la console di amministrazione.
L'account e-mail monitorato è un account speciale utilizzato solo per l'endpoint e-mail. Questo account non è un account e-mail di un utente normale. Un account e-mail di un utente normale non deve essere configurato come account utilizzato dal provider e-mail, perché il provider e-mail elimina i messaggi e-mail dalla inbox al termine dei messaggi.
I seguenti valori di configurazione vengono impostati quando si aggiunge a livello di programmazione un endpoint e-mail a un servizio:
  • cronExpression : Un'espressione cron se l'e-mail deve essere pianificata utilizzando un'espressione cron.
  • repeatCount : Numero di volte in cui l’endpoint e-mail esegue la scansione della cartella o della directory. Il valore -1 indica una scansione indefinita. Il valore predefinito è -1.
  • repeatInterval : Frequenza di scansione in secondi utilizzata dal ricevitore per verificare la posta in arrivo. Il valore predefinito è 10.
  • startDelay : Tempo di attesa per l'analisi dopo l'avvio del pianificatore. Il valore predefinito è 0.
  • batchSize : Il numero di messaggi e-mail che il ricevitore elabora per scansione per ottenere prestazioni ottimali. Il valore -1 indica tutte le e-mail. Il valore predefinito è 2.
  • userName : Nome utente utilizzato per richiamare un servizio di destinazione dall’e-mail. Il valore predefinito è SuperAdmin .
  • domainName : Un valore di configurazione obbligatorio. Il valore predefinito è DefaultDom .
  • domainPattern : Specifica i pattern di dominio dell'e-mail in arrivo che il provider accetta. Ad esempio, se adobe.com viene utilizzato, vengono elaborati solo i messaggi e-mail provenienti da adobe.com, mentre quelli provenienti da altri domini vengono ignorati.
  • filePattern : Specifica i pattern di allegati che il provider accetta. Questo include file con estensioni di nomi file specifiche (*.dat, *.xml), file con nomi specifici (dati) e file con espressioni composite nel nome e nell'estensione (*. dD 'port'). Il valore predefinito è * .
  • receiveSuccfulJob : Indirizzo e-mail cui vengono inviati i messaggi per indicare l’esito positivo dei processi. Per impostazione predefinita, al mittente viene sempre inviato un messaggio di processo riuscito. Se digitate sender , i risultati dell'e-mail vengono inviati al mittente. Sono supportati fino a 100 destinatari. Specificate altri destinatari con indirizzi e-mail, separati da una virgola. Per disattivare questa opzione, lasciate vuoto questo valore. In alcuni casi, potrebbe essere utile attivare un processo e non si desidera inviare una notifica via e-mail del risultato. Il valore predefinito è sender .
  • receiveFailedJob : Indirizzo e-mail cui vengono inviati i messaggi per indicare che i processi non sono riusciti. Per impostazione predefinita, al mittente viene sempre inviato un messaggio di processo non riuscito. Se digitate sender , i risultati dell'e-mail vengono inviati al mittente. Sono supportati fino a 100 destinatari. Specificate altri destinatari con indirizzi e-mail, separati da una virgola. Per disattivare questa opzione, lasciate vuoto questo valore. Il valore predefinito è sender .
  • inboxHost : Il nome host della inbox o l'indirizzo IP per il provider di posta elettronica da analizzare.
  • inboxPort : La porta utilizzata dal server e-mail. Il valore predefinito per POP3 è 110 e il valore predefinito per IMAP è 143. Se SSL è abilitato, il valore predefinito per POP3 è 995 e il valore predefinito per IMAP è 993.
  • inboxProtocol : Il protocollo e-mail per l’endpoint e-mail da utilizzare per la scansione della inbox. Le opzioni sono IMAP o POP3 . Il server di posta elettronica dell'host della inbox deve supportare questi protocolli.
  • inboxTimeOut : Timeout in secondi per il provider di posta elettronica di attendere le risposte della inbox. Il valore predefinito è 60.
  • inboxUser : Nome utente necessario per accedere all’account e-mail. A seconda del server e-mail e della configurazione, questa potrebbe essere solo la parte del nome utente dell’e-mail o l’indirizzo e-mail completo.
  • inboxPassword : La password per l’utente della inbox.
  • inboxSSLEnabled : Impostate questo valore per obbligare il provider di posta elettronica a utilizzare SSL per inviare messaggi di notifica di risultati o errori. Assicurarsi che l'host IMAP o POP3 supporti SSL.
  • smtpHost : Il nome host del server di posta elettronica a cui il provider invia i risultati e i messaggi di errore.
  • smtpPort : Il valore predefinito per la porta SMTP è 25.
  • smtpUser : L’account utente del provider di posta elettronica da utilizzare per l’invio di notifiche e-mail di risultati ed errori.
  • smtpPassword : La password dell'account SMTP. Alcuni server di posta elettronica non richiedono una password SMTP.
  • charSet : Set di caratteri utilizzato dal provider di posta elettronica. Il valore predefinito è UTF-8 .
  • smtpSSLEnabled : Impostate questo valore per obbligare il provider di posta elettronica a utilizzare SSL per inviare messaggi di notifica di risultati o errori. Verificate che l'host SMTP supporti SSL.
  • failJobFolder : Specifica una directory in cui memorizzare i risultati quando il server di posta SMTP non è operativo.
  • asincrono : Quando è impostato su sincrono, tutti i documenti di input vengono elaborati e viene restituita una sola risposta. Se impostato su asincrono, viene inviata una risposta per ciascun documento di input elaborato. Ad esempio, viene creato un endpoint e-mail per il processo introdotto in questo argomento e viene inviato un messaggio e-mail alla inbox dell'endpoint che contiene più documenti PDF non protetti. Quando tutti i documenti PDF sono crittografati con una password e se l'endpoint è configurato come sincrono, viene inviato un singolo messaggio e-mail di risposta con tutti i documenti PDF protetti collegati. Se l'endpoint è configurato come asincrono, viene inviato un messaggio e-mail di risposta separato per ciascun documento PDF protetto. Ciascun messaggio e-mail contiene un singolo documento PDF come allegato. Il valore predefinito è asincrono.
Definire i valori dei parametri di input
Quando create un endpoint e-mail, dovete definire i valori dei parametri di input. In altre parole, devi descrivere i valori di input passati all'operazione richiamata dall'endpoint e-mail. Ad esempio, prendete in considerazione il processo introdotto in questo argomento. Ha un valore di input denominato InDoc e il suo tipo di dati è com.adobe.idp.Document . Quando create un endpoint e-mail per questo processo (dopo che un processo viene attivato, diventa un servizio), dovete definire il valore del parametro di input.
Per definire i valori dei parametri di input richiesti per un endpoint e-mail, specificate i seguenti valori:
Nome del parametro di input: Nome del parametro di input. Il nome di un valore di input è specificato in Workbench per un processo. Se il valore di input appartiene a un'operazione di servizio (un servizio Forms che non è un processo creato in Workbench), il nome di input è specificato nel file component.xml. Ad esempio, il nome del parametro di input per il processo introdotto in questa sezione è InDoc .
Tipo mapping: Utilizzato per configurare i valori di input necessari per richiamare l'operazione del servizio. Due tipi di mapping sono i seguenti:
  • Literal : L'endpoint e-mail utilizza il valore immesso nel campo così come viene visualizzato. Sono supportati tutti i tipi Java di base. Ad esempio, se un'API utilizza input quali String, long, int e Boolean, la stringa viene convertita nel tipo corretto e il servizio viene richiamato.
  • Variable : Il valore immesso è un pattern di file utilizzato dall'endpoint e-mail per selezionare l'input. Ad esempio, se si seleziona Variabile per il tipo di mappatura e il documento di input deve essere un file PDF, è possibile specificare *.pdf come valore di mappatura.
Valore mappatura: Specifica il valore del tipo di mappatura. Ad esempio, se si seleziona un tipo di mappatura della variabile, è possibile specificare *.pdf come pattern di file.
Tipo di dati: Specifica il tipo di dati dei valori di input. Ad esempio, il tipo di dati del valore di input del processo introdotto in questa sezione è com.adobe.idp.Document.
Definire un valore di parametro di output
Quando create un endpoint e-mail, dovete definire un valore di parametro di output. Ovvero, devi descrivere il valore di output restituito dal servizio richiamato dall'endpoint e-mail. Ad esempio, prendete in considerazione il processo introdotto in questo argomento. Il valore di output è denominato SecuredDoc e il tipo di dati è com.adobe.idp.Document . Quando create un endpoint e-mail per questo processo (dopo che un processo viene attivato, diventa un servizio), dovete definire il valore del parametro di output.
Per definire un valore del parametro di output richiesto per un endpoint e-mail, specificate i seguenti valori:
Nome del parametro di output: Nome del parametro di output. Il nome di un valore di output del processo è specificato in Workbench. Se il valore di output appartiene a un'operazione di servizio (un servizio che non è un processo creato in Workbench), il nome di output è specificato nel file component.xml. Ad esempio, il nome del parametro di output per il processo introdotto in questa sezione è SecuredDoc .
Tipo mapping: Utilizzato per configurare l'output del servizio e l'operazione. Sono disponibili le seguenti opzioni:
  • Se il servizio restituisce un singolo oggetto (un singolo documento), il pattern è uguale a quello della destinazione di origine è sourcefilename.pdf. %F.pdf Ad esempio, il processo introdotto in questa sezione restituisce un singolo documento. Di conseguenza, il tipo di mappatura può essere definito come %F.pdf ( %F ovvero utilizzare il nome file specificato). Il pattern %E specifica l'estensione del documento di input.
  • Se il servizio restituisce un elenco, il pattern è Result\%F\ e la destinazione di origine è Result\sourcefilename\source1 (output 1) e Result\sourcefilename\source2 (output 2).
  • Se il servizio restituisce una mappa, il pattern è Result\%F\ e la destinazione di origine è Result\sourcefilename\file1 and Result\sourcefilename\file2. Se la mappa ha più di un oggetto, il pattern è uguale Result\%F.pdf e la destinazione di origine è Result\sourcefilename1.pdf (output 1), Result\sourcefilenam2.pdf (output 2) e così via.
Tipo di dati: Specifica il tipo di dati del valore restituito. Ad esempio, il tipo di dati del valore restituito dal processo introdotto in questa sezione è com.adobe.idp.Document .
Creare l’endpoint e-mail
Dopo aver impostato gli attributi dell’endpoint e i valori di configurazione e aver definito i valori dei parametri di input e output, dovete creare l’endpoint e-mail.
Abilitare l'endpoint
Dopo aver creato un endpoint e-mail, è necessario attivarlo. Quando l'endpoint è abilitato, può essere utilizzato per richiamare il servizio. Dopo aver attivato l’endpoint, potete visualizzarlo nella console di amministrazione.
Consulta anche

Aggiunta di un endpoint e-mail tramite l'API Java

Aggiungete un endpoint e-mail utilizzando l'API Java:
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto Client EndpointRegistry.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un EndpointRegistryClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Impostate gli attributi dell’endpoint e-mail.
    • Creare un CreateEndpointInfo oggetto utilizzando il relativo costruttore.
    • Specificare il valore dell'identificatore del connettore richiamando il metodo dell' CreateEndpointInfo oggetto setConnectorId e passando il valore della stringa Email .
    • Specificate la descrizione dell'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setDescription e passando un valore di stringa che descrive l'endpoint.
    • Specificare il nome dell'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setName e passando un valore di stringa che specifica il nome.
    • Specificare il servizio al quale appartiene l'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setServiceId e passando un valore di stringa che specifica il nome del servizio.
    • Specificare l'operazione richiamata richiamando il metodo dell' CreateEndpointInfo oggetto setOperationName e passando un valore di stringa che specifica il nome dell'operazione. In genere, quando si crea un endpoint e-mail per un servizio originato da un processo creato in Workbench, viene richiamato il nome dell'operazione.
  4. Specificate i valori di configurazione.
    Per ogni valore di configurazione da impostare per l'endpoint e-mail, è necessario richiamare il CreateEndpointInfo metodo dell' setConfigParameterAsText oggetto. Ad esempio, per impostare il valore di smtpHost configurazione, richiamare il metodo dell' CreateEndpointInfo oggetto setConfigParameterAsText e passare i seguenti valori:
    • Un valore di stringa che specifica il nome del valore di configurazione. Quando impostate il valore di smtpHost configurazione, specificate smtpHost .
    • Un valore di stringa che specifica il valore del valore di configurazione. Quando si imposta il valore di smtpHost configurazione, specificare un valore di stringa che specifica il nome del server SMTP.
    Per visualizzare tutti i valori di configurazione impostati per il servizio EncryptDocument introdotto in questa sezione, vedere l'esempio di codice Java disponibile in QuickStart: Aggiunta di un endpoint e-mail tramite l'API Java.
  5. Definire i valori dei parametri di input.
    Definire un valore del parametro di input richiamando il metodo dell' CreateEndpointInfo oggetto setInputParameterMapping e passando i seguenti valori:
    • Un valore di stringa che specifica il nome del parametro di input. Ad esempio, il nome del parametro di input per il servizio EncryptDocument è InDoc .
    • Una stringa che specifica il tipo di dati del parametro di input. Ad esempio, il tipo di dati del parametro di InDoc input è com.adobe.idp.Document .
    • Un valore di stringa che specifica il tipo di mapping. For example, you can specify variable .
    • Un valore di stringa che specifica il valore del tipo di mappatura. Ad esempio, è possibile specificare *.pdf come pattern di file.
    Richiama il setInputParameterMapping metodo da definire per ogni valore del parametro di input. Poiché il processo EncryptDocument ha un solo parametro di input, è necessario richiamare questo metodo una volta.
  6. Definire un valore di parametro di output.
    Definire un valore del parametro di output richiamando il metodo dell' CreateEndpointInfo oggetto setOutputParameterMapping e passando i seguenti valori:
    • Un valore di stringa che specifica il nome del parametro di output. Ad esempio, il nome del parametro di output per il servizio EncryptDocument è SecuredDoc .
    • Una stringa che specifica il tipo di dati del parametro di output. Ad esempio, il tipo di dati del parametro di SecuredDoc output è com.adobe.idp.Document .
    • Un valore di stringa che specifica il tipo di mapping. For example, you can specify %F.pdf .
  7. Create l’endpoint e-mail.
    Creare l'endpoint richiamando il metodo dell' EndpointRegistryClient oggetto createEndpoint e passando l' CreateEndpointInfo oggetto. Questo metodo restituisce un Endpoint oggetto che rappresenta l’endpoint e-mail.
  8. Abilitate l’endpoint.
    Abilitare l'endpoint richiamando il metodo dell' EndpointRegistryClient oggetto enable e passando l' Endpoint oggetto restituito dal createEndpoint metodo.
Consulta anche

File costante valori di configurazione e-mail

Avvio rapido: L'aggiunta di un endpoint e-mail tramite l'API Java utilizza un file costante che deve far parte del progetto Java per compilare il rapido avvio. Questo file costante rappresenta i valori di configurazione che devono essere impostati quando si aggiunge un endpoint e-mail. Il seguente codice Java rappresenta il file costante.
 /**
     * 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";
 }

Aggiunta di endpoint remoti

Le API LiveCycle Remoting non sono più utilizzate per i moduli AEM su JEE.
Puoi aggiungere un endpoint remoto a un servizio a livello di programmazione utilizzando l'API Java AEM Forms. Aggiungendo un endpoint remoto, si sta abilitando un'applicazione Flex per richiamare il servizio utilizzando la rimozione. (Vedere Richiamo di AEM Forms mediante (obsoleto per i moduli AEM) AEM Forms .)
Ai fini dell'aggiunta programmatica di un endpoint Remoting a un servizio, tenere in considerazione il seguente processo di breve durata denominato EncryptDocument .
Questo processo accetta un documento PDF non protetto come valore di input e quindi passa il documento PDF non protetto all'operazione del servizio EncryptPDFUsingPassword di cifratura. Il documento PDF è crittografato con una password e il documento PDF crittografato con password è il valore di output di questo processo. Il nome del valore di input (il documento PDF non protetto) è InDoc e il tipo di dati è com.adobe.idp.Document . Il nome del valore di output (il documento PDF crittografato con password) è SecuredDoc e il tipo di dati è com.adobe.idp.Document .
Per dimostrare come aggiungere un endpoint remoto a un servizio, in questa sezione viene aggiunto un endpoint remoto a un servizio denominato EncryptDocument.
Non è possibile aggiungere un endpoint remoto utilizzando i servizi Web.

Riepilogo dei passaggi

Per rimuovere un endpoint da un servizio, eseguire le operazioni seguenti:
  1. Includere i file di progetto.
  2. Creare un EndpointRegistryClient oggetto.
  3. Impostate gli attributi dell'endpoint remoto.
  4. Creare un endpoint remoto.
  5. Abilitate l’endpoint.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (richiesto se i AEM Forms sono distribuiti su JBoss Application Server)
  • jbossall-client.jar (richiesto se i AEM Forms sono distribuiti in JBoss Application Server)
Per informazioni sulla posizione di questi file JAR, vedere Inclusione di file libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Per aggiungere un endpoint remoto a livello di programmazione, è necessario creare un EndpointRegistryClient oggetto.
Impostazione degli attributi endpoint remoto
Per creare un endpoint remoto per un servizio, specificate i seguenti valori:
  • Valore identificatore connettore: Specifica il tipo di endpoint creato. Per creare un endpoint remoto, specificate Remoting .
  • Descrizione : Specifica la descrizione dell'endpoint.
  • Nome : Specifica il nome dell'endpoint.
  • Valore ID servizio: Specifica il servizio a cui appartiene l'endpoint. Ad esempio, per aggiungere un endpoint remoto al processo introdotto in questa sezione (un processo diventa un servizio quando viene attivato in Workbench), specificare EncryptDocument .
  • Nome operazione: Specifica il nome dell'operazione richiamata utilizzando l'endpoint. Quando create un endpoint remoto, specificate un carattere jolly (*).
Creare un endpoint remoto
Dopo aver impostato gli attributi dell'endpoint remoto, potete creare un endpoint remoto per un servizio.
Abilitare l'endpoint
Dopo aver creato un nuovo endpoint, è necessario abilitarlo. Quando un endpoint remoto è abilitato, consente a un client Flex di richiamare il servizio.
Consulta anche

Aggiunta di un endpoint remoto tramite l'API Java

Aggiungete un endpoint remoto utilizzando l'API Java:
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto Client EndpointRegistry.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un EndpointRegistryClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Impostate gli attributi dell'endpoint remoto.
    • Creare un CreateEndpointInfo oggetto utilizzando il relativo costruttore.
    • Specificare il valore dell'identificatore del connettore richiamando il metodo dell' CreateEndpointInfo oggetto setConnectorId e passando il valore della stringa Remoting .
    • Specificate la descrizione dell'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setDescription e passando un valore di stringa che descrive l'endpoint.
    • Specificare il nome dell'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setName e passando un valore di stringa che specifica il nome.
    • Specificare il servizio al quale appartiene l'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setServiceId e passando un valore di stringa che specifica il nome del servizio.
    • Specificare l'operazione richiamata dal CreateEndpointInfo metodo dell' setOperationName oggetto e passare un valore di stringa che specifica il nome dell'operazione. Per un endpoint remoto, specificate un carattere jolly (*).
  4. Creare un endpoint remoto.
    Creare l'endpoint richiamando il metodo dell' EndpointRegistryClient oggetto createEndpoint e passando l' CreateEndpointInfo oggetto. Questo metodo restituisce un Endpoint oggetto che rappresenta il nuovo endpoint remoto.
  5. Abilitate l’endpoint.
    Abilitare l'endpoint richiamando il metodo dell' EndpointRegistryClient oggetto enable e passando l' Endpoint oggetto restituito dal createEndpoint metodo.
Consulta anche

Aggiunta di endpoint TaskManager

È possibile aggiungere a livello di programmazione un endpoint TaskManager a un servizio utilizzando l'API Java AEM Forms. Aggiungendo un endpoint di TaskManager a un servizio, l'utente di Workspace può richiamare il servizio. In altre parole, un utente che lavora in Workspace può richiamare un processo con un endpoint TaskManager corrispondente.
Non è possibile aggiungere un endpoint TaskManager utilizzando i servizi Web.

Riepilogo dei passaggi

Per aggiungere un endpoint TaskManager a un servizio, eseguire le operazioni seguenti:
  1. Includere i file di progetto.
  2. Creare un EndpointRegistryClient oggetto.
  3. Create una categoria per l'endpoint.
  4. Impostate gli attributi endpoint TaskManager.
  5. Creare un endpoint TaskManager.
  6. Abilitate l’endpoint.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (richiesto se i AEM Forms sono distribuiti su JBoss Application Server)
  • jbossall-client.jar (richiesto se i AEM Forms sono distribuiti in JBoss Application Server)
Per informazioni sulla posizione di questi file JAR, vedere Inclusione di file libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Prima di poter aggiungere un endpoint TaskManager in modo programmatico, è necessario creare un EndpointRegistryClient oggetto.
Creare una categoria per l'endpoint
Le categorie vengono utilizzate per organizzare i servizi all'interno di Workspace. In altre parole, un utente di Workspace può richiamare un servizio che dispone di un endpoint TaskManager selezionando una categoria all'interno di Workspace. Quando si crea un endpoint TaskManager, è possibile fare riferimento a una categoria esistente o creare una nuova categoria a livello di programmazione.
Questa sezione crea una nuova categoria come parte dell'aggiunta di un endpoint TaskManager a un servizio.
Imposta attributi endpoint TaskManager
Per creare un endpoint TaskManager per un servizio, specificare i valori seguenti:
  • Identificatore del connettore: Specifica il tipo di endpoint creato. Per creare un endpoint TaskManager, specificare TaskManagerConnector .
  • Descrizione : Specifica la descrizione dell'endpoint.
  • Nome : Specifica il nome dell'endpoint.
  • Identificatore servizio: Specifica il servizio a cui appartiene l'endpoint.
  • Categoria : Specifica un valore di identificatore di categoria associato all'endpoint TaskManager.
  • Nome operazione: In genere, durante la creazione di un endpoint TaskManager per un servizio originato da un processo creato in Workbench, il nome dell'operazione è invoke .
Creare un endpoint TaskManager
Dopo aver impostato gli attributi endpoint TaskManager, è possibile creare un endpoint TaskManager per un servizio.
Abilitare l'endpoint
Dopo aver creato un nuovo endpoint, è necessario abilitarlo. Quando l’endpoint è abilitato, può essere utilizzato per richiamare il servizio dall’interno di Workspace. Dopo aver attivato l’endpoint, potete visualizzarlo nella console di amministrazione.
Consulta anche

Aggiunta di un endpoint TaskManager tramite l'API Java

Aggiungete un endpoint TaskManager utilizzando l'API Java:
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto Client EndpointRegistry.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un EndpointRegistryClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Create una categoria per l'endpoint.
    • Creare un CreateEndpointCategoryInfo oggetto utilizzando il relativo costruttore e passando i seguenti valori:
      • Un valore di stringa che specifica il valore di identificatore della categoria
      • Un valore di stringa che specifica la descrizione della categoria
    • Creare la categoria richiamando il metodo dell' EndpointRegistryClient oggetto createEndpointCategory e passando l' CreateEndpointCategoryInfo oggetto. Questo metodo restituisce un EndpointCategory oggetto che rappresenta la nuova categoria.
  4. Impostate gli attributi endpoint TaskManager.
    • Creare un CreateEndpointInfo oggetto utilizzando il relativo costruttore.
    • Specificare il valore dell'identificatore del connettore richiamando il metodo dell' CreateEndpointInfo oggetto setConnectorId e passando il valore della stringa TaskManagerConnector .
    • Specificate la descrizione dell'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setDescription e passando un valore di stringa che descrive l'endpoint.
    • Specificare il nome dell'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setName e passando un valore di stringa che specifica il nome.
    • Specificare il servizio al quale appartiene l'endpoint richiamando il metodo dell' CreateEndpointInfo oggetto setServiceId e passando un valore di stringa che specifica il nome del servizio.
    • Specificare la categoria a cui appartiene l'endpoint richiamando il metodo dell' CreateEndpointInfo setCategoryId oggetto e passando un valore di stringa che specifica il valore dell'identificatore della categoria. È possibile richiamare il metodo dell' EndpointCategory oggetto getId per ottenere il valore dell'identificatore di questa categoria.
    • Specificare l'operazione richiamata richiamando il metodo dell' CreateEndpointInfo oggetto setOperationName e passando un valore di stringa che specifica il nome dell'operazione. In genere, quando si crea un TaskManager endpoint per un servizio originato da un processo creato in Workbench, il nome dell'operazione è invoke .
  5. Creare un endpoint TaskManager.
    Creare l'endpoint richiamando il metodo dell' EndpointRegistryClient oggetto createEndpoint e passando l' CreateEndpointInfo oggetto. Questo metodo restituisce un Endpoint oggetto che rappresenta il nuovo endpoint TaskManager.
  6. Abilitate l’endpoint.
    Abilitare l'endpoint richiamando il metodo dell' EndpointRegistryClient oggetto enable e passando l' Endpoint oggetto restituito dal createEndpoint metodo.
Consulta anche

Modifica di endpoint

Potete modificare programmaticamente un endpoint esistente utilizzando l'API Java AEM Forms. Modificando un endpoint, potete modificare il comportamento dell'endpoint. Considerate, ad esempio, un endpoint cartella esaminata che specifica una cartella utilizzata come cartella esaminata. È possibile modificare a livello di programmazione i valori di configurazione che appartengono all’endpoint della cartella esaminata, in modo che un’altra cartella funzioni come cartella esaminata. Per informazioni sui valori di configurazione che appartengono a un endpoint di una cartella esaminata, consultate Aggiunta di endpoint di cartelle esaminate.
Per dimostrare come modificare un endpoint, in questa sezione viene modificato un endpoint cartella esaminata modificando la cartella che si comporta come cartella esaminata.
Non è possibile modificare un endpoint utilizzando i servizi Web.

Riepilogo dei passaggi

Per modificare un endpoint, eseguire le operazioni seguenti:
  1. Includere i file di progetto.
  2. Creare un EndpointRegistryClient oggetto.
  3. Recuperate l’endpoint.
  4. Specificate nuovi valori di configurazione.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (richiesto se i AEM Forms sono distribuiti su JBoss Application Server)
  • jbossall-client.jar (richiesto se i AEM Forms sono distribuiti in JBoss Application Server)
Per informazioni sulla posizione di questi file JAR, vedere Inclusione di file libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Per modificare un endpoint a livello di programmazione, è necessario creare un EndpointRegistryClient oggetto.
Recuperare l’endpoint da modificare
Prima di poter modificare un endpoint, è necessario recuperarlo. Per recuperare un endpoint, è necessario connettersi come utente che può accedere a un endpoint. È consigliabile connettersi come amministratore. (Vedere Impostazione delle proprietà di connessione).
È possibile recuperare un endpoint recuperando un elenco di endpoint. Potete quindi eseguire un'iterazione nell'elenco, cercando l'endpoint specifico da rimuovere. Ad esempio, potete individuare un endpoint determinando il servizio che corrisponde all'endpoint e il tipo di endpoint. Quando si individua l’endpoint, è possibile modificarlo.
Specificare nuovi valori di configurazione
Quando modificate un endpoint, specificate nuovi valori di configurazione. Ad esempio, per modificare un endpoint cartella esaminata, reimpostare tutti i valori di configurazione dell'endpoint cartella esaminata, non solo quelli che si desidera modificare. Per informazioni sui valori di configurazione che appartengono a un endpoint di una cartella esaminata, consultate Aggiunta di endpoint di cartelle esaminate.
Per informazioni sui valori di configurazione che appartengono a un endpoint e-mail, consultate Aggiunta di endpoint e-mail.
Non è possibile modificare il servizio richiamato dall'endpoint. Se tentate di modificare il servizio, viene generata un'eccezione. Per modificare il servizio associato a un determinato endpoint, rimuovete l'endpoint e createne uno nuovo. (Vedere Rimozione di endpoint .)
Consulta anche

Modifica di un endpoint tramite l'API Java

Modificate un endpoint utilizzando l'API Java:
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto Client EndpointRegistry.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un EndpointRegistryClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Recuperate l’endpoint da modificare.
    • Recuperare un elenco di tutti gli endpoint a cui l'utente corrente (specificato nelle proprietà di connessione) può accedere richiamando il metodo dell' EndpointRegistryClient oggetto getEndpoints e passando un PagingFilter oggetto che funge da filtro. Potete passare un (PagingFilter)null valore per restituire tutti gli endpoint. Questo metodo restituisce un java.util.List oggetto in cui ogni elemento è un Endpoint oggetto. Per informazioni su un PagingFilter oggetto, consultate Riferimento API per AEM Forms.
    • Eseguire un'iterazione sull' java.util.List oggetto per determinare se dispone di endpoint. Se esistono endpoint, ogni elemento è un' EndPoint istanza.
    • Determinare il servizio che corrisponde a un endpoint richiamando il metodo dell' EndPoint oggetto getServiceId . Questo metodo restituisce un valore di stringa che specifica il nome del servizio.
    • Determinare il tipo di endpoint richiamando il metodo dell' EndPoint oggetto getConnectorId . Questo metodo restituisce un valore di stringa che specifica il tipo di endpoint. Ad esempio, se l’endpoint è un endpoint cartella esaminata, questo metodo restituisce WatchedFolder .
  4. Specificate nuovi valori di configurazione.
    • Creare un ModifyEndpointInfo oggetto richiamandone il costruttore.
    • Per ogni valore di configurazione da impostare, richiamare il ModifyEndpointInfo metodo dell' setConfigParameterAsText . Ad esempio, per impostare il valore di configurazione dell'URL, richiamare il metodo dell' ModifyEndpointInfo oggetto setConfigParameterAsText e passare i seguenti valori:
      • Un valore di stringa che specifica il nome del valore di configurazione. Ad esempio, per impostare il valore di url configurazione, specificare url .
      • Un valore di stringa che specifica il valore del valore di configurazione. Per definire un valore per il valore di url configurazione, specificate il percorso della cartella esaminata.
    • Richiamare il metodo dell' EndpointRegistryClient oggetto modifyEndpoint e passare l' ModifyEndpointInfo oggetto.
Consulta anche

Rimozione di endpoint

Puoi rimuovere programmaticamente un endpoint da un servizio utilizzando l'API Java AEM Forms. Dopo aver rimosso un endpoint, il servizio non può essere invocato utilizzando il metodo di chiamata abilitato dall'endpoint. Ad esempio, se si rimuove un endpoint SOAP da un servizio, non è possibile richiamare il servizio utilizzando la modalità SOAP.
Per dimostrare come rimuovere un endpoint da un servizio, questa sezione rimuove un endpoint EJB da un servizio denominato EncryptDocument .
Non è possibile rimuovere un endpoint utilizzando i servizi Web.

Riepilogo dei passaggi

Per rimuovere un endpoint da un servizio, eseguire le operazioni seguenti:
  1. Includere i file di progetto.
  2. Creare un EndpointRegistryClient oggetto.
  3. Recuperate l’endpoint.
  4. Rimuovere l'endpoint.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (richiesto se i AEM Forms sono distribuiti su JBoss Application Server)
  • jbossall-client.jar (richiesto se i AEM Forms sono distribuiti in JBoss Application Server)
Per informazioni sulla posizione di questi file JAR, vedere Inclusione di file libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Per rimuovere un endpoint a livello di programmazione, è necessario creare un EndpointRegistryClient oggetto.
Recuperare l’endpoint da rimuovere
Prima di rimuovere un endpoint, è necessario recuperarlo. Per recuperare un endpoint, è necessario connettersi come utente che può accedere a un endpoint. È consigliabile connettersi come amministratore. (Vedere Impostazione delle proprietà di connessione).
È possibile recuperare un endpoint recuperando un elenco di endpoint. Potete quindi eseguire un'iterazione nell'elenco, cercando l'endpoint specifico da rimuovere. Ad esempio, potete individuare un endpoint determinando il servizio che corrisponde all'endpoint e il tipo di endpoint. Quando individuate l’endpoint, potete rimuoverlo.
Rimuovere l'endpoint
Dopo aver creato un nuovo endpoint, è necessario abilitarlo. Quando l'endpoint è abilitato, può essere utilizzato per richiamare il servizio. Dopo aver attivato l’endpoint, potete visualizzarlo nella console di amministrazione.
Consulta anche

Rimozione di un endpoint tramite l'API Java

Rimuovete un endpoint utilizzando l'API Java:
  1. Includere i file di progetto.
    Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto Client EndpointRegistry.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un EndpointRegistryClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Recuperate l’endpoint da rimuovere.
    • Recuperare un elenco di tutti gli endpoint a cui l'utente corrente (specificato nelle proprietà di connessione) ha accesso richiamando il metodo dell' EndpointRegistryClient oggetto getEndpoints e passando un PagingFilter oggetto che funge da filtro. Potete passare (PagingFilter)null per restituire tutti gli endpoint. Questo metodo restituisce un java.util.List oggetto in cui ogni elemento è un Endpoint oggetto.
    • Eseguire un'iterazione sull' java.util.List oggetto per determinare se dispone di endpoint. Se esistono endpoint, ogni elemento è un' EndPoint istanza.
    • Determinare il servizio che corrisponde a un endpoint richiamando il metodo dell' EndPoint oggetto getServiceId . Questo metodo restituisce un valore di stringa che specifica il nome del servizio.
    • Determinare il tipo di endpoint richiamando il metodo dell' EndPoint oggetto getConnectorId . Questo metodo restituisce un valore di stringa che specifica il tipo di endpoint. Ad esempio, se l’endpoint è un endpoint EJB, questo metodo restituisce EJB .
  4. Rimuovere l'endpoint.
    Rimuovere l'endpoint richiamando il metodo dell' EndpointRegistryClient oggetto remove e passando l' EndPoint oggetto che rappresenta l'endpoint da rimuovere.
Consulta anche

Recupero delle informazioni sul connettore endpoint

Potete recuperare informazioni sui connettori endpoint a livello di programmazione utilizzando l'API AEM Forms. Un connettore consente a un endpoint di richiamare un servizio utilizzando vari metodi di chiamata. Ad esempio, un connettore per cartelle esaminate consente a un endpoint di richiamare un servizio utilizzando le cartelle esaminate. Tramite il recupero programmatico delle informazioni sui connettori endpoint, è possibile recuperare i valori di configurazione associati a un connettore, ad esempio quali valori di configurazione sono obbligatori e quali facoltativi.
Per dimostrare come recuperare informazioni sui connettori endpoint, questa sezione recupera informazioni su un connettore per cartelle esaminate. Consultate Aggiunta di endpoint cartelle esaminate.
Non è possibile recuperare informazioni sugli endpoint utilizzando i servizi Web.
In questo argomento viene utilizzata l' ConnectorRegistryClient API per recuperare informazioni sui connettori endpoint. Consultate Riferimento API per AEM Forms .

Riepilogo dei passaggi

Per recuperare le informazioni sul connettore endpoint, eseguire le operazioni seguenti:
  1. Includere i file di progetto.
  2. Creare un ConnectorRegistryClient oggetto.
  3. Specificare il tipo di connettore.
  4. Recuperare i valori di configurazione.
Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (richiesto se i AEM Forms sono distribuiti su JBoss Application Server)
  • jbossall-client.jar (richiesto se i AEM Forms sono distribuiti in JBoss Application Server)
Se i AEM Forms sono distribuiti su un server applicazione J2EE supportato che non è JBoss, sostituite adobe-utilities.jar e jbossall-client.jar con file JAR specifici per il server applicazione J2EE in cui sono distribuiti i AEM Forms. Per informazioni sulla posizione di tutti i file JAR AEM Forms, vedere Inclusione di file libreria Java AEM Forms.
Creare un oggetto ConnectorRegistry Client
Per recuperare le informazioni sul connettore dell'endpoint a livello di programmazione, creare un ConnectorRegistryClient oggetto.
Specificare il tipo di connettore
Specificare il tipo di connettore da cui recuperare le informazioni. Esistono i seguenti tipi di connettori:
  • EJB : Consente a un'applicazione client di richiamare un servizio utilizzando la modalità EJB.
  • SOAP : Abilita un'applicazione client a richiamare un servizio utilizzando la modalità SOAP.
  • Cartella esaminata: Consente alle cartelle esaminate di richiamare un servizio.
  • E-mail : Consente ai messaggi e-mail di richiamare un servizio.
  • Remoto : Abilita un'applicazione client Flex per richiamare un servizio.
  • TaskManagerConnector : Consente a un utente di Workspace di richiamare un servizio dall’interno di Workspace.
Recuperare i valori di configurazione
Dopo aver specificato il tipo di connettore, è possibile recuperare informazioni sul connettore, ad esempio il valore di configurazione supportato. Ad esempio, per qualsiasi connettore, è possibile determinare quali valori di configurazione sono obbligatori e quali sono facoltativi.
Consulta anche

Recuperare le informazioni sul connettore dell'endpoint utilizzando l'API Java

Recuperate le informazioni sul connettore endpoint utilizzando l'API Java:
  1. Includere i file di progetto. .
    Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
  2. Creare un oggetto ConnectorRegistry Client.
    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un ConnectorRegistryClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.
  3. Specificare il tipo di connettore.
    Specificare il tipo di connettore richiamando il metodo dell' ConnectorRegistryClient oggetto getEndpointDefinition e passando un valore di stringa che specifica il tipo di connettore. Ad esempio, per specificare il tipo di connettore per cartelle esaminate, passare il valore stringa WatchedFolder . Questo metodo restituisce un Endpoint oggetto che corrisponde al tipo di connettore.
  4. Recuperare i valori di configurazione.
    • Recuperare i valori di configurazione associati all'interno dell'endpoint richiamando il metodo dell' Endpoint oggetto getConfigParameters . Questo metodo restituisce un array di ConfigParameter oggetti.
    • Recuperate informazioni su ciascun valore di configurazione recuperando ogni elemento all'interno dell'array. Ciascun elemento è un ConfigParameter oggetto. È possibile, ad esempio, determinare se il valore di configurazione è obbligatorio o facoltativo richiamando il metodo dell' ConfigParameter oggetto isRequired . Se il valore di configurazione è obbligatorio, questo metodo restituisce true .
Consulta anche