Acerca del servicio de registro de extremo
El servicio Endpoint Registry permite administrar los extremos mediante programación. Por ejemplo, puede añadir los siguientes tipos de extremos a un servicio:
EJB
SOAP
Carpeta vigilada
Correo electrónico
(obsoleto para formularios AEM) Remoting
Administrador de tareas
SOAP, EJB y (obsoleto para AEM formularios en JEE) Los extremos de reasignación se crean automáticamente para cada servicio activado. Los extremos SOAP y EJB permiten SOAP y EJB para todas las operaciones de servicio.
Un extremo Remoting permite a los clientes de Flex invocar operaciones en el servicio AEM Forms al que se agrega el extremo. Se crea un destino de Flex con el mismo nombre que el extremo y los clientes de Flex pueden crear RemoteObjects que apunten a este destino para invocar operaciones en el servicio correspondiente.
Los extremos Correo electrónico, Administrador de tareas y Carpeta vigilada exponen solo una operación específica del servicio. La adición de estos extremos requiere un segundo paso de configuración para seleccionar un método para invocar, establecer parámetros de configuración y especificar asignaciones de parámetros de entrada y salida.
Puede organizar los extremos de TaskManager en grupos llamados categories. A continuación, estas categorías se exponen a Workspace mediante TaskManager, donde los usuarios finales ven los extremos de TaskManager a medida que se clasifican. Dentro de Workspace, los usuarios finales ven estas categorías en el panel de navegación. Los extremos de cada categoría se muestran como tarjetas de proceso en la página Iniciar procesos de Workspace.
Puede realizar estas tareas mediante el servicio Endpoint Registry:
Añada puntos finales de EJB. (Consulte Adición de puntos de conexión EJB.)
Añada extremos SOAP. (Consulte Adición de puntos de conexión SOAP.)
Agregar extremos de carpeta vigilada (consulte Añadir puntos finales de carpeta vigilada.)
Añada puntos finales de correo electrónico. (Consulte Añadir puntos de conexión de correo electrónico.)
Añada los extremos de Remoting. (Consulte Adición de puntos de conexión remotos.)
Agregar extremos de TaskManager (consulte Adición de puntos de conexión de TaskManager.)
Modificación de puntos de conexión (consulte Modificación de puntos finales.)
Eliminación de extremos (consulte Eliminación de extremos.)
Recuperar información del conector del extremo (Consulte Recuperación de información del conector de extremo.)
Puede añadir mediante programación un extremo EJB a un servicio mediante la API Java de AEM Forms. Al agregar un extremo EJB a un servicio, está permitiendo que una aplicación cliente invoque el servicio mediante el modo EJB. Es decir, al configurar las propiedades de conexión necesarias para invocar AEM Forms, puede seleccionar el modo EJB. (Consulte Configuración de las propiedades de conexión.)
No se puede agregar un punto final de EJB utilizando servicios web.
Normalmente, un punto final de EJB se agrega a un servicio de forma predeterminada. Sin embargo, se puede agregar un punto final de EJB a un proceso que se implementa mediante programación o cuando se eliminó un punto final de EJB y se debe agregar de nuevo.
Para añadir un punto final de EJB a un servicio, realice las siguientes tareas:
EndpointRegistry Client
objeto.Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Los siguientes archivos JAR deben agregarse a la ruta de clase del proyecto:
Para obtener información sobre la ubicación de estos archivos JAR, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
Crear un objeto de cliente de EndpointRegistry
Antes de añadir mediante programación un extremo de EJB, debe crear un EndpointRegistryClient
objeto.
Establecer atributos de extremo de EJB
Para crear un punto final de EJB para un servicio, especifique los siguientes valores:
EJB
.*
). Sin embargo, si desea especificar una operación específica en lugar de invocar todas las operaciones de servicio, especifique el nombre de la operación en lugar de usar el carácter comodín ( *
).Crear un extremo de EJB
Después de establecer los atributos de extremo de EJB, puede crear un extremo de EJB para un servicio.
Habilitar el punto final
Después de crear un nuevo extremo, debe habilitarlo. Después de habilitar el extremo, se puede utilizar para invocar el servicio. Después de habilitar el punto final, puede verlo en la consola de administración.
Consulte también lo siguiente
Añadir un extremo EJB mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Añada un punto final de EJB mediante la API de Java:
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-livecycle-client.jar, en la ruta de clase de su proyecto Java. (
Cree un objeto de cliente EndpointRegistry.
ServiceClientFactory
objeto que contiene propiedades de conexión.EndpointRegistryClient
usando su constructor y pasando el ServiceClientFactory
objeto.Establezca los atributos de extremo de EJB.
CreateEndpointInfo
usando su constructor.CreateEndpointInfo
del objeto setConnectorId
método y pasar el valor de cadena EJB
.CreateEndpointInfo
del objeto setDescription
y pasando un valor de cadena que describe el punto final.CreateEndpointInfo
del objeto setName
y pasando un valor de cadena que especifica el nombre.CreateEndpointInfo
del objeto setServiceId
y pasando un valor de cadena que especifica el nombre del servicio.CreateEndpointInfo
del objeto setOperationName
y pase un valor de cadena que especifique el nombre de la operación. Para los extremos SOAP y EJB, especifique un carácter comodín ( *
), lo que implica todas las operaciones.Cree un punto final de EJB.
Cree el punto final invocando la variable EndpointRegistryClient
del objeto createEndpoint
y pasando el CreateEndpointInfo
objeto. Este método devuelve un Endpoint
que representa el nuevo punto final de EJB.
Habilite el punto final.
Habilitar el extremo invocando el EndpointRegistryClient
método enable del objeto y pasar el Endpoint
objeto devuelto por el createEndpoint
método.
Consulte también lo siguiente
Inicio rápido: Añadir un extremo EJB mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Puede añadir mediante programación un extremo SOAP a un servicio mediante la API Java de AEM Forms. Al agregar un extremo SOAP, se habilita una aplicación cliente para que invoque el servicio mediante el modo SOAP. Es decir, al configurar las propiedades de conexión necesarias para invocar AEM Forms, puede seleccionar el modo SOAP.
No se puede agregar un extremo SOAP utilizando servicios web.
Normalmente, un extremo SOAP se agrega a un servicio de forma predeterminada. Sin embargo, se puede agregar un extremo SOAP a un proceso que se implementa mediante programación o cuando se elimina un extremo SOAP y se tiene que agregar de nuevo.
Para agregar un extremo SOAP a un servicio, realice las siguientes tareas:
EndpointRegistryClient
objeto.Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Los siguientes archivos JAR deben agregarse a la ruta de clase del proyecto:
Estos archivos JAR son necesarios para crear un extremo SOAP. Sin embargo, se requieren archivos JAR adicionales si se utiliza el extremo SOAP para invocar el servicio. Para obtener información sobre los archivos JAR de AEM Forms, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
Crear un objeto de cliente de EndpointRegistry
Para agregar mediante programación un extremo SOAP a un servicio, debe crear un EndpointRegistryClient
objeto.
Establecer atributos de extremo SOAP
Para agregar un extremo SOAP a un servicio, especifique los siguientes valores:
SOAP
.*
). Sin embargo, si desea especificar una operación específica en lugar de invocar todas las operaciones de servicio, especifique el nombre de la operación en lugar de usar el carácter comodín ( *
).Crear un extremo SOAP
Después de establecer los atributos de extremo SOAP, puede crear un extremo SOAP.
Habilitar el punto final
Después de crear un nuevo extremo, debe habilitarlo. Cuando el extremo está habilitado, se puede utilizar para invocar el servicio. Después de habilitar el punto final, puede verlo en la consola de administración.
Consulte también lo siguiente
Añadir un extremo SOAP mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Agregue un extremo SOAP a un servicio mediante la API de Java:
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-livecycle-client.jar, en la ruta de clase de su proyecto Java.
Cree un objeto de cliente EndpointRegistry.
ServiceClientFactory
objeto que contiene propiedades de conexión.EndpointRegistryClient
usando su constructor y pasando el ServiceClientFactory
objeto.Establezca los atributos de extremo SOAP.
CreateEndpointInfo
usando su constructor.CreateEndpointInfo
del objeto setConnectorId
método y pasar el valor de cadena SOAP
.CreateEndpointInfo
del objeto setDescription
y pasando un valor de cadena que describe el punto final.CreateEndpointInfo
del objeto setName
y pasando un valor de cadena que especifica el nombre.CreateEndpointInfo
del objeto setServiceId
y pasando un valor de cadena que especifica el nombre del servicio.CreateEndpointInfo
del objeto setOperationName
y pasando un valor de cadena que especifica el nombre de la operación. Para los extremos SOAP y EJB, especifique un carácter comodín ( *
), lo que implica todas las operaciones.Cree un extremo SOAP.
Cree el punto final invocando la variable EndpointRegistryClient
del objeto createEndpoint
y pasando el CreateEndpointInfo
objeto. Este método devuelve un Endpoint
que representa el nuevo extremo SOAP.
Habilite el punto final.
Habilitar el extremo invocando el EndpointRegistryClient
método enable del objeto y pase el Endpoint
objeto devuelto por el createEndpoint
método.
Consulte también lo siguiente
Inicio rápido: Añadir un extremo SOAP mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Puede agregar mediante programación un extremo de carpeta vigilada a un servicio mediante la API Java de AEM Forms. Al agregar un extremo de carpeta vigilada, se permite a los usuarios colocar un archivo (como un archivo PDF) en una carpeta. Cuando el archivo se coloca en la carpeta , se invoca el servicio configurado y se manipula el archivo. Una vez que el servicio realiza la operación especificada, guarda el archivo modificado en una carpeta de salida especificada. Una carpeta vista está configurada para analizarse con un intervalo de velocidad fijo o con un programa cron, como todos los lunes, miércoles y viernes al mediodía.
Para añadir mediante programación un extremo de carpeta vigilada a un servicio, tenga en cuenta el siguiente proceso de corta duración denominado EncryptDocument. (Consulte Explicación de los procesos de AEM Forms.)
Este proceso acepta un documento de PDF no protegido como valor de entrada y, a continuación, pasa el documento de PDF no protegido al EncryptPDFUsingPassword
operación. El documento del PDF está cifrado con una contraseña y el documento del PDF cifrado con contraseña es el valor de salida de este proceso. El nombre del valor de entrada (el documento PDF no protegido) es InDoc
y el tipo de datos es com.adobe.idp.Document
. El nombre del valor de salida (el documento de PDF cifrado con contraseña) es SecuredDoc
y el tipo de datos es com.adobe.idp.Document
.
No se puede agregar un extremo de carpeta vigilada mediante servicios web.
Para agregar un extremo de carpeta vigilada a un servicio, realice las siguientes tareas:
EndpointRegistryClient
objeto.Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Los siguientes archivos JAR deben agregarse a la ruta de clase del proyecto:
Para obtener información sobre la ubicación de estos archivos JAR, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
Crear un objeto de cliente de EndpointRegistry
Para agregar mediante programación un extremo de carpeta vigilada, debe crear un EndpointRegistryClient
objeto.
Establecer atributos de extremo de carpeta vigilada
Para crear un extremo de carpeta vigilada para un servicio, especifique los siguientes valores:
WatchedFolder
.EncryptDocument
.invoke
.Especificar valores de configuración
Debe especificar valores de configuración para un extremo de carpeta vigilada al agregar mediante programación un extremo de carpeta vigilada a un servicio. Un administrador especifica estos valores de configuración si se agrega un extremo de carpeta vigilada mediante la consola de administración.
La siguiente lista especifica los valores de configuración que se establecen al agregar mediante programación un extremo de carpeta vigilada a un servicio:
data*
, todos los archivos y carpetas que coinciden con data*
no se recogen. Esto incluye archivos y carpetas con nombre data1
, data2
, etc. Además, el patrón se puede complementar con patrones comodín para especificar patrones de archivo. La carpeta vigilada modifica la expresión regular para admitir patrones comodín como *.*
y *.pdf
. Estas expresiones regulares no admiten estos patrones comodín.*
, todos los archivos y carpetas que coinciden con input*
son recogidos. Esto incluye archivos y carpetas con nombre input1
, input2
, etc. El valor predeterminado es *
. Este valor indica todos los archivos y carpetas. Además, el patrón se puede complementar con patrones comodín para especificar patrones de archivo. La carpeta vigilada modifica la expresión regular para admitir patrones comodín como *.*
y *.pdf
. Estas expresiones regulares no admiten estos patrones comodín. Este valor es obligatorio.result/%Y/%M/%D/
. Esta es la carpeta de resultados dentro de la carpeta vigilada.preserve/%Y/%M/%D/
.failure/%Y/%M/%D/
.Definir valores de parámetros de entrada
Al crear un extremo de carpeta vigilada, debe definir los valores de parámetro de entrada. Es decir, debe describir los valores de entrada que se pasan a la operación que invoca la carpeta vigilada. Por ejemplo, considere el proceso introducido en este tema. Tiene un valor de entrada denominado InDoc
y su tipo de datos es com.adobe.idp.Document
. Al crear un extremo de carpeta vigilada para este proceso (después de activar un proceso, se convierte en un servicio), debe definir el valor del parámetro de entrada.
Para definir los valores de parámetro de entrada necesarios para un extremo de carpeta vigilada, especifique los siguientes valores:
Nombre del parámetro de entrada: Nombre del parámetro de entrada. El nombre de un valor de entrada se especifica en Workbench para un proceso. Si el valor de entrada pertenece a una operación de servicio (un servicio que no es un proceso creado en Workbench), el nombre de entrada se especifica en el archivo component.xml. Por ejemplo, el nombre del parámetro de entrada para el proceso introducido en esta sección es InDoc
.
Tipo de asignación: Se utiliza para configurar los valores de entrada necesarios para invocar la operación de servicio. Existen dos tipos de asignación:
Literal
: El extremo Carpeta vigilada utiliza el valor introducido en el campo tal como se muestra. Se admiten todos los tipos de Java básicos. Por ejemplo, si una API utiliza entradas como String, long, int y Boolean, la cadena se convierte al tipo adecuado y se invoca el servicio.Variable
: El valor introducido es un patrón de archivo que la carpeta vigilada utiliza para seleccionar la entrada. Por ejemplo, si selecciona Variable para el tipo de asignación y el documento de entrada debe ser un archivo PDF, puede especificar *.pdf
como valor de asignación.Valor de asignación: Especifica el valor del tipo de asignación. Por ejemplo, si selecciona un Variable
tipo de asignación, puede especificar *.pdf
como patrón de archivo.
Tipo de datos: Especifica el tipo de datos de los valores de entrada. Por ejemplo, el tipo de datos del valor de entrada del proceso introducido en esta sección es com.adobe.idp.Document
.
Definición de un valor de parámetro de salida
Al crear un extremo de carpeta vigilada, debe definir un valor de parámetro de salida. Es decir, debe describir el valor de salida que devuelve el servicio que invoca el extremo de la carpeta vigilada. Por ejemplo, considere el proceso introducido en este tema. Tiene un valor de salida denominado SecuredDoc
y su tipo de datos es com.adobe.idp.Document
. Al crear un extremo de carpeta vigilada para este proceso (después de activar un proceso, se convierte en un servicio), debe definir el valor del parámetro de salida.
Para definir un valor de parámetro de salida requerido para un extremo de carpeta vigilada, especifique los siguientes valores:
Nombre del parámetro de salida: Nombre del parámetro de salida. El nombre de un valor de salida de proceso se especifica en Workbench. Si el valor de salida pertenece a una operación de servicio (un servicio que no es un proceso creado en Workbench), el nombre de salida se especifica en el archivo component.xml. Por ejemplo, el nombre del parámetro de salida para el proceso introducido en esta sección es SecuredDoc
.
Tipo de asignación: Se utiliza para configurar la salida del servicio y la operación. Las opciones disponibles son las siguientes:
%F.pdf
y el destino de origen es sourcefilename.pdf. Por ejemplo, el proceso introducido en esta sección devuelve un solo documento. Como resultado, el tipo de asignación se puede definir como %F.pdf
( %F
significa utilizar el nombre de archivo dado). El patrón %E
especifica la extensión del documento de entrada.Result\%F\
y el destino de origen es Result\sourcefilename\source1 (output 1) y Result\sourcefilename\source2 (output 2).Result\%F\
y el destino de origen es Result\sourcefilename\file1 y Result\sourcefilename\file2. Si el mapa tiene más de un objeto, el patrón es Result\%F.pdf
y el destino de origen es Result\sourcefilename1.pdf (output 1), Result\sourcefilenam2.pdf (output 2), etc.Tipo de datos: Especifica el tipo de datos del valor devuelto. Por ejemplo, el tipo de datos del valor devuelto del proceso introducido en esta sección es com.adobe.idp.Document
.
Crear un extremo de carpeta vigilada
Después de establecer los atributos del extremo, los valores de configuración y definir los valores de los parámetros de entrada y salida, debe crear el extremo de la carpeta vigilada.
Habilitar el punto final
Después de crear un extremo de carpeta vigilada, debe habilitarlo. Cuando el extremo está habilitado, se puede utilizar para invocar el servicio. Después de habilitar el punto final, puede verlo en la consola de administración.
Consulte también lo siguiente
Añadir un extremo de carpeta vigilada mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Agregue un extremo de carpeta vigilada mediante la API Java de AEM Forms:
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-livecycle-client.jar, en la ruta de clase de su proyecto Java.
Cree un objeto de cliente EndpointRegistry.
ServiceClientFactory
objeto que contiene propiedades de conexión.EndpointRegistryClient
usando su constructor y pasando el ServiceClientFactory
objeto.Establezca los atributos de extremo de la carpeta vigilada.
CreateEndpointInfo
usando su constructor.CreateEndpointInfo
del objeto setConnectorId
método y pasar el valor de cadena WatchedFolder
.CreateEndpointInfo
del objeto setDescription
y pasando un valor de cadena que describe el punto final.CreateEndpointInfo
del objeto setName
y pasando un valor de cadena que especifica el nombre.CreateEndpointInfo
del objeto setServiceId
y pasando un valor de cadena que especifica el nombre del servicio.CreateEndpointInfo
del objeto setOperationName
y pasando un valor de cadena que especifica el nombre de la operación. Normalmente, al crear un extremo de carpeta vigilada para un servicio originado en un proceso creado en Workbench, se invoca el nombre de la operación.Especifique los valores de configuración.
Para que cada valor de configuración se establezca para el extremo de la carpeta vigilada, debe invocar la variable CreateEndpointInfo
del objeto setConfigParameterAsText
método. Por ejemplo, para configurar la variable url
valor de configuración, invoque la variable CreateEndpointInfo
del objeto setConfigParameterAsText
y pase los siguientes valores de cadena:
url
valor de configuración, especifique url
.url
, especifique la ubicación de la carpeta vigilada.Para ver todos los valores de configuración establecidos para el servicio EncryptDocument, consulte el ejemplo de código Java ubicado en Inicio rápido: Añadir un extremo de carpeta vigilada mediante la API de Java.
Defina los valores de parámetro de entrada.
Defina un valor de parámetro de entrada invocando la variable CreateEndpointInfo
del objeto setInputParameterMapping
y pase los siguientes valores:
InDoc
.InDoc
el parámetro de entrada es com.adobe.idp.Document
.variable
.Invocar el setInputParameterMapping
para cada valor de parámetro de entrada que se va a definir. Dado que el proceso EncryptDocument solo tiene un parámetro de entrada, debe invocar este método una vez.
Defina un valor de parámetro de salida.
Defina un valor de parámetro de salida invocando la variable CreateEndpointInfo
del objeto setOutputParameterMapping
y pase los siguientes valores:
SecuredDoc
.SecuredDoc
el parámetro de salida es com.adobe.idp.Document
.%F.pdf
.Cree un extremo de carpeta vigilada.
Cree el punto final invocando la variable EndpointRegistryClient
del objeto createEndpoint
y pasando el CreateEndpointInfo
objeto. Este método devuelve un Endpoint
que representa el extremo de la carpeta vigilada.
Habilite el punto final.
Habilitar el extremo invocando el EndpointRegistryClient
del objeto enable
y pasando el Endpoint
objeto devuelto por el createEndpoint
método.
Consulte también lo siguiente
Inicio rápido: Añadir un extremo de carpeta vigilada mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
La variable Inicio rápido: Añadir un extremo de carpeta vigilada mediante la API de Java utiliza un archivo constante que debe formar parte del proyecto Java para compilar el inicio rápido. Este archivo constante representa los valores de configuración que deben establecerse al agregar un extremo de carpeta vigilada. El siguiente código Java representa el archivo 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";
}
Puede añadir mediante programación un extremo de correo electrónico a un servicio mediante la API Java de AEM Forms. Al añadir un extremo de correo electrónico, se permite a los usuarios enviar un mensaje de correo electrónico con uno o más archivos adjuntos a una cuenta de correo electrónico especificada. A continuación, se invoca la operación configurar servicio y manipula los archivos. Una vez que el servicio realiza la operación especificada, envía un mensaje de correo electrónico al remitente con los archivos modificados como archivos adjuntos.
Para añadir mediante programación un extremo de correo electrónico a un servicio, tenga en cuenta el siguiente proceso breve denominado MyApplication\EncryptDocument. Para obtener información sobre los procesos de corta duración, consulte Explicación de los procesos de AEM Forms.
Este proceso acepta un documento de PDF no protegido como valor de entrada y, a continuación, pasa el documento de PDF no protegido al EncryptPDFUsingPassword
operación. Este proceso cifra el documento del PDF con una contraseña y devuelve el documento del PDF cifrado con contraseña como valor de salida. El nombre del valor de entrada (el documento PDF no protegido) es InDoc
y el tipo de datos es com.adobe.idp.Document
. El nombre del valor de salida (el documento de PDF cifrado con contraseña) es SecuredDoc
y el tipo de datos es com.adobe.idp.Document
.
No puede agregar un extremo de correo electrónico mediante servicios web.
Para añadir un extremo de correo electrónico a un servicio, realice las siguientes tareas:
EndpointRegistryClient
objeto.Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Los siguientes archivos JAR deben agregarse a la ruta de clase del proyecto:
Para obtener información sobre la ubicación de estos archivos JAR, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
Crear un objeto de cliente de EndpointRegistry
Para poder agregar mediante programación un extremo de correo electrónico, debe crear un EndpointRegistryClient
objeto.
Establecer atributos de extremo de correo electrónico
Para crear un extremo de correo electrónico para un servicio, especifique los siguientes valores:
Email
.EncryptDocument
.invoke
.Especificar valores de configuración
Debe especificar valores de configuración para un extremo de correo electrónico al agregar mediante programación un extremo de correo electrónico a un servicio. Un administrador especifica estos valores de configuración si se agrega un extremo de correo electrónico mediante la consola de administración.
La cuenta de correo electrónico que se supervisa es una cuenta especial que se utiliza solo para el extremo de correo electrónico . Esta cuenta no es una cuenta de correo electrónico de un usuario normal. La cuenta de correo electrónico de un usuario normal no debe configurarse como la cuenta que utiliza el proveedor de correo electrónico porque este elimina los mensajes de correo electrónico de la bandeja de entrada una vez que han finalizado con los mensajes.
Los siguientes valores de configuración se establecen al agregar mediante programación un extremo de correo electrónico a un servicio:
SuperAdmin
.DefaultDom
.adobe.com
se utiliza, solo se procesa el correo electrónico de adobe.com y se ignora el correo electrónico de otros dominios.*
.sender
, los resultados de correo electrónico se envían al remitente. Se admiten hasta 100 destinatarios. Especifique destinatarios adicionales con direcciones de correo electrónico, cada uno separado por una coma. Para desactivar esta opción, deje este valor en blanco. En algunos casos, es posible que desee almacenar en déclencheur un proceso y no desee que se le notifique por correo electrónico el resultado. El valor predeterminado es sender
.sender
, los resultados de correo electrónico se envían al remitente. Se admiten hasta 100 destinatarios. Especifique destinatarios adicionales con direcciones de correo electrónico, cada uno separado por una coma. Para desactivar esta opción, deje este valor en blanco. El valor predeterminado es sender
.IMAP
o POP3
. El servidor de correo de host de la bandeja de entrada debe admitir estos protocolos.UTF-8
.Definir valores de parámetros de entrada
Al crear un extremo de correo electrónico, debe definir los valores de parámetro de entrada. Es decir, debe describir los valores de entrada que se pasan a la operación que invoca el extremo de correo electrónico. Por ejemplo, considere el proceso introducido en este tema. Tiene un valor de entrada denominado InDoc
y su tipo de datos es com.adobe.idp.Document
. Al crear un extremo de correo electrónico para este proceso (después de activar un proceso, se convierte en un servicio), debe definir el valor del parámetro de entrada.
Para definir los valores de parámetro de entrada necesarios para un extremo de correo electrónico, especifique los siguientes valores:
Nombre del parámetro de entrada: Nombre del parámetro de entrada. El nombre de un valor de entrada se especifica en Workbench para un proceso. Si el valor de entrada pertenece a una operación de servicio (un servicio de Forms que no es un proceso creado en Workbench), el nombre de entrada se especifica en el archivo component.xml. Por ejemplo, el nombre del parámetro de entrada para el proceso introducido en esta sección es InDoc
.
Tipo de asignación: Se utiliza para configurar los valores de entrada necesarios para invocar la operación de servicio. Dos tipos de asignación son los siguientes:
Literal
: El extremo Email utiliza el valor introducido en el campo como se muestra. Se admiten todos los tipos de Java básicos. Por ejemplo, si una API utiliza entradas como String, long, int y Boolean, la cadena se convierte al tipo adecuado y se invoca el servicio.Variable
: El valor introducido es un patrón de archivo que el extremo Email utiliza para elegir la entrada. Por ejemplo, si selecciona Variable para el tipo de asignación y el documento de entrada debe ser un archivo PDF, puede especificar *.pdf
como valor de asignación.Valor de asignación: Especifica el valor del tipo de asignación. Por ejemplo, si selecciona un tipo de asignación Variable , puede especificar *.pdf
como patrón de archivo.
Tipo de datos: Especifica el tipo de datos de los valores de entrada. Por ejemplo, el tipo de datos del valor de entrada del proceso introducido en esta sección es com.adobe.idp.Document.
Definición de un valor de parámetro de salida
Al crear un extremo de correo electrónico, debe definir un valor de parámetro de salida. Es decir, debe describir el valor de salida que devuelve el servicio que invoca el extremo de correo electrónico. Por ejemplo, considere el proceso introducido en este tema. Tiene un valor de salida denominado SecuredDoc
y su tipo de datos es com.adobe.idp.Document
. Al crear un extremo de correo electrónico para este proceso (después de activar un proceso, se convierte en un servicio), debe definir el valor del parámetro de salida.
Para definir un valor de parámetro de salida requerido para un extremo de correo electrónico, especifique los siguientes valores:
Nombre del parámetro de salida: Nombre del parámetro de salida. El nombre de un valor de salida de proceso se especifica en Workbench. Si el valor de salida pertenece a una operación de servicio (un servicio que no es un proceso creado en Workbench), el nombre de salida se especifica en el archivo component.xml. Por ejemplo, el nombre del parámetro de salida para el proceso introducido en esta sección es SecuredDoc
.
Tipo de asignación: Se utiliza para configurar la salida del servicio y la operación. Las opciones disponibles son las siguientes:
%F.pdf
y el destino de origen es sourcefilename.pdf. Por ejemplo, el proceso introducido en esta sección devuelve un solo documento. Como resultado, el tipo de asignación se puede definir como %F.pdf
( %F
significa utilizar el nombre de archivo dado). El patrón %E
especifica la extensión del documento de entrada.Result\%F\
y el destino de origen es Result\sourcefilename\source1 (output 1) y Result\sourcefilename\source2 (output 2).Result\%F\
y el destino de origen es Result\sourcefilename\file1 y Result\sourcefilename\file2. Si el mapa tiene más de un objeto, el patrón es Result\%F.pdf
y el destino de origen es Result\sourcefilename1.pdf (output 1), Result\sourcefilenam2.pdf (output 2), etc.Tipo de datos: Especifica el tipo de datos del valor devuelto. Por ejemplo, el tipo de datos del valor devuelto del proceso introducido en esta sección es com.adobe.idp.Document
.
Crear el extremo de correo electrónico
Después de establecer los atributos de extremo de correo electrónico y los valores de configuración, y definir los valores de parámetro de entrada y salida, debe crear el extremo de correo electrónico.
Habilitar el punto final
Después de crear un extremo de correo electrónico, debe habilitarlo. Cuando el extremo está habilitado, se puede utilizar para invocar el servicio. Después de habilitar el punto final, puede verlo en la consola de administración.
Consulte también lo siguiente
Añadir un extremo de correo electrónico mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Añada un extremo de correo electrónico mediante la API de Java:
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-livecycle-client.jar, en la ruta de clase de su proyecto Java.
Cree un objeto de cliente EndpointRegistry.
ServiceClientFactory
objeto que contiene propiedades de conexión.EndpointRegistryClient
usando su constructor y pasando el ServiceClientFactory
objeto.Establezca los atributos de extremo del correo electrónico.
CreateEndpointInfo
usando su constructor.CreateEndpointInfo
del objeto setConnectorId
método y pasar el valor de cadena Email
.CreateEndpointInfo
del objeto setDescription
y pasando un valor de cadena que describe el punto final.CreateEndpointInfo
del objeto setName
y pasando un valor de cadena que especifica el nombre.CreateEndpointInfo
del objeto setServiceId
y pasando un valor de cadena que especifica el nombre del servicio.CreateEndpointInfo
del objeto setOperationName
y pasando un valor de cadena que especifica el nombre de la operación. Normalmente, al crear un extremo de correo electrónico para un servicio originado en un proceso creado en Workbench, se invoca el nombre de la operación.Especifique los valores de configuración.
Para cada valor de configuración que se establezca para el extremo de correo electrónico, debe invocar la variable CreateEndpointInfo
del objeto setConfigParameterAsText
método. Por ejemplo, para configurar la variable smtpHost
valor de configuración, invoque la variable CreateEndpointInfo
del objeto setConfigParameterAsText
y pase los siguientes valores:
smtpHost
valor de configuración, especifique smtpHost
.smtpHost
, especifique un valor de cadena que especifique el nombre del servidor SMTP.Para ver todos los valores de configuración establecidos para el servicio EncryptDocument introducidos en esta sección, consulte el ejemplo de código Java ubicado en Inicio rápido: Añadir un extremo de correo electrónico mediante la API de Java.
Defina los valores de parámetro de entrada.
Defina un valor de parámetro de entrada invocando la variable CreateEndpointInfo
del objeto setInputParameterMapping
y pase los siguientes valores:
InDoc
.InDoc
el parámetro de entrada es com.adobe.idp.Document
.variable
.Invocar el setInputParameterMapping
para cada valor de parámetro de entrada que se va a definir. Dado que el proceso EncryptDocument solo tiene un parámetro de entrada, debe invocar este método una vez.
Defina un valor de parámetro de salida.
Defina un valor de parámetro de salida invocando la variable CreateEndpointInfo
del objeto setOutputParameterMapping
y pasando los siguientes valores:
SecuredDoc
.SecuredDoc
el parámetro de salida es com.adobe.idp.Document
.%F.pdf
.Cree el extremo de correo electrónico.
Cree el punto final invocando la variable EndpointRegistryClient
del objeto createEndpoint
y pasando el CreateEndpointInfo
objeto. Este método devuelve un Endpoint
que representa el extremo de correo electrónico.
Habilite el punto final.
Habilitar el extremo invocando el EndpointRegistryClient
del objeto enable
y pasando el Endpoint
objeto devuelto por el createEndpoint
método.
Consulte también lo siguiente
Inicio rápido: Añadir un extremo de carpeta vigilada mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
La variable Inicio rápido: Añadir un extremo de correo electrónico mediante la API de Java utiliza un archivo constante que debe formar parte del proyecto Java para compilar el inicio rápido. Este archivo constante representa los valores de configuración que deben establecerse al agregar un extremo de correo electrónico. El siguiente código Java representa el archivo 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";
}
API de LiveCycle Remoting obsoletas para AEM formularios en JEE.
Puede agregar mediante programación un extremo Remoting a un servicio mediante la API Java de AEM Forms. Al agregar un extremo Remoting, está permitiendo que una aplicación de Flex invoque el servicio mediante remoting. (Consulte Invocación de AEM Forms mediante AEM Forms Remoting (obsoleto para formularios AEM).)
Para añadir mediante programación un extremo Remoting a un servicio, tenga en cuenta el siguiente proceso de corta duración denominado EncryptDocument.
Este proceso acepta un documento de PDF no protegido como valor de entrada y, a continuación, pasa el documento de PDF no protegido al EncryptPDFUsingPassword
operación. El documento del PDF está cifrado con una contraseña y el documento del PDF cifrado con contraseña es el valor de salida de este proceso. El nombre del valor de entrada (el documento PDF no protegido) es InDoc
y el tipo de datos es com.adobe.idp.Document
. El nombre del valor de salida (el documento de PDF cifrado con contraseña) es SecuredDoc
y el tipo de datos es com.adobe.idp.Document
.
Para demostrar cómo agregar un extremo Remoting a un servicio, esta sección agrega un extremo Remoting a un servicio llamado EncryptDocument.
No se puede agregar un extremo Remoting mediante servicios web.
Para eliminar un punto final de un servicio, realice las siguientes tareas:
EndpointRegistryClient
objeto.Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Los siguientes archivos JAR deben agregarse a la ruta de clase del proyecto:
Para obtener información sobre la ubicación de estos archivos JAR, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
Crear un objeto de cliente de EndpointRegistry
Para agregar mediante programación un extremo Remoting, debe crear un EndpointRegistryClient
objeto.
Establecer atributos de extremo de Remoting
Para crear un extremo Remoting para un servicio, especifique los siguientes valores:
Remoting
.EncryptDocument
.Crear un extremo remoto
Después de establecer los atributos de extremo Remoting, puede crear un extremo Remoting para un servicio.
Habilitar el punto final
Después de crear un nuevo extremo, debe habilitarlo. Cuando un extremo Remoting está habilitado, permite que un cliente de Flex invoque el servicio.
Consulte también lo siguiente
Añadir un extremo de Remoting mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Añada un punto final de Remoting utilizando la API de Java:
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-livecycle-client.jar, en la ruta de clase de su proyecto Java.
Cree un objeto de cliente EndpointRegistry.
ServiceClientFactory
objeto que contiene propiedades de conexión.EndpointRegistryClient
usando su constructor y pasando el ServiceClientFactory
objeto.Establezca los atributos de extremo de Remoting.
CreateEndpointInfo
usando su constructor.CreateEndpointInfo
del objeto setConnectorId
método y pasar el valor de cadena Remoting
.CreateEndpointInfo
del objeto setDescription
y pasando un valor de cadena que describe el punto final.CreateEndpointInfo
del objeto setName
y pasando un valor de cadena que especifica el nombre.CreateEndpointInfo
del objeto setServiceId
y pasando un valor de cadena que especifica el nombre del servicio.CreateEndpointInfo
del objeto setOperationName
y pasando un valor de cadena que especifica el nombre de la operación. Para un extremo Remoting, especifique un carácter comodín (*).Cree un extremo Remoting.
Cree el punto final invocando la variable EndpointRegistryClient
del objeto createEndpoint
y pasando el CreateEndpointInfo
objeto. Este método devuelve un Endpoint
que representa el nuevo extremo Remoting.
Habilite el punto final.
Habilitar el extremo invocando el EndpointRegistryClient
del objeto enable
y pasando el Endpoint
objeto devuelto por el createEndpoint
método.
Consulte también lo siguiente
Inicio rápido: Adición de un extremo de Remoting mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Puede agregar mediante programación un extremo de TaskManager a un servicio mediante la API Java de AEM Forms. Al agregar un extremo de TaskManager a un servicio, se habilita un usuario de Workspace para que invoque el servicio. Es decir, un usuario que trabaja en Workspace puede invocar un proceso que tiene un extremo TaskManager correspondiente.
No se puede agregar un extremo de TaskManager mediante servicios web.
Para agregar un extremo de TaskManager a un servicio, realice las siguientes tareas:
EndpointRegistryClient
objeto.Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Los siguientes archivos JAR deben agregarse a la ruta de clase del proyecto:
Para obtener información sobre la ubicación de estos archivos JAR, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
Crear un objeto de cliente de EndpointRegistry
Para poder agregar mediante programación un extremo de TaskManager, debe crear un EndpointRegistryClient
objeto.
Crear una categoría para el extremo
Las categorías se utilizan para organizar servicios dentro de Workspace. Es decir, un usuario de Workspace puede invocar un servicio que tiene un extremo de TaskManager seleccionando una categoría dentro de Workspace. Al crear un extremo de TaskManager, puede hacer referencia a una categoría existente o crear mediante programación una nueva categoría.
Esta sección crea una nueva categoría como parte de la adición de un extremo de TaskManager a un servicio.
Establecer atributos de extremo de TaskManager
Para crear un extremo de TaskManager para un servicio, especifique los siguientes valores:
TaskManagerConnector
.invoke
.Crear un extremo de TaskManager
Después de establecer los atributos de extremo de TaskManager, puede crear un extremo de TaskManager para un servicio.
Habilitar el punto final
Después de crear un nuevo extremo, debe habilitarlo. Cuando el punto final está habilitado, se puede utilizar para invocar el servicio desde Workspace. Después de habilitar el punto final, puede verlo en la consola de administración.
Consulte también lo siguiente
Añadir un extremo de TaskManager mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Agregue un extremo de TaskManager usando la API de Java:
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-livecycle-client.jar, en la ruta de clase de su proyecto Java.
Cree un objeto de cliente EndpointRegistry.
ServiceClientFactory
objeto que contiene propiedades de conexión.EndpointRegistryClient
usando su constructor y pasando el ServiceClientFactory
objeto.Cree una categoría para el extremo.
Cree un CreateEndpointCategoryInfo
usando su constructor y pasando los siguientes valores:
Cree la categoría invocando la variable EndpointRegistryClient
del objeto createEndpointCategory
y pasando el CreateEndpointCategoryInfo
objeto. Este método devuelve un EndpointCategory
objeto que representa la nueva categoría.
Establezca los atributos de extremo de TaskManager.
CreateEndpointInfo
usando su constructor.CreateEndpointInfo
del objeto setConnectorId
método y pasar el valor de cadena TaskManagerConnector
.CreateEndpointInfo
del objeto setDescription
y pasando un valor de cadena que describe el punto final.CreateEndpointInfo
del objeto setName
y pasando un valor de cadena que especifica el nombre.CreateEndpointInfo
del objeto setServiceId
y pasando un valor de cadena que especifica el nombre del servicio.CreateEndpointInfo
del objeto setCategoryId
y pasando un valor de cadena que especifica el valor del identificador de categoría. Puede invocar la variable EndpointCategory
del objeto getId
para obtener el valor de identificador de esta categoría.CreateEndpointInfo
del objeto setOperationName
y pasando un valor de cadena que especifica el nombre de la operación. Normalmente, al crear un TaskManager
para un servicio que se originó en un proceso creado en Workbench, el nombre de la operación es invoke
.Cree un extremo de TaskManager.
Cree el punto final invocando la variable EndpointRegistryClient
del objeto createEndpoint
y pasando el CreateEndpointInfo
objeto. Este método devuelve un Endpoint
que representa el nuevo extremo de TaskManager.
Habilite el punto final.
Habilitar el extremo invocando el EndpointRegistryClient
del objeto enable
y pasando el Endpoint
objeto devuelto por el createEndpoint
método.
Consulte también lo siguiente
Inicio rápido: Añadir un extremo de TaskManager mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Puede modificar mediante programación un extremo existente mediante la API Java de AEM Forms. Si modifica un punto final, puede cambiar el comportamiento del punto final. Considere, por ejemplo, un punto final de Carpeta vigilada que especifica una carpeta que se utiliza como carpeta vigilada. Puede modificar mediante programación los valores de configuración que pertenecen al extremo de la carpeta vigilada, lo que hace que otra carpeta funcione como la carpeta vigilada. Para obtener información sobre los valores de configuración que pertenecen a un extremo de carpeta vigilada, consulte Añadir puntos finales de carpeta vigilada.
Para demostrar cómo modificar un punto final, esta sección modifica un punto final de Carpeta vigilada al cambiar la carpeta que se comporta como la carpeta vigilada.
No se puede modificar un punto final mediante servicios web.
Para modificar un punto final, realice las siguientes tareas:
EndpointRegistryClient
objeto.Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Los siguientes archivos JAR deben agregarse a la ruta de clase del proyecto:
Para obtener información sobre la ubicación de estos archivos JAR, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
Crear un objeto de cliente de EndpointRegistry
Para modificar un extremo mediante programación, debe crear un EndpointRegistryClient
objeto.
Recupere el punto final para modificar
Para poder modificar un punto final, debe recuperarlo. Para recuperar un punto final, debe conectarse como usuario que puede acceder a un punto final. Se recomienda conectarse como administrador. (Consulte Configuración de las propiedades de conexión).
Puede recuperar un punto final recuperando una lista de puntos finales. A continuación, puede iterar a través de la lista, buscando el punto final específico que desea eliminar. Por ejemplo, puede localizar un punto final determinando el servicio que corresponde al punto final y el tipo de punto final. Cuando localice el punto final, puede modificarlo.
Especificar nuevos valores de configuración
Al modificar un extremo, especifique nuevos valores de configuración. Por ejemplo, para modificar un extremo de carpeta vigilada, restablezca todos los valores de configuración de extremo de carpeta vigilada, no solo los que desea modificar. Para obtener información sobre los valores de configuración que pertenecen a un extremo de carpeta vigilada, consulte Añadir puntos finales de carpeta vigilada.
Para obtener información sobre los valores de configuración que pertenecen a un extremo de correo electrónico, consulte Añadir puntos de conexión de correo electrónico.
No puede modificar el servicio que invoca el extremo. Si intenta modificar el servicio, se produce una excepción. Para modificar el servicio asociado a un punto final determinado, elimine el punto final y cree uno nuevo. (Consulte Eliminación de extremos.)
Consulte también lo siguiente
Modificación de un extremo mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Modifique un punto final utilizando la API de Java:
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-livecycle-client.jar, en la ruta de clase de su proyecto Java.
Cree un objeto de cliente EndpointRegistry.
ServiceClientFactory
objeto que contiene propiedades de conexión.EndpointRegistryClient
usando su constructor y pasando el ServiceClientFactory
objeto.Recupere el punto final para modificar.
EndpointRegistryClient
del objeto getEndpoints
método y pasar una PagingFilter
objeto que actúa como filtro. Puede pasar un (PagingFilter)null
para devolver todos los extremos. Este método devuelve un java.util.List
objeto donde cada elemento es un Endpoint
objeto. Para obtener información sobre un PagingFilter
objeto, consulte Referencia de la API de AEM Forms.java.util.List
para determinar si tiene extremos. Si existen extremos, cada elemento es un EndPoint
instancia.EndPoint
del objeto getServiceId
método. Este método devuelve un valor de cadena que especifica el nombre del servicio.EndPoint
del objeto getConnectorId
método. Este método devuelve un valor de cadena que especifica el tipo de extremo. Por ejemplo, si el extremo es un extremo de carpeta vigilada, este método devuelve WatchedFolder
.Especifique nuevos valores de configuración.
Cree un ModifyEndpointInfo
invocando su constructor.
Para cada valor de configuración que se va a establecer, invoque la variable ModifyEndpointInfo
del objeto setConfigParameterAsText
método. Por ejemplo, para establecer el valor de configuración de la url, invoque la función ModifyEndpointInfo
del objeto setConfigParameterAsText
y pase los siguientes valores:
url
valor de configuración, especifique url
.url
, especifique la ubicación de la carpeta vigilada.Invocar el EndpointRegistryClient
del objeto modifyEndpoint
y pase el ModifyEndpointInfo
objeto.
Consulte también lo siguiente
Inicio rápido: Modificación de un extremo mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Puede eliminar mediante programación un extremo de un servicio mediante la API Java de AEM Forms. Después de quitar un extremo, no se puede invocar el servicio utilizando el método de invocación que habilitó el extremo. Por ejemplo, si elimina un extremo SOAP de un servicio, no puede invocar el servicio mediante el modo SOAP.
Para demostrar cómo quitar un punto final de un servicio, esta sección elimina un punto final de EJB de un servicio denominado EncryptDocument.
No se puede quitar un punto final mediante servicios web.
Para eliminar un punto final de un servicio, realice las siguientes tareas:
EndpointRegistryClient
objeto.Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Los siguientes archivos JAR deben agregarse a la ruta de clase del proyecto:
Para obtener información sobre la ubicación de estos archivos JAR, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
Crear un objeto de cliente de EndpointRegistry
Para eliminar un extremo mediante programación, debe crear un EndpointRegistryClient
objeto.
Recupere el punto final que desea eliminar
Para poder eliminar un punto final, debe recuperarlo. Para recuperar un punto final, debe conectarse como usuario que puede acceder a un punto final. Se recomienda conectarse como administrador. (Consulte Configuración de las propiedades de conexión).
Puede recuperar un punto final recuperando una lista de puntos finales. A continuación, puede iterar a través de la lista, buscando el punto final específico que desea eliminar. Por ejemplo, puede localizar un punto final determinando el servicio que corresponde al punto final y el tipo de punto final. Cuando localice el punto final, puede eliminarlo.
Eliminar el punto final
Después de crear un nuevo extremo, debe habilitarlo. Cuando el extremo está habilitado, se puede utilizar para invocar el servicio. Después de habilitar el punto final, puede verlo en la consola de administración.
Consulte también lo siguiente
Eliminación de un extremo mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Elimine un punto final utilizando la API de Java:
Incluir archivos de proyecto.
Incluya archivos JAR del cliente, como adobe-livecycle-client.jar, en la ruta de clase de su proyecto Java.
Cree un objeto de cliente EndpointRegistry.
ServiceClientFactory
objeto que contiene propiedades de conexión.EndpointRegistryClient
usando su constructor y pasando el ServiceClientFactory
objeto.Recupere el punto final que desea eliminar.
EndpointRegistryClient
del objeto getEndpoints
método y pasar una PagingFilter
objeto que actúa como filtro. Puede pasar (PagingFilter)null
para devolver todos los extremos. Este método devuelve un java.util.List
objeto donde cada elemento es un Endpoint
objeto.java.util.List
para determinar si tiene extremos. Si existen extremos, cada elemento es un EndPoint
instancia.EndPoint
del objeto getServiceId
método. Este método devuelve un valor de cadena que especifica el nombre del servicio.EndPoint
del objeto getConnectorId
método. Este método devuelve un valor de cadena que especifica el tipo de extremo. Por ejemplo, si el punto final es un punto final de EJB, este método devuelve EJB
.Elimine el punto final.
Elimine el punto final invocando la variable EndpointRegistryClient
del objeto remove
y pasando el EndPoint
que representa el punto final que se va a quitar.
Consulte también lo siguiente
Inicio rápido: Eliminación de un extremo mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Puede recuperar mediante programación información sobre conectores de extremo mediante la API de AEM Forms. Un conector permite que un extremo invoque un servicio mediante varios métodos de invocación. Por ejemplo, un conector de carpeta vigilada permite que un extremo invoque un servicio mediante carpetas vigiladas. Mediante la recuperación mediante programación de información sobre los conectores de extremo, puede recuperar los valores de configuración asociados a un conector, como los valores de configuración necesarios y los opcionales.
Para demostrar cómo recuperar información sobre los conectores de extremo, esta sección recupera información sobre un conector de carpeta vigilada. (Consulte Añadir puntos finales de carpeta vigilada.)
No se puede recuperar información sobre extremos mediante servicios web.
Este tema utiliza la variable ConnectorRegistryClient
API para recuperar información sobre conectores de extremo. (Consulte Referencia de la API de AEM Forms.)
Para recuperar la información del conector de extremo, realice las siguientes tareas:
ConnectorRegistryClient
objeto.Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Los siguientes archivos JAR deben agregarse a la ruta de clase del proyecto:
Si AEM Forms se implementa en un servidor de aplicaciones J2EE compatible que no sea JBoss, sustituya adobe-Utilities.jar y jbossall-client.jar por archivos JAR específicos del servidor de aplicaciones J2EE en el que se implementa AEM Forms. Para obtener información sobre la ubicación de todos los archivos JAR de AEM Forms, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
Creación de un objeto cliente ConnectorRegistry
Para recuperar mediante programación la información del conector del extremo, cree un ConnectorRegistryClient
objeto.
Especifique el tipo de conector
Especifique el tipo de conector desde el que desea recuperar información. Existen los siguientes tipos de conectores:
Recuperar valores de configuración
Después de especificar el tipo de conector, puede recuperar información sobre el conector, como el valor de configuración admitido. Por ejemplo, para cualquier conector, puede determinar qué valores de configuración son obligatorios y cuáles son opcionales.
Consulte también lo siguiente
Recuperar información del conector de extremo mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Recupere la información del conector de extremo mediante la API de Java:
Incluir archivos de proyecto. .
Incluya archivos JAR del cliente, como adobe-livecycle-client.jar, en la ruta de clase de su proyecto Java.
Cree un objeto cliente ConnectorRegistry.
ServiceClientFactory
objeto que contiene propiedades de conexión.ConnectorRegistryClient
usando su constructor y pasando el ServiceClientFactory
objeto.Especifique el tipo de conector.
Especifique el tipo de conector invocando la variable ConnectorRegistryClient
del objeto getEndpointDefinition
y pasando un valor de cadena que especifica el tipo de conector. Por ejemplo, para especificar el tipo de conector Carpeta vigilada, pase el valor de cadena WatchedFolder
. Este método devuelve un Endpoint
objeto que corresponde al tipo de conector.
Recupere valores de configuración.
Endpoint
del objeto getConfigParameters
método. Este método devuelve una matriz de ConfigParameter
objetos.ConfigParameter
objeto. Por ejemplo, puede determinar si el valor de configuración es obligatorio u opcional invocando la variable ConfigParameter
del objeto isRequired
método. Si el valor de configuración es obligatorio, este método devuelve true
.Consulte también lo siguiente
Inicio rápido: Recuperación de información del conector de extremo mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión