Compartir diseños personalizados para imprimir desde ArcGIS Pro

Si necesita funcionalidades de impresión en ArcGIS Enterprise fuera del alcance del servicio PrintingTools predeterminado, puede crear diseños personalizados en ArcGIS Pro acordes con sus necesidades. Puede compartir estos diseños en su portal como herramienta web o publicarlos en su sitio de ArcGIS Server independiente (si lo utiliza) como servicio de geoprocesamiento. Los servicios de geoprocesamiento que permiten la impresión se denominan servicios de impresión.

No debe actualizar los diseños que vienen con el servicio PrintingTools predeterminado ni agregar nuevos diseños y volver a publicar este servicio. En su lugar, debe ejecutar la herramienta de script Exportar mapa web en ArcGIS Pro y compartir el resultado, lo que servirá de recurso adicional para la impresión de mapas web.

Si comparte una herramienta web con el portal, el resultado de este tutorial se compartirá en el portal de ArcGIS Enterprise en el que tiene iniciada sesión y el servicio de impresión en el que se basa la herramienta web se guardará en el ArcGIS Server federado que designe.

Si trabaja con un sitio de servidor independiente, el resultado de este tutorial es un servicio de impresión basado en las herramientas Exportar mapa web y Obtener información de plantillas de diseño que ejecute en ArcGIS Pro.

Este tema es similar a Publicar un servicio de impresión con diseños personalizados desde ArcMap. Sin embargo, ese tema utiliza ArcMap para publicar un servicio de impresión en su servidor, ya sea independiente o federado con un portal. Este tema utiliza ArcGIS Pro para compartir una herramienta web con su portal o publicar un servicio de impresión con su servidor independiente.

Crear un diseño personalizado

Si desea crear una plantilla de diseño personalizado, puede hacerlo en ArcGIS Pro. Consulte Diseños en ArcGIS Pro para obtener más información. Guarde su nuevo diseño en una carpeta: en la pestaña Compartir, en el grupo Guardar como, haga clic en Archivo de diseño. También puede hacer clic con el botón derecho en el diseño del panel Catálogo y elegir Guardar como archivo de diseño.

Consideraciones al preparar sus diseños

Existen varias prácticas recomendadas a la hora de crear diseños en ArcGIS Pro para utilizarlos en un portal de ArcGIS Enterprise:

• Si tiene más de un marco de mapa en su diseño, identifique el marco de mapa que desea que utilice la herramienta web y asígnele el nombre WEBMAP_MAP_FRAME (con distinción entre mayúsculas y minúsculas). El servicio de impresión utilizará el marco de mapa con dicho nombre.
• Inserte texto dinámico, como el título, el nombre del autor, etc. Para obtener más información sobre el texto dinámico, consulte ¿Qué es el texto dinámico? en la documentación de ArcGIS Pro. Para hacerlo:
  1. En la pestaña Insertar de la cinta, seleccione el comando Texto del grupo Texto.
  2. Haga clic en una ubicación del diseño para colocar el nuevo elemento de texto.
  3. Abra la página Propiedades del elemento de texto.
  4. Inserte una de las siguientes etiquetas en la propiedad Texto del elemento seleccionado:

     titleText	<dyn type="layout" property="metadata" attribute="title" emptyStr=""/>
     authorText	<dyn type="layout" property="metadata" attribute="contactname" emptyStr=""/>
     copyrightText	<dyn type="layout" property="metadata" attribute="credits" emptyStr=""/>

     Nota:

     Solo puede agregar una etiqueta de texto dinámico por elemento de texto.

• También puede agregar el elemento de texto dinámico Hora actual de la categoría Sistema del desplegable Texto dinámico. También se encuentra en el grupo Texto de la cinta Insertar.
• Si desea insertar un elemento de texto personalizado, agregue un elemento de texto e integre el nombre del elemento en un conjunto de llaves abiertas y cerradas, como {parcel-id}.
• Si inserta una barra de escala, recomendamos seleccionar la opción Calcular en centro, que calcula la escala de mapa usando el centro del marco de mapa en lugar de una ubicación a lo largo del ecuador. Esta opción no se recomienda para el texto de escala (por ejemplo, 1:3.000).

Precaución:

No inserte el texto dinámico Usuario en el diseño. Este texto dinámico puede rellenarse con información sensible sobre el servicio de impresión.

Registrar la carpeta de plantillas de diseño con ArcGIS Server

ArcGIS Server debe poder acceder a carpeta que contiene sus plantillas de diseño (ya sea un servidor federado con su portal o su servidor independiente). Si el servidor puede acceder a la carpeta, puede registrarla con el servidor; de lo contrario, copie el contenido de la carpeta en el servidor de ArcGIS Pro cuando comparta la herramienta web o publique el servicio de impresión.

Consulte Administrar data stores registrados en la Ayuda de ArcGIS Pro para obtener instrucciones.

Preparar las herramientas personalizadas

Cuando tenga todo listo, ejecute la herramienta de script Exportar mapa web, utilizando la carpeta que contiene sus plantillas de diseño personalizadas. Luego, ejecute la herramienta de script Obtener información de plantillas de diseño, haciendo referencia a la misma carpeta.

1. En el panel Geoprocesamiento, busque Cajas de herramientas > Herramientas de servidor > Impresión.
2. Haga doble clic en la herramienta Exportar mapa web para abrirla.
3. Deje el parámetro Mapa Web como JSON como #.

   Para obtener imágenes que se puedan imprimir, los usuarios de este servicio enviarán su propio mapa web JSON para este parámetro. Los widgets de impresión de las API Web de ArcGIS, las plantillas de aplicaciones de ArcGIS Enterprise y ArcGIS Web AppBuilder generan este JSON.

4. Deje el parámetro Archivo de salida como está.

   Después de publicar esta herramienta en el servidor, la salida se ubica en el directorio de trabajos del servidor.

5. En el parámetro Carpeta de plantillas de diseño, haga clic en el botón Examinar y busque la carpeta en la que se almacenan sus diseños.

   Sugerencia:

   Si solo desea hacer referencia a los diseños básicos instalados con ArcGIS Enterprise, deje en blanco este parámetro.

6. También puede elegir un diseño de la lista desplegable Plantilla de diseño.

   Este será el diseño predeterminado cuando los usuarios ejecuten el servicio.

7. Haga clic en Ejecutar para ejecutar la herramienta.
8. Vaya a Cajas de herramientas > Herramientas de servidor > Impresión y haga doble clic en la herramienta de script Get Layout Templates Info para abrirla.

La herramienta de script Obtener información de plantillas de diseño le permite agregar la tarea Obtener información de plantillas de diseño a los servicios de impresión. Esta tarea proporciona el tamaño de la página de diseño y el tamaño de un marco de mapa. También muestra si los siguientes elementos de diseño están disponibles:

• Leyenda
• Texto del título
• Texto de copyright
• Texto de autor
• Elementos de texto personalizados

9. Elija la misma Carpeta de plantillas de diseño que especificó al ejecutar la herramienta Exportar mapa web en el paso 5. Haga clic en Ejecutar para ejecutar el script.

Ahora que ha ejecutado dos herramientas de geoprocesamiento con sus diseños personalizados, puede compartir los resultados con ArcGIS Enterprise. El flujo de trabajo a seguir dependerá de si está trabajando con un portal de ArcGIS Enterprise (con uno o varios sitios de servidor federado) o con un sitio de servidor independiente.

Compartir una herramienta web de impresión con el portal de ArcGIS Enterprise

Si trabaja con un portal de ArcGIS Enterprise, siga estos pasos para compartir los resultados de la herramienta de geoprocesamiento con el portal como una herramienta web:

1. En la pestaña Análisis de la cinta haga clic en Historial, o haga clic en la pestaña Historial del panel Catálogo. Haga clic con el botón derecho en el resultado Exportar mapa web y elija Compartir como > Herramienta web.

   Aparece el cuadro de diálogo Compartir como una herramienta web.

2. Utilice la opción Analizar para identificar cualquier posible problema.
3. En la pestaña General del cuadro de diálogo, sustituya los valores predeterminados de Detalles del elemento (nombre, resumen y etiquetas) según sea necesario. Si registró la carpeta de plantillas de diseño con el servidor como se describe más arriba, elija la opción Referencia a datos registrados; de lo contrario, elija Copiar todos los datos. Designe la carpeta del portal en la que desea que se guarde la herramienta web, y la carpeta del sitio de ArcGIS Server federado y el servidor en la que desea que se guarde su servicio de geoprocesamiento subyacente. A continuación, defina las opciones de uso compartido para esta herramienta web.
4. Cambie a la pestaña Configuración. Especifique un Modo de ejecución para la herramienta en la sección Parámetros. En la mayoría de casos, elegirá Sincrónico. Elija Asíncrono si espera que las solicitudes a la herramienta tarden más de unos segundos (como, por ejemplo, al imprimir un mapa grande y detallado). A continuación, defina un Nivel del mensaje de registro para la herramienta.

   Nota:

   Los servicios de impresión que tienen el Modo de ejecución del tipo Asíncrono no se pueden utilizar en aplicaciones de ArcGIS Web AppBuilder.

5. Cambie a la pestaña Contenido. Haga clic en Agregar herramienta y agregue el resultado de Obtener información de plantillas de diseño.

   Esta herramienta web incorpora ahora las dos herramientas que ejecutó.

6. Haga clic en Compartir para compartir la herramienta web.
7. Verifique que su herramienta web se haya publicado correctamente; debe estar disponible en su portal de ArcGIS Enterprise y su servicio de geoprocesamiento subyacente debe estar disponible en ArcGIS Server Manager.

Ahora se puede hacer referencia a su nueva herramienta web en los widgets de impresión ofrecidos por las API Web de ArcGIS y en el Visor de mapas del portal. La URL de la herramienta web está disponible en su página del elemento en el portal de ArcGIS Enterprise.

La herramienta web se basa en un servicio de impresión personalizado de su sitio de ArcGIS Server federado. Puede designar este servicio como el servicio de impresión de su portal de ArcGIS Enterprise. Abra ArcGIS Server Manager y localice el servicio. A continuación, copie su URL, incluida la tarea Exportar mapa web, y péquela en el cuadro de diálogo Servicios de utilidades de Impresión.

Publicar un servicio de impresión en el servidor independiente

Si trabaja con un sitio de ArcGIS Server independiente de la versión 10.6 o posterior, puede publicar un servicio de impresión desde ArcGIS Pro en el servidor siguiendo los pasos que aparecen a continuación.

1. Agregue una conexión de administrador al sitio de ArcGIS Server. La conexión debe ser una conexión de administrador para poder publicar los servicios de geoprocesamiento en el servidor independiente.
2. En el panel Catálogo, haga clic con el botón derecho en la conexión del servidor y elija Publicar. Utilice la opción Servicio de geoprocesamiento para iniciar la ventana Elemento(s) seleccionado(s) del historial. Seleccione el elemento Exportar mapa web de la lista para iniciar la ventana Publicar servicio de geoprocesamiento.
3. Utilice la opción Analizar para identificar cualquier posible problema.
4. En la pestaña General del cuadro de diálogo, sustituya los valores predeterminados de Detalles del elemento (nombre, resumen y etiquetas) según sea necesario. Si registró la carpeta de plantillas de diseño con el servidor como se describe más arriba, elija la opción Referencia a datos registrados; de lo contrario, elija Copiar todos los datos. Designe la carpeta de servidor en la que desea que se guarde su servicio de geoprocesamiento subyacente. A continuación, defina las opciones de uso compartido para esta herramienta web.
5. Cambie a la pestaña Configuración. Especifique un Modo de ejecución para la herramienta en la sección Parámetros. En la mayoría de casos, elegirá Sincrónico. Elija Asíncrono si espera que las solicitudes al servicio de impresión tarden más de unos segundos (como, por ejemplo, al imprimir un mapa grande y detallado). A continuación, defina un Nivel del mensaje de registro para la herramienta.
6. Cambie a la pestaña Contenido. Haga clic en Agregar herramienta y agregue el resultado de Obtener información de plantillas de diseño.

   Este servicio de impresión incorpora ahora las dos herramientas que ejecutó.

7. Haga clic en Publicar para empezar a publicar el servicio de impresión.
8. Compruebe que el servicio de impresión esté publicado correctamente. Debería estar disponible en ArcGIS Server Manager.

Ahora se puede hacer referencia al nuevo servicio en los widgets de impresión ofrecidos por las API Web de ArcGIS. Encontrará la URL del servicio de impresión en su Directorio de servicios de ArcGIS.

Para registrar el servicio de impresión personalizado con un portal de ArcGIS Enterprise, copie esta URL, incluida la tarea Exportar mapa web, y péguela en el cuadro de diálogo Servicios de utilidades de Impresión. Tenga en cuenta que el portal solo aceptará una URL que use HTTPS en su servicio de utilidades de impresión.

Actualizar las plantillas de diseño

Si desea actualizar los diseños en su carpeta de plantillas de diseño, el flujo de trabajo apropiado está determinado por si registró la carpeta de plantillas de diseño con el servidor antes de compartir (consulte la sección "Registrar las plantillas de diseño con ArcGIS Server" situada más arriba). También depende de si desea agregar un nuevo diseño a la carpeta o solo actualizar un diseño existente. Esto se debe a que la tarea de geoprocesamiento que creó conserva una lista de los diseños que había en su carpeta de plantillas de diseño en el momento de ejecución.

Si registró su carpeta de plantillas de diseño con el servidor, antes de compartir, significa que el servidor puede ver sus diseños. Si realiza alguna actualización en los archivos de diseño existentes (.pagx) de la carpeta, los diseños modificados estarán disponibles de inmediato. Sin embargo, el servidor no verá ninguno de los nuevos diseños agregados después de compartir.

Por consiguiente, si se cumple alguna de las siguientes circunstancias, tendrá que volver a seguir el flujo de trabajo de arriba y compartir una nueva herramienta web o un nuevo servicio de impresión para que sus cambios estén disponibles para sus usuarios de ArcGIS Server:

• No registró su carpeta de plantillas de diseño con el servidor antes de compartir la herramienta web o el servicio de impresión, lo que significa que los diseños se copiaron al servidor en el momento de la publicación.
• Después de compartir la herramienta web o el servicio de impresión, desea agregar una nueva plantilla de diseño a la carpeta y ponerla a disposición de sus usuarios.