Informazioni su Endpoint Registry Service
Il servizio del Registro di sistema degli endpoint consente di gestire gli endpoint a livello di programmazione. Ad esempio, potete aggiungere i seguenti tipi di endpoint a un servizio:
EJB
SOAP
Cartella esaminata
(Obsoleto per AEM moduli) Remoting
Task Manager
SOAP, EJB e (obsoleto per i moduli AEM su JEE) Gli endpoint di promemoria vengono creati automaticamente per ciascun servizio attivato. Gli endpoint SOAP ed EJB consentono SOAP ed EJB per tutte le operazioni di servizio.
Un endpoint remoto consente ai client Flex di richiamare le operazioni sul servizio AEM Forms a cui viene aggiunto l'endpoint. Viene creata una destinazione Flex con lo stesso nome dell'endpoint e i client Flex possono creare oggetti remoti che puntano a questa destinazione per richiamare le operazioni sul servizio appropriato.
Gli endpoint E-mail, Task Manager e Cartella esaminata mostrano solo un'operazione specifica del servizio. L'aggiunta di questi endpoint richiede un secondo passaggio di configurazione per selezionare un metodo da richiamare, impostare i parametri di configurazione e specificare le mappature dei parametri di input e output.
È possibile organizzare gli endpoint di TaskManager in gruppi denominati categorie. Queste categorie vengono quindi esposte a Workspace tramite TaskManager, con gli utenti finali che visualizzano gli endpoint di TaskManager man mano che vengono classificati. In Workspace, gli utenti finali visualizzano queste categorie nel riquadro di navigazione. Gli endpoint all'interno di ciascuna categoria vengono visualizzati come schede di processo nella pagina Processi iniziali di Workspace.
È possibile eseguire le seguenti attività utilizzando il servizio del Registro di sistema di Endpoint:
Aggiungete gli endpoint EJB. (Vedere Aggiunta di endpoint EJB.)
Aggiungere endpoint SOAP. (Vedere Aggiunta di endpoint SOAP.)
Aggiungi endpoint cartella esaminata (vedere Aggiunta di endpoint cartella esaminata).
Aggiungi endpoint e-mail. (Vedere Aggiunta di endpoint e-mail.)
Aggiungi endpoint di tipo promemoria. (Vedere Aggiunta di endpoint remoti.)
Aggiungere endpoint TaskManager (vedere Aggiunta di endpoint TaskManager).
Modificare gli endpoint (vedere Modifica di endpoint).
Rimuovere gli endpoint (vedere Rimozione di endpoint).
Recuperare le informazioni sul connettore endpoint (vedere Recupero delle informazioni sul connettore endpoint.)
Puoi aggiungere a livello di programmazione un endpoint EJB a un servizio utilizzando l'API Java di AEM Forms . Aggiungendo un endpoint EJB a un servizio, si sta abilitando un'applicazione client per richiamare il servizio utilizzando la modalità EJB. In altre parole, quando si impostano le proprietà di connessione necessarie per richiamare AEM Forms, è possibile selezionare la modalità EJB. (Vedere Impostazione delle proprietà di connessione.)
Non è possibile aggiungere un endpoint EJB utilizzando i servizi Web.
In genere, un endpoint EJB viene aggiunto a un servizio per impostazione predefinita. Tuttavia, un endpoint EJB può essere aggiunto a un processo distribuito a livello di programmazione o quando un endpoint EJB è stato rimosso e deve essere aggiunto di nuovo.
Per aggiungere un endpoint EJB a un servizio, eseguire le operazioni seguenti:
EndpointRegistry Client
.Includi file di progetto
Includete i file necessari nel progetto di sviluppo. I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
Per informazioni sulla posizione di questi file JAR, vedere Inclusione file libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Prima di poter aggiungere un endpoint EJB a livello di programmazione, è necessario creare un oggetto EndpointRegistryClient
.
Impostazione degli attributi dell’endpoint EJB
Per creare un endpoint EJB per un servizio, specificate i seguenti valori:
EJB
.*
). Tuttavia, se si desidera specificare un'operazione specifica invece di richiamare tutte le operazioni del servizio, specificare il nome dell'operazione anziché utilizzare il carattere jolly ( *
).Creare un endpoint EJB
Dopo aver impostato gli attributi dell'endpoint EJB, potete creare un endpoint EJB per un servizio.
Abilitare l'endpoint
Dopo aver creato un nuovo endpoint, è necessario abilitarlo. Dopo aver abilitato l'endpoint, può essere utilizzato per richiamare il servizio. Dopo aver attivato l’endpoint, potete visualizzarlo nella console di amministrazione.
Consulta anche
Aggiunta di un endpoint EJB tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Aggiungete un endpoint EJB utilizzando l'API Java:
Includere i file di progetto.
Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java. (
Creare un oggetto Client EndpointRegistry.
ServiceClientFactory
che contiene le proprietà di connessione.EndpointRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Impostate 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 di stringa che descrive l'endpoint.CreateEndpointInfo
dell'oggetto setName
e passando un valore di stringa che specifica il nome.CreateEndpointInfo
dell'oggetto <a1/> e passando un valore di stringa che specifica il nome del servizio.setServiceId
setOperationName
dell'oggetto CreateEndpointInfo
e passare un valore di stringa che specifica il nome dell'operazione. Per gli endpoint SOAP ed EJB, specificate un carattere jolly ( *
) che implica tutte le operazioni.Create un endpoint EJB.
Creare l'endpoint richiamando il metodo EndpointRegistryClient
dell'oggetto createEndpoint
e passando l'oggetto CreateEndpointInfo
. Questo metodo restituisce un oggetto Endpoint
che rappresenta il nuovo endpoint EJB.
Abilitate l’endpoint.
Abilitare l'endpoint richiamando il metodo di abilitazione dell'oggetto EndpointRegistryClient
e passando l'oggetto Endpoint
restituito dal metodo createEndpoint
.
Consulta anche
Avvio rapido: Aggiunta di un endpoint EJB tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
È possibile aggiungere a livello di programmazione 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
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
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 su file AEM Forms JAR, vedere Inclusione file libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Per aggiungere a livello di programmazione un endpoint SOAP a un servizio, è necessario creare un oggetto EndpointRegistryClient
.
Imposta attributi endpoint SOAP
Per aggiungere un endpoint SOAP a un servizio, specificate i seguenti valori:
SOAP
.*
). Tuttavia, se si desidera specificare un'operazione specifica invece di richiamare tutte le operazioni del servizio, specificare il nome dell'operazione anziché utilizzare il carattere jolly ( *
).Creare un endpoint SOAP
Dopo aver impostato gli attributi dell'endpoint SOAP, potete creare un endpoint SOAP.
Abilitare l'endpoint
Dopo aver creato un nuovo endpoint, è necessario abilitarlo. Quando l'endpoint è abilitato, può essere utilizzato per richiamare il servizio. Dopo aver attivato l’endpoint, potete visualizzarlo nella console di amministrazione.
Consulta anche
Aggiunta di un endpoint SOAP tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Aggiungete un endpoint SOAP a un servizio utilizzando l'API Java:
Includere i file di progetto.
Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto Client EndpointRegistry.
ServiceClientFactory
che contiene le proprietà di connessione.EndpointRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Impostate 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 di stringa che descrive l'endpoint.CreateEndpointInfo
dell'oggetto setName
e passando un valore di stringa che specifica il nome.CreateEndpointInfo
dell'oggetto <a1/> e passando un valore di stringa che specifica il nome del servizio.setServiceId
setOperationName
dell'oggetto CreateEndpointInfo
e passando un valore di stringa che specifica il nome dell'operazione. Per gli endpoint SOAP ed EJB, specificate un carattere jolly ( *
) che implica tutte le operazioni.Creare un endpoint SOAP.
Creare l'endpoint richiamando il metodo EndpointRegistryClient
dell'oggetto createEndpoint
e passando l'oggetto CreateEndpointInfo
. Questo metodo restituisce un oggetto Endpoint
che rappresenta il nuovo endpoint SOAP.
Abilitate l’endpoint.
Abilitare l'endpoint richiamando il metodo di abilitazione dell'oggetto EndpointRegistryClient
e passando l'oggetto Endpoint
restituito dal metodo createEndpoint
.
Consulta anche
Avvio rapido: Aggiunta di un endpoint SOAP tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
È possibile aggiungere a livello di programmazione un endpoint di cartelle esaminate a un servizio utilizzando l'API Java di AEM Forms . Aggiungendo un endpoint cartella esaminata, gli utenti possono inserire un file (ad esempio un file PDF) in una cartella. Quando il file viene inserito nella cartella, viene richiamato il servizio configurato e manipolato il file. Dopo che il servizio ha eseguito l'operazione specificata, salva il file modificato in una cartella di output specificata. Una cartella esaminata è configurata per essere analizzata a un intervallo di frequenza fissa o con una pianificazione cron, ad esempio ogni lunedì, mercoledì e venerdì a mezzogiorno.
Per aggiungere in modo programmatico un endpoint di cartelle esaminate a un servizio, prendere in considerazione il seguente processo di breve durata denominato EncryptDocument. (Vedere Informazioni processi AEM Forms.)
Questo processo accetta un documento PDF non protetto come valore di input, quindi passa 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 con password) è SecuredDoc
e il tipo di dati è com.adobe.idp.Document
.
Non è possibile aggiungere un endpoint cartella esaminata utilizzando i servizi Web.
Per aggiungere a un servizio un endpoint della cartella esaminata, eseguire le operazioni seguenti:
EndpointRegistryClient
.Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
Per informazioni sulla posizione di questi file JAR, vedere Inclusione file libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Per aggiungere a livello di programmazione un endpoint cartella esaminata, è necessario creare un oggetto EndpointRegistryClient
.
Imposta attributi endpoint cartella esaminata
Per creare un endpoint della cartella esaminata per un servizio, specificate i seguenti valori:
WatchedFolder
.EncryptDocument
.invoke
.Specificare i valori di configurazione
È necessario specificare i valori di configurazione per un endpoint di una cartella esaminata quando si aggiunge a livello di programmazione un endpoint di una cartella esaminata a un servizio. Questi valori di configurazione vengono specificati da un amministratore se un endpoint della cartella esaminata viene aggiunto utilizzando la console di amministrazione.
L'elenco seguente specifica i valori di configurazione impostati durante l'aggiunta a livello di programmazione di un endpoint di una cartella esaminata a un servizio:
data*
, tutti i file e le cartelle che corrispondono a data*
non vengono prelevati. Sono inclusi file e cartelle denominati data1
, data2
e così via. Inoltre, il pattern può essere completato con pattern di caratteri jolly per specificare i pattern di file. La cartella esaminata modifica l'espressione regolare per supportare i pattern con caratteri jolly quali *.*
e *.pdf
. Questi pattern carattere jolly non sono supportati dalle espressioni regolari.*
, vengono prelevati tutti i file e le cartelle che corrispondono 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 esaminata modifica l'espressione regolare per supportare i pattern con caratteri jolly quali *.*
e *.pdf
. Questi pattern carattere jolly non sono supportati dalle espressioni regolari. Questo valore è obbligatorio.result/%Y/%M/%D/
. Si tratta della cartella dei risultati all’interno della cartella esaminata.preserve/%Y/%M/%D/
.failure/%Y/%M/%D/
.Definire i valori dei parametri di input
Quando si crea un endpoint della cartella esaminata, è necessario definire i valori dei parametri di input. È quindi necessario descrivere i valori di input passati all'operazione richiamata dalla cartella esaminata. Ad esempio, prendete in considerazione il processo introdotto in questo argomento. Il valore immesso è InDoc
e il tipo di dati è com.adobe.idp.Document
. Quando create un endpoint della cartella esaminata per questo processo (dopo che un processo è stato attivato, diventa un servizio), dovete definire il valore del parametro di input.
Per definire i valori dei parametri di input richiesti per l’endpoint di una cartella esaminata, specificate i seguenti valori:
Nome del parametro di input: Nome del parametro di input. Il nome di un valore di input è specificato in Workbench per un processo. Se il valore di input appartiene a un'operazione di servizio (un servizio che non è un processo creato in Workbench), il nome di input è specificato nel file component.xml. Ad esempio, il nome del parametro di input per il processo introdotto in questa sezione è InDoc
.
Tipo mapping: Utilizzato per configurare i valori di input necessari per richiamare l'operazione del servizio. Esistono due tipi di mapping:
Literal
: L’endpoint Cartella osservata utilizza il valore immesso nel campo così come viene visualizzato. Sono supportati tutti i tipi Java di base. Ad esempio, se un'API utilizza input quali String, long, int e Boolean, la stringa viene convertita nel tipo corretto e il servizio viene richiamato.Variable
: Il valore immesso è un pattern di file utilizzato dalla cartella esaminata per selezionare l'input. Ad esempio, se si seleziona Variabile per il tipo di mappatura e il documento di input deve essere un file PDF, è possibile specificare *.pdf
come valore di mappatura.Valore mappatura: Specifica il valore del tipo di mappatura. Ad esempio, se si seleziona un tipo di mappatura Variable
, è possibile specificare *.pdf
come pattern di file.
Tipo di dati: Specifica il tipo di dati dei valori di input. Ad esempio, il tipo di dati del valore immesso del processo introdotto in questa sezione è com.adobe.idp.Document
.
Definire un valore di parametro di output
Quando create un endpoint cartella esaminata, dovete definire un valore di parametro di output. È quindi necessario descrivere il valore di output restituito dal servizio richiamato dall'endpoint Cartella osservata. Ad esempio, prendete in considerazione il processo introdotto in questo argomento. Ha un valore di output denominato SecuredDoc
e il relativo tipo di dati è com.adobe.idp.Document
. Quando create un endpoint della cartella esaminata per questo processo (dopo che un processo è attivato, diventa un servizio), dovete definire il valore del parametro di output.
Per definire un valore del parametro di output richiesto per un endpoint di una cartella esaminata, specificate i seguenti valori:
Nome del parametro di output: Nome del parametro di output. Il nome di un valore di output del processo è specificato in Workbench. Se il valore di output appartiene a un'operazione di servizio (un servizio che non è un processo creato in Workbench), il nome di output è specificato nel file component.xml. Ad esempio, il nome del parametro di output per il processo introdotto in questa sezione è SecuredDoc
.
Tipo mapping: Utilizzato per configurare l'output del servizio e l'operazione. Sono disponibili le seguenti opzioni:
%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 dal processo introdotto in questa sezione è com.adobe.idp.Document
.
Creare un endpoint cartella esaminata
Dopo aver impostato gli attributi dell’endpoint, i valori di configurazione e i valori dei parametri di input e output, dovete creare l’endpoint della cartella esaminata.
Abilitare l'endpoint
Dopo aver creato un endpoint cartella esaminata, è necessario attivarlo. Quando l'endpoint è abilitato, può essere utilizzato per richiamare il servizio. Dopo aver attivato l’endpoint, potete visualizzarlo nella console di amministrazione.
Consulta anche
Aggiunta di un endpoint cartella esaminata tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Aggiungete un endpoint della cartella esaminata utilizzando l'API Java di AEM Forms :
Includere i file di progetto.
Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto Client EndpointRegistry.
ServiceClientFactory
che contiene le proprietà di connessione.EndpointRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Impostate gli attributi endpoint cartella esaminata.
CreateEndpointInfo
utilizzando il relativo costruttore.setConnectorId
dell'oggetto CreateEndpointInfo
e passando il valore della stringa WatchedFolder
.setDescription
dell'oggetto CreateEndpointInfo
e passando un valore di stringa che descrive l'endpoint.CreateEndpointInfo
dell'oggetto setName
e passando un valore di stringa che specifica il nome.CreateEndpointInfo
dell'oggetto <a1/> e passando un valore di stringa che specifica il nome del servizio.setServiceId
setOperationName
dell'oggetto CreateEndpointInfo
e passando un valore di stringa che specifica il nome dell'operazione. In genere, durante la creazione di un endpoint di tipo Cartella esaminata per un servizio originato da un processo creato in Workbench, viene richiamato il nome dell'operazione.Specificate i valori di configurazione.
Per ogni valore di configurazione da impostare per l'endpoint della cartella esaminata, è 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 passare i seguenti valori stringa:
url
, specificare url
.url
, specificare il percorso della cartella esaminata.Per visualizzare tutti i valori di configurazione impostati per il servizio EncryptDocument, vedere l'esempio di codice Java disponibile in QuickStart: Aggiunta di un endpoint cartella esaminata tramite l'API Java.
Definire 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 ha un solo parametro di input, è necessario richiamare questo metodo una volta.
Definire un valore di 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 cartella esaminata.
Creare l'endpoint richiamando il metodo EndpointRegistryClient
dell'oggetto createEndpoint
e passando l'oggetto CreateEndpointInfo
. Questo metodo restituisce un oggetto Endpoint
che rappresenta l'endpoint cartella esaminata.
Abilitate l’endpoint.
Abilitare l'endpoint richiamando il metodo EndpointRegistryClient
dell'oggetto enable
e passando l'oggetto Endpoint
restituito dal metodo createEndpoint
.
Consulta anche
Avvio rapido: Aggiunta di un endpoint cartella esaminata tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido di avvio rapido: L'aggiunta di un endpoint di cartelle esaminate tramite l'API Java utilizza un file costante che deve far parte del progetto Java per compilare il rapido avvio. Questo file costante rappresenta i valori di configurazione che devono essere impostati quando si aggiunge un endpoint cartella esaminata. Il seguente codice Java rappresenta il file costante.
/**
* This class contains constants that can be used when setting Watched Folder
* configuration values
*/
public final class WatchedFolderEndpointConfigConstants {
public static final String PROPERTY_FILEPROVIDER_URL = "url";
public static final String PROPERTY_PROPERTY_ASYNCHRONOUS = "asynchronous";
public static final String PROPERTY_CRON_EXPRESSION = "cronExpression";
public static final String PROPERTY_PURGE_DURATION = "purgeDuration";
public static final String PROPERTY_REPEAT_INTERVAL = "repeatInterval";
public static final String PROPERTY_REPEAT_COUNT = "repeatCount";
public static final String PROPERTY_THROTTLE = "throttleOn";
public static final String PROPERTY_USERNAMER = "userName";
public static final String PROPERTY_DOMAINNAME = "domainName";
public static final String PROPERTY_FILEPROVIDER_BATCH_SIZE = "batchSize";
public static final String PROPERTY_FILEPROVIDER_WAIT_TIME = "waitTime";
public static final String PROPERTY_EXCLUDE_FILE_PATTERN = "excludeFilePattern";
public static final String PROPERTY_INCLUDE_FILE_PATTERN = "excludeFilePattern";
public static final String PROPERTY_FILEPROVIDER_RESULT_FOLDER_NAME = "resultFolderName";
public static final String PROPERTY_FILEPROVIDER_PRESERVE_FOLDER_NAME = "preserveFolderName";
public static final String PROPERTY_FILEPROVIDER_FAILURE_FOLDER_NAME = "failureFolderName";
public static final String PROPERTY_FILEPROVIDER_PRESERVE_ON_FAILURE = "preserveOnFailure";
public static final String PROPERTY_FILEPROVIDER_OVERWRITE_DUPLICATE_FILENAME = "overwriteDuplicateFilename";
}
Puoi aggiungere un endpoint e-mail a un servizio a livello di programmazione utilizzando l'API Java di AEM Forms . Aggiungendo un endpoint e-mail, gli utenti possono inviare un messaggio e-mail contenente uno o più file allegati a un account e-mail specificato. Quindi, viene richiamata l’operazione di configurazione del servizio e vengono modificati i file. Dopo che il servizio ha eseguito l'operazione specificata, invia un messaggio e-mail al mittente con i file modificati come allegati di file.
Ai fini dell'aggiunta programmatica di un endpoint e-mail a un servizio, tenere in considerazione il seguente processo di breve durata denominato MyApplication\EncryptDocument. Per informazioni sui processi di breve durata, vedere Informazioni processi AEM Forms.
Questo processo accetta un documento PDF non protetto come valore di input, quindi passa il documento PDF non protetto all'operazione EncryptPDFUsingPassword
del servizio di cifratura. In questo modo il documento PDF viene crittografato con una password e il documento PDF crittografato con password viene restituito come valore di output. Il nome del valore di input (il documento PDF non protetto) è InDoc
e il tipo di dati è com.adobe.idp.Document
. Il nome del valore di output (il documento PDF con password) è SecuredDoc
e il tipo di dati è com.adobe.idp.Document
.
Non potete aggiungere un endpoint e-mail utilizzando i servizi Web.
Per aggiungere un endpoint e-mail a un servizio, eseguite le seguenti operazioni:
EndpointRegistryClient
.Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
Per informazioni sulla posizione di questi file JAR, vedere Inclusione file libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Prima di poter aggiungere un endpoint e-mail a livello di programmazione, è necessario creare un oggetto EndpointRegistryClient
.
Impostare gli attributi dell’endpoint e-mail
Per creare un endpoint e-mail per un servizio, specificate 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 un endpoint e-mail viene aggiunto utilizzando la console di amministrazione.
L'account e-mail monitorato è un account speciale utilizzato solo per l'endpoint e-mail. Questo account non è un account e-mail di un utente normale. Un account e-mail di un utente normale non deve essere configurato come account utilizzato dal provider e-mail, perché il provider e-mail elimina i messaggi e-mail dalla inbox al termine dei messaggi.
I seguenti valori di configurazione vengono impostati quando si aggiunge a livello di programmazione un endpoint e-mail a un servizio:
SuperAdmin
.DefaultDom
.adobe.com
, vengono elaborati solo i messaggi e-mail provenienti da adobe.com, mentre quelli provenienti da altri domini vengono ignorati.*
.sender
, i risultati dell'e-mail vengono inviati al mittente. Sono supportati fino a 100 destinatari. Specificate altri destinatari con indirizzi e-mail, separati da una virgola. Per disattivare questa opzione, lasciate vuoto questo valore. In alcuni casi, potrebbe essere utile attivare un processo e non si desidera inviare una notifica via e-mail del risultato. Il valore predefinito è sender
.sender
, i risultati dell'e-mail vengono inviati al mittente. Sono supportati fino a 100 destinatari. Specificate altri destinatari con indirizzi e-mail, separati da una virgola. Per disattivare questa opzione, lasciate vuoto questo valore. Il valore predefinito è sender
.IMAP
o POP3
. Il server di posta elettronica dell'host della inbox deve supportare questi protocolli.UTF-8
.Definire i valori dei parametri di input
Quando create un endpoint e-mail, dovete definire i valori dei parametri di input. In altre parole, devi descrivere i valori di input passati all'operazione richiamata dall'endpoint e-mail. Ad esempio, prendete in considerazione il processo introdotto in questo argomento. Il valore immesso è InDoc
e il tipo di dati è com.adobe.idp.Document
. Quando create un endpoint e-mail per questo processo (dopo che un processo viene attivato, diventa un servizio), dovete definire il valore del parametro di input.
Per definire i valori dei parametri di input richiesti per un endpoint e-mail, specificate i seguenti valori:
Nome del parametro di input: Nome del parametro di input. Il nome di un valore di input è specificato in Workbench per un processo. Se il valore di input appartiene a un'operazione di servizio (un servizio Forms che non è un processo creato in Workbench), il nome di input è specificato nel file component.xml. Ad esempio, il nome del parametro di input per il processo introdotto in questa sezione è InDoc
.
Tipo mapping: Utilizzato per configurare i valori di input necessari per richiamare l'operazione del servizio. Due tipi di mapping sono i seguenti:
Literal
: L'endpoint e-mail utilizza il valore immesso nel campo così come viene visualizzato. Sono supportati tutti i tipi Java di base. Ad esempio, se un'API utilizza input quali String, long, int e Boolean, la stringa viene convertita nel tipo corretto e il servizio viene richiamato.Variable
: Il valore immesso è un pattern di file utilizzato dall'endpoint e-mail per selezionare l'input. Ad esempio, se si seleziona Variabile per il tipo di mappatura e il documento di input deve essere un file PDF, è possibile specificare *.pdf
come valore di mappatura.Valore mappatura: Specifica il valore del tipo di mappatura. Ad esempio, se si seleziona un tipo di mappatura della variabile, è possibile specificare *.pdf
come pattern di file.
Tipo di dati: Specifica il tipo di dati dei valori di input. Ad esempio, il tipo di dati del valore di input del processo introdotto in questa sezione è com.adobe.idp.Document.
Definire un valore di parametro di output
Quando create un endpoint e-mail, dovete definire un valore di parametro di output. Ovvero, devi descrivere il valore di output restituito dal servizio richiamato dall'endpoint e-mail. Ad esempio, prendete in considerazione il processo introdotto in questo argomento. Ha un valore di output denominato SecuredDoc
e il relativo tipo di dati è com.adobe.idp.Document
. Quando create un endpoint e-mail per questo processo (dopo che un processo viene attivato, diventa un servizio), dovete definire il valore del parametro di output.
Per definire un valore del parametro di output richiesto per un endpoint e-mail, specificate i seguenti valori:
Nome del parametro di output: Nome del parametro di output. Il nome di un valore di output del processo è specificato in Workbench. Se il valore di output appartiene a un'operazione di servizio (un servizio che non è un processo creato in Workbench), il nome di output è specificato nel file component.xml. Ad esempio, il nome del parametro di output per il processo introdotto in questa sezione è SecuredDoc
.
Tipo mapping: Utilizzato per configurare l'output del servizio e l'operazione. Sono disponibili le seguenti opzioni:
%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 dal processo introdotto in questa sezione è com.adobe.idp.Document
.
Creare l’endpoint e-mail
Dopo aver impostato gli attributi dell’endpoint e i valori di configurazione e aver definito i valori dei parametri di input e output, dovete creare l’endpoint e-mail.
Abilitare l'endpoint
Dopo aver creato un endpoint e-mail, è necessario attivarlo. Quando l'endpoint è abilitato, può essere utilizzato per richiamare il servizio. Dopo aver attivato l’endpoint, potete visualizzarlo nella console di amministrazione.
Consulta anche
Aggiunta di un endpoint e-mail tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Aggiungete un endpoint e-mail utilizzando l'API Java:
Includere i file di progetto.
Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto Client EndpointRegistry.
ServiceClientFactory
che contiene le proprietà di connessione.EndpointRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Impostate 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 di stringa che descrive l'endpoint.CreateEndpointInfo
dell'oggetto setName
e passando un valore di stringa che specifica il nome.CreateEndpointInfo
dell'oggetto <a1/> e passando un valore di stringa che specifica il nome del servizio.setServiceId
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 originato da un processo creato in Workbench, viene richiamato il nome dell'operazione.Specificate 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 passare i seguenti valori:
smtpHost
, specificare smtpHost
.smtpHost
, specificare un valore di stringa che specifica il nome del server SMTP.Per visualizzare tutti i valori di configurazione impostati per il servizio EncryptDocument introdotto in questa sezione, vedere l'esempio di codice Java disponibile in QuickStart: Aggiunta di un endpoint e-mail mediante l'API Java.
Definire 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 ha un solo parametro di input, è necessario richiamare questo metodo una volta.
Definire un valore di 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
.Create l’endpoint e-mail.
Creare l'endpoint richiamando il metodo EndpointRegistryClient
dell'oggetto createEndpoint
e passando l'oggetto CreateEndpointInfo
. Questo metodo restituisce un oggetto Endpoint
che rappresenta l'endpoint e-mail.
Abilitate l’endpoint.
Abilitare l'endpoint richiamando il metodo EndpointRegistryClient
dell'oggetto enable
e passando l'oggetto Endpoint
restituito dal metodo createEndpoint
.
Consulta anche
Avvio rapido: Aggiunta di un endpoint cartella esaminata tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido di avvio rapido: L'aggiunta di un endpoint e-mail tramite l'API Java utilizza un file costante che deve far parte del progetto Java per compilare il rapido avvio. Questo file costante rappresenta i valori di configurazione che devono essere impostati quando si aggiunge un endpoint e-mail. Il seguente codice Java rappresenta il file costante.
/**
* This class contains constants that can be used when setting email endpoint
* configuration values
*/
public class EmailEndpointConfigConstants {
public static final String PROPERTY_EMAILPROVIDER_CRON_EXPRESSION = "cronExpression";
public static final String PROPERTY_EMAILPROVIDER_REPREAT_COUNT = "repeatCount";
public static final String PROPERTY_EMAILPROVIDER_REPREAT_INTERVAL = "repeatInterval";
public static final String PROPERTY_EMAILPROVIDER_START_DELAY = "startDelay";
public static final String PROPERTY_EMAILPROVIDER_BATCH_SIZE = "batchSize";
public static final String PROPERTY_EMAILPROVIDER_USERNAME = "userName";
public static final String PROPERTY_EMAILPROVIDER_DOMAINNAME = "domainName";
public static final String PROPERTY_EMAILPROVIDER_DOMAINPATTERN = "domainPattern";
public static final String PROPERTY_EMAILPROVIDER_FILEPATTERN = "filePattern";
public static final String PROPERTY_EMAILPROVIDER_RECIPIENT_SUCCESSFUL_JOB = "recipientSuccessfulJob";
public static final String PROPERTY_EMAILPROVIDER_RECIPIENT_FAILED_JOB = "recipientFailedJob";
public static final String PROPERTY_EMAILPROVIDER_INBOX_HOST = "inboxHost";
public static final String PROPERTY_EMAILPROVIDER_INBOX_PORT = "inboxPort";
public static final String PROPERTY_EMAILPROVIDER_PROTOCOL = "inboxProtocol";
public static final String PROPERTY_EMAILPROVIDER_INBOX_TIMEOUT = "inboxTimeOut";
public static final String PROPERTY_EMAILPROVIDER_INBOX_USER = "inboxUser";
public static final String PROPERTY_EMAILPROVIDER_INBOX_PASSWORD = "inboxPassword";
public static final String PROPERTY_EMAILPROVIDER_INBOX_SSL = "inboxSSLEnabled";
public static final String PROPERTY_EMAILPROVIDER_SMTP_HOST = "smtpHost";
public static final String PROPERTY_EMAILPROVIDER_SMTP_PORT = "smtpPort";
public static final String PROPERTY_EMAILPROVIDER_SMTP_USER = "smtpUser";
public static final String PROPERTY_EMAILPROVIDER_SMTP_PASSWORD = "smtpPassword";
public static final String PROPERTY_EMAILPROVIDER_CHARSET = "charSet";
public static final String PROPERTY_EMAILPROVIDER_SMTP_SSL = "smtpSSLEnabled";
public static final String PROPERTY_EMAILPROVIDER_FAILED_FOLDER = "failedJobFolder";
public static final String PROPERTY_EMAILPROVIDER_ASYNCHRONOUS = "asynchronous";
}
API di LiveCycle Remoting obsolete per i moduli AEM su JEE.
Puoi aggiungere un endpoint remoto a un servizio a livello di programmazione utilizzando l'API Java di AEM Forms . Aggiungendo un endpoint remoto, si sta abilitando un'applicazione Flex per richiamare il servizio utilizzando la rimozione. (Vedere Chiamata AEM Forms tramite (obsoleto per AEM moduli) AEM Forms Remoting.)
Ai fini dell'aggiunta programmatica di un endpoint Remoting a un servizio, prendere in considerazione il seguente processo di breve durata denominato EncryptDocument.
Questo processo accetta un documento PDF non protetto come valore di input, quindi passa 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 con password) è SecuredDoc
e il tipo di dati è com.adobe.idp.Document
.
Per dimostrare come aggiungere un endpoint remoto a un servizio, in questa sezione viene aggiunto un endpoint remoto a un servizio denominato EncryptDocument.
Non è possibile aggiungere un endpoint remoto utilizzando i servizi Web.
Per rimuovere un endpoint da un servizio, eseguire le operazioni seguenti:
EndpointRegistryClient
.Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
Per informazioni sulla posizione di questi file JAR, vedere Inclusione file libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Per aggiungere un endpoint remoto a livello di programmazione, è necessario creare un oggetto EndpointRegistryClient
.
Impostazione degli attributi endpoint remoto
Per creare un endpoint remoto per un servizio, specificate i seguenti valori:
Remoting
.EncryptDocument
.Creare un endpoint remoto
Dopo aver impostato gli attributi dell'endpoint remoto, potete creare un endpoint remoto per un servizio.
Abilitare l'endpoint
Dopo aver creato un nuovo endpoint, è necessario abilitarlo. Quando un endpoint remoto è abilitato, consente a un client Flex di richiamare il servizio.
Consulta anche
Aggiunta di un endpoint remoto tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Aggiungete un endpoint remoto utilizzando l'API Java:
Includere i file di progetto.
Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto Client EndpointRegistry.
ServiceClientFactory
che contiene le proprietà di connessione.EndpointRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Impostate 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 di stringa che descrive l'endpoint.CreateEndpointInfo
dell'oggetto setName
e passando un valore di stringa che specifica il nome.CreateEndpointInfo
dell'oggetto <a1/> e passando un valore di stringa che specifica il nome del servizio.setServiceId
CreateEndpointInfo
dell'oggetto setOperationName
e passare un valore di stringa che specifica il nome dell'operazione. Per un endpoint remoto, specificate un carattere jolly (*).Creare un endpoint remoto.
Creare l'endpoint richiamando il metodo EndpointRegistryClient
dell'oggetto createEndpoint
e passando l'oggetto CreateEndpointInfo
. Questo metodo restituisce un oggetto Endpoint
che rappresenta il nuovo endpoint remoto.
Abilitate l’endpoint.
Abilitare l'endpoint richiamando il metodo EndpointRegistryClient
dell'oggetto enable
e passando l'oggetto Endpoint
restituito dal metodo createEndpoint
.
Consulta anche
Avvio rapido: Aggiunta di un endpoint remoto tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
È possibile aggiungere a livello di programmazione un endpoint TaskManager a un servizio utilizzando l'API Java AEM Forms . Aggiungendo un endpoint di TaskManager a un servizio, l'utente di Workspace può richiamare il servizio. In altre parole, un utente che lavora in Workspace può richiamare un processo con un endpoint TaskManager corrispondente.
Non è possibile aggiungere un endpoint TaskManager utilizzando i servizi Web.
Per aggiungere un endpoint TaskManager a un servizio, eseguire le operazioni seguenti:
EndpointRegistryClient
.Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
Per informazioni sulla posizione di questi file JAR, vedere Inclusione file libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Prima di poter aggiungere un endpoint TaskManager a livello di programmazione, è necessario creare un oggetto EndpointRegistryClient
.
Creare una categoria per l'endpoint
Le categorie vengono utilizzate per organizzare i servizi all'interno di Workspace. In altre parole, un utente di Workspace può richiamare un servizio che dispone di un endpoint TaskManager selezionando una categoria all'interno di Workspace. Quando si crea un endpoint TaskManager, è possibile fare riferimento a una categoria esistente o creare una nuova categoria a livello di programmazione.
Questa sezione crea una nuova categoria come parte dell'aggiunta di un endpoint TaskManager a un servizio.
Imposta attributi endpoint TaskManager
Per creare un endpoint TaskManager per un servizio, specificare i valori seguenti:
TaskManagerConnector
.invoke
.Creare un endpoint TaskManager
Dopo aver impostato gli attributi endpoint TaskManager, è possibile creare un endpoint TaskManager per un servizio.
Abilitare l'endpoint
Dopo aver creato un nuovo endpoint, è necessario abilitarlo. Quando l’endpoint è abilitato, può essere utilizzato per richiamare il servizio dall’interno di Workspace. Dopo aver attivato l’endpoint, potete visualizzarlo nella console di amministrazione.
Consulta anche
Aggiunta di un endpoint TaskManager tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Aggiungete un endpoint TaskManager utilizzando l'API Java:
Includere i file di progetto.
Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto Client EndpointRegistry.
ServiceClientFactory
che contiene le proprietà di connessione.EndpointRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Create una categoria per l'endpoint.
Creare un oggetto CreateEndpointCategoryInfo
utilizzando il relativo costruttore e passando i seguenti valori:
Creare la categoria richiamando il metodo EndpointRegistryClient
dell'oggetto createEndpointCategory
e passando l'oggetto CreateEndpointCategoryInfo
. Questo metodo restituisce un oggetto EndpointCategory
che rappresenta la nuova categoria.
Impostate gli attributi 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 di stringa che descrive l'endpoint.CreateEndpointInfo
dell'oggetto setName
e passando un valore di stringa che specifica il nome.CreateEndpointInfo
dell'oggetto <a1/> e passando un valore di stringa che specifica il nome del servizio.setServiceId
CreateEndpointInfo
dell'oggetto <a1/> e passando un valore di stringa che specifica il valore dell'identificatore della categoria. setCategoryId
È possibile richiamare il metodo EndpointCategory
dell'oggetto getId
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, durante la creazione di un endpoint TaskManager
per un servizio originato da un processo creato in Workbench, il nome dell'operazione è invoke
.Creare un endpoint TaskManager.
Creare l'endpoint richiamando il metodo EndpointRegistryClient
dell'oggetto createEndpoint
e passando l'oggetto CreateEndpointInfo
. Questo metodo restituisce un oggetto Endpoint
che rappresenta il nuovo endpoint TaskManager.
Abilitate l’endpoint.
Abilitare l'endpoint richiamando il metodo EndpointRegistryClient
dell'oggetto enable
e passando l'oggetto Endpoint
restituito dal metodo createEndpoint
.
Consulta anche
Avvio rapido: Aggiunta di un endpoint TaskManager tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Potete modificare a livello di programmazione un endpoint esistente utilizzando l'API Java di AEM Forms . Modificando un endpoint, potete modificare il comportamento dell'endpoint. Considerate, ad esempio, un endpoint cartella esaminata che specifica una cartella utilizzata come cartella esaminata. È possibile modificare a livello di programmazione i valori di configurazione che appartengono all’endpoint della cartella esaminata, in modo che un’altra cartella funzioni come cartella esaminata. Per informazioni sui valori di configurazione che appartengono a un endpoint di una cartella esaminata, vedere Aggiunta di endpoint cartella esaminata.
Per dimostrare come modificare un endpoint, in questa sezione viene modificato un endpoint cartella esaminata modificando la cartella che si comporta come cartella esaminata.
Non è possibile modificare un endpoint utilizzando i servizi Web.
Per modificare un endpoint, eseguire le operazioni seguenti:
EndpointRegistryClient
.Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
Per informazioni sulla posizione di questi file JAR, vedere Inclusione file libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Per modificare un endpoint a livello di programmazione, è necessario creare un oggetto EndpointRegistryClient
.
Recuperare l’endpoint da modificare
Prima di poter modificare un endpoint, è necessario recuperarlo. Per recuperare un endpoint, è necessario connettersi come utente che può accedere a un endpoint. È consigliabile connettersi come amministratore. (Vedere Impostazione delle proprietà di connessione).
È possibile recuperare un endpoint recuperando un elenco di endpoint. Potete quindi eseguire un'iterazione nell'elenco, cercando l'endpoint specifico da rimuovere. Ad esempio, potete individuare un endpoint determinando il servizio che corrisponde all'endpoint e il tipo di endpoint. Quando si individua l’endpoint, è possibile modificarlo.
Specificare nuovi valori di configurazione
Quando modificate un endpoint, specificate nuovi valori di configurazione. Ad esempio, per modificare un endpoint cartella esaminata, reimpostare tutti i valori di configurazione dell'endpoint cartella esaminata, non solo quelli che si desidera modificare. Per informazioni sui valori di configurazione che appartengono a un endpoint di una cartella esaminata, vedere Aggiunta di endpoint cartella esaminata.
Per informazioni sui valori di configurazione che appartengono a un endpoint e-mail, vedere Aggiunta di endpoint e-mail.
Non è possibile modificare il servizio richiamato dall'endpoint. Se tentate di modificare il servizio, viene generata un'eccezione. Per modificare il servizio associato a un determinato endpoint, rimuovete l'endpoint e createne uno nuovo. (Vedere Rimozione di endpoint.)
Consulta anche
Modifica di un endpoint tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Modificate un endpoint utilizzando l'API Java:
Includere i file di progetto.
Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto Client EndpointRegistry.
ServiceClientFactory
che contiene le proprietà di connessione.EndpointRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Recuperate l’endpoint da modificare.
EndpointRegistryClient
dell'oggetto getEndpoints
e passando un oggetto PagingFilter
che funge da filtro. Potete passare 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
, vedere AEM Forms API Reference.java.util.List
per determinare se contiene endpoint. Se esistono endpoint, ogni elemento è un'istanza EndPoint
.EndPoint
dell'oggetto getServiceId
. Questo metodo restituisce un valore di stringa che specifica il nome del servizio.EndPoint
dell'oggetto getConnectorId
. Questo metodo restituisce un valore di stringa che specifica il tipo di endpoint. Ad esempio, se l'endpoint è un endpoint cartella esaminata, questo metodo restituisce WatchedFolder
.Specificate nuovi valori di configurazione.
Creare un oggetto ModifyEndpointInfo
richiamandone il 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, richiamare il metodo ModifyEndpointInfo
dell'oggetto setConfigParameterAsText
e passare i seguenti valori:
url
, specificare url
.url
, specificate il percorso della cartella esaminata.Richiamare il metodo EndpointRegistryClient
dell'oggetto modifyEndpoint
e passare l'oggetto ModifyEndpointInfo
.
Consulta anche
Avvio rapido: Modifica di un endpoint tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Puoi rimuovere programmaticamente un endpoint da un servizio utilizzando l'API Java di AEM Forms . Dopo aver rimosso un endpoint, il servizio non può essere invocato utilizzando il metodo di chiamata abilitato dall'endpoint. Ad esempio, se si rimuove un endpoint SOAP da un servizio, non è possibile richiamare il servizio utilizzando la modalità SOAP.
Per dimostrare come rimuovere un endpoint da un servizio, questa sezione rimuove un endpoint EJB da un servizio denominato EncryptDocument.
Non è possibile rimuovere un endpoint utilizzando i servizi Web.
Per rimuovere un endpoint da un servizio, eseguire le operazioni seguenti:
EndpointRegistryClient
.Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
Per informazioni sulla posizione di questi file JAR, vedere Inclusione file libreria Java AEM Forms.
Creare un oggetto Client EndpointRegistry
Per rimuovere un endpoint a livello di programmazione, è necessario creare un oggetto EndpointRegistryClient
.
Recuperare l’endpoint da rimuovere
Prima di rimuovere un endpoint, è necessario recuperarlo. Per recuperare un endpoint, è necessario connettersi come utente che può accedere a un endpoint. È consigliabile connettersi come amministratore. (Vedere Impostazione delle proprietà di connessione).
È possibile recuperare un endpoint recuperando un elenco di endpoint. Potete quindi eseguire un'iterazione nell'elenco, cercando l'endpoint specifico da rimuovere. Ad esempio, potete individuare un endpoint determinando il servizio che corrisponde all'endpoint e il tipo di endpoint. Quando individuate l’endpoint, potete rimuoverlo.
Rimuovere l'endpoint
Dopo aver creato un nuovo endpoint, è necessario abilitarlo. Quando l'endpoint è abilitato, può essere utilizzato per richiamare il servizio. Dopo aver attivato l’endpoint, potete visualizzarlo nella console di amministrazione.
Consulta anche
Rimozione di un endpoint tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Rimuovete un endpoint utilizzando l'API Java:
Includere i file di progetto.
Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto Client EndpointRegistry.
ServiceClientFactory
che contiene le proprietà di connessione.EndpointRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Recuperate l’endpoint da rimuovere.
EndpointRegistryClient
dell'oggetto getEndpoints
e passando un oggetto PagingFilter
che funge da filtro. Potete 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 contiene endpoint. Se esistono endpoint, ogni elemento è un'istanza EndPoint
.EndPoint
dell'oggetto getServiceId
. Questo metodo restituisce un valore di stringa che specifica il nome del servizio.EndPoint
dell'oggetto getConnectorId
. Questo metodo restituisce un valore di stringa che specifica il tipo di endpoint. Ad esempio, se l'endpoint è un endpoint EJB, questo metodo restituisce EJB
.Rimuovere 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
Avvio rapido: Rimozione di un endpoint tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Potete recuperare informazioni sui connettori endpoint a livello di programmazione utilizzando l'API AEM Forms . Un connettore consente a un endpoint di richiamare un servizio utilizzando vari metodi di chiamata. Ad esempio, un connettore per cartelle esaminate consente a un endpoint di richiamare un servizio utilizzando le cartelle esaminate. Tramite il recupero programmatico delle informazioni sui connettori endpoint, è possibile recuperare i valori di configurazione associati a un connettore, ad esempio quali valori di configurazione sono obbligatori e quali facoltativi.
Per dimostrare come recuperare informazioni sui connettori endpoint, questa sezione recupera informazioni su un connettore per cartelle esaminate. (Vedere Aggiunta di endpoint cartella osservata.)
Non è possibile recuperare informazioni sugli endpoint utilizzando i servizi Web.
In questo argomento viene utilizzata l'API ConnectorRegistryClient
per recuperare informazioni sui connettori endpoint. (Vedere AEM Forms API Reference.)
Per recuperare le informazioni sul connettore endpoint, eseguire le operazioni seguenti:
ConnectorRegistryClient
.Includi file di progetto
Includete i file necessari nel progetto di sviluppo. Se create un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate i servizi Web, accertatevi di includere i file proxy.
I seguenti file JAR devono essere aggiunti al percorso di classe del progetto:
Se AEM Forms è distribuito su un server applicazione J2EE supportato che non è JBoss, sostituite adobe-utilities.jar e jbossall-client.jar con file JAR specifici per il server applicazione J2EE in cui AEM Forms è distribuito. Per informazioni sulla posizione di tutti file AEM Forms JAR, vedere Inclusione file libreria Java AEM Forms.
Creare un oggetto ConnectorRegistry Client
Per recuperare le informazioni sul connettore dell'endpoint a livello di programmazione, creare un oggetto ConnectorRegistryClient
.
Specificare il tipo di connettore
Specificare il tipo di connettore da cui recuperare le informazioni. Esistono i seguenti tipi di connettori:
Recuperare i valori di configurazione
Dopo aver specificato il tipo di connettore, è possibile recuperare informazioni sul connettore, ad esempio il valore di configurazione supportato. Ad esempio, per qualsiasi connettore, è possibile determinare quali valori di configurazione sono obbligatori e quali sono facoltativi.
Consulta anche
Recuperare le informazioni sul connettore dell'endpoint utilizzando l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione
Recuperate le informazioni sul connettore endpoint utilizzando l'API Java:
Includere i file di progetto. .
Includete file JAR client, ad esempio adobe-livecycle-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto ConnectorRegistry Client.
ServiceClientFactory
che contiene le proprietà di connessione.ConnectorRegistryClient
utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory
.Specificare il tipo di connettore.
Specificare il tipo di connettore richiamando il metodo ConnectorRegistryClient
dell'oggetto getEndpointDefinition
e passando un valore di stringa che specifica il tipo di connettore. Ad esempio, per specificare il tipo di connettore per cartelle esaminate, passare il valore stringa WatchedFolder
. Questo metodo restituisce un oggetto Endpoint
che corrisponde al tipo di connettore.
Recuperare i valori di configurazione.
Endpoint
dell'oggetto getConfigParameters
. Questo metodo restituisce un array di oggetti ConfigParameter
.ConfigParameter
. È possibile, ad esempio, determinare se il valore di configurazione è obbligatorio o facoltativo richiamando il metodo ConfigParameter
dell'oggetto isRequired
. Se il valore di configurazione è obbligatorio, questo metodo restituisce true
.Consulta anche
Avvio rapido: Recupero delle informazioni sul connettore endpoint tramite l'API Java
Inclusione file libreria Java AEM Forms
Impostazione delle proprietà di connessione