Gestione programmatica degli endpoint programmatically-managing-endpoints

Aggiunta di un endpoint EJB tramite l’API Java adding-an-ejb-endpoint-using-the-java-api

Aggiungi un endpoint EJB utilizzando l'API Java:

Includi file di progetto.

Includi file JAR client, come adobe-livecycle-client.jar, nel percorso di classe del progetto Java. (
Creare un oggetto Client EndpointRegistry.
- Crea un ServiceClientFactory oggetto contenente le proprietà di connessione.
- Crea un EndpointRegistryClient utilizzando il relativo costruttore e passando ServiceClientFactory oggetto.
Impostare gli attributi dell’endpoint EJB.
- Crea un CreateEndpointInfo utilizzando il relativo costruttore.
- Specifica il valore dell’identificatore del connettore richiamando il CreateEndpointInfo dell’oggetto setConnectorId e passare il valore della stringa EJB.
- Specifica la descrizione dell’endpoint richiamando il CreateEndpointInfo dell’oggetto setDescription e passare un valore stringa che descrive l'endpoint.
- Specifica il nome dell'endpoint richiamando il CreateEndpointInfo dell’oggetto setName e passare un valore stringa che specifica il nome.
- Specifica il servizio a cui appartiene l'endpoint richiamando il CreateEndpointInfo dell’oggetto setServiceId e passare un valore stringa che specifica il nome del servizio.
- Specifica l'operazione richiamata richiamando il CreateEndpointInfo dell’oggetto setOperationName e passare un valore stringa che specifica il nome dell'operazione. Per gli endpoint SOAP ed EJB, specifica un carattere jolly ( *), che implica tutte le operazioni.
Crea un endpoint EJB.

Crea l’endpoint richiamando il EndpointRegistryClient dell’oggetto createEndpoint e passare CreateEndpointInfo oggetto. Questo metodo restituisce un Endpoint che rappresenta il nuovo endpoint EJB.
Attiva l'endpoint.

Abilita l’endpoint richiamando il EndpointRegistryClient il metodo enable dell’oggetto e il passaggio del Endpoint oggetto restituito da createEndpoint metodo .

Consulta anche

Guida introduttiva: Aggiunta di un endpoint EJB tramite l’API Java

Aggiungere un endpoint SOAP utilizzando l’API Java

Aggiunta di endpoint SOAP adding-soap-endpoints

Puoi aggiungere programmaticamente un endpoint SOAP a un servizio utilizzando l’API Java di 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.

NOTE

Non è possibile aggiungere un endpoint SOAP utilizzando i servizi Web.

NOTE

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

Per aggiungere un endpoint SOAP a un servizio, eseguire le operazioni seguenti:

Includi file di progetto.
Crea un EndpointRegistryClient oggetto.
Impostare gli attributi dell’endpoint SOAP.
Creare un endpoint SOAP.
Attiva l'endpoint.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un'applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, assicurati di includere i file proxy.

I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)
jbossall-client.jar (richiesto se AEM Forms è distribuito su 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 di AEM Forms, vedi Inclusione dei file libreria Java di AEM Forms.

Creare un oggetto client EndpointRegistry

Per aggiungere programmaticamente un endpoint SOAP a un servizio, è necessario creare un EndpointRegistryClient oggetto.

Impostare gli attributi dell’endpoint SOAP

Per aggiungere un endpoint SOAP a un servizio, specificare i seguenti valori:

Valore identificativo del 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 identificativo del servizio: Specifica il servizio a cui appartiene l'endpoint.
Nome operazione: Specifica il nome dell'operazione richiamata utilizzando l'endpoint. Durante la creazione di un endpoint SOAP, specificare un carattere jolly ( *). Tuttavia, se desideri specificare un’operazione specifica anziché richiamare tutte le operazioni del servizio, specifica il nome dell’operazione anziché il carattere jolly ( *).

Creare un endpoint SOAP

Dopo aver impostato gli attributi dell’endpoint SOAP, è possibile 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 abilitato l’endpoint, puoi visualizzarlo nella console di amministrazione.

Consulta anche

Aggiungere un endpoint SOAP utilizzando l’API Java add-a-soap-endpoint-using-the-java-api

Aggiungi un endpoint SOAP a un servizio utilizzando l'API Java:

Includi file di progetto.

Includi file JAR client, come adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto Client EndpointRegistry.
- Crea un ServiceClientFactory oggetto contenente le proprietà di connessione.
- Crea un EndpointRegistryClient utilizzando il relativo costruttore e passando ServiceClientFactory oggetto.
Impostare gli attributi dell’endpoint SOAP.
- Crea un CreateEndpointInfo utilizzando il relativo costruttore.
- Specifica il valore dell’identificatore del connettore richiamando il CreateEndpointInfo dell’oggetto setConnectorId e passare il valore della stringa SOAP.
- Specifica la descrizione dell’endpoint richiamando il CreateEndpointInfo dell’oggetto setDescription e passare un valore stringa che descrive l'endpoint.
- Specifica il nome dell'endpoint richiamando il CreateEndpointInfo dell’oggetto setName e passare un valore stringa che specifica il nome.
- Specifica il servizio a cui appartiene l'endpoint richiamando il CreateEndpointInfo dell’oggetto setServiceId e passare un valore stringa che specifica il nome del servizio.
- Specifica l'operazione richiamata richiamando il CreateEndpointInfo dell’oggetto setOperationName e passare un valore stringa che specifica il nome dell'operazione. Per gli endpoint SOAP ed EJB, specifica un carattere jolly ( *), che implica tutte le operazioni.
Creare un endpoint SOAP.

Crea l’endpoint richiamando il EndpointRegistryClient dell’oggetto createEndpoint e passare CreateEndpointInfo oggetto. Questo metodo restituisce un Endpoint oggetto che rappresenta il nuovo endpoint SOAP.
Attiva l'endpoint.

Abilita l’endpoint richiamando il EndpointRegistryClient il metodo enable dell'oggetto e trasmettere Endpoint oggetto restituito da createEndpoint metodo .

Consulta anche

Guida introduttiva: Aggiunta di un endpoint SOAP utilizzando l’API Java

Aggiungi un endpoint per cartelle controllate utilizzando l’API Java

Aggiunta di endpoint cartelle controllate adding-watched-folder-endpoints

Puoi aggiungere programmaticamente un endpoint Cartella osservata a un servizio utilizzando l’API Java di AEM Forms. Aggiungendo un endpoint per cartelle controllate, 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 viene manipolato il file. Dopo aver eseguito l'operazione specificata, il servizio salva il file modificato in una cartella di output specificata. Una cartella controllata è configurata per la scansione a un intervallo a tasso fisso o con un programma cron, ad esempio ogni lunedì, mercoledì e venerdì a mezzogiorno.

Per aggiungere in modo programmatico un endpoint Cartella osservata a un servizio, considera il seguente processo di breve durata denominato Crittografa documento. (Vedi Informazioni sui processi AEM Forms.)

aw_aw_encryptdocumentprocess

Questo processo accetta un documento PDF non protetto come valore di input e quindi trasmette il documento PDF non protetto al servizio di crittografia EncryptPDFUsingPassword funzionamento. Il documento PDF viene crittografato con una password e il documento PDF crittografato con password rappresenta 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.

NOTE

Non è possibile aggiungere un endpoint per cartelle controllate utilizzando i servizi Web.

Riepilogo dei passaggi summary_of_steps-2

Per aggiungere a un servizio un endpoint di tipo Cartella controllata, eseguire le operazioni seguenti:

Includi file di progetto.
Crea un EndpointRegistryClient oggetto.
Imposta gli attributi dell'endpoint della cartella controllata.
Specifica i valori di configurazione.
Definisci i valori dei parametri di input.
Definire un valore del parametro di output.
Crea un endpoint per cartelle controllate.
Attiva l'endpoint.

Includi file di progetto

I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)
jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)

Per informazioni sulla posizione di questi file JAR, vedi Inclusione dei file libreria Java di AEM Forms.

Creare un oggetto Client EndpointRegistry

Per aggiungere a livello di programmazione un endpoint per cartelle controllate, è necessario creare un EndpointRegistryClient oggetto.

Impostare gli attributi dell’endpoint della cartella controllata

Per creare un endpoint per cartelle controllate per un servizio, specificare i seguenti valori:

Identificatore del connettore: Specifica il tipo di endpoint creato. Per creare un endpoint per cartelle controllate, specificare WatchedFolder.
Descrizione: Specifica la descrizione dell'endpoint.
Nome: Specifica il nome dell'endpoint.
Identificatore del servizio: Specifica il servizio a cui appartiene l'endpoint. Ad esempio, per aggiungere un endpoint Cartella osservata al processo introdotto in questa sezione (un processo diventa un servizio quando viene attivato tramite Workbench), specificare EncryptDocument.
Nome operazione: Specifica il nome dell'operazione richiamata utilizzando l'endpoint. In genere, durante la creazione di un endpoint Cartella di controllo per un servizio creato 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 sottoposta a controllo quando si aggiunge in modo programmatico un endpoint di una cartella sottoposta a controllo a un servizio. Questi valori di configurazione vengono specificati da un amministratore se viene aggiunto un endpoint per cartelle controllate utilizzando la console di amministrazione.

L'elenco seguente specifica i valori di configurazione impostati durante l'aggiunta programmatica di un endpoint di tipo Cartella sottoposta a controllo a un servizio:

url: Specifica il percorso della cartella controllata. 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 richiamati solo in modo sincrono. Il valore predefinito è vero. È consigliato l’utilizzo asincrono.
cronExpression: Utilizzato dal quarzo per pianificare il polling della directory di input.
purgeDuration: Questo è 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 garantire che la cartella dei risultati non sia piena. Il valore -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 sottoposta a controllo per l'input. A meno che non sia abilitata la limitazione, questo valore deve essere più lungo del tempo necessario per elaborare un lavoro medio; in caso contrario, il sistema potrebbe sovraccaricarsi. Il valore predefinito è 5.
repeatCount: Il numero di volte in cui una cartella osservata 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 controllate 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 sottoposta a controllo. Questo valore è obbligatorio. Il valore predefinito è SuperAdmin.
domainName: 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 sul 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 acquisito dopo che sono passati 59 o più minuti. Questo attributo è utile per garantire che un file o una cartella venga copiata 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 controllata di eseguire la scansione del file se non è in attesa da dieci minuti. Il valore predefinito è 0.
excludeFilePattern: Il pattern utilizzato da una cartella controllata per determinare quali file e cartelle analizzare e raccogliere. Qualsiasi file o cartella con questo pattern non verrà analizzato 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 controllata. Questo passaggio impedisce alla cartella controllata 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 data* non vengono prelevati. Questo include file e cartelle denominati data1, data2e così via. Inoltre, il pattern può essere completato con pattern di caratteri jolly per specificare i pattern di file. La cartella controllata modifica l’espressione regolare per supportare pattern di caratteri jolly quali *.* e *.pdf. Questi pattern di caratteri jolly non sono supportati da espressioni regolari.
includeFilePattern: Il pattern utilizzato dalla cartella controllata per determinare le cartelle e i file da analizzare e raccogliere. Ad esempio, se questo valore è *, tutti i file e le cartelle corrispondenti input* vengono prelevati. Questo include file e cartelle denominati input1, input2e 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 controllata modifica l’espressione regolare per supportare pattern di caratteri jolly quali *.* e *.pdf. Questi pattern di caratteri jolly non sono supportati da espressioni regolari. Questo valore è obbligatorio.
resultFolderName: Cartella in cui vengono archiviati i risultati salvati. Questa posizione può essere un percorso di directory assoluto o relativo. Se i risultati non vengono visualizzati in questa cartella, controlla 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/. Questa è la cartella dei risultati all'interno della cartella controllata.
preserveFolderName: Il percorso in cui vengono archiviati i file dopo la scansione e il ritiro riusciti. Questa posizione può essere un percorso di directory assoluto, relativo o nullo. Il valore predefinito è preserve/%Y/%M/%D/.
failedFolderName: Cartella in cui vengono salvati i file di errore. Questa posizione è sempre relativa alla cartella controllata. I file di sola lettura non vengono elaborati e verranno salvati nella cartella degli errori. Il valore predefinito è failure/%Y/%M/%D/.
preserveOnFailure: Mantieni i file di input in caso di errore durante l'esecuzione dell'operazione su un servizio. Il valore predefinito è vero.
overwriteDuplicateFilename: Se impostato su true, i file nella cartella dei risultati e nella cartella preserve vengono sovrascritti. Se impostato su false, il nome verrà utilizzato per i file e le cartelle con un suffisso di indice numerico. Il valore predefinito è false.

Definire i valori dei parametri di input

Quando crei un endpoint di una cartella controllata, devi definire i valori dei parametri di input. In altre parole, devi descrivere i valori di input passati all’operazione richiamata dalla cartella controllata. Ad esempio, considera il processo introdotto in questo argomento. Ha un valore di input denominato InDoc e il relativo tipo di dati è com.adobe.idp.Document. Quando crei un endpoint di tipo Cartella controllata per questo processo (dopo l'attivazione di un processo, questo diventa un servizio), devi definire il valore del parametro di input.

Per definire i valori dei parametri di input richiesti per un endpoint di una cartella sottoposta a controllo, specificare i seguenti valori:

Nome del parametro di input: Nome del parametro di input. Il nome di un valore di input viene 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 viene specificato nel file component.xml. Ad esempio, il nome del parametro di input per il processo introdotto in questa sezione è InDoc.

Tipo di mappatura: Utilizzato per configurare i valori di input necessari per richiamare l'operazione del servizio. Esistono due tipi di mapping:

Literal: L’endpoint Cartella controllata utilizza il valore immesso nel campo durante la visualizzazione. 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 controllata per selezionare l’input. Ad esempio, se selezioni Variabile per il tipo di mappatura e il documento di input deve essere un file PDF, puoi specificare *.pdfcome valore di mappatura.

Valore mappatura: Specifica il valore del tipo di mappatura. Ad esempio, se selezioni un Variable tipo di mappatura, puoi specificare *.pdf come pattern di file.

Tipo di dati: Specifica il tipo di dati dei valori immessi. Ad esempio, il tipo di dati del valore di input del processo introdotto in questa sezione è com.adobe.idp.Document.

Definire un valore del parametro di output

Quando crei un endpoint di una cartella controllata, devi definire un valore di parametro di output. In altre parole, è necessario descrivere il valore di output restituito dal servizio richiamato dall'endpoint Cartella controllata. Ad esempio, considera il processo introdotto in questo argomento. Ha un valore di output denominato SecuredDoc e il relativo tipo di dati è com.adobe.idp.Document. Quando crei un endpoint di tipo Cartella controllata per questo processo (dopo l'attivazione di un processo, questo diventa un servizio), devi definire il valore del parametro di output.

Per definire un valore del parametro di output richiesto per un endpoint di una cartella sottoposta a controllo, specificare 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 viene specificato nel file component.xml. Ad esempio, il nome del parametro di output per il processo introdotto in questa sezione è SecuredDoc.

Tipo di mappatura: 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 è %F.pdf e la destinazione di origine è sourcefilename.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 significa utilizzare il nome file specificato). Il modello %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 e Result\sourcefilename\file2. Se la mappa ha più di un oggetto, il pattern è 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 del processo introdotto in questa sezione è com.adobe.idp.Document.

Creare un endpoint per cartelle controllate

Dopo aver impostato gli attributi, i valori di configurazione e i valori dei parametri di input e output dell’endpoint, è necessario creare l’endpoint Cartella controllata.

Abilitare l’endpoint

Dopo aver creato un endpoint per cartelle controllate, è necessario abilitarlo. Quando l’endpoint è abilitato, può essere utilizzato per richiamare il servizio. Dopo aver abilitato l’endpoint, puoi visualizzarlo nella console di amministrazione.

Consulta anche

Aggiungi un endpoint per cartelle controllate utilizzando l’API Java add-a-watched-folder-endpoint-using-the-java-api

Aggiungi un endpoint per cartelle controllate utilizzando l’API Java di AEM Forms:

Includi file di progetto.

Includi file JAR client, come adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto Client EndpointRegistry.
- Crea un ServiceClientFactory oggetto contenente le proprietà di connessione.
- Crea un EndpointRegistryClient utilizzando il relativo costruttore e passando ServiceClientFactory oggetto.
Imposta gli attributi dell'endpoint della cartella controllata.
- Crea un CreateEndpointInfo utilizzando il relativo costruttore.
- Specifica il valore dell’identificatore del connettore richiamando il CreateEndpointInfo dell’oggetto setConnectorId e passare il valore della stringa WatchedFolder.
- Specifica la descrizione dell’endpoint richiamando il CreateEndpointInfo dell’oggetto setDescription e passare un valore stringa che descrive l'endpoint.
- Specifica il nome dell'endpoint richiamando il CreateEndpointInfo dell’oggetto setName e passare un valore stringa che specifica il nome.
- Specifica il servizio a cui appartiene l'endpoint richiamando il CreateEndpointInfo dell’oggetto setServiceId e passare un valore stringa che specifica il nome del servizio.
- Specifica l'operazione richiamata richiamando il CreateEndpointInfo dell’oggetto setOperationName e passare un valore stringa che specifica il nome dell'operazione. In genere, durante la creazione di un endpoint Cartella di controllo per un servizio creato da un processo creato in Workbench, viene richiamato il nome dell'operazione.

Specifica i valori di configurazione.

Per ogni valore di configurazione da impostare per l’endpoint Cartella controllata, è necessario richiamare l’ CreateEndpointInfo dell’oggetto setConfigParameterAsText metodo . Ad esempio, per impostare il url valore di configurazione, richiama il CreateEndpointInfo dell’oggetto setConfigParameterAsText e passare i seguenti valori stringa:

Valore stringa che specifica il nome del valore di configurazione. Quando si imposta la variabile url valore di configurazione, specifica url.
Valore stringa che specifica il valore di configurazione. Quando si imposta la variabile url valore di configurazione, specifica il percorso della cartella controllata.

note note
NOTE
Per visualizzare tutti i valori di configurazione impostati per il servizio EncryptDocument, vedi l'esempio di codice Java disponibile in Guida introduttiva: Aggiunta di un endpoint per cartelle controllate tramite l’API Java.

Definisci i valori dei parametri di input.

Definire un valore del parametro di input richiamando il CreateEndpointInfo dell’oggetto setInputParameterMapping e passare i seguenti valori:

Valore stringa che specifica il nome del parametro di input. Ad esempio, il nome del parametro di input per il servizio EncryptDocument è InDoc.
Valore stringa che specifica il tipo di dati del parametro di input. Ad esempio, il tipo di dati InDoc il parametro di input è com.adobe.idp.Document.
Valore stringa che specifica il tipo di mapping. Ad esempio, puoi specificare variable.
Valore stringa che specifica il valore del tipo di mappatura. Ad esempio, è possibile specificare *.pdf come pattern di file.

note note
NOTE
Richiama il `setInputParameterMapping` metodo per ogni valore del parametro di input da definire. Poiché il processo EncryptDocument dispone di un solo parametro di input, è necessario richiamare questo metodo una volta.

Definire un valore del parametro di output.

Definire un valore del parametro di output richiamando il CreateEndpointInfo dell’oggetto setOutputParameterMapping e passare i seguenti valori:
- Valore stringa che specifica il nome del parametro di output. Ad esempio, il nome del parametro di output per il servizio EncryptDocument è SecuredDoc.
- Valore stringa che specifica il tipo di dati del parametro di output. Ad esempio, il tipo di dati SecuredDoc parametro di output com.adobe.idp.Document.
- Valore stringa che specifica il tipo di mapping. Ad esempio, puoi specificare %F.pdf.
Crea un endpoint per cartelle controllate.

Crea l’endpoint richiamando il EndpointRegistryClient dell’oggetto createEndpoint e passare CreateEndpointInfo oggetto. Questo metodo restituisce un Endpoint oggetto che rappresenta l'endpoint Cartella controllata.
Attiva l'endpoint.

Abilita l’endpoint richiamando il EndpointRegistryClient dell’oggetto enable e passare Endpoint oggetto restituito da createEndpoint metodo .

Consulta anche

Guida introduttiva: Aggiunta di un endpoint per cartelle controllate tramite l’API Java

Aggiungi un endpoint e-mail utilizzando l’API Java

File costante dei valori di configurazione della cartella controllata watched-folder-configuration-values-constant-file

La Guida introduttiva: Aggiunta di un endpoint per cartelle controllate tramite l’API Java utilizza un file costante che deve far parte del progetto Java per compilare il quick start. Questo file costante rappresenta i valori di configurazione che devono essere impostati quando si aggiunge un endpoint Watched Folder. 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 adding-email-endpoints

Puoi aggiungere programmaticamente un endpoint e-mail a un servizio utilizzando l’API Java di AEM Forms. Aggiungendo un endpoint e-mail, gli utenti possono inviare un messaggio e-mail con uno o più file allegati a un account e-mail specifico. Quindi viene richiamata l’operazione di configurazione del servizio e vengono manipolati i file. Dopo aver eseguito l’operazione specificata, il servizio invia un messaggio e-mail al mittente contenente i file modificati come allegati di file.

Ai fini dell’aggiunta programmatica di un endpoint e-mail a un servizio, considera il seguente processo di breve durata denominato MyApplication\EncryptDocument. Per informazioni sui processi di breve durata, vedi Informazioni sui processi AEM Forms.

ae_encryptdocumentprocess

Questo processo accetta un documento PDF non protetto come valore di input e quindi trasmette il documento PDF non protetto al servizio di crittografia EncryptPDFUsingPassword funzionamento. Questo processo crittografa il documento PDF con una password e restituisce il documento PDF crittografato con password 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.

NOTE

Non è possibile aggiungere un endpoint e-mail utilizzando i servizi Web.

Riepilogo dei passaggi summary_of_steps-3

Per aggiungere un endpoint e-mail a un servizio, esegui le seguenti operazioni:

Includi file di progetto.
Crea un EndpointRegistryClient oggetto.
Imposta gli attributi dell’endpoint e-mail.
Specifica i valori di configurazione.
Definisci i valori dei parametri di input.
Definire un valore del parametro di output.
Crea l’endpoint e-mail.
Attiva l'endpoint.

Includi file di progetto

I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)
jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)

Per informazioni sulla posizione di questi file JAR, vedi Inclusione dei file libreria Java di AEM Forms.

Creare un oggetto Client EndpointRegistry

Prima di poter aggiungere programmaticamente un endpoint e-mail, devi creare un EndpointRegistryClient oggetto.

Impostare gli attributi dell’endpoint e-mail

Per creare un endpoint e-mail per un servizio, specifica i seguenti valori:

Valore identificativo del connettore: Specifica il tipo di endpoint creato. Per creare un endpoint e-mail, specificare Email.
Descrizione: Specifica una descrizione per l'endpoint.
Nome: Specifica il nome dell'endpoint.
Valore identificativo del 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 viene attivato tramite Workbench), specifica EncryptDocument.
Nome operazione: Specifica il nome dell'operazione richiamata utilizzando l'endpoint. In genere, quando si crea un endpoint e-mail per un servizio creato 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 viene aggiunto un endpoint e-mail tramite la console di amministrazione.

NOTE

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 regolare. L’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 casella in entrata al termine dei messaggi.

I seguenti valori di configurazione vengono impostati quando si aggiunge programmaticamente 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: Velocità di scansione in secondi utilizzata dal ricevitore per il controllo della posta in arrivo. Il valore predefinito è 10.
startDelay: Tempo di attesa per l'analisi dopo l'avvio della pianificazione. Il tempo 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 da un messaggio e-mail. Il valore predefinito è SuperAdmin.
domainName: Un valore di configurazione obbligatorio. Il valore predefinito è DefaultDom.
domainPattern: Specifica i pattern di dominio delle e-mail in arrivo accettate dal provider. Ad esempio, se adobe.com viene utilizzato, viene elaborata solo l’e-mail da adobe.com, l’e-mail da altri domini viene ignorata.
filePattern: Specifica i pattern di file allegato in ingresso accettati dal provider. Ciò include i file con estensioni di nome file specifiche (*.dat, *.xml), i file con nomi specifici (dati) e i file con espressioni composite nel nome e nell'estensione (*.[dD][aA][Tt]). Il valore predefinito è *.
recipientSuccfulJob: Indirizzo e-mail a cui vengono inviati i messaggi per indicare l’esito positivo dei processi. Per impostazione predefinita, al mittente viene sempre inviato un messaggio di lavoro riuscito. Se si digita sender, i risultati dell’e-mail vengono inviati al mittente. Sono supportati fino a 100 destinatari. Specifica i destinatari aggiuntivi con indirizzi e-mail, ciascuno separato da una virgola. Per disattivare questa opzione, lasciare vuoto questo valore. In alcuni casi, potresti voler attivare un processo e non volere una notifica via e-mail del risultato. Il valore predefinito è sender.
recipientFailedJob: Indirizzo e-mail a cui vengono inviati i messaggi per indicare processi non riusciti. Per impostazione predefinita, al mittente viene sempre inviato un messaggio di lavoro non riuscito. Se si digita sender, i risultati dell’e-mail vengono inviati al mittente. Sono supportati fino a 100 destinatari. Specifica i destinatari aggiuntivi con indirizzi e-mail, ciascuno separato da una virgola. Per disattivare questa opzione, lasciare vuoto questo valore. Il valore predefinito è sender.
inboxHost: Nome host della casella in entrata o indirizzo IP da analizzare dal provider di posta elettronica.
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 casella in entrata. Le opzioni sono IMAP o POP3. Il server di posta elettronica host della casella in entrata deve supportare questi protocolli.
inboxTimeOut: Timeout in secondi prima che il provider di posta elettronica attenda le risposte della casella in entrata. Il valore predefinito è 60.
inboxUser: Nome utente necessario per accedere all’account e-mail. A seconda del server e-mail e della configurazione, questa può essere solo la parte del nome utente dell’e-mail o l’indirizzo e-mail completo.
inboxPassword: Password per l’utente della inbox.
inboxSSLEnabled: Imposta questo valore per forzare il provider di posta elettronica a utilizzare SSL durante l’invio di messaggi di notifica di risultati o errori. Assicurati che l'host IMAP o POP3 supporti SSL.
smtpHost: Nome host del server di posta a cui il provider di posta elettronica 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 quando invia notifiche e-mail di risultati ed errori.
smtpPassword: Password dell'account SMTP. Alcuni server di posta non richiedono una password SMTP.
charSet: Il set di caratteri utilizzato dal provider di posta elettronica. Il valore predefinito è UTF-8.
smtpSSLEnabled: Imposta questo valore per forzare il provider di posta elettronica a utilizzare SSL durante l’invio di messaggi di notifica di risultati o errori. Assicurati che l’host SMTP supporti SSL.
failedJobFolder: Specifica una directory in cui memorizzare i risultati quando il server di posta SMTP non è operativo.
asincrono: Se è impostato su sincrono, vengono elaborati tutti i documenti di input e viene restituita una sola risposta. Se è impostato su asincrono, viene inviata una risposta per ogni 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 casella in entrata 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 allegati. Se l’endpoint è configurato come asincrono, viene inviato un messaggio e-mail di risposta separato per ciascun documento protetto di PDF. Ogni messaggio e-mail contiene un singolo documento PDF come allegato. Il valore predefinito è asincrono.

Definire i valori dei parametri di input

Quando crei un endpoint e-mail, devi 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, considera il processo introdotto in questo argomento. Ha un valore di input denominato InDoc e il relativo tipo di dati è com.adobe.idp.Document. Quando crei un endpoint e-mail per questo processo (dopo l'attivazione di un processo, questo diventa un servizio), devi definire il valore del parametro di input.

Per definire i valori dei parametri di input richiesti per un endpoint e-mail, specifica i seguenti valori:

Nome del parametro di input: Nome del parametro di input. Il nome di un valore di input viene 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 viene specificato nel file component.xml. Ad esempio, il nome del parametro di input per il processo introdotto in questa sezione è InDoc.

Tipo di mappatura: Utilizzato per configurare i valori di input necessari per richiamare l'operazione del servizio. Due tipi di mappatura 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 inserito è un pattern di file utilizzato dall’endpoint e-mail per selezionare l’input. Ad esempio, se selezioni Variabile per il tipo di mappatura e il documento di input deve essere un file PDF, puoi specificare *.pdf come valore di mappatura.

Valore mappatura: Specifica il valore del tipo di mappatura. Ad esempio, se selezioni un tipo di mappatura Variabile, puoi 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 del parametro di output

Quando crei un endpoint e-mail, devi definire un valore di parametro di output. In altre parole, devi descrivere il valore di output restituito dal servizio richiamato dall’endpoint e-mail. Ad esempio, considera il processo introdotto in questo argomento. Ha un valore di output denominato SecuredDoc e il relativo tipo di dati è com.adobe.idp.Document. Quando crei un endpoint e-mail per questo processo (dopo l'attivazione di un processo, questo diventa un servizio), devi definire il valore del parametro di output.

Per definire un valore del parametro di output richiesto per un endpoint e-mail, specifica i seguenti valori:

Tipo di mappatura: 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 è %F.pdf e la destinazione di origine è sourcefilename.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 significa utilizzare il nome file specificato). Il modello %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 e Result\sourcefilename\file2. Se la mappa ha più di un oggetto, il pattern è 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 del processo introdotto in questa sezione è com.adobe.idp.Document.

Creare l’endpoint e-mail

Dopo aver impostato gli attributi e i valori di configurazione dell’endpoint e-mail e aver definito i valori dei parametri di input e output, devi creare l’endpoint e-mail.

Abilitare l’endpoint

Dopo aver creato un endpoint e-mail, devi attivarlo. Quando l’endpoint è abilitato, può essere utilizzato per richiamare il servizio. Dopo aver abilitato l’endpoint, puoi visualizzarlo nella console di amministrazione.

Consulta anche

Aggiungi un endpoint e-mail utilizzando l’API Java add-an-email-endpoint-using-the-java-api

Aggiungi un endpoint e-mail utilizzando l’API Java:

Includi file di progetto.

Includi file JAR client, come adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto Client EndpointRegistry.
- Crea un ServiceClientFactory oggetto contenente le proprietà di connessione.
- Crea un EndpointRegistryClient utilizzando il relativo costruttore e passando ServiceClientFactory oggetto.
Imposta gli attributi dell’endpoint e-mail.
- Crea un CreateEndpointInfo utilizzando il relativo costruttore.
- Specifica il valore dell’identificatore del connettore richiamando il CreateEndpointInfo dell’oggetto setConnectorId e passare il valore della stringa Email.
- Specifica la descrizione dell’endpoint richiamando il CreateEndpointInfo dell’oggetto setDescription e passare un valore stringa che descrive l'endpoint.
- Specifica il nome dell'endpoint richiamando il CreateEndpointInfo dell’oggetto setName e passare un valore stringa che specifica il nome.
- Specifica il servizio a cui appartiene l'endpoint richiamando il CreateEndpointInfo dell’oggetto setServiceId e passare un valore stringa che specifica il nome del servizio.
- Specifica l'operazione richiamata richiamando il CreateEndpointInfo dell’oggetto setOperationName e passare un valore stringa che specifica il nome dell'operazione. In genere, quando si crea un endpoint e-mail per un servizio creato da un processo creato in Workbench, viene richiamato il nome dell’operazione.

Specifica i valori di configurazione.

Per ogni valore di configurazione da impostare per l’endpoint e-mail, è necessario richiamare CreateEndpointInfo dell’oggetto setConfigParameterAsText metodo . Ad esempio, per impostare il smtpHost valore di configurazione, richiama il CreateEndpointInfo dell’oggetto setConfigParameterAsText e passare i seguenti valori:

Valore stringa che specifica il nome del valore di configurazione. Quando si imposta la variabile smtpHost valore di configurazione, specifica smtpHost.
Valore stringa che specifica il valore di configurazione. Quando si imposta la variabile smtpHost valore di configurazione, specificare un valore di stringa che specifica il nome del server SMTP.

note note
NOTE
Per visualizzare tutti i valori di configurazione impostati per il servizio EncryptDocument introdotto in questa sezione, vedi l'esempio di codice Java situato in Guida introduttiva: Aggiunta di un endpoint e-mail tramite API Java.

Definisci i valori dei parametri di input.

Definire un valore del parametro di input richiamando il CreateEndpointInfo dell’oggetto setInputParameterMapping e passare i seguenti valori:

Valore stringa che specifica il nome del parametro di input. Ad esempio, il nome del parametro di input per il servizio EncryptDocument è InDoc.
Valore stringa che specifica il tipo di dati del parametro di input. Ad esempio, il tipo di dati InDoc il parametro di input è com.adobe.idp.Document.
Valore stringa che specifica il tipo di mapping. Ad esempio, puoi specificare variable.
Valore stringa che specifica il valore del tipo di mappatura. Ad esempio, è possibile specificare *.pdf come pattern di file.

note note
NOTE
Richiama il `setInputParameterMapping` metodo per ogni valore del parametro di input da definire. Poiché il processo EncryptDocument dispone di un solo parametro di input, è necessario richiamare questo metodo una volta.

Definire un valore del parametro di output.

Definire un valore del parametro di output richiamando il CreateEndpointInfo dell’oggetto setOutputParameterMapping e passando i seguenti valori:
- Valore stringa che specifica il nome del parametro di output. Ad esempio, il nome del parametro di output per il servizio EncryptDocument è SecuredDoc.
- Valore stringa che specifica il tipo di dati del parametro di output. Ad esempio, il tipo di dati SecuredDoc parametro di output com.adobe.idp.Document.
- Valore stringa che specifica il tipo di mapping. Ad esempio, puoi specificare %F.pdf.
Crea l’endpoint e-mail.

Crea l’endpoint richiamando il EndpointRegistryClient dell’oggetto createEndpoint e passare CreateEndpointInfo oggetto. Questo metodo restituisce un Endpoint oggetto che rappresenta l’endpoint e-mail.
Attiva l'endpoint.

Abilita l’endpoint richiamando il EndpointRegistryClient dell’oggetto enable e passare Endpoint oggetto restituito da createEndpoint metodo .

Consulta anche

Guida introduttiva: Aggiunta di un endpoint per cartelle controllate tramite l’API Java

Aggiungere un endpoint remoto utilizzando l'API Java

File costante valori di configurazione e-mail email-configuration-values-constant-file

La Guida introduttiva: Aggiunta di un endpoint e-mail tramite API Java utilizza un file costante che deve far parte del progetto Java per compilare il quick start. 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 adding-remoting-endpoints

NOTE

API di LiveCycle Remoting obsolete per i moduli AEM su JEE.

Puoi aggiungere programmaticamente un endpoint Remoting a un servizio utilizzando l'API Java di AEM Forms. Aggiungendo un endpoint Remoting, si sta abilitando un'applicazione Flex per richiamare il servizio utilizzando remoting. (Vedi Richiamo di AEM Forms utilizzando (obsoleto per i moduli AEM) AEM Forms Remoting.)

Ai fini dell'aggiunta programmatica di un endpoint Remoting a un servizio, considera il seguente processo di breve durata denominato Crittografa documento.

ar_ar_encryptdocumentprocess

Per illustrare come aggiungere un endpoint Remoting a un servizio, in questa sezione viene aggiunto un endpoint Remoting a un servizio denominato EncryptDocument.

NOTE

Non è possibile aggiungere un endpoint Remoting utilizzando i servizi Web.

Riepilogo dei passaggi summary_of_steps-4

Per rimuovere un endpoint da un servizio, esegui le seguenti operazioni:

Includi file di progetto.
Crea un EndpointRegistryClient oggetto.
Impostare gli attributi dell'endpoint remoto.
Creare un endpoint remoto.
Attiva l'endpoint.

Includi file di progetto

I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)
jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)

Per informazioni sulla posizione di questi file JAR, vedi Inclusione dei file libreria Java di AEM Forms.

Creare un oggetto client EndpointRegistry

Per aggiungere programmaticamente un endpoint Remoting, è necessario creare un EndpointRegistryClient oggetto.

Impostare gli attributi dell'endpoint remoto

Per creare un endpoint remoto per un servizio, specificare i seguenti valori:

Valore identificativo del connettore: Specifica il tipo di endpoint creato. Per creare un endpoint remoto, specificare Remoting.
Descrizione: Specifica la descrizione dell'endpoint.
Nome: Specifica il nome dell'endpoint.
Valore identificativo del servizio: Specifica il servizio a cui appartiene l'endpoint. Ad esempio, per aggiungere un endpoint Remoting 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. Durante la creazione di un endpoint remoto, specificare un carattere jolly (*).

Creare un endpoint remoto

Dopo aver impostato gli attributi dell'endpoint remoto, è possibile 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

Aggiungere un endpoint remoto utilizzando l'API Java add-a-remoting-endpoint-using-the-java-api

Aggiungi un endpoint remoto utilizzando l'API Java:

Includi file di progetto.

Includi file JAR client, come adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto Client EndpointRegistry.
- Crea un ServiceClientFactory oggetto contenente le proprietà di connessione.
- Crea un EndpointRegistryClient utilizzando il relativo costruttore e passando ServiceClientFactory oggetto.
Impostare gli attributi dell'endpoint remoto.
- Crea un CreateEndpointInfo utilizzando il relativo costruttore.
- Specifica il valore dell’identificatore del connettore richiamando il CreateEndpointInfo dell’oggetto setConnectorId e passare il valore della stringa Remoting.
- Specifica la descrizione dell’endpoint richiamando il CreateEndpointInfo dell’oggetto setDescription e passare un valore stringa che descrive l'endpoint.
- Specifica il nome dell'endpoint richiamando il CreateEndpointInfo dell’oggetto setName e passare un valore stringa che specifica il nome.
- Specifica il servizio a cui appartiene l'endpoint richiamando il CreateEndpointInfo dell’oggetto setServiceId e passare un valore stringa che specifica il nome del servizio.
- Specifica l’operazione richiamata dalla CreateEndpointInfo dell’oggetto setOperationName e passare un valore stringa che specifica il nome dell'operazione. Per un endpoint remoto, specificare un carattere jolly (*).
Creare un endpoint remoto.

Crea l’endpoint richiamando il EndpointRegistryClient dell’oggetto createEndpoint e passare CreateEndpointInfo oggetto. Questo metodo restituisce un Endpoint oggetto che rappresenta il nuovo endpoint Remoting.
Attiva l'endpoint.

Abilita l’endpoint richiamando il EndpointRegistryClient dell’oggetto enable e passare Endpoint oggetto restituito da createEndpoint metodo .

Consulta anche

Guida introduttiva: Aggiunta di un endpoint remoto utilizzando l'API Java

Aggiungere un endpoint TaskManager utilizzando l'API Java

Aggiunta di endpoint TaskManager adding-taskmanager-endpoints

Puoi aggiungere programmaticamente un endpoint TaskManager a un servizio utilizzando l’API Java di AEM Forms. Aggiungendo un endpoint TaskManager a un servizio, è possibile abilitare un utente Workspace a richiamare il servizio. In altre parole, un utente che lavora in Workspace può richiamare un processo con un endpoint TaskManager corrispondente.

NOTE

Non è possibile aggiungere un endpoint TaskManager utilizzando i servizi Web.

Riepilogo dei passaggi summary_of_steps-5

Per aggiungere un endpoint TaskManager a un servizio, eseguire le operazioni seguenti:

Includi file di progetto.
Crea un EndpointRegistryClient oggetto.
Crea una categoria per l’endpoint.
Impostare gli attributi dell'endpoint TaskManager.
Creare un endpoint TaskManager.
Attiva l'endpoint.

Includi file di progetto

I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)
jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)

Per informazioni sulla posizione di questi file JAR, vedi Inclusione dei file libreria Java di AEM Forms.

Creare un oggetto client EndpointRegistry

Prima di poter aggiungere programmaticamente un endpoint TaskManager, è necessario creare un EndpointRegistryClient oggetto.

Crea 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 con un endpoint TaskManager selezionando una categoria all’interno di Workspace. Durante la creazione di un endpoint TaskManager, è possibile fare riferimento a una categoria esistente o crearne una nuova a livello di programmazione.

NOTE

Questa sezione crea una nuova categoria come parte dell'aggiunta di un endpoint TaskManager a un servizio.

Imposta gli attributi dell’endpoint TaskManager

Per creare un endpoint TaskManager per un servizio, specificare i seguenti valori:

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 del 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, quando si crea un endpoint TaskManager per un servizio creato da un processo creato in Workbench, il nome dell'operazione è invoke.

Creare un endpoint TaskManager

Dopo aver impostato gli attributi dell'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 abilitato l’endpoint, puoi visualizzarlo nella console di amministrazione.

Consulta anche

Aggiungere un endpoint TaskManager utilizzando l'API Java add-a-taskmanager-endpoint-using-the-java-api

Aggiungi un endpoint TaskManager utilizzando l'API Java:

Includi file di progetto.

Includi file JAR client, come adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto Client EndpointRegistry.
- Crea un ServiceClientFactory oggetto contenente le proprietà di connessione.
- Crea un EndpointRegistryClient utilizzando il relativo costruttore e passando ServiceClientFactory oggetto.
Crea una categoria per l’endpoint.
- Crea un CreateEndpointCategoryInfo utilizzando il relativo costruttore e passando i seguenti valori:
  - Valore stringa che specifica il valore di identificazione della categoria
  - Valore stringa che specifica la descrizione della categoria
- Crea la categoria richiamando il EndpointRegistryClient dell’oggetto createEndpointCategory e passare CreateEndpointCategoryInfo oggetto. Questo metodo restituisce un EndpointCategory oggetto che rappresenta la nuova categoria.
Impostare gli attributi dell'endpoint TaskManager.
- Crea un CreateEndpointInfo utilizzando il relativo costruttore.
- Specifica il valore dell’identificatore del connettore richiamando il CreateEndpointInfo dell’oggetto setConnectorId e passare il valore della stringa TaskManagerConnector.
- Specifica la descrizione dell’endpoint richiamando il CreateEndpointInfo dell’oggetto setDescription e passare un valore stringa che descrive l'endpoint.
- Specifica il nome dell'endpoint richiamando il CreateEndpointInfo dell’oggetto setName e passare un valore stringa che specifica il nome.
- Specifica il servizio a cui appartiene l'endpoint richiamando il CreateEndpointInfo dell’oggetto setServiceId e passare un valore stringa che specifica il nome del servizio.
- Specifica la categoria a cui appartiene l'endpoint richiamando il CreateEndpointInfo dell’oggetto setCategoryId e passare un valore stringa che specifica il valore dell'identificatore della categoria. È possibile richiamare EndpointCategory dell’oggetto getId per ottenere il valore di identificatore di questa categoria.
- Specifica l'operazione richiamata richiamando il CreateEndpointInfo dell’oggetto setOperationName e passare un valore stringa che specifica il nome dell'operazione. In genere, durante la creazione di un TaskManager endpoint per un servizio creato da un processo creato in Workbench, il nome dell'operazione è invoke.
Creare un endpoint TaskManager.

Crea l’endpoint richiamando il EndpointRegistryClient dell’oggetto createEndpoint e passare CreateEndpointInfo oggetto. Questo metodo restituisce un Endpoint oggetto che rappresenta il nuovo endpoint TaskManager.
Attiva l'endpoint.

Abilita l’endpoint richiamando il EndpointRegistryClient dell’oggetto enable e passare Endpoint oggetto restituito da createEndpoint metodo .

Consulta anche

Guida introduttiva: Aggiunta di un endpoint TaskManager utilizzando l’API Java

Modifica di un endpoint utilizzando l’API Java

Modifica degli endpoint modifying-endpoints

Puoi modificare programmaticamente un endpoint esistente utilizzando l’API Java di AEM Forms. Modificando un endpoint, potete modificare il comportamento dell’endpoint. Considera, ad esempio, un endpoint Cartella controllata che specifica una cartella utilizzata come cartella controllata. Puoi modificare programmaticamente i valori di configurazione che appartengono all’endpoint Cartella controllata, in modo che un’altra cartella funzioni come cartella controllata. Per informazioni sui valori di configurazione che appartengono a un endpoint di una cartella controllata, consulta Aggiunta di endpoint cartelle controllate.

Per illustrare come modificare un endpoint, in questa sezione viene modificato un endpoint di tipo Cartella controllata modificando la cartella che si comporta come cartella controllata.

NOTE

Non è possibile modificare un endpoint utilizzando i servizi Web.

Riepilogo dei passaggi summary_of_steps-6

Per modificare un endpoint, esegui le seguenti operazioni:

Includi file di progetto.
Crea un EndpointRegistryClient oggetto.
Recupera l’endpoint.
Specifica i nuovi valori di configurazione.

Includi file di progetto

I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)
jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)

Per informazioni sulla posizione di questi file JAR, vedi Inclusione dei file libreria Java di AEM Forms.

Creare un oggetto client EndpointRegistry

Per modificare un endpoint a livello di programmazione, devi creare un EndpointRegistryClient oggetto.

Recupera l’endpoint da modificare

Prima di poter modificare un endpoint, è necessario recuperarlo. Per recuperare un endpoint, è necessario connettersi come utente in grado di accedere a un endpoint. È consigliabile connettersi come amministratore. (Vedi Impostazione delle proprietà di connessione).

È possibile recuperare un endpoint recuperando un elenco di endpoint. È quindi possibile eseguire iterazioni nell’elenco, cercando l’endpoint specifico da rimuovere. Ad esempio, è possibile individuare un endpoint determinando il servizio corrispondente all'endpoint e il tipo di endpoint. Quando individua l’endpoint, puoi modificarlo.

Specificare nuovi valori di configurazione

Quando modifichi un endpoint, specifica nuovi valori di configurazione. Ad esempio, per modificare un endpoint di una cartella controllata, reimposta tutti i valori di configurazione dell’endpoint della cartella controllata, non solo quelli che desideri modificare. Per informazioni sui valori di configurazione che appartengono a un endpoint di una cartella controllata, consulta Aggiunta di endpoint cartelle controllate.

NOTE

Per informazioni sui valori di configurazione che appartengono a un endpoint e-mail, consulta Aggiunta di endpoint e-mail.

NOTE

Non è possibile modificare il servizio richiamato dall'endpoint. Se tenti di modificare il servizio, viene generata un’eccezione. Per modificare il servizio associato a un determinato endpoint, rimuovi l'endpoint e creane uno nuovo. (Vedi Rimozione di endpoint.)

Consulta anche

Modifica di un endpoint utilizzando l’API Java modifying-an-endpoint-using-the-java-api

Modificare un endpoint utilizzando l'API Java:

Includi file di progetto.

Includi file JAR client, come adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto Client EndpointRegistry.
- Crea un ServiceClientFactory oggetto contenente le proprietà di connessione.
- Crea un EndpointRegistryClient utilizzando il relativo costruttore e passando ServiceClientFactory oggetto.
Recupera l’endpoint da modificare.
- Recupera un elenco di tutti gli endpoint a cui l'utente corrente (specificato nelle proprietà di connessione) può accedere richiamando il EndpointRegistryClient dell’oggetto getEndpoints e passare un PagingFilter oggetto che funge da filtro. Puoi trasmettere un (PagingFilter)null per restituire tutti gli endpoint. Questo metodo restituisce un java.util.List oggetto in cui ogni elemento è Endpoint oggetto. Per informazioni su un PagingFilter oggetto, vedere Riferimento API di AEM Forms.
- Itera attraverso il java.util.List per determinare se dispone di endpoint. Se esistono degli endpoint, ogni elemento è un EndPoint istanza.
- Determina il servizio che corrisponde a un endpoint richiamando il EndPoint dell’oggetto getServiceId metodo . Questo metodo restituisce un valore stringa che specifica il nome del servizio.
- Determinare il tipo di endpoint richiamando il EndPoint dell’oggetto getConnectorId metodo . Questo metodo restituisce un valore di stringa che specifica il tipo di endpoint. Ad esempio, se l’endpoint è un endpoint Cartella controllata, questo metodo restituisce WatchedFolder.
Specifica i nuovi valori di configurazione.
- Crea un ModifyEndpointInfo richiamando il relativo costruttore.
- Per ogni valore di configurazione da impostare, richiama il ModifyEndpointInfo dell’oggetto setConfigParameterAsText metodo . Ad esempio, per impostare il valore di configurazione dell’url, invoca il ModifyEndpointInfo dell’oggetto setConfigParameterAsText e passare i seguenti valori:
  - Valore stringa che specifica il nome del valore di configurazione. Ad esempio, per impostare il url valore di configurazione, specifica url.
  - Valore stringa che specifica il valore di configurazione. Per definire un valore per url valore di configurazione, specifica il percorso della cartella controllata.
- Richiama il EndpointRegistryClient dell’oggetto modifyEndpoint e passare il ModifyEndpointInfo oggetto.

Consulta anche

Guida introduttiva: Modifica di un endpoint utilizzando l’API Java

Rimozione di un endpoint utilizzando l'API Java

Rimozione di endpoint removing-endpoints

Puoi rimuovere programmaticamente un endpoint da un servizio utilizzando l'API Java di AEM Forms. Dopo la rimozione di un endpoint, non è possibile richiamare il servizio utilizzando il metodo di chiamata che l'endpoint ha abilitato. 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 Crittografa documento.

NOTE

Non è possibile rimuovere un endpoint utilizzando i servizi Web.

Riepilogo dei passaggi summary_of_steps-7

Per rimuovere un endpoint da un servizio, esegui le seguenti operazioni:

Includi file di progetto.
Crea un EndpointRegistryClient oggetto.
Recupera l’endpoint.
Rimuovi l'endpoint.

Includi file di progetto

I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)
jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)

Per informazioni sulla posizione di questi file JAR, vedi Inclusione dei file libreria Java di AEM Forms.

Creare un oggetto client EndpointRegistry

Per rimuovere un endpoint a livello di programmazione, devi creare un EndpointRegistryClient oggetto.

Recupera l’endpoint da rimuovere

Prima di rimuovere un endpoint, è necessario recuperarlo. Per recuperare un endpoint, è necessario connettersi come utente in grado di accedere a un endpoint. È consigliabile connettersi come amministratore. (Vedi Impostazione delle proprietà di connessione).

Rimuovere l'endpoint

Consulta anche

Rimozione di un endpoint utilizzando l'API Java removing-an-endpoint-using-the-java-api

Rimuovi un endpoint utilizzando l'API Java:

Includi file di progetto.

Includi file JAR client, come adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto Client EndpointRegistry.
- Crea un ServiceClientFactory oggetto contenente le proprietà di connessione.
- Crea un EndpointRegistryClient utilizzando il relativo costruttore e passando ServiceClientFactory oggetto.
Recupera l’endpoint da rimuovere.
- Recupera un elenco di tutti gli endpoint a cui l'utente corrente (specificato nelle proprietà di connessione) ha accesso richiamando il EndpointRegistryClient dell’oggetto getEndpoints e passare un PagingFilter oggetto che funge da filtro. Puoi passare (PagingFilter)null per restituire tutti gli endpoint. Questo metodo restituisce un java.util.List oggetto in cui ogni elemento è Endpoint oggetto.
- Itera attraverso il java.util.List per determinare se dispone di endpoint. Se esistono degli endpoint, ogni elemento è un EndPoint istanza.
- Determina il servizio che corrisponde a un endpoint richiamando il EndPoint dell’oggetto getServiceId metodo . Questo metodo restituisce un valore stringa che specifica il nome del servizio.
- Determinare il tipo di endpoint richiamando il EndPoint dell’oggetto getConnectorId metodo . 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.
Rimuovi l'endpoint.

Rimuovi l'endpoint richiamando il EndpointRegistryClient dell’oggetto remove e passare EndPoint oggetto che rappresenta l'endpoint da rimuovere.

Consulta anche

Guida introduttiva: Rimozione di un endpoint utilizzando l'API Java

Recupera le informazioni sul connettore endpoint utilizzando l’API Java

Recupero delle informazioni sul connettore endpoint retrieving-endpoint-connector-information

Puoi recuperare in modo programmatico informazioni sui connettori endpoint utilizzando l’API di AEM Forms. Un connettore consente a un endpoint di richiamare un servizio utilizzando vari metodi di chiamata. Ad esempio, un connettore per cartelle controllate consente a un endpoint di richiamare un servizio utilizzando cartelle controllate. Recuperando programmaticamente le informazioni sui connettori endpoint, puoi 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 controllate. (Vedi Aggiunta di endpoint cartelle controllate.)

NOTE

Non è possibile recuperare informazioni sugli endpoint utilizzando i servizi Web.

NOTE

In questo argomento viene utilizzato il ConnectorRegistryClient API per recuperare informazioni sui connettori endpoint. (Vedi Riferimento API di AEM Forms.)

Riepilogo dei passaggi summary_of_steps-8

Per recuperare le informazioni sul connettore endpoint, esegui le seguenti operazioni:

Includi file di progetto.
Crea un ConnectorRegistryClient oggetto.
Specifica il tipo di connettore.
Recupera i valori di configurazione.

Includi file di progetto

I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)
jbossall-client.jar (richiesto se AEM Forms è distribuito su JBoss Application Server)

Se AEM Forms è distribuito su un server applicazioni J2EE supportato che non è JBoss, sostituisci adobe-utilities.jar e jbossall-client.jar con file JAR specifici per il server applicazioni J2EE in cui viene distribuito AEM Forms. Per informazioni sulla posizione di tutti i file JAR di AEM Forms, vedi Inclusione dei file libreria Java di AEM Forms.

Creare un oggetto Client ConnectorRegistry

Per recuperare in modo programmatico le informazioni sul connettore endpoint, crea un ConnectorRegistryClient oggetto.

Specifica il tipo di connettore

Specifica 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: Consente a un'applicazione client di richiamare un servizio utilizzando la modalità SOAP.
Cartella osservata: Consente alle cartelle controllate di richiamare un servizio.
E-mail: Consente ai messaggi e-mail di richiamare un servizio.
Remoto: Consente a un'applicazione client Flex di richiamare un servizio.
ConnettoreGestioneAttività: Consente a un utente di Workspace di richiamare un servizio dall’interno di Workspace.

Recupera i valori di configurazione

Dopo aver specificato il tipo di connettore, puoi recuperare informazioni sul connettore, ad esempio il valore di configurazione supportato. Ad esempio, per qualsiasi connettore, puoi determinare quali valori di configurazione sono obbligatori e quali sono facoltativi.

Consulta anche

Recupera le informazioni sul connettore endpoint utilizzando l’API Java retrieve-endpoint-connector-information-using-the-java-api

Recupera le informazioni sul connettore endpoint utilizzando l’API Java:

Includi file di progetto. .

Includi file JAR client, come adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto Client ConnectorRegistry.
- Crea un ServiceClientFactory oggetto contenente le proprietà di connessione.
- Crea un ConnectorRegistryClient utilizzando il relativo costruttore e passando ServiceClientFactory oggetto.
Specifica il tipo di connettore.

Specifica il tipo di connettore richiamando il ConnectorRegistryClient dell’oggetto getEndpointDefinition e passare un valore stringa che specifica il tipo di connettore. Ad esempio, per specificare il tipo di connettore Cartella controllata, passare il valore della stringa WatchedFolder. Questo metodo restituisce un Endpoint oggetto corrispondente al tipo di connettore.
Recupera i valori di configurazione.
- Recupera i valori di configurazione associati all'interno dell'endpoint richiamando il Endpoint dell’oggetto getConfigParameters metodo . Questo metodo restituisce un array di ConfigParameter oggetti.
- Recupera le informazioni su ciascun valore di configurazione recuperando ogni elemento all’interno dell’array. Ogni elemento è un ConfigParameter oggetto. Ad esempio, puoi determinare se il valore di configurazione è obbligatorio o facoltativo richiamando il ConfigParameter dell’oggetto isRequired metodo . Se il valore di configurazione è obbligatorio, questo metodo restituisce true.

Consulta anche

Guida introduttiva: Recupero delle informazioni sul connettore endpoint tramite API Java