Configurar extremos de correo electrónico configuring-email-endpoints

Los extremos de correo electrónico permiten a los usuarios invocar un servicio enviando uno o varios documentos (como archivos adjuntos de correo electrónico) a una cuenta de correo electrónico especificada. La bandeja de entrada de correo electrónico actúa como punto de recopilación de los archivos adjuntos. El servicio supervisa la bandeja de entrada y procesa los archivos adjuntos. Los resultados de la conversión se reenvían al usuario definido en el extremo.

Para un extremo de correo electrónico, los usuarios autorizados pueden invocar un proceso enviando archivos por correo electrónico a la cuenta adecuada. Los resultados se devolverán al usuario remitente (de forma predeterminada) o al usuario definido en la configuración del extremo.

Antes de configurar un extremo de correo electrónico, cree una cuenta de correo electrónico POP3 o IMAP para que la use el extremo. Configure una cuenta independiente para cada tipo de conversión. Por ejemplo, se puede configurar una cuenta para generar documentos de PDF estándar a partir de archivos adjuntos entrantes y otra cuenta para generar documentos de PDF seguros.

Todos los extremos de correo electrónico se configuran con un nombre de usuario y una contraseña autorizados para la bandeja de entrada de correo electrónico, que son necesarios al invocar el servicio. La cuenta de correo electrónico está protegida por el sistema de servidor de correo en el que está configurada.

Si los usuarios envían documentos con caracteres de idioma de Europa Occidental en nombres de ruta de archivo y conversión, deben utilizar una aplicación de correo electrónico que admita los tipos de codificación necesarios (Latin1 [ISO-8859-1], Europa Occidental [Windows]o UTF-8). Para obtener más información, consulte la Instalación e implementación de AEM formularios documento para el servidor de aplicaciones.

Antes de configurar un extremo de correo electrónico, configure el servicio de correo electrónico. (Consulte Configuración de los parámetros de extremo de correo electrónico predeterminados.) Los parámetros de configuración del servicio de correo electrónico tienen dos propósitos:

Configuración de SSL para un extremo de correo electrónico configure-ssl-for-an-email-endpoint

Puede configurar POP3, IMAP o SMTP para que utilice Secure Sockets Layer (SSL) para un extremo de correo electrónico.

Configuración de los parámetros de extremo de correo electrónico predeterminados configure-default-email-endpoint-settings

Puede utilizar la página Administración de servicios para configurar atributos que son comunes para todos los extremos de correo electrónico y para proporcionar valores predeterminados para todos los extremos de correo electrónico.

Para que el flujo de trabajo de formularios reciba y gestione mensajes de correo electrónico entrantes de los usuarios, debe crear un extremo de correo electrónico para el servicio Tarea completa. Este extremo de correo electrónico requiere configuración adicional, tal como se describe en Creación de un extremo de correo electrónico para el servicio Tarea completa.

Cambiar los valores predeterminados para los extremos de correo electrónico change-the-default-values-for-email-endpoints

Configuración de extremo de correo electrónico predeterminada default-email-endpoint-settings

Expresión Cron: La expresión cron utilizada por quartz para programar el sondeo del directorio de entrada.

Intervalo de repetición: Número de veces que se repite la encuesta de directorio. El intervalo de repetición predeterminado es en segundos si no se especifica este valor en la configuración del extremo. El valor predeterminado es 10. Este valor no puede ser inferior a 10.

Recuento de repetición: Número de veces que se sondea el directorio de entrada. El recuento de repetición predeterminado que se debe usar si este valor no se especifica en la configuración del extremo. Un valor de -1 indica la digitalización indefinida del directorio. El valor predeterminado es -1.

Retraso al iniciar el trabajo: El valor predeterminado, en segundos, del retraso antes de que el trabajo comience a analizar el punto final. El valor predeterminado es 0.

Tamaño del lote: Número de correos electrónicos que procesa el receptor por escaneo para obtener un rendimiento óptimo. El valor -1 indica todos los correos electrónicos. El valor predeterminado es 2.

Asíncrono: Identifica el tipo de invocación como asíncrono o sincrónico. Los procesos transitorios y sincrónicos solo se pueden invocar sincrónicamente. El valor predeterminado es asíncrono.

Patrón de dominio: El patrón de nombre de dominio que se utiliza para filtrar correos electrónicos entrantes. Por ejemplo, si se utiliza adobe.com, solo se procesará el correo electrónico de adobe.com; se ignora el correo electrónico de otros dominios.

Patrón de archivo: Los patrones de archivo adjunto entrantes que acepta el proveedor. Esto incluye archivos que tienen extensiones específicas (*.dat, *.xml), nombres específicos (datos) y expresiones compuestas en el nombre y la extensión (.[dD][aA][Tt]). El valor predeterminado es *.*.

Destinatarios del trabajo correctos: Una o más direcciones de correo electrónico que se utilizan para enviar correos electrónicos para indicar que los trabajos se han realizado correctamente. De forma predeterminada, siempre se envía un mensaje de trabajo correcto al remitente del trabajo inicial. Se admiten hasta 100 destinatarios. Para desactivar esta configuración, deje este campo en blanco.

Destinatarios del trabajo con errores: Una o más direcciones de correo electrónico que se usan para enviar correos electrónicos para indicar que hay trabajos fallidos. De forma predeterminada, siempre se envía un mensaje de trabajo fallido al remitente que envió el trabajo inicial. Se admiten hasta 100 destinatarios. Para desactivar esta configuración, deje este campo en blanco.

Host de bandeja de entrada: El nombre de host de la bandeja de entrada o la dirección IP que debe analizar el proveedor de correo electrónico.

Puerto de la bandeja de entrada: El número de puerto de la bandeja de entrada que debe analizar el proveedor de correo electrónico. Si el valor es 0, se utilizará el puerto IMAP o POP3 predeterminado.

Protocolo de bandeja de entrada: El protocolo de correo electrónico para el extremo de correo electrónico que se utiliza para analizar la bandeja de entrada. Las opciones son IMAP o POP3. El servidor de correo de host de la bandeja de entrada debe admitir estos protocolos.

Tiempo de espera de la bandeja de entrada: Especifica la cantidad de tiempo que el extremo esperará antes de cancelarse cuando intente conectarse a la bandeja de entrada. Si no se adquiere una conexión antes de que se alcance el valor de tiempo de espera, la bandeja de entrada no se sondeará.

Usuario de bandeja de entrada: El nombre de usuario necesario para iniciar sesión en la cuenta de correo electrónico. Según el servidor de correo electrónico y la configuración, este nombre solo puede ser la parte del nombre de usuario del correo electrónico o puede ser la dirección de correo electrónico completa.

Contraseña de la bandeja de entrada: La contraseña del usuario de la bandeja de entrada.

POP3/IMAP SSL habilitado: Cuando se selecciona, activa SSL.

Host SMTP: El nombre de host del servidor de correo que utiliza el proveedor de correo electrónico para enviar resultados y mensajes de error. Por ejemplo, mail.example.com.

Puerto SMTP: El puerto que se utiliza para conectar con el servidor de correo. El valor predeterminado es 25.

Usuario SMTP: La cuenta de usuario del proveedor de correo electrónico que se utiliza cuando envía correos electrónicos para obtener resultados y errores.

Contraseña SMTP: La contraseña de la cuenta SMTP. Algunos servidores de correo no requieren una contraseña SMTP.

Enviar desde: La dirección de correo electrónico (por ejemplo, user@company.com) utilizada para enviar notificaciones por correo electrónico de resultados y errores. Si no especifica un valor de Enviar desde, el servidor de correo electrónico intenta determinar la dirección de correo electrónico combinando el valor especificado en la configuración del usuario SMTP con un dominio predeterminado configurado en el servidor de correo electrónico. Si el servidor de correo electrónico no tiene un dominio predeterminado y no especifica ningún valor para Enviar desde, pueden producirse errores. Para asegurarse de que los mensajes de correo electrónico tienen la dirección de origen correcta, especifique un valor para la configuración Enviar desde .

SSL SMTP habilitado: Cuando se selecciona, activa SSL sobre SMTP.

Incluya El Cuerpo Del Correo Electrónico Original Como Adjunto: De forma predeterminada, cuando se envía un correo electrónico al servidor de formularios, el texto original del mensaje se incluye en el cuerpo del mensaje. Para incluir el texto como archivo adjunto, seleccione esta opción.

Utilice La Línea Del Asunto Original Para Los Correos Electrónicos De Resultado: De forma predeterminada, el servidor de Forms utiliza los valores especificados en los ajustes Asunto del correo electrónico de éxito y Asunto del correo electrónico de error como línea de asunto al enviar mensajes de correo electrónico de resultados. Para utilizar en su lugar la misma línea de asunto que el correo electrónico original enviado al servidor, seleccione esta opción.

Asunto del correo electrónico de éxito: Después de enviar un correo electrónico a un extremo de correo electrónico para iniciar o continuar un proceso, recibe un mensaje de correo electrónico de retorno del servidor de AEM forms. Si el correo electrónico se envía correctamente, recibirá un correo electrónico de éxito. Si el correo electrónico falla, recibirá un mensaje de correo electrónico de error que le informa del motivo del error. Esta configuración le permite especificar la línea de asunto de los mensajes de correo electrónico de éxito enviados para este extremo.

Cuerpo de correo electrónico de éxito: Permite especificar el texto del cuerpo de los mensajes de correo electrónico de éxito enviados para este extremo.

Prefijo de asunto de correo electrónico de error: Permite especificar el texto utilizado al principio de la línea de asunto de los mensajes de correo electrónico de error enviados para este extremo.

Asunto del correo electrónico de error: Permite especificar la línea de asunto de los mensajes de correo electrónico de error enviados para este extremo. Este texto se muestra después del prefijo Error Email Subject .

Cuerpo del correo electrónico de error: Permite especificar la primera línea del texto del cuerpo de los mensajes de correo electrónico de error enviados para este extremo.

Información de resumen de correo electrónico: Cada mensaje de éxito o de error incluye una sección que contiene el texto de correo electrónico original que envió al servidor de formularios. Esta configuración especifica el texto que aparece encima de esa sección.

Valide la bandeja de entrada antes de crear/actualizar este extremo: Cuando se selecciona esta opción, el servidor de formularios comprueba si la configuración de SMTP/POP3 es correcta antes de crear el punto final. Al hacer clic en Agregar, aparece un mensaje que indica si la cuenta de la bandeja de entrada es válida. Si no se selecciona esta opción, el servidor de AEM forms crea el extremo sin validar la bandeja de entrada.

Codificación de conjunto de caracteres: El formato de codificación que se utiliza para el mensaje de correo electrónico. El valor predeterminado es UTF-8, que la mayoría de los usuarios fuera de Japón utilizarán. Los usuarios de un entorno japonés pueden elegir ISO2022-JP.

Carpeta de correo electrónico enviado con error: Especifica un directorio en el que almacenar los resultados si el servidor de correo SMTP no está operativo.

Configuración de extremo de correo electrónico email-endpoint-settings

Utilice la siguiente configuración para configurar un extremo de correo electrónico.

Nombre: Una configuración obligatoria que identifica el punto final. No incluya un carácter < porque trunca el nombre mostrado en Workspace. Si introduce una URL como nombre del extremo, asegúrese de que cumple las reglas de sintaxis especificadas en RFC1738.

Descripción: Descripción del extremo. No incluya un carácter < porque trunca la descripción mostrada en Workspace.

Expresión Cron: Introduzca una expresión cron si el correo electrónico debe programarse utilizando una expresión cron.

Recuento de repetición: Número de veces que el extremo del correo electrónico analiza la carpeta o el directorio. Un valor de -1 indica escaneo indefinido. El valor predeterminado es -1.

Intervalo de repetición: La velocidad de digitalización que utiliza el receptor para comprobar el correo entrante.

Retraso al iniciar el trabajo: Tiempo de espera para analizar después de que se inicie el planificador.

Tamaño del lote: Número de correos electrónicos que procesa el receptor por escaneo para obtener un rendimiento óptimo. El valor -1 indica todos los correos electrónicos. El valor predeterminado es 2.

Nombre de usuario: Una configuración obligatoria, que es el nombre de usuario que se utiliza al invocar un servicio de destinatario desde el correo electrónico. El valor predeterminado es SuperAdmin.

Nombre de dominio: Una configuración obligatoria, que es el dominio del usuario. El valor predeterminado es DefaultDom.

Patrón de dominio: Especifica los patrones de dominio del correo electrónico entrante que acepta el proveedor. Por ejemplo, si se utiliza adobe.com, solo se procesa el correo electrónico de adobe.com; se ignora el correo electrónico de otros dominios.

Patrón de archivo: Especifica los patrones de archivo adjunto entrantes que acepta el proveedor. Esto incluye archivos que tienen extensiones específicas (*.dat, *.xml), nombres específicos (datos) o expresiones compuestas en el nombre y la extensión (*).[dD][aA][Tt]).

Destinatarios del trabajo correctos: Una dirección de correo electrónico a la que se envían mensajes para indicar los trabajos realizados correctamente. De forma predeterminada, siempre se envía un mensaje de trabajo correcto al remitente. Si escribe el remitente, los resultados del correo electrónico se envían al remitente. Se admiten hasta 100 destinatarios. Especifique destinatarios adicionales con direcciones de correo electrónico, separados por comas (,).

Para desactivar esta configuración, deje la configuración en blanco. En algunos casos, se desea almacenar en déclencheur un proceso y no se desea enviar una notificación por correo electrónico del resultado.

Destinatarios del trabajo con errores: Una dirección de correo electrónico a la que se envían mensajes para indicar los trabajos fallidos. De forma predeterminada, siempre se envía un mensaje de trabajo fallido al remitente. Si escribe el remitente, los resultados del correo electrónico se envían al remitente. Se admiten hasta 100 destinatarios. Especifique destinatarios adicionales con direcciones de correo electrónico, separados por comas (,).

Para desactivar esta configuración, deje la configuración en blanco. En algunos casos, se desea almacenar en déclencheur un proceso y no se desea enviar una notificación por correo electrónico del resultado.

Host de bandeja de entrada: El nombre de host de la bandeja de entrada o la dirección IP que debe analizar el proveedor de correo electrónico.

Puerto de la bandeja de entrada: Puerto que utiliza el servidor de correo electrónico. El valor predeterminado para POP3 es 110 y el valor predeterminado para IMAP es 143. Si SSL está habilitado, el valor predeterminado para POP3 es 995 y el valor predeterminado para IMAP es 993.

Protocolo de bandeja de entrada: El protocolo de correo electrónico para el extremo de correo electrónico que se utiliza para analizar la bandeja de entrada. Los valores son IMAP o POP3. El servidor de correo de host de la bandeja de entrada debe admitir estos protocolos.

Tiempo de espera de la bandeja de entrada: Tiempo de espera, en segundos, para que el proveedor de correo electrónico espere a recibir respuestas de la bandeja de entrada.

Usuario de bandeja de entrada: El nombre de usuario necesario para iniciar sesión en la cuenta de correo electrónico. Según el servidor de correo electrónico y la configuración, este valor puede ser solo la parte del nombre de usuario del correo electrónico o puede ser la dirección de correo electrónico completa.

Contraseña de la bandeja de entrada: La contraseña del usuario de la bandeja de entrada.

POP3/IMAP SSL habilitado: Seleccione esta configuración para obligar al proveedor de correo electrónico a utilizar SSL para escanear la bandeja de entrada. Asegúrese de que su servidor de correo sea compatible con SSL.

Host SMTP: El nombre de host del servidor de correo que utiliza el proveedor de correo electrónico para enviar resultados y mensajes de error.

Puerto SMTP: El valor predeterminado del puerto SMTP es 25.

Usuario SMTP: La cuenta de usuario del proveedor de correo electrónico que se utiliza cuando envía notificaciones por correo electrónico de resultados y errores.

Contraseña SMTP: La contraseña de la cuenta SMTP. Algunos servidores de correo no requieren una contraseña SMTP.

Enviar desde: La dirección de correo electrónico (por ejemplo, user@company.com) utilizada para enviar notificaciones por correo electrónico de resultados y errores. Si no especifica un valor de Enviar desde, el servidor de correo electrónico intenta determinar la dirección de correo electrónico combinando el valor especificado en la configuración del usuario SMTP con un dominio predeterminado configurado en el servidor de correo electrónico. Si el servidor de correo electrónico no tiene un dominio predeterminado y no especifica ningún valor para Enviar desde, pueden producirse errores. Para asegurarse de que los mensajes de correo electrónico tienen la dirección de origen correcta, especifique un valor para la configuración Enviar desde .

SSL SMTP habilitado: Seleccione esta configuración para obligar al proveedor de correo electrónico a utilizar SSL para escanear la bandeja de entrada. Asegúrese de que su servidor de correo sea compatible con SSL.

Carpeta de correo electrónico enviado con error: Especifica un directorio en el que almacenar los resultados si el servidor de correo SMTP no está operativo.

asincrónico: Cuando se establece en sincrónico, se procesan todos los documentos de entrada y se devuelve una sola respuesta. Cuando se establece como asíncrono, se envía una respuesta a cada documento que se procesa.

Por ejemplo, se crea un extremo de correo electrónico para un servicio que toma un solo documento de Word y devuelve ese documento como archivo PDF. Se puede enviar un correo electrónico a la bandeja de entrada del extremo que contiene varios (3) documentos de Word. Cuando se procesan los tres documentos, si el punto final está configurado como sincrónico, se envía un único correo electrónico de respuesta con los tres documentos adjuntos. Si el punto final es asíncrono, se envía un correo electrónico de respuesta después de convertir cada documento de Word a PDF. El resultado son tres correos electrónicos, cada uno con un único archivo adjunto de PDF.

El valor predeterminado es asíncrono.

Incluya el cuerpo del correo electrónico original como adjunto: De forma predeterminada, cuando se envía un correo electrónico al servidor de formularios, el texto original del mensaje se incluye en el cuerpo del mensaje. Para incluir el texto como archivo adjunto, seleccione esta opción.

Utilice la línea de asunto original para los correos electrónicos de resultados: De forma predeterminada, el servidor de Forms utiliza los valores especificados en los ajustes Asunto del correo electrónico de éxito y Asunto del correo electrónico de error como línea de asunto al enviar mensajes de correo electrónico de resultados. Para utilizar en su lugar la misma línea de asunto que el correo electrónico original enviado al servidor, seleccione esta opción.

Asunto del correo electrónico de éxito: Después de enviar un correo electrónico a un extremo de correo electrónico para iniciar o continuar un proceso, recibe un mensaje de correo electrónico de retorno del servidor de AEM forms. Si el correo electrónico se envía correctamente, recibirá un correo electrónico de éxito. Si el correo electrónico falla, recibirá un mensaje de correo electrónico de error que le informa del motivo del error. Esta configuración le permite especificar la línea de asunto de los mensajes de correo electrónico de éxito enviados para este extremo.

Cuerpo de correo electrónico de éxito: Permite especificar el texto del cuerpo de los mensajes de correo electrónico de éxito enviados para este extremo.

Prefijo de asunto de correo electrónico de error: Permite especificar el texto utilizado al principio de la línea de asunto de los mensajes de correo electrónico de error enviados para este extremo.

Asunto del correo electrónico de error: Permite especificar la línea de asunto de los mensajes de correo electrónico de error enviados para este extremo. Este texto se muestra después del prefijo Error Email Subject .

Cuerpo del correo electrónico de error: Permite especificar la primera línea del texto del cuerpo de los mensajes de correo electrónico de error enviados para este extremo.

Información de resumen de correo electrónico: Cada mensaje de éxito o de error incluye una sección que contiene el texto de correo electrónico original que envió al servidor de formularios. Esta configuración especifica el texto que aparece encima de esa sección.

Valide la bandeja de entrada antes de crear/actualizar este extremo: Cuando se selecciona esta opción, el servidor de formularios comprueba si la configuración de SMTP/POP3 es correcta antes de crear el punto final. Al hacer clic en Agregar, aparece un mensaje que indica si la cuenta de la bandeja de entrada es válida. Si no se selecciona esta opción, el servidor de AEM forms crea el extremo sin validar la bandeja de entrada.

Nombre de la operación: Esta configuración es obligatoria. Lista de operaciones que se pueden asignar al extremo de correo electrónico. La operación que seleccione aquí determina qué campos se muestran en las secciones Asignaciones de parámetros de entrada y Asignaciones de parámetros de salida .

Asignaciones de parámetros de entrada: Se utiliza para configurar la entrada necesaria para procesar el servicio y la operación. Los dos tipos de entrada son literales y variables:

Literal: El correo electrónico utiliza el valor introducido en el campo tal como se muestra.

Variable: Puede asignar una cadena del asunto, el cuerpo, el encabezado o la dirección de correo electrónico del remitente del correo electrónico. Para ello, utilice una de las siguientes palabras clave: %SUBJECT%, %BODY%, %HEADER% o %SENDER%. Por ejemplo, si utiliza %SUBJECT%, el contenido del asunto del correo electrónico se utilizará como parámetro de entrada. Para recoger archivos adjuntos, introduzca un patrón de archivo que el extremo de correo electrónico pueda utilizar para seleccionar los documentos adjuntos. Por ejemplo, al introducir *.pdf, se selecciona cualquier documento adjunto que tenga una extensión de nombre de archivo .pdf. Introducción de * selecciona cualquier documento adjunto. Al introducir example.pdf, se selecciona cualquier documento adjunto denominado example.pdf.

Asignaciones de parámetros de salida: Se utiliza para configurar la salida del servicio y la operación. Los siguientes caracteres en los valores de asignación de parámetros de salida se expanden en el nombre del archivo adjunto:

%F Representa el nombre de archivo del archivo de origen (sin incluir una extensión).

%E Representa la extensión del archivo de origen.

Cualquier incidencia de la barra invertida () se sustituye por %%.

nota ​: Si el mensaje de solicitud de servicio incluye varios archivos adjuntos, no puede usar los parámetros %F y %E para la propiedad Asignaciones de parámetros de salida del extremo. Si la respuesta de servicios devuelve varios archivos adjuntos, no se puede especificar el mismo nombre de archivo para más de un archivo adjunto. Si no sigue estas recomendaciones, el servicio invocado crea los nombres de los archivos devueltos y los nombres no son predecibles.

Los valores disponibles son los siguientes:

Objeto único: El proveedor de correo electrónico no tiene el destino de la carpeta de origen; los resultados se devuelven como datos adjuntos. El patrón es Result/%F.ps y devuelve Result%%sourcefilename.ps como archivo adjunto de nombre de archivo.

Lista: El patrón es Result/%F/ y devuelve Result%%sourcefilename%%file1 como archivo adjunto de nombre de archivo.

Mapa: El patrón es Result/%F/ y el destino de origen es Result%%sourcefilename%%file1 y Result%%sourcefilename%%file2. Si el mapa contiene más de un objeto y el patrón es Result/%F.ps, los archivos adjuntos del archivo de respuesta son Result%%sourcefilename1.ps (output 1) y Result%%sourcefilename2.ps (output 2).

Creación de un extremo de correo electrónico para el servicio Tarea completa create-an-email-endpoint-for-the-complete-task-service

Para que el flujo de trabajo de formularios reciba y gestione mensajes de correo electrónico entrantes de los usuarios, debe crear un extremo de correo electrónico para el servicio Tarea completa.