El paso Enviar correo electrónico envía una notificación por correo electrónico a uno o varios destinatarios cuando se ejecuta el paso. Este tipo de paso se puede utilizar para enviar notificaciones cuando un paso o trabajo se ha completado o cuando un paso no se ha completado correctamente.
Opcionalmente, puede configurar los ajustes de notificación por correo electrónico de ArcGIS Workflow Manager antes de enviar las notificaciones por correo electrónico con el paso Enviar correo electrónico. La configuración personalizada del servidor SMTP permite incluir archivos adjuntos, utilizar direcciones de correo electrónico en lugar de nombres de usuario o un Id. de grupo, y activar los cuadros de texto CC y CCO.
Nota:
Es posible que tenga que modificar los roles personalizados para recuperar las direcciones de correo electrónico de los miembros de la organización con expresiones de ArcGIS Arcade.
Configurar el paso
Haga lo siguiente para configurar el paso:
- Cree o edite un diagrama de flujo de trabajo para acceder al panel Biblioteca de pasos.
- Arrastre Enviar correo electrónico desde el panel Biblioteca de pasos a una flecha de conexión de un paso en el lienzo del flujo de trabajo.
Aparece el panel Detalles del paso.
- Proporcione un nombre para el paso en el cuadro de texto Nombre de paso.
- Opcionalmente, haga clic en el botón de alternancia Habilitar servidor SMTP personalizado para utilizar su servidor SMTP para enviar correos electrónicos.
- Si no dispone de ningún servidor SMTP personalizado, elija una de las siguientes opciones de Tipo de destinatario e indique los destinatarios en el cuadro de texto Para:
- Nombres de usuario: proporcione una lista de nombres de usuario separados por un punto y coma o utilice una expresión de Arcade para crear una lista dinámica de destinatarios. Las expresiones de Arcade deben ir entre comillas dobles.
- Id. de grupo: proporcione un Id. de grupo único o utilice una expresión de Arcade para recuperar un Id. de grupo. Las expresiones de Arcade deben ir entre comillas dobles.
Debe proporcionarse como mínimo un nombre de usuario, un Id. de grupo o una expresión de Arcade que sea válido en el cuadro de texto Para.
Precaución:
Si no dispone de un servidor SMTP personalizado, el número máximo de destinatarios es de 50. Las expresiones de Arcade pueden hacer que la lista de destinatarios supere el límite de tamaño máximo.
Un nombre de usuario
JDoe
Un Id. de grupo
7dr6de56442840ccbf49b3f869f49b27
Varios nombres de usuario
JDoe;KSmith;MFields
Una expresión de Arcade
"GetUser($CurrentPortal, jobOwner($job))['username']"
Varias expresiones de Arcade
"GetUser($CurrentPortal, jobOwner($job))['username']";"jobCreator($job)";"lastRunner($job, '8b107614-c6dc-20b3-c232-e03bf7c007bc')"
Nombres de usuario y expresiones de Arcade
JDoe;"GetUser($CurrentPortal, jobOwner($job))['username']";KSmith;"lastRunner($job, '8b107614-c6dc-20b3-c232-e03bf7c007bc')"
Sugerencia:
Haga clic en La entrada admite expresiones de Arcade
y elija una expresión de ArcGIS Arcade para agregarla su cuadro de texto asociado. - Si dispone de un servidor SMTP personalizado, indique las direcciones de correo electrónico separadas por punto y coma en los cuadros de texto Para, CC y CCO según sea necesario, o utilice una expresión de ArcGIS Arcadepara crear una lista dinámica de destinatarios. Las expresiones de Arcade deben ir entre comillas dobles.
Debe proporcionar como mínimo una dirección de correo electrónico o una expresión de Arcade válida en el cuadro de texto Para, CC o CCO.
Una dirección de correo electrónico
user1@test.com
Varias direcciones de correo electrónico
user1@test.com;user2@test.com;user3@test.com;user4@test.com
Una expresión de Arcade
"GetUser($CurrentPortal, JobOwner($Job))['Email']"
Varias expresiones de Arcade
"GetUser($CurrentPortal, JobOwner($Job))['Email']";"GetUser($CurrentPortal)['Email']";"GetUser($CurrentPortal, LastRunner($Job, 'f50d740d-cc04-9296-4ce3-181e82604465'))['Email']"
Direcciones de correo electrónico y expresiones de Arcade
user1@test.com;"GetUser($CurrentPortal, JobOwner($Job))['Email']";user3@test.com;"GetUser($CurrentPortal)['Email']"
Sugerencia:
Haga clic en La entrada admite expresiones de Arcade
y elija una expresión de ArcGIS Arcade para agregarla su cuadro de texto asociado. - Indique el tema de la notificación que se envía por correo electrónico en el cuadro de texto Tema.
Debe indicar un asunto. El cuadro de texto Asunto no puede estar vacío.
También puede usar expresiones de ArcGIS Arcade para proporcionar un valor dinámico para el asunto. Si el asunto contiene texto sin formato y expresiones de Arcade, formatee el texto de la siguiente manera:
JobName($Job) + 'is ready' - Indique el texto del mensaje para la notificación por correo electrónico en el cuadro de texto Cuerpo.
Debe proporcionar un mensaje en el cuerpo. El cuadro de texto Cuerpo no puede estar vacío.
También puede usar expresiones de ArcGIS Arcade para proporcionar un valor dinámico para el cuerpo.
Si el cuerpo contiene texto sin formato y expresiones de Arcade, formatee el texto de la siguiente manera:
'<b>' + JobName($Job) + '</b>, created by <b>' + JobCreator($Job) + '</b>, was started on <b>' + Text(Date(JobStartDate($Job)), 'dddd, MMMM D, Y') + '</b>.'Precaución:
Si no dispone de ningún servidor SMTP personalizado, el tamaño del cuerpo del correo electrónico está limitado a 100 KB. Las expresiones de Arcade pueden causar que el cuerpo exceda el límite máximo de tamaño.
- Si dispone de un servidor SMTP personalizado, puede incluir adjuntos en su notificación por correo electrónico con las opciones bajo Incluir adjuntos:
- Ninguno: no incluye ningún adjunto de trabajo en la notificación por correo electrónico.
- Todos: incluye todas las carpetas de adjuntos en la notificación por correo electrónico.
- Por carpeta: indique una lista separada por comas de todos los nombres de carpetas de adjuntos en el cuadro de texto Por carpeta para especificar las carpetas de adjuntos de trabajo que desea incluir en la notificación por correo electrónico.
Nota:
Las carpetas de adjuntos de trabajo están contenidas en el elemento de flujo de trabajo y no son rutas del sistema de archivos.
Nota:
Si un trabajo contiene varios adjuntos, se envían como un único archivo .zip, en el que se mantiene la estructura de las carpetas de adjuntos.
- También puede hacer clic en Vista previa del correo electrónico para mostrar una vista previa del correo electrónico.
Nota:
Si el correo electrónico contiene una expresión de Arcade específica del trabajo, debe proporcionar un Id. de trabajo válido en el cuadro de texto Vista previa del correo electrónico antes de que sea posible ver una vista previa de la expresión de Arcade. Si el correo electrónico contiene una expresión de Arcade correspondiente al valor de salida de un paso, se debe completar el paso para poder ver una vista previa del valor de salida.
Aparece la ventana Vista previa del correo electrónico con una lista de destinatarios y una vista previa del asunto y el cuerpo.
- Haga clic en la pestaña Opciones.
- Configure Opciones de pasos según sea necesario.
- Manual: el paso se ejecuta manualmente.
- Opcional: se permite finalizar el paso sin haberlo ejecutado.
- Automático: el paso se ejecuta tan pronto como se activa.
- Ejecutar según programa: ejecute el paso según un programa establecido.
- Manual: el paso se ejecuta manualmente.
- Opcionalmente, elija una de las siguientes opciones para configurar la ayuda en el paso:
- Ninguno: configure el paso sin ayuda de pasos.
- Texto: configure el texto de ayuda para el paso en el cuadro de texto Texto.
Puede usar expresiones de ArcGIS Arcade para proporcionar un valor dinámico para la ayuda del paso. Si la ayuda del paso contiene texto sin formato y expresiones de Arcade, tendrá que formatear el texto del siguiente modo:
'For further assistance, please contact' + JobCreator($Job) + '.' - URL: configure el paso con un vínculo a un recurso de ayuda en el cuadro de texto URL.
Nota:
Solo se admiten los formatos de URL HTTP y HTTPS.
También puede usar expresiones de Arcade para proporcionar un valor dinámico. Si la URL contiene texto sin formato y expresiones de Arcade, deberá formatear el texto como se indica a continuación:
'https://pro.arcgis.com/en/pro-app/latest/tool-reference/' + JobExtendedProperty($Job, 'tools', 'toolbox') + '/' + jobExtendedProperty($job, 'tools', 'alias') + '.htm'Configure la casilla de verificación Codificar automáticamente el resultado de Arcade:
- Si una expresión de Arcade devuelve caracteres especiales que deben ser de escape al convertirlos en una URL, como un espacio o una barra diagonal, asegúrese de que la casilla de verificación Codificar automáticamente el resultado de Arcade está activada.
- Si se utiliza una expresión Arcade para formar la URL base, desmarque la casilla de verificación Codificar automáticamente el resultado de Arcade.
- También puede hacer clic en la pestaña Estilo para cambiar la forma y el color del paso.
- Si lo desea, haga clic en la pestaña Acerca de y proporcione una descripción para el paso en el cuadro de texto Descripción del paso.
Sugerencia:
La pestaña Acerca de también contiene un Id. del paso que puede utilizarse con propiedades del paso dinámico para obtener una salida del paso. Haga clic en Copiar Id. del paso
para copiar el Id. del paso en el portapapeles.
Valor de retorno
Cuando el paso se completa, el valor de retorno se almacena para indicar el resultado del paso. El valor de retorno puede evaluarse de inmediato utilizando rutas para determinar los pasos siguientes del flujo de trabajo. También puede recuperar el valor de retorno correspondiente a los pasos completados por medio del flujo de trabajo utilizando las expresiones de ArcGIS Arcade. En la tabla siguiente figuran los valores de retorno del paso:
| Valor de retorno | Descripción |
|---|---|
| S000001 | El paso se ha completado correctamente. |
F000001 | El paso no ha podido completarse correctamente. |