Sobre o Endpoint Registry Service
O serviço Endpoint Registry fornece a capacidade de gerenciar programaticamente os pontos de extremidade. Por exemplo, é possível adicionar os seguintes tipos de pontos de extremidade a um serviço:
EJB
SOAP
Pasta assistida
(Obsoleto para formulários AEM) Remoção
Gerenciador de tarefas
SOAP, EJB e (Obsoleto para formulários AEM no JEE) Os pontos finais remotos são criados automaticamente para cada serviço ativado. Os pontos de extremidade SOAP e EJB habilitam SOAP e EJB para todas as operações de serviço.
Um terminal Remoting permite que os clientes Flex chamem operações no serviço AEM Forms ao qual o terminal é adicionado. É criado um destino Flex com o mesmo nome do ponto de extremidade e os clientes Flex podem criar RemoteObjects que apontam para esse destino para chamar operações no serviço relevante.
Os pontos de extremidade Email, Gerenciador de Tarefas e Pasta assistida expõem apenas uma operação específica do serviço. A adição desses pontos finais requer uma segunda etapa de configuração para selecionar um método para chamar, definir parâmetros de configuração e especificar mapeamentos de parâmetros de entrada e saída.
Você pode organizar pontos de extremidade do TaskManager em grupos chamados categoria. Essas categorias são então expostas ao Workspace por meio do TaskManager, com os usuários finais visualizando os pontos finais do TaskManager à medida que são categorizados. No Workspace, os usuários finais visualizam essas categorias no painel de navegação. Os pontos de extremidade dentro de cada categoria são exibidos como cartões de processo na página Processos do Start no Workspace.
É possível realizar essas tarefas usando o serviço Endpoint Registry:
Adicione pontos de extremidade EJB. (Consulte Adicionando Endpoints EJB.)
Adicionar pontos de extremidade SOAP. (Consulte Adicionando Endpoints SOAP.)
Adicionar pontos de extremidade de pasta monitorada (Consulte Adicionar pontos de extremidade de pasta monitorada.)
Adicionar pontos de extremidade de email. (Consulte Adicionando Pontos de Extremidade de Email.)
Adicionar pontos finais remotos. (Consulte Adicionando Pontos Finais Remotos.)
Adicionar pontos de extremidade do TaskManager (Consulte Adicionando pontos de extremidade do TaskManager.)
Modifique pontos de extremidade (Consulte Modificando Pontos de Extremidade.)
Remova os pontos de extremidade (Consulte Remoção dos pontos de extremidade.)
Recuperar informações do conector do ponto de extremidade (Consulte Recuperando Informações do Conector do Ponto de Extremidade.)
Você pode adicionar programaticamente um terminal EJB a um serviço usando a API Java da AEM Forms. Ao adicionar um terminal EJB a um serviço, você está permitindo que um aplicativo cliente chame o serviço usando o modo EJB. Ou seja, ao definir as propriedades de conexão necessárias para chamar o AEM Forms, você pode selecionar o modo EJB. (Consulte Definição das propriedades de ligação.)
Não é possível adicionar um terminal EJB usando serviços da Web.
Normalmente, um ponto de extremidade EJB é adicionado a um serviço por padrão. Entretanto, um ponto de extremidade EJB pode ser adicionado a um processo que é implantado programaticamente ou quando um ponto de extremidade EJB foi removido e deve ser adicionado novamente.
Para adicionar um terminal EJB a um serviço, execute as seguintes tarefas:
EndpointRegistry Client
.Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Os seguintes arquivos JAR devem ser adicionados ao caminho de classe do seu projeto:
Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo os arquivos da biblioteca Java da AEM Forms.
Criar um objeto Cliente EndpointRegistry
Antes de poder adicionar programaticamente um terminal EJB, é necessário criar um objeto EndpointRegistryClient
.
Definir atributos de ponto de extremidade EJB
Para criar um terminal EJB para um serviço, especifique os seguintes valores:
EJB
.*
). No entanto, se você quiser especificar uma operação específica em vez de chamar todas as operações de serviço, especifique o nome da operação em vez de usar o caractere curinga ( *
).Criar um ponto de extremidade EJB
Depois de definir atributos de ponto de extremidade EJB, você pode criar um ponto de extremidade EJB para um serviço.
Ativar o ponto final
Depois de criar um novo terminal, é necessário ativá-lo. Depois de ativar o terminal, ele pode ser usado para chamar o serviço. Depois de ativar o terminal, você pode visualização-lo no console de administração.
Consulte também:
Adicionar um terminal EJB usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Adicione um terminal EJB usando a API Java:
Incluir arquivos de projeto.
Inclua arquivos JAR do cliente, como adobe-livecycle-client.jar, no caminho da classe do seu projeto Java. (
Crie um objeto EndpointRegistry Client.
ServiceClientFactory
que contenha propriedades de conexão.EndpointRegistryClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Defina atributos de ponto de extremidade EJB.
CreateEndpointInfo
usando seu construtor.CreateEndpointInfo
do objeto setConnectorId
e transmitindo o valor da string EJB
.CreateEndpointInfo
do objeto setDescription
e transmitindo um valor de string que descreve o ponto de extremidade.CreateEndpointInfo
do objeto setName
e transmitindo um valor de string que especifica o nome.CreateEndpointInfo
do objeto setServiceId
e transmitindo um valor de string que especifica o nome do serviço.CreateEndpointInfo
do objeto setOperationName
e transmita um valor de cadeia de caracteres que especifica o nome da operação. Para pontos de extremidade SOAP e EJB, especifique um caractere curinga ( *
), o que implica todas as operações.Crie um terminal EJB.
Crie o ponto de extremidade chamando o método EndpointRegistryClient
do objeto createEndpoint
e transmitindo o objeto CreateEndpointInfo
. Este método retorna um objeto Endpoint
que representa o novo ponto final EJB.
Ative o terminal.
Ative o terminal chamando o método enable do objeto EndpointRegistryClient
e transmitindo o objeto Endpoint
que foi retornado pelo método createEndpoint
.
Consulte também:
Início rápido: Adicionar um terminal EJB usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Você pode adicionar programaticamente um terminal SOAP a um serviço usando a API Java da AEM Forms. Ao adicionar um terminal SOAP, você permite que um aplicativo cliente chame o serviço usando o modo SOAP. Ou seja, ao definir as propriedades de conexão necessárias para chamar o AEM Forms, você pode selecionar o modo SOAP.
Não é possível adicionar um terminal SOAP usando serviços da Web.
Normalmente, um terminal SOAP é adicionado a um serviço por padrão. Entretanto, um terminal SOAP pode ser adicionado a um processo que é implantado de forma programática ou quando um terminal SOAP foi removido e precisa ser adicionado novamente.
Para adicionar um terminal SOAP a um serviço, execute as seguintes tarefas:
EndpointRegistryClient
.Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Os seguintes arquivos JAR devem ser adicionados ao caminho de classe do seu projeto:
Esses arquivos JAR são necessários para criar um terminal SOAP. No entanto, é necessário adicionar arquivos JAR se você usar o terminal SOAP para chamar o serviço. Para obter informações sobre arquivos AEM Forms JAR, consulte Incluindo arquivos da biblioteca AEM Forms Java.
Criar um objeto Cliente EndpointRegistry
Para adicionar programaticamente um terminal SOAP a um serviço, é necessário criar um objeto EndpointRegistryClient
.
Definir atributos de ponto de extremidade SOAP
Para adicionar um terminal SOAP a um serviço, especifique os seguintes valores:
SOAP
.*
). No entanto, se você quiser especificar uma operação específica em vez de chamar todas as operações de serviço, especifique o nome da operação em vez de usar o caractere curinga ( *
).Criar um terminal SOAP
Depois de definir atributos de ponto de extremidade SOAP, você pode criar um ponto de extremidade SOAP.
Ativar o ponto final
Depois de criar um novo terminal, é necessário ativá-lo. Quando o terminal está ativado, ele pode ser usado para chamar o serviço. Depois de ativar o terminal, é possível vê-lo em visualização no console de administração.
Consulte também:
Adicionar um terminal SOAP usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Adicione um terminal SOAP a um serviço usando a API Java:
Incluir arquivos de projeto.
Inclua arquivos JAR do cliente, como adobe-livecycle-client.jar, no caminho da classe do seu projeto Java.
Crie um objeto EndpointRegistry Client.
ServiceClientFactory
que contenha propriedades de conexão.EndpointRegistryClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Defina os atributos de ponto de extremidade SOAP.
CreateEndpointInfo
usando seu construtor.CreateEndpointInfo
do objeto setConnectorId
e transmitindo o valor da string SOAP
.CreateEndpointInfo
do objeto setDescription
e transmitindo um valor de string que descreve o ponto de extremidade.CreateEndpointInfo
do objeto setName
e transmitindo um valor de string que especifica o nome.CreateEndpointInfo
do objeto setServiceId
e transmitindo um valor de string que especifica o nome do serviço.CreateEndpointInfo
do objeto setOperationName
e transmitindo um valor de cadeia de caracteres que especifica o nome da operação. Para pontos de extremidade SOAP e EJB, especifique um caractere curinga ( *
), o que implica todas as operações.Crie um terminal SOAP.
Crie o ponto de extremidade chamando o método EndpointRegistryClient
do objeto createEndpoint
e transmitindo o objeto CreateEndpointInfo
. Este método retorna um objeto Endpoint
que representa o novo terminal SOAP.
Ative o terminal.
Ative o terminal chamando o método enable do objeto EndpointRegistryClient
e transmitindo o objeto Endpoint
que foi retornado pelo método createEndpoint
.
Consulte também:
Início rápido: Adicionar um terminal SOAP usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Você pode adicionar programaticamente um terminal de Pasta assistida a um serviço usando a API Java da AEM Forms. Ao adicionar um terminal de Pasta assistida, você permite que os usuários coloquem um arquivo (como um arquivo PDF) em uma pasta. Quando o arquivo é colocado na pasta, o serviço configurado é então chamado e manipula o arquivo. Depois que o serviço executa a operação especificada, ele salva o arquivo modificado em uma pasta de saída especificada. Uma pasta assistida é configurada para ser digitalizada em um intervalo de taxa fixa ou com um cronograma de verificação, como todas as segundas, quartas e sextas-feiras ao meio-dia.
Para fins de adicionar programaticamente um ponto de extremidade de Pasta monitorada a um serviço, considere o seguinte processo de vida curta chamado EncryptDocument. (Consulte Entendendo os processos AEM Forms.)
Esse processo aceita um documento PDF não protegido como um valor de entrada e passa o documento PDF não protegido para a operação EncryptPDFUsingPassword
do serviço de criptografia. O documento PDF é criptografado com uma senha e o documento PDF criptografado por senha é o valor de saída desse processo. O nome do valor de entrada (o documento PDF não protegido) é InDoc
e o tipo de dados é com.adobe.idp.Document
. O nome do valor de saída (o documento PDF criptografado por senha) é SecuredDoc
e o tipo de dados é com.adobe.idp.Document
.
Não é possível adicionar um ponto de extremidade de Pasta assistida usando serviços da Web.
Para adicionar um terminal de Pasta assistida a um serviço, execute as seguintes tarefas:
EndpointRegistryClient
.Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Os seguintes arquivos JAR devem ser adicionados ao caminho de classe do seu projeto:
Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo os arquivos da biblioteca Java da AEM Forms.
Criar um objeto Cliente EndpointRegistry
Para adicionar programaticamente um ponto de extremidade de Pasta assistida, é necessário criar um objeto EndpointRegistryClient
.
Definir atributos de ponto de extremidade de Pasta assistida
Para criar um ponto de extremidade de Pasta assistida para um serviço, especifique os seguintes valores:
WatchedFolder
.EncryptDocument
.invoke
.Especificar valores de configuração
Você deve especificar valores de configuração para um endpoint de Pasta assistida ao adicionar programaticamente um endpoint de Pasta assistida a um serviço. Esses valores de configuração são especificados por um administrador se um endpoint de Pasta assistida for adicionado usando o console de administração.
A lista a seguir especifica os valores de configuração que são definidos ao adicionar programaticamente um ponto de extremidade de Pasta assistida a um serviço:
data*
, todos os arquivos e pastas que correspondem a data*
não serão selecionados. Isso inclui arquivos e pastas chamados data1
, data2
e assim por diante. Além disso, o padrão pode ser complementado com padrões curingas para especificar padrões de arquivos. A pasta assistida modifica a expressão normal para suportar padrões curingas, como *.*
e *.pdf
. Esses padrões curingas não são suportados por expressões regulares.*
, todos os arquivos e pastas que correspondem a input*
serão coletados. Isso inclui arquivos e pastas chamados input1
, input2
e assim por diante. O valor padrão é *
. Esse valor indica todos os arquivos e pastas. Além disso, o padrão pode ser complementado com padrões curingas para especificar padrões de arquivos. A pasta assistida modifica a expressão normal para suportar padrões curingas, como *.*
e *.pdf
. Esses padrões curingas não são suportados por expressões regulares. Este valor é obrigatório.result/%Y/%M/%D/
. Esta é a pasta de resultados dentro da pasta assistida.preserve/%Y/%M/%D/
.failure/%Y/%M/%D/
.Definir valores de parâmetros de entrada
Ao criar um ponto final de Pasta assistida, você deve definir valores de parâmetro de entrada. Ou seja, você deve descrever os valores de entrada passados para a operação chamada pela pasta assistida. Por exemplo, considere o processo apresentado neste tópico. Ele tem um valor de entrada chamado InDoc
e seu tipo de dados é com.adobe.idp.Document
. Ao criar um terminal de Pasta assistida para esse processo (depois que um processo é ativado, ele se torna um serviço), você deve definir o valor do parâmetro de entrada.
Para definir valores de parâmetro de entrada necessários para um ponto de extremidade de Pasta assistida, especifique os seguintes valores:
Nome do parâmetro de entrada: O nome do parâmetro de entrada. O nome de um valor de entrada é especificado no Workbench para um processo. Se o valor de entrada pertencer a uma operação de serviço (um serviço que não é um processo criado no Workbench), o nome de entrada será especificado no arquivo component.xml. Por exemplo, o nome do parâmetro de entrada para o processo introduzido nesta seção é InDoc
.
Tipo de mapeamento: Usado para configurar os valores de entrada necessários para chamar a operação de serviço. Há dois tipos de mapeamento:
Literal
: O endpoint de Pasta assistida usa o valor inserido no campo conforme ele é exibido. Todos os tipos básicos de Java são suportados. Por exemplo, se uma API usar uma entrada como String, long, int e Boolean, a string será convertida no tipo correto e o serviço será chamado.Variable
: O valor inserido é um padrão de arquivo que a pasta assistida usa para escolher a entrada. Por exemplo, se você selecionar Variável para o tipo de mapeamento e o documento de entrada precisar ser um arquivo PDF, poderá especificar *.pdf
como valor de mapeamento.Valor de mapeamento: Especifica o valor do tipo de mapeamento. Por exemplo, se você selecionar um tipo de mapeamento Variable
, poderá especificar *.pdf
como padrão de arquivo.
Tipo de dados: Especifica o tipo de dados dos valores de entrada. Por exemplo, o tipo de dados do valor de entrada do processo introduzido nesta seção é com.adobe.idp.Document
.
Definir um valor de parâmetro de saída
Ao criar um ponto final de Pasta assistida, você deve definir um valor de parâmetro de saída. Ou seja, você deve descrever o valor de saída que é retornado pelo serviço chamado pelo endpoint de Pasta assistida. Por exemplo, considere o processo apresentado neste tópico. Ele tem um valor de saída chamado SecuredDoc
e seu tipo de dados é com.adobe.idp.Document
. Ao criar um terminal de Pasta assistida para esse processo (depois que um processo é ativado, ele se torna um serviço), você deve definir o valor do parâmetro de saída.
Para definir um valor de parâmetro de saída necessário para um endpoint de Pasta assistida, especifique os seguintes valores:
Nome do parâmetro de saída: O nome do parâmetro de saída. O nome de um valor de saída de processo é especificado no Workbench. Se o valor de saída pertencer a uma operação de serviço (um serviço que não é um processo criado no Workbench), o nome de saída será especificado no arquivo component.xml. Por exemplo, o nome do parâmetro de saída para o processo introduzido nesta seção é SecuredDoc
.
Tipo de mapeamento: Usado para configurar a saída do serviço e da operação. As opções disponíveis são as seguintes:
%F.pdf
e o destino de origem será sourcefilename.pdf. Por exemplo, o processo introduzido nesta seção retorna um único documento. Como resultado, o tipo de mapeamento pode ser definido como %F.pdf
( %F
significa usar o nome de arquivo especificado). O padrão %E
especifica a extensão do documento de entrada.Result\%F\
e o destino de origem será Result\sourcefilename\source1 (output 1) e Result\sourcefilename\source2 (output 2).Result\%F\
e o destino de origem será Result\sourcefilename\file1 and Result\sourcefilename\file2. Se o mapa tiver mais de um objeto, o padrão será Result\%F.pdf
e o destino de origem será Result\sourcefilename1.pdf (saída 1), Result\sourcefilenam2.pdf (saída 2) e assim por diante.Tipo de dados: Especifica o tipo de dados do valor de retorno. Por exemplo, o tipo de dados do valor de retorno do processo introduzido nesta seção é com.adobe.idp.Document
.
Criar um ponto de extremidade de Pasta assistida
Depois de definir os atributos do ponto final, os valores de configuração e os valores dos parâmetros de entrada e saída, você deve criar o ponto final da Pasta assistida.
Ativar o ponto final
Depois de criar um terminal de Pasta assistida, é necessário ativá-lo. Quando o terminal está ativado, ele pode ser usado para chamar o serviço. Depois de ativar o terminal, você pode visualização-lo no console de administração.
Consulte também:
Adicionar um terminal de Pasta assistida usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Adicione um terminal de Pasta assistida usando a API Java da AEM Forms:
Incluir arquivos de projeto.
Inclua arquivos JAR do cliente, como adobe-livecycle-client.jar, no caminho da classe do seu projeto Java.
Crie um objeto EndpointRegistry Client.
ServiceClientFactory
que contenha propriedades de conexão.EndpointRegistryClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Defina os atributos do ponto de extremidade da Pasta assistida.
CreateEndpointInfo
usando seu construtor.CreateEndpointInfo
do objeto setConnectorId
e transmitindo o valor da string WatchedFolder
.CreateEndpointInfo
do objeto setDescription
e transmitindo um valor de string que descreve o ponto de extremidade.CreateEndpointInfo
do objeto setName
e transmitindo um valor de string que especifica o nome.CreateEndpointInfo
do objeto setServiceId
e transmitindo um valor de string que especifica o nome do serviço.CreateEndpointInfo
do objeto setOperationName
e transmitindo um valor de cadeia de caracteres que especifica o nome da operação. Geralmente, ao criar um ponto de extremidade de Pasta assistida para um serviço originado de um processo criado no Workbench, o nome da operação é chamado.Especifique os valores de configuração.
Para que cada valor de configuração seja definido para o ponto de extremidade Pasta assistida, é necessário chamar o método CreateEndpointInfo
do objeto setConfigParameterAsText
. Por exemplo, para definir o valor de configuração url
, chame o método CreateEndpointInfo
do objeto setConfigParameterAsText
e passe os seguintes valores de string:
url
, especifique url
.url
, especifique o local da pasta monitorada.Para ver todos os valores de configuração definidos para o serviço EncryptDocument, consulte o exemplo de código Java localizado em QuickStart: Adicionando um terminal de Pasta assistida usando a API Java.
Defina os valores dos parâmetros de entrada.
Defina um valor de parâmetro de entrada invocando o método CreateEndpointInfo
do objeto setInputParameterMapping
e transmita os seguintes valores:
InDoc
.InDoc
é com.adobe.idp.Document
.variable
.Chame o método setInputParameterMapping
para cada valor de parâmetro de entrada a ser definido. Como o processo EncryptDocument tem apenas um parâmetro de entrada, é necessário chamar esse método uma vez.
Defina um valor de parâmetro de saída.
Defina um valor de parâmetro de saída chamando o método CreateEndpointInfo
do objeto setOutputParameterMapping
e transmita os seguintes valores:
SecuredDoc
.SecuredDoc
é com.adobe.idp.Document
.%F.pdf
.Criar um terminal de Pasta assistida.
Crie o ponto de extremidade chamando o método EndpointRegistryClient
do objeto createEndpoint
e transmitindo o objeto CreateEndpointInfo
. Este método retorna um objeto Endpoint
que representa o ponto final da Pasta assistida.
Ative o terminal.
Ative o terminal chamando o método EndpointRegistryClient
do objeto enable
e transmitindo o objeto Endpoint
que foi retornado pelo método createEndpoint
.
Consulte também:
Início rápido: Adicionando um ponto de extremidade de Pasta assistida usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
O QuickStart: A adição de um terminal de Pasta assistida usando a API Java usa um arquivo constante que deve fazer parte do seu projeto Java para compilar o start rápido. Esse arquivo constante representa valores de configuração que devem ser definidos ao adicionar um ponto final de Pasta assistida. O código Java a seguir representa o arquivo constante.
/**
* 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";
}
Você pode adicionar programaticamente um terminal de email a um serviço usando a API Java da AEM Forms. Ao adicionar um terminal de email, você permite que os usuários enviem uma mensagem de email com um ou mais anexos de arquivo para uma conta de email especificada. Em seguida, a operação de configuração de serviço é chamada e manipula os arquivos. Depois que o serviço executa a operação especificada, ele envia uma mensagem de email para o remetente com os arquivos modificados como anexos de arquivo.
Para fins de adicionar programaticamente um terminal de email a um serviço, considere o seguinte processo de vida curta chamado MyApplication\EncryptDocument. Para obter informações sobre processos de duração curta, consulte Entendendo os processos AEM Forms.
Esse processo aceita um documento PDF não protegido como um valor de entrada e passa o documento PDF não protegido para a operação EncryptPDFUsingPassword
do serviço de criptografia. Esse processo criptografa o documento PDF com uma senha e retorna o documento PDF criptografado por senha como valor de saída. O nome do valor de entrada (o documento PDF não protegido) é InDoc
e o tipo de dados é com.adobe.idp.Document
. O nome do valor de saída (o documento PDF criptografado por senha) é SecuredDoc
e o tipo de dados é com.adobe.idp.Document
.
Não é possível adicionar um terminal de email usando serviços da Web.
Para adicionar um terminal de email a um serviço, execute as seguintes tarefas:
EndpointRegistryClient
.Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Os seguintes arquivos JAR devem ser adicionados ao caminho de classe do seu projeto:
Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo os arquivos da biblioteca Java da AEM Forms.
Criar um objeto Cliente EndpointRegistry
Antes de poder adicionar programaticamente um terminal de E-mail, você deve criar um objeto EndpointRegistryClient
.
Definir atributos de ponto de extremidade de email
Para criar um terminal de email para um serviço, especifique os seguintes valores:
Email
.EncryptDocument
.invoke
.Especificar valores de configuração
Você deve especificar valores de configuração para um terminal de email ao adicionar programaticamente um terminal de email a um serviço. Esses valores de configuração são especificados por um administrador se um terminal de email for adicionado usando o console de administração.
A conta de email que é monitorada é uma conta especial usada apenas para o terminal Email. Esta conta não é uma conta de email normal do usuário. A conta de email de um usuário regular não deve ser configurada como a conta que o Provedor de email usa, pois o Provedor de email exclui mensagens da caixa de entrada depois que elas são terminadas.
Os seguintes valores de configuração são definidos ao adicionar programaticamente um ponto de extremidade de Email a um serviço:
SuperAdmin
.DefaultDom
.adobe.com
for usado, somente o email do adobe.com será processado, o email de outros domínios será ignorado.*
.sender
, os resultados do email serão enviados para o remetente. Há suporte para até 100 recipient. Especifique recipient adicionais com endereços de email, cada um separado por vírgula. Para desativar essa opção, deixe esse valor em branco. Em alguns casos, talvez você queira acionar um processo e não desejar uma notificação por email do resultado. O valor padrão é sender
.sender
, os resultados do email serão enviados para o remetente. Há suporte para até 100 recipient. Especifique recipient adicionais com endereços de email, cada um separado por vírgula. Para desativar essa opção, deixe esse valor em branco. O valor padrão é sender
.IMAP
ou POP3
. O servidor de correio do host da caixa de entrada deve suportar esses protocolos.UTF-8
.Definir valores de parâmetros de entrada
Ao criar um terminal de email, você deve definir valores de parâmetro de entrada. Ou seja, você deve descrever os valores de entrada passados para a operação chamada pelo terminal Email. Por exemplo, considere o processo apresentado neste tópico. Ele tem um valor de entrada chamado InDoc
e seu tipo de dados é com.adobe.idp.Document
. Ao criar um terminal de email para esse processo (depois que um processo é ativado, ele se torna um serviço), você deve definir o valor do parâmetro de entrada.
Para definir os valores de parâmetro de entrada necessários para um ponto de extremidade Email, especifique os seguintes valores:
Nome do parâmetro de entrada: O nome do parâmetro de entrada. O nome de um valor de entrada é especificado no Workbench para um processo. Se o valor de entrada pertencer a uma operação de serviço (um serviço Forms que não é um processo criado no Workbench), o nome de entrada será especificado no arquivo component.xml. Por exemplo, o nome do parâmetro de entrada para o processo introduzido nesta seção é InDoc
.
Tipo de mapeamento: Usado para configurar os valores de entrada necessários para chamar a operação de serviço. Dois tipos de mapeamento são os seguintes:
Literal
: O terminal Email usa o valor inserido no campo conforme é exibido. Todos os tipos básicos de Java são suportados. Por exemplo, se uma API usar uma entrada como String, long, int e Boolean, a string será convertida no tipo correto e o serviço será chamado.Variable
: O valor inserido é um padrão de arquivo que o terminal Email usa para escolher a entrada. Por exemplo, se você selecionar Variável para o tipo de mapeamento e o documento de entrada precisar ser um arquivo PDF, poderá especificar *.pdf
como valor de mapeamento.Valor de mapeamento: Especifica o valor do tipo de mapeamento. Por exemplo, se você selecionar um tipo de mapeamento de variável, poderá especificar *.pdf
como padrão de arquivo.
Tipo de dados: Especifica o tipo de dados dos valores de entrada. Por exemplo, o tipo de dados do valor de entrada do processo introduzido nesta seção é com.adobe.idp.Documento.
Definir um valor de parâmetro de saída
Ao criar um terminal de email, você deve definir um valor de parâmetro de saída. Ou seja, você deve descrever o valor de saída que é retornado pelo serviço chamado pelo terminal Email. Por exemplo, considere o processo apresentado neste tópico. Ele tem um valor de saída chamado SecuredDoc
e seu tipo de dados é com.adobe.idp.Document
. Ao criar um terminal de email para esse processo (depois que um processo é ativado, ele se torna um serviço), você deve definir o valor do parâmetro de saída.
Para definir um valor de parâmetro de saída necessário para um ponto de extremidade Email, especifique os seguintes valores:
Nome do parâmetro de saída: O nome do parâmetro de saída. O nome de um valor de saída de processo é especificado no Workbench. Se o valor de saída pertencer a uma operação de serviço (um serviço que não é um processo criado no Workbench), o nome de saída será especificado no arquivo component.xml. Por exemplo, o nome do parâmetro de saída para o processo introduzido nesta seção é SecuredDoc
.
Tipo de mapeamento: Usado para configurar a saída do serviço e da operação. As opções disponíveis são as seguintes:
%F.pdf
e o destino de origem será sourcefilename.pdf. Por exemplo, o processo introduzido nesta seção retorna um único documento. Como resultado, o tipo de mapeamento pode ser definido como %F.pdf
( %F
significa usar o nome de arquivo especificado). O padrão %E
especifica a extensão do documento de entrada.Result\%F\
e o destino de origem será Result\sourcefilename\source1 (output 1) e Result\sourcefilename\source2 (output 2).Result\%F\
e o destino de origem será Result\sourcefilename\file1 and Result\sourcefilename\file2. Se o mapa tiver mais de um objeto, o padrão será Result\%F.pdf
e o destino de origem será Result\sourcefilename1.pdf (saída 1), Result\sourcefilenam2.pdf (saída 2) e assim por diante.Tipo de dados: Especifica o tipo de dados do valor de retorno. Por exemplo, o tipo de dados do valor de retorno do processo introduzido nesta seção é com.adobe.idp.Document
.
Criar o terminal Email
Depois de definir os atributos e os valores de configuração do ponto de extremidade de E-mail e definir os valores dos parâmetros de entrada e saída, você deve criar o ponto de extremidade de E-mail.
Ativar o ponto final
Depois de criar um terminal de email, é necessário ativá-lo. Quando o terminal está ativado, ele pode ser usado para chamar o serviço. Depois de ativar o terminal, você pode visualização-lo no console de administração.
Consulte também:
Adicionar um terminal de email usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Adicione um terminal de email usando a API Java:
Incluir arquivos de projeto.
Inclua arquivos JAR do cliente, como adobe-livecycle-client.jar, no caminho da classe do seu projeto Java.
Crie um objeto EndpointRegistry Client.
ServiceClientFactory
que contenha propriedades de conexão.EndpointRegistryClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Defina atributos de ponto de extremidade de email.
CreateEndpointInfo
usando seu construtor.CreateEndpointInfo
do objeto setConnectorId
e transmitindo o valor da string Email
.CreateEndpointInfo
do objeto setDescription
e transmitindo um valor de string que descreve o ponto de extremidade.CreateEndpointInfo
do objeto setName
e transmitindo um valor de string que especifica o nome.CreateEndpointInfo
do objeto setServiceId
e transmitindo um valor de string que especifica o nome do serviço.CreateEndpointInfo
do objeto setOperationName
e transmitindo um valor de cadeia de caracteres que especifica o nome da operação. Geralmente, ao criar um terminal de email para um serviço originado de um processo criado no Workbench, o nome da operação é chamado.Especifique os valores de configuração.
Para que cada valor de configuração seja definido para o terminal Email, você deve chamar o método CreateEndpointInfo
setConfigParameterAsText
do objeto. Por exemplo, para definir o valor de configuração smtpHost
, chame o método CreateEndpointInfo
do objeto setConfigParameterAsText
e passe os seguintes valores:
smtpHost
, especifique smtpHost
.smtpHost
, especifique um valor de string que especifique o nome do servidor SMTP.Para ver todos os valores de configuração definidos para o serviço EncryptDocument introduzido nesta seção, consulte o exemplo de código Java localizado em QuickStart: Adicionando um terminal de email usando a API Java.
Defina os valores dos parâmetros de entrada.
Defina um valor de parâmetro de entrada invocando o método CreateEndpointInfo
do objeto setInputParameterMapping
e transmita os seguintes valores:
InDoc
.InDoc
é com.adobe.idp.Document
.variable
.Chame o método setInputParameterMapping
para cada valor de parâmetro de entrada a ser definido. Como o processo EncryptDocument tem apenas um parâmetro de entrada, é necessário chamar esse método uma vez.
Defina um valor de parâmetro de saída.
Defina um valor de parâmetro de saída chamando o método CreateEndpointInfo
do objeto setOutputParameterMapping
e transmitindo os seguintes valores:
SecuredDoc
.SecuredDoc
é com.adobe.idp.Document
.%F.pdf
.Crie o terminal Email.
Crie o ponto de extremidade chamando o método EndpointRegistryClient
do objeto createEndpoint
e transmitindo o objeto CreateEndpointInfo
. Este método retorna um objeto Endpoint
que representa o ponto de extremidade Email.
Ative o terminal.
Ative o terminal chamando o método EndpointRegistryClient
do objeto enable
e transmitindo o objeto Endpoint
que foi retornado pelo método createEndpoint
.
Consulte também:
Início rápido: Adicionando um ponto de extremidade de Pasta assistida usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
O QuickStart: Adicionar um terminal de email usando a API Java usa um arquivo constante que deve fazer parte do seu projeto Java para compilar o start rápido. Esse arquivo constante representa valores de configuração que devem ser definidos ao adicionar um ponto de extremidade de email. O código Java a seguir representa o arquivo constante.
/**
* 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";
}
APIs de LiveCycle Remoting substituídas para formulários AEM em JEE.
Você pode adicionar programaticamente um terminal Remoting a um serviço usando a API Java da AEM Forms. Ao adicionar um terminal Remoting, você está permitindo que um aplicativo Flex chame o serviço usando a remoção. (Consulte Invocando o AEM Forms Usando (Obsoleto para formulários AEM) AEM Forms Remoting.)
Para fins de adicionar programaticamente um terminal Remoto a um serviço, considere o seguinte processo de vida curta chamado EncryptDocument.
Esse processo aceita um documento PDF não protegido como um valor de entrada e passa o documento PDF não protegido para a operação EncryptPDFUsingPassword
do serviço de criptografia. O documento PDF é criptografado com uma senha e o documento PDF criptografado por senha é o valor de saída desse processo. O nome do valor de entrada (o documento PDF não protegido) é InDoc
e o tipo de dados é com.adobe.idp.Document
. O nome do valor de saída (o documento PDF criptografado por senha) é SecuredDoc
e o tipo de dados é com.adobe.idp.Document
.
Para demonstrar como adicionar um terminal Remoto a um serviço, esta seção adiciona um terminal Remoto a um serviço chamado EncryptDocument.
Não é possível adicionar um terminal Remoto usando serviços da Web.
Para remover um terminal de um serviço, execute as seguintes tarefas:
EndpointRegistryClient
.Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Os seguintes arquivos JAR devem ser adicionados ao caminho de classe do seu projeto:
Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo os arquivos da biblioteca Java da AEM Forms.
Criar um objeto Cliente EndpointRegistry
Para adicionar programaticamente um terminal Remoting, é necessário criar um objeto EndpointRegistryClient
.
Definir atributos de ponto final remoto
Para criar um terminal Remoto para um serviço, especifique os seguintes valores:
Remoting
.EncryptDocument
.Criar um terminal Remoto
Depois de definir os atributos de ponto de extremidade Remoto, você pode criar um ponto de extremidade Remota para um serviço.
Ativar o ponto final
Depois de criar um novo terminal, é necessário ativá-lo. Quando um terminal Remoting é ativado, ele permite que um cliente Flex chame o serviço.
Consulte também:
Adicionar um terminal Remoto usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Adicione um terminal Remoting usando a API Java:
Incluir arquivos de projeto.
Inclua arquivos JAR do cliente, como adobe-livecycle-client.jar, no caminho da classe do seu projeto Java.
Crie um objeto EndpointRegistry Client.
ServiceClientFactory
que contenha propriedades de conexão.EndpointRegistryClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Definir atributos de ponto final remoto.
CreateEndpointInfo
usando seu construtor.CreateEndpointInfo
do objeto setConnectorId
e transmitindo o valor da string Remoting
.CreateEndpointInfo
do objeto setDescription
e transmitindo um valor de string que descreve o ponto de extremidade.CreateEndpointInfo
do objeto setName
e transmitindo um valor de string que especifica o nome.CreateEndpointInfo
do objeto setServiceId
e transmitindo um valor de string que especifica o nome do serviço.CreateEndpointInfo
do objeto setOperationName
e transmitindo um valor de cadeia de caracteres que especifica o nome da operação. Para um terminal Remoto, especifique um caractere curinga (*).Criar um terminal Remoto.
Crie o ponto de extremidade chamando o método EndpointRegistryClient
do objeto createEndpoint
e transmitindo o objeto CreateEndpointInfo
. Este método retorna um objeto Endpoint
que representa o novo terminal Remoting.
Ative o terminal.
Ative o terminal chamando o método EndpointRegistryClient
do objeto enable
e transmitindo o objeto Endpoint
que foi retornado pelo método createEndpoint
.
Consulte também:
Início rápido: Adicionar um terminal Remoting usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Você pode adicionar programaticamente um terminal do TaskManager a um serviço usando a API Java da AEM Forms. Ao adicionar um terminal do TaskManager a um serviço, você permite que um usuário do Workspace chame o serviço. Ou seja, um usuário que trabalha no Workspace pode chamar um processo que tem um terminal do TaskManager correspondente.
Não é possível adicionar um terminal do TaskManager usando serviços da Web.
Para adicionar um terminal do TaskManager a um serviço, execute as seguintes tarefas:
EndpointRegistryClient
.Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Os seguintes arquivos JAR devem ser adicionados ao caminho de classe do seu projeto:
Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo os arquivos da biblioteca Java da AEM Forms.
Criar um objeto Cliente EndpointRegistry
Antes de poder adicionar programaticamente um terminal do TaskManager, é necessário criar um objeto EndpointRegistryClient
.
Criar uma categoria para o terminal
As categorias são usadas para organizar serviços no Workspace. Ou seja, um usuário do Workspace pode chamar um serviço que tenha um terminal do TaskManager selecionando uma categoria no Workspace. Ao criar um terminal do TaskManager, você pode fazer referência a uma categoria existente ou criar programaticamente uma nova categoria.
Esta seção cria uma nova categoria como parte da adição de um terminal do TaskManager a um serviço.
Definir atributos de ponto de extremidade do TaskManager
Para criar um terminal do TaskManager para um serviço, especifique os seguintes valores:
TaskManagerConnector
.invoke
.Criar um terminal do TaskManager
Depois de definir atributos de ponto de extremidade do TaskManager, você pode criar um ponto de extremidade do TaskManager para um serviço.
Ativar o ponto final
Depois de criar um novo terminal, é necessário ativá-lo. Quando o terminal está ativado, ele pode ser usado para chamar o serviço a partir do Workspace. Depois de ativar o terminal, você pode visualização-lo no console de administração.
Consulte também:
Adicionar um terminal do TaskManager usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Adicione um terminal do TaskManager usando a API Java:
Incluir arquivos de projeto.
Inclua arquivos JAR do cliente, como adobe-livecycle-client.jar, no caminho da classe do seu projeto Java.
Crie um objeto EndpointRegistry Client.
ServiceClientFactory
que contenha propriedades de conexão.EndpointRegistryClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Crie uma categoria para o terminal.
Crie um objeto CreateEndpointCategoryInfo
usando seu construtor e transmitindo os seguintes valores:
Crie a categoria chamando o método EndpointRegistryClient
do objeto createEndpointCategory
e transmitindo o objeto CreateEndpointCategoryInfo
. Este método retorna um objeto EndpointCategory
que representa a nova categoria.
Defina os atributos do ponto de extremidade do TaskManager.
CreateEndpointInfo
usando seu construtor.CreateEndpointInfo
do objeto setConnectorId
e transmitindo o valor da string TaskManagerConnector
.CreateEndpointInfo
do objeto setDescription
e transmitindo um valor de string que descreve o ponto de extremidade.CreateEndpointInfo
do objeto setName
e transmitindo um valor de string que especifica o nome.CreateEndpointInfo
do objeto setServiceId
e transmitindo um valor de string que especifica o nome do serviço.CreateEndpointInfo
do objeto setCategoryId
e transmitindo um valor de string que especifica o valor do identificador de categoria. Você pode chamar o método EndpointCategory
do objeto getId
para obter o valor identificador dessa categoria.CreateEndpointInfo
do objeto setOperationName
e transmitindo um valor de cadeia de caracteres que especifica o nome da operação. Normalmente, ao criar um terminal TaskManager
para um serviço que tenha origem em um processo criado no Workbench, o nome da operação é invoke
.Criar um terminal do TaskManager.
Crie o ponto de extremidade chamando o método EndpointRegistryClient
do objeto createEndpoint
e transmitindo o objeto CreateEndpointInfo
. Este método retorna um objeto Endpoint
que representa o novo terminal do TaskManager.
Ative o terminal.
Ative o terminal chamando o método EndpointRegistryClient
do objeto enable
e transmitindo o objeto Endpoint
que foi retornado pelo método createEndpoint
.
Consulte também:
Início rápido: Adicionar um terminal do TaskManager usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Você pode modificar programaticamente um terminal existente usando a API Java da AEM Forms. Ao modificar um endpoint, você pode alterar o comportamento do endpoint. Considere, por exemplo, um endpoint de Pasta assistida que especifica uma pasta que é usada como a pasta assistida. Você pode modificar programaticamente os valores de configuração que pertencem ao ponto final da Pasta assistida, resultando em outra pasta funcionando como a pasta assistida. Para obter informações sobre valores de configuração que pertencem a um ponto de extremidade de Pasta assistida, consulte Adicionar pontos de extremidade de pasta monitorada.
Para demonstrar como modificar um terminal, esta seção modifica um terminal de Pasta assistida alterando a pasta que se comporta como a pasta assistida.
Não é possível modificar um terminal usando serviços da Web.
Para modificar um terminal, execute as seguintes tarefas:
EndpointRegistryClient
.Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Os seguintes arquivos JAR devem ser adicionados ao caminho de classe do seu projeto:
Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo os arquivos da biblioteca Java da AEM Forms.
Criar um objeto Cliente EndpointRegistry
Para modificar programaticamente um terminal, é necessário criar um objeto EndpointRegistryClient
.
Recuperar o ponto de extremidade para modificar
Antes de modificar um terminal, é necessário recuperá-lo. Para recuperar um terminal, é necessário conectar-se como um usuário que pode acessar um terminal. É recomendável conectar-se como administrador. (Consulte Definição das propriedades de ligação).
Você pode recuperar um terminal recuperando uma lista de pontos finais. Em seguida, você pode iterar pela lista, pesquisando o endpoint específico a ser removido. Por exemplo, você pode localizar um terminal determinando o serviço que corresponde ao terminal e o tipo de terminal. Ao localizar o terminal, é possível modificá-lo.
Especificar novos valores de configuração
Ao modificar um terminal, especifique novos valores de configuração. Por exemplo, para modificar um endpoint de Pasta assistida, redefina todos os valores de configuração de endpoint de Pasta assistida, não apenas aqueles que você deseja modificar. Para obter informações sobre valores de configuração que pertencem a um ponto de extremidade de Pasta assistida, consulte Adicionar pontos de extremidade de pasta monitorada.
Para obter informações sobre valores de configuração que pertencem a um ponto de extremidade de email, consulte Adicionando pontos de extremidade de email.
Não é possível modificar o serviço chamado pelo ponto final. Se você tentar modificar o serviço, uma exceção será lançada. Para modificar o serviço associado a um determinado terminal, remova o terminal e crie um novo. (Consulte Remoção de Pontos de Extremidade.)
Consulte também:
Modificação de um terminal usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Modifique um terminal usando a API Java:
Incluir arquivos de projeto.
Inclua arquivos JAR do cliente, como adobe-livecycle-client.jar, no caminho da classe do seu projeto Java.
Crie um objeto EndpointRegistry Client.
ServiceClientFactory
que contenha propriedades de conexão.EndpointRegistryClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Recupere o terminal para modificá-lo.
EndpointRegistryClient
do objeto getEndpoints
e transmitindo um objeto PagingFilter
que atue como filtro. Você pode passar um valor (PagingFilter)null
para retornar todos os pontos de extremidade. Este método retorna um objeto java.util.List
em que cada elemento é um objeto Endpoint
. Para obter informações sobre um objeto PagingFilter
, consulte Referência da API do AEM Forms.java.util.List
para determinar se ele tem pontos de extremidade. Se houver pontos de extremidade, cada elemento será uma instância EndPoint
.EndPoint
getServiceId
do objeto. Esse método retorna um valor de string que especifica o nome do serviço.EndPoint
do objeto getConnectorId
. Esse método retorna um valor de string que especifica o tipo de endpoint. Por exemplo, se o ponto de extremidade for um ponto de extremidade de Pasta assistida, esse método retornará WatchedFolder
.Especifique novos valores de configuração.
Crie um objeto ModifyEndpointInfo
chamando seu construtor.
Para cada valor de configuração a ser definido, chame o método ModifyEndpointInfo
do objeto setConfigParameterAsText
. Por exemplo, para definir o valor de configuração de url, chame o método ModifyEndpointInfo
do objeto setConfigParameterAsText
e passe os seguintes valores:
url
, especifique url
.url
, especifique o local da pasta monitorada.Chame o método EndpointRegistryClient
do objeto modifyEndpoint
e passe o objeto ModifyEndpointInfo
.
Consulte também:
Início rápido: Modificação de um terminal usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Você pode remover programaticamente um terminal de um serviço usando a API Java da AEM Forms. Depois de remover um terminal, o serviço não pode ser chamado usando o método de invocação que o terminal ativou. Por exemplo, se você remover um terminal SOAP de um serviço, não será possível chamar o serviço usando o modo SOAP.
Para demonstrar como remover um ponto de extremidade de um serviço, esta seção remove um ponto de extremidade EJB de um serviço chamado EncryptDocument.
Não é possível remover um terminal usando serviços da Web.
Para remover um terminal de um serviço, execute as seguintes tarefas:
EndpointRegistryClient
.Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Os seguintes arquivos JAR devem ser adicionados ao caminho de classe do seu projeto:
Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo os arquivos da biblioteca Java da AEM Forms.
Criar um objeto Cliente EndpointRegistry
Para remover programaticamente um terminal, é necessário criar um objeto EndpointRegistryClient
.
Recuperar o ponto de extremidade a ser removido
Antes de remover um terminal, é necessário recuperá-lo. Para recuperar um terminal, é necessário conectar-se como um usuário que pode acessar um terminal. É recomendável conectar-se como administrador. (Consulte Definição das propriedades de ligação).
Você pode recuperar um terminal recuperando uma lista de pontos finais. Em seguida, você pode iterar pela lista, pesquisando o endpoint específico a ser removido. Por exemplo, você pode localizar um terminal determinando o serviço que corresponde ao terminal e o tipo de terminal. Ao localizar o terminal, você pode removê-lo.
Remover o ponto final
Depois de criar um novo terminal, é necessário ativá-lo. Quando o terminal está ativado, ele pode ser usado para chamar o serviço. Depois de ativar o terminal, você pode visualização-lo no console de administração.
Consulte também:
Remoção de um terminal usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Remova um terminal usando a API Java:
Incluir arquivos de projeto.
Inclua arquivos JAR do cliente, como adobe-livecycle-client.jar, no caminho da classe do seu projeto Java.
Crie um objeto EndpointRegistry Client.
ServiceClientFactory
que contenha propriedades de conexão.EndpointRegistryClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Recupere o terminal a ser removido.
EndpointRegistryClient
do objeto getEndpoints
e transmitindo um objeto PagingFilter
que atue como filtro. Você pode enviar (PagingFilter)null
para retornar todos os pontos de extremidade. Este método retorna um objeto java.util.List
em que cada elemento é um objeto Endpoint
.java.util.List
para determinar se ele tem pontos de extremidade. Se houver pontos de extremidade, cada elemento será uma instância EndPoint
.EndPoint
getServiceId
do objeto. Esse método retorna um valor de string que especifica o nome do serviço.EndPoint
do objeto getConnectorId
. Esse método retorna um valor de string que especifica o tipo de endpoint. Por exemplo, se o endpoint for um endpoint EJB, esse método retornará EJB
.Remova o terminal.
Remova o ponto de extremidade chamando o método EndpointRegistryClient
do objeto remove
e transmitindo o objeto EndPoint
que representa o ponto de extremidade a ser removido.
Consulte também:
Início rápido: Remoção de um terminal usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Você pode recuperar programaticamente informações sobre conectores de ponto de extremidade usando a API do AEM Forms. Um conector permite que um terminal chame um serviço usando vários métodos de invocação. Por exemplo, um conector de Pasta assistida permite que um terminal chame um serviço usando pastas monitoradas. Ao recuperar informações programaticamente sobre conectores de ponto de extremidade, você pode recuperar valores de configuração associados a um conector, como quais valores de configuração são obrigatórios e quais são opcionais.
Para demonstrar como recuperar informações sobre conectores de ponto de extremidade, esta seção recupera informações sobre um conector de Pasta assistida. (Consulte Adicionando Pontos de Extremidade de Pasta Assistidos.)
Não é possível recuperar informações sobre pontos finais usando serviços da Web.
Este tópico usa a API ConnectorRegistryClient
para recuperar informações sobre conectores de ponto de extremidade. (Consulte Referência de API do AEM Forms.)
Para recuperar as informações do conector do ponto de extremidade, execute as seguintes tarefas:
ConnectorRegistryClient
.Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Os seguintes arquivos JAR devem ser adicionados ao caminho de classe do seu projeto:
Se a AEM Forms for implantada em um servidor de aplicativos J2EE compatível que não seja JBoss, substitua adobe-utilities.jar e jbossall-client.jar por arquivos JAR específicos ao servidor de aplicativos J2EE no qual a AEM Forms está implantada. Para obter informações sobre a localização de todos os arquivos AEM Forms JAR, consulte Incluindo arquivos da biblioteca AEM Forms Java.
Criar um objeto ConnectorRegistry Client
Para recuperar programaticamente as informações do conector do ponto de extremidade, crie um objeto ConnectorRegistryClient
.
Especificar o tipo de conector
Especifique o tipo de conector a partir do qual recuperar informações. Os seguintes tipos de conectores existem:
Recuperar valores de configuração
Depois de especificar o tipo de conector, você pode recuperar informações sobre o conector, como o valor de configuração suportado. Por exemplo, para qualquer conector, você pode determinar quais valores de configuração são obrigatórios e quais são opcionais.
Consulte também:
Recuperar informações do conector do ponto de extremidade usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Recupere informações do conector do ponto de extremidade usando a API Java:
Incluir arquivos de projeto. .
Inclua arquivos JAR do cliente, como adobe-livecycle-client.jar, no caminho da classe do seu projeto Java.
Crie um objeto ConnectorRegistry Client.
ServiceClientFactory
que contenha propriedades de conexão.ConnectorRegistryClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Especifique o tipo de conector.
Especifique o tipo de conector chamando o método ConnectorRegistryClient
do objeto getEndpointDefinition
e transmitindo um valor de string que especifica o tipo de conector. Por exemplo, para especificar o tipo de conector de Pasta assistida, passe o valor da string WatchedFolder
. Este método retorna um objeto Endpoint
que corresponde ao tipo de conector.
Recuperar valores de configuração.
Endpoint
getConfigParameters
do objeto. Este método retorna uma matriz de ConfigParameter
objetos.ConfigParameter
. Você pode, por exemplo, determinar se o valor de configuração é obrigatório ou opcional chamando o método ConfigParameter
do objeto isRequired
. Se o valor de configuração for necessário, esse método retornará true
.Consulte também:
Início rápido: Recuperando informações do conector do ponto de extremidade usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão