Informazioni sul servizio Registro di sistema di Endpoint
Il servizio Registro endpoint consente di gestire gli endpoint in modo programmatico. Ad esempio, puoi aggiungere a un servizio i seguenti tipi di endpoint:
EJB
SOAP
Cartella osservata
(Funzione obsoleta per i moduli AEM) Remoting
Gestione attività
Gli endpoint di tipo remoto SOAP, EJB e (obsoleti per i moduli AEM su JEE) vengono creati automaticamente per ogni servizio attivato. Gli endpoint SOAP ed EJB abilitano SOAP ed EJB per tutte le operazioni del servizio.
Un endpoint remoto consente ai client Flex di richiamare le operazioni sul servizio AEM Forms a cui è stato aggiunto l’endpoint. Viene creata una destinazione Flex con lo stesso nome dell'endpoint e i client Flex possono creare oggetti remoti che puntano a questa destinazione per richiamare le operazioni sul servizio pertinente.
Gli endpoint Email, Task Manager e Watched Folder mostrano solo un'operazione specifica del servizio. Per aggiungere questi endpoint è necessario 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 categories. Queste categorie vengono quindi esposte a Workspace tramite TaskManager e gli utenti finali visualizzano gli endpoint di TaskManager durante la loro classificazione. 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 in Workspace.
È possibile eseguire queste operazioni utilizzando il servizio Registro di sistema Endpoint:
Aggiungi gli endpoint EJB. (Vedere Aggiunta di endpoint EJB.)
Aggiungi endpoint SOAP. (Vedere Aggiunta di endpoint SOAP.)
Aggiungi endpoint per cartelle controllate (consulta Aggiunta di endpoint per cartelle controllate).
Aggiungi endpoint e-mail. (Consulta Aggiunta di endpoint e-mail.)
Aggiungi endpoint di tipo Remoting. (Vedere Aggiunta di endpoint remoti.)
Aggiungi endpoint TaskManager (vedere Aggiunta di endpoint TaskManager).
Modificare gli endpoint (vedere Modifica degli endpoint.)
Rimuovere gli endpoint (vedere Rimozione di endpoint.)
Recupera le informazioni sul connettore endpoint (consulta Recupero informazioni sul connettore endpoint.)
Puoi aggiungere programmaticamente un endpoint EJB a un servizio utilizzando l’API Java di AEM Forms. Aggiungendo un endpoint EJB a un servizio, stai 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.
Per aggiungere un endpoint EJB a un servizio, esegui le seguenti operazioni:
EndpointRegistry Client
.Includi file di progetto
Includi i file necessari nel progetto di sviluppo. I seguenti file JAR devono essere aggiunti al percorso della classe del progetto:
Per informazioni sulla posizione di questi file JAR, consulta Inclusione dei file della libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Prima di poter aggiungere programmaticamente un endpoint EJB, è necessario creare un oggetto EndpointRegistryClient
.
Impostare gli attributi dell’endpoint EJB
Per creare un endpoint EJB per un servizio, specifica i seguenti valori:
EJB
.*
). 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 EJB
Dopo aver impostato gli attributi dell'endpoint EJB, puoi 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 abilitato l’endpoint, puoi visualizzarlo nella console di amministrazione.
Consulta anche
Aggiunta di un endpoint EJB tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
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.
ServiceClientFactory
contenente le proprietà di connessione.EndpointRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Impostare gli attributi dell’endpoint EJB.
CreateEndpointInfo
utilizzando il relativo costruttore.setConnectorId
dell'oggetto CreateEndpointInfo
e passando il valore della stringa EJB
.setDescription
dell'oggetto CreateEndpointInfo
e passando un valore stringa che descrive l'endpoint.setName
dell'oggetto CreateEndpointInfo
e passando un valore di stringa che specifichi il nome.setServiceId
dell'oggetto CreateEndpointInfo
e passando un valore stringa che specifichi il nome del servizio.setOperationName
dell'oggetto CreateEndpointInfo
e passare un valore stringa che specifica il nome dell'operazione. Per gli endpoint SOAP e EJB, specifica un carattere jolly ( *
) che implica tutte le operazioni.Crea un endpoint EJB.
Creare il punto finale richiamando il metodo createEndpoint
dell'oggetto EndpointRegistryClient
e passando l'oggetto CreateEndpointInfo
. Questo metodo restituisce un oggetto Endpoint
che rappresenta il nuovo endpoint EJB.
Attiva l'endpoint.
Abilita l’endpoint richiamando il metodo enable dell’oggetto EndpointRegistryClient
e passando l’oggetto Endpoint
restituito dal metodo createEndpoint
.
Consulta anche
Guida introduttiva: Aggiunta di un endpoint EJB tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
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.
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.
Per aggiungere un endpoint SOAP a un servizio, eseguire le operazioni seguenti:
EndpointRegistryClient
.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:
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, consulta 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 oggetto EndpointRegistryClient
.
Impostare gli attributi dell’endpoint SOAP
Per aggiungere un endpoint SOAP a un servizio, specificare i seguenti valori:
SOAP
.*
). 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
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
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.
ServiceClientFactory
contenente le proprietà di connessione.EndpointRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Impostare gli attributi dell’endpoint SOAP.
CreateEndpointInfo
utilizzando il relativo costruttore.setConnectorId
dell'oggetto CreateEndpointInfo
e passando il valore della stringa SOAP
.setDescription
dell'oggetto CreateEndpointInfo
e passando un valore stringa che descrive l'endpoint.setName
dell'oggetto CreateEndpointInfo
e passando un valore di stringa che specifichi il nome.setServiceId
dell'oggetto CreateEndpointInfo
e passando un valore stringa che specifichi il nome del servizio.setOperationName
dell'oggetto CreateEndpointInfo
e passando un valore di stringa che specifica il nome dell'operazione. Per gli endpoint SOAP e EJB, specifica un carattere jolly ( *
) che implica tutte le operazioni.Creare un endpoint SOAP.
Creare il punto finale richiamando il metodo createEndpoint
dell'oggetto EndpointRegistryClient
e passando l'oggetto CreateEndpointInfo
. Questo metodo restituisce un oggetto Endpoint
che rappresenta il nuovo endpoint SOAP.
Attiva l'endpoint.
Abilita l’endpoint richiamando il metodo enable dell’oggetto EndpointRegistryClient
e passando l’oggetto Endpoint
restituito dal metodo createEndpoint
.
Consulta anche
Guida introduttiva: Aggiunta di un endpoint SOAP utilizzando l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
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.
Ai fini dell'aggiunta programmatica di un endpoint Cartella osservata a un servizio, considera il seguente processo di breve durata denominato EncryptDocument. (Consulta Informazioni sui processi AEM Forms.)
Questo processo accetta un documento PDF non protetto come valore di input e quindi trasmette il documento PDF non protetto all'operazione EncryptPDFUsingPassword
del servizio 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 per cartelle controllate utilizzando i servizi Web.
Per aggiungere a un servizio un endpoint di tipo Cartella controllata, eseguire le operazioni seguenti:
EndpointRegistryClient
.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:
Per informazioni sulla posizione di questi file JAR, consulta Inclusione dei file della libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Per aggiungere programmaticamente un endpoint Cartella osservata, è necessario creare un oggetto EndpointRegistryClient
.
Impostare gli attributi dell’endpoint della cartella controllata
Per creare un endpoint per cartelle controllate per un servizio, specificare i seguenti valori:
WatchedFolder
.EncryptDocument
.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:
data*
, non verranno prelevati tutti i file e le cartelle corrispondenti a data*
. 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 controllata modifica l’espressione regolare per supportare i pattern dei caratteri jolly quali *.*
e *.pdf
. Questi pattern di caratteri jolly non sono supportati da espressioni regolari.*
, vengono prelevati tutti i file e le cartelle corrispondenti a input*
. 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 controllata modifica l’espressione regolare per supportare i pattern dei caratteri jolly quali *.*
e *.pdf
. Questi pattern di caratteri jolly non sono supportati da espressioni regolari. Questo valore è obbligatorio.result/%Y/%M/%D/
. Questa è la cartella dei risultati all'interno della cartella controllata.preserve/%Y/%M/%D/
.failure/%Y/%M/%D/
.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 *.pdf
come valore di mappatura.Valore mappatura: Specifica il valore del tipo di mappatura. Ad esempio, se selezioni un tipo di mappatura Variable
, 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:
%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 pattern %E
specifica l’estensione del documento di input.Result\%F\
e la destinazione di origine è Result\sourcefilename\source1 (output 1) e Result\sourcefilename\source2 (output 2).Result\%F\
e la destinazione di origine è Result\sourcefilename\file1 and 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
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
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.
ServiceClientFactory
contenente le proprietà di connessione.EndpointRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Imposta gli attributi dell'endpoint della cartella controllata.
CreateEndpointInfo
utilizzando il relativo costruttore.setConnectorId
dell'oggetto CreateEndpointInfo
e passando il valore della stringa WatchedFolder
.setDescription
dell'oggetto CreateEndpointInfo
e passando un valore stringa che descrive l'endpoint.setName
dell'oggetto CreateEndpointInfo
e passando un valore di stringa che specifichi il nome.setServiceId
dell'oggetto CreateEndpointInfo
e passando un valore stringa che specifichi il nome del servizio.setOperationName
dell'oggetto CreateEndpointInfo
e passando un valore di 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 il metodo CreateEndpointInfo
dell’oggetto setConfigParameterAsText
. Ad esempio, per impostare il valore di configurazione url
, richiamare il metodo CreateEndpointInfo
dell'oggetto setConfigParameterAsText
e trasmettere i seguenti valori stringa:
url
, specificare url
.url
, specifica il percorso della cartella controllata.Per visualizzare tutti i valori di configurazione impostati per il servizio EncryptDocument, vedi l'esempio di codice Java situato in QuickStart: 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 metodo setInputParameterMapping
dell'oggetto CreateEndpointInfo
e passando i seguenti valori:
InDoc
.InDoc
è com.adobe.idp.Document
.variable
.Richiama il metodo setInputParameterMapping
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 metodo setOutputParameterMapping
dell'oggetto CreateEndpointInfo
e passando i seguenti valori:
SecuredDoc
.SecuredDoc
è com.adobe.idp.Document
.%F.pdf
.Crea un endpoint per cartelle controllate.
Creare il punto finale richiamando il metodo createEndpoint
dell'oggetto EndpointRegistryClient
e passando l'oggetto CreateEndpointInfo
. Questo metodo restituisce un oggetto Endpoint
che rappresenta l'endpoint Watched Folder.
Attiva l'endpoint.
Abilita l’endpoint richiamando il metodo enable
dell’oggetto EndpointRegistryClient
e passando l’oggetto Endpoint
restituito dal metodo createEndpoint
.
Consulta anche
Guida introduttiva: Aggiunta di un endpoint per cartelle controllate tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido di: L'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";
}
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, consulta Informazioni sui processi AEM Forms.
Questo processo accetta un documento PDF non protetto come valore di input e quindi trasmette il documento PDF non protetto all'operazione EncryptPDFUsingPassword
del servizio di cifratura. 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
.
Non è possibile aggiungere un endpoint e-mail utilizzando i servizi Web.
Per aggiungere un endpoint e-mail a un servizio, esegui le seguenti operazioni:
EndpointRegistryClient
.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:
Per informazioni sulla posizione di questi file JAR, consulta Inclusione dei file della libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Prima di poter aggiungere programmaticamente un endpoint e-mail, è necessario creare un oggetto EndpointRegistryClient
.
Impostare gli attributi dell’endpoint e-mail
Per creare un endpoint e-mail per un servizio, specifica i seguenti valori:
Email
.EncryptDocument
.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.
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:
SuperAdmin
.DefaultDom
.adobe.com
, viene elaborato solo l’e-mail da adobe.com, l’e-mail da altri domini viene ignorata.*
.sender
, i risultati delle 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
.sender
, i risultati delle 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
.IMAP
o POP3
. Il server di posta elettronica host della casella in entrata deve supportare questi protocolli.UTF-8
.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:
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:
%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 pattern %E
specifica l’estensione del documento di input.Result\%F\
e la destinazione di origine è Result\sourcefilename\source1 (output 1) e Result\sourcefilename\source2 (output 2).Result\%F\
e la destinazione di origine è Result\sourcefilename\file1 and 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
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
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.
ServiceClientFactory
contenente le proprietà di connessione.EndpointRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Imposta gli attributi dell’endpoint e-mail.
CreateEndpointInfo
utilizzando il relativo costruttore.setConnectorId
dell'oggetto CreateEndpointInfo
e passando il valore della stringa Email
.setDescription
dell'oggetto CreateEndpointInfo
e passando un valore stringa che descrive l'endpoint.setName
dell'oggetto CreateEndpointInfo
e passando un valore di stringa che specifichi il nome.setServiceId
dell'oggetto CreateEndpointInfo
e passando un valore stringa che specifichi il nome del servizio.setOperationName
dell'oggetto CreateEndpointInfo
e passando un valore di 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 il metodo CreateEndpointInfo
dell’oggetto setConfigParameterAsText
. Ad esempio, per impostare il valore di configurazione smtpHost
, richiamare il metodo CreateEndpointInfo
dell'oggetto setConfigParameterAsText
e trasmettere i seguenti valori:
smtpHost
, specificare smtpHost
.smtpHost
, specificare un valore stringa che specifichi il nome del server SMTP.Per visualizzare tutti i valori di configurazione impostati per il servizio EncryptDocument introdotto in questa sezione, vedi l'esempio di codice Java situato in QuickStart: Aggiunta di un endpoint e-mail utilizzando l'API Java.
Definisci i valori dei parametri di input.
Definire un valore del parametro di input richiamando il metodo setInputParameterMapping
dell'oggetto CreateEndpointInfo
e passando i seguenti valori:
InDoc
.InDoc
è com.adobe.idp.Document
.variable
.Richiama il metodo setInputParameterMapping
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 metodo setOutputParameterMapping
dell'oggetto CreateEndpointInfo
e passando i seguenti valori:
SecuredDoc
.SecuredDoc
è com.adobe.idp.Document
.%F.pdf
.Crea l’endpoint e-mail.
Creare il punto finale richiamando il metodo createEndpoint
dell'oggetto EndpointRegistryClient
e passando l'oggetto CreateEndpointInfo
. Questo metodo restituisce un oggetto Endpoint
che rappresenta l’endpoint e-mail.
Attiva l'endpoint.
Abilita l’endpoint richiamando il metodo enable
dell’oggetto EndpointRegistryClient
e passando l’oggetto Endpoint
restituito dal metodo createEndpoint
.
Consulta anche
Guida introduttiva: Aggiunta di un endpoint per cartelle controllate tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido di: 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 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";
}
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. (Vedere 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 EncryptDocument.
Questo processo accetta un documento PDF non protetto come valore di input e quindi trasmette il documento PDF non protetto all'operazione EncryptPDFUsingPassword
del servizio 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 illustrare come aggiungere un endpoint Remoting a un servizio, in questa sezione viene aggiunto un endpoint Remoting a un servizio denominato EncryptDocument.
Non è possibile aggiungere un endpoint Remoting utilizzando i servizi Web.
Per rimuovere un endpoint da un servizio, esegui le seguenti operazioni:
EndpointRegistryClient
.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:
Per informazioni sulla posizione di questi file JAR, consulta Inclusione dei file della libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Per aggiungere programmaticamente un endpoint Remoting, è necessario creare un oggetto EndpointRegistryClient
.
Impostare gli attributi dell'endpoint remoto
Per creare un endpoint remoto per un servizio, specificare i seguenti valori:
Remoting
.EncryptDocument
.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
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
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.
ServiceClientFactory
contenente le proprietà di connessione.EndpointRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Impostare gli attributi dell'endpoint remoto.
CreateEndpointInfo
utilizzando il relativo costruttore.setConnectorId
dell'oggetto CreateEndpointInfo
e passando il valore della stringa Remoting
.setDescription
dell'oggetto CreateEndpointInfo
e passando un valore stringa che descrive l'endpoint.setName
dell'oggetto CreateEndpointInfo
e passando un valore di stringa che specifichi il nome.setServiceId
dell'oggetto CreateEndpointInfo
e passando un valore stringa che specifichi il nome del servizio.setOperationName
dell'oggetto CreateEndpointInfo
e passare un valore stringa che specifichi il nome dell'operazione. Per un endpoint remoto, specificare un carattere jolly (*).Creare un endpoint remoto.
Creare il punto finale richiamando il metodo createEndpoint
dell'oggetto EndpointRegistryClient
e passando l'oggetto CreateEndpointInfo
. Questo metodo restituisce un oggetto Endpoint
che rappresenta il nuovo endpoint Remoting.
Attiva l'endpoint.
Abilita l’endpoint richiamando il metodo enable
dell’oggetto EndpointRegistryClient
e passando l’oggetto Endpoint
restituito dal metodo createEndpoint
.
Consulta anche
Guida introduttiva: Aggiunta di un endpoint remoto utilizzando l'API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
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.
Non è possibile aggiungere un endpoint TaskManager utilizzando i servizi Web.
Per aggiungere un endpoint TaskManager a un servizio, eseguire le operazioni seguenti:
EndpointRegistryClient
.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:
Per informazioni sulla posizione di questi file JAR, consulta Inclusione dei file della libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Prima di poter aggiungere programmaticamente un endpoint TaskManager, è necessario creare un oggetto EndpointRegistryClient
.
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.
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:
TaskManagerConnector
.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
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
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.
ServiceClientFactory
contenente le proprietà di connessione.EndpointRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Crea una categoria per l’endpoint.
Creare un oggetto CreateEndpointCategoryInfo
utilizzando il relativo costruttore e passando i seguenti valori:
Creare la categoria richiamando il metodo createEndpointCategory
dell'oggetto EndpointRegistryClient
e passando l'oggetto CreateEndpointCategoryInfo
. Questo metodo restituisce un oggetto EndpointCategory
che rappresenta la nuova categoria.
Impostare gli attributi dell'endpoint TaskManager.
CreateEndpointInfo
utilizzando il relativo costruttore.setConnectorId
dell'oggetto CreateEndpointInfo
e passando il valore della stringa TaskManagerConnector
.setDescription
dell'oggetto CreateEndpointInfo
e passando un valore stringa che descrive l'endpoint.setName
dell'oggetto CreateEndpointInfo
e passando un valore di stringa che specifichi il nome.setServiceId
dell'oggetto CreateEndpointInfo
e passando un valore stringa che specifichi il nome del servizio.setCategoryId
dell'oggetto CreateEndpointInfo
e passando un valore stringa che specifica il valore dell'identificatore della categoria. È possibile richiamare il metodo getId
dell'oggetto EndpointCategory
per ottenere il valore dell'identificatore di questa categoria.setOperationName
dell'oggetto CreateEndpointInfo
e passando un valore di stringa che specifica il nome dell'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.
Creare il punto finale richiamando il metodo createEndpoint
dell'oggetto EndpointRegistryClient
e passando l'oggetto CreateEndpointInfo
. Questo metodo restituisce un oggetto Endpoint
che rappresenta il nuovo endpoint TaskManager.
Attiva l'endpoint.
Abilita l’endpoint richiamando il metodo enable
dell’oggetto EndpointRegistryClient
e passando l’oggetto Endpoint
restituito dal metodo createEndpoint
.
Consulta anche
Guida introduttiva: Aggiunta di un endpoint TaskManager utilizzando l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
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, vedere Aggiunta di endpoint di 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.
Non è possibile modificare un endpoint utilizzando i servizi Web.
Per modificare un endpoint, esegui le seguenti operazioni:
EndpointRegistryClient
.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:
Per informazioni sulla posizione di questi file JAR, consulta Inclusione dei file della libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Per modificare programmaticamente un endpoint, è necessario creare un oggetto EndpointRegistryClient
.
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. (Vedere 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, vedere Aggiunta di endpoint di cartelle controllate.
Per informazioni sui valori di configurazione che appartengono a un endpoint e-mail, consulta Aggiunta di endpoint e-mail.
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. (Vedere Rimozione di endpoint.)
Consulta anche
Modifica di un endpoint utilizzando l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
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.
ServiceClientFactory
contenente le proprietà di connessione.EndpointRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Recupera l’endpoint da modificare.
getEndpoints
dell'oggetto EndpointRegistryClient
e passando un oggetto PagingFilter
che agisce come filtro. Puoi trasmettere un valore (PagingFilter)null
per restituire tutti gli endpoint. Questo metodo restituisce un oggetto java.util.List
in cui ogni elemento è un oggetto Endpoint
. Per informazioni su un oggetto PagingFilter
, consulta Riferimento API di AEM Forms.java.util.List
per determinare se dispone di endpoint. Se esistono endpoint, ogni elemento è un'istanza EndPoint
.getServiceId
dell'oggetto EndPoint
. Questo metodo restituisce un valore stringa che specifica il nome del servizio.getConnectorId
dell'oggetto EndPoint
. Questo metodo restituisce un valore di stringa che specifica il tipo di endpoint. Ad esempio, se l’endpoint è un endpoint di tipo Cartella controllata, questo metodo restituisce WatchedFolder
.Specifica i nuovi valori di configurazione.
Creare un oggetto ModifyEndpointInfo
richiamando il relativo costruttore.
Per ogni valore di configurazione da impostare, richiamare il metodo ModifyEndpointInfo
dell'oggetto setConfigParameterAsText
. Ad esempio, per impostare il valore di configurazione dell’URL, richiama il metodo setConfigParameterAsText
dell’oggetto ModifyEndpointInfo
e passa i seguenti valori:
url
, specificare url
.url
, specifica il percorso della cartella controllata.Richiamare il metodo modifyEndpoint
dell'oggetto EndpointRegistryClient
e passare l'oggetto ModifyEndpointInfo
.
Consulta anche
Guida introduttiva: Modifica di un endpoint utilizzando l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
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 EncryptDocument.
Non è possibile rimuovere un endpoint utilizzando i servizi Web.
Per rimuovere un endpoint da un servizio, esegui le seguenti operazioni:
EndpointRegistryClient
.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:
Per informazioni sulla posizione di questi file JAR, consulta Inclusione dei file della libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Per rimuovere un endpoint a livello di programmazione, è necessario creare un oggetto EndpointRegistryClient
.
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. (Vedere 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 si individua l'endpoint, è possibile 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 abilitato l’endpoint, puoi visualizzarlo nella console di amministrazione.
Consulta anche
Rimozione di un endpoint utilizzando l'API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
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.
ServiceClientFactory
contenente le proprietà di connessione.EndpointRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Recupera l’endpoint da rimuovere.
getEndpoints
dell'oggetto EndpointRegistryClient
e passando un oggetto PagingFilter
che agisce come filtro. Puoi passare (PagingFilter)null
per restituire tutti gli endpoint. Questo metodo restituisce un oggetto java.util.List
in cui ogni elemento è un oggetto Endpoint
.java.util.List
per determinare se dispone di endpoint. Se esistono endpoint, ogni elemento è un'istanza EndPoint
.getServiceId
dell'oggetto EndPoint
. Questo metodo restituisce un valore stringa che specifica il nome del servizio.getConnectorId
dell'oggetto EndPoint
. 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.
Rimuovere l'endpoint richiamando il metodo remove
dell'oggetto EndpointRegistryClient
e passando l'oggetto EndPoint
che rappresenta l'endpoint da rimuovere.
Consulta anche
Guida introduttiva: Rimozione di un endpoint utilizzando l'API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
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. (Vedere Aggiunta di endpoint di cartelle controllate.)
Non è possibile recuperare informazioni sugli endpoint utilizzando i servizi Web.
Questo argomento utilizza l’ API ConnectorRegistryClient
per recuperare informazioni sui connettori endpoint. (Consulta Riferimento API di AEM Forms.)
Per recuperare le informazioni sul connettore endpoint, esegui le seguenti operazioni:
ConnectorRegistryClient
.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:
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, consulta 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 oggetto ConnectorRegistryClient
.
Specifica il tipo di connettore
Specifica il tipo di connettore da cui recuperare le informazioni. Esistono i seguenti tipi di connettori:
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
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
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.
ServiceClientFactory
contenente le proprietà di connessione.ConnectorRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Specifica il tipo di connettore.
Specificare il tipo di connettore richiamando il metodo getEndpointDefinition
dell'oggetto ConnectorRegistryClient
e passando un valore di stringa che specifica il tipo di connettore. Ad esempio, per specificare il tipo di connettore Cartella controllata, passare il valore stringa WatchedFolder
. Questo metodo restituisce un oggetto Endpoint
che corrisponde al tipo di connettore.
Recupera i valori di configurazione.
getConfigParameters
dell'oggetto Endpoint
. Questo metodo restituisce una matrice di oggetti ConfigParameter
.ConfigParameter
. Ad esempio, è possibile determinare se il valore di configurazione è obbligatorio o facoltativo richiamando il metodo isRequired
dell'oggetto ConfigParameter
. Se il valore di configurazione è obbligatorio, questo metodo restituisce true
.Consulta anche
Guida introduttiva: Recupero delle informazioni sul connettore endpoint tramite API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione