Compartir diseños personalizados para imprimir desde ArcGIS Pro

Si necesita disponer de capacidades de impresión en ArcGIS Enterprise fuera del alcance del servicio PrintingTools predeterminado, puede crear diseños personalizados en ArcGIS Pro. Puede compartir estos diseños en su portal como una herramienta web o publicarlos en un sitio de ArcGIS Server independiente como un servicio de geoprocesamiento. Los servicios de geoprocesamiento que permiten la impresión se denominan servicios de impresión.

No actualice los diseños que vienen con el servicio PrintingTools predeterminado y no agregue nuevos diseños y vuelva a publicar este servicio. En su lugar, ejecute la herramienta de script Exportar mapa web en ArcGIS Pro y comparta el resultado, lo que hace las veces de recurso adicional para imprimir mapas web.

Si comparte una herramienta web en el portal, el resultado de este tutorial se compartirá en el portal ArcGIS Enterprise donde ha iniciado sesión y el servicio de impresión que subyace a 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.

Creación de 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 el 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.

Nota:

Para admitir diseños personalizados creados en ArcGIS Pro 3.0 y versiones posteriores, su organización debe utilizar una versión de ArcGIS Server que sea la 11.0 o posterior.

Preparación de 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 agregar texto dinámico, siga estos pasos:
  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 posicionar 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 Sistemadel menú 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, por ejemplo {parcel-id}.
• Si inserta una barra de escala, recomendamos seleccionar la opción Calcular en el centro, que calcula la escala de mapa usando el centro del marco del 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).
• Introducido en 11.2, también puede agregar atributos y estadísticas como elementos de texto dinámicos en los diseños.

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.

Registro de 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.

Preparación de 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.

Utilizar plantillas de impresión personalizadas en el portal de ArcGIS Enterprise

Puede cargar plantillas de diseño (.pagx) y plantillas de informe (.rptt) como elementos de portal que se pueden pasar a servicios de impresión individuales. Realice estos pasos para cargar una plantilla de impresión personalizada.

1. Cree una plantilla de diseño o informe en ArcGIS Pro.
2. Guarde la plantilla como archivo .pagx o .rptt.
3. Inicie sesión en su portal.
4. Haga clic en Contenido.
5. Haga clic en Nuevo elemento.
6. Arrastre y suelte el archivo de plantilla o haga clic en Su dispositivo y seleccione el archivo.

Ahora es posible pasar la plantilla a los servicios de impresión por medio de los parámetros Layout_Item_ID y Report_Item_ID.

Para obtener más información, consulte los temas Crear una plantilla de informe personalizada y Archivos de diseño.

Limitaciones

Existen las siguientes limitaciones al utilizar plantillas de informe personalizadas:

• Los elementos deben estar en el mismo portal cuando el servidor de servicios de impresión está federado. Por ejemplo, un servicio de impresión que se ejecuta en un portal A no puede acceder al elemento del portal B.
• Los servicios de impresión predeterminados de los servicios de impresión listos para usar y ArcGIS GIS Server no admiten esta capacidad.
• Los clientes web no admiten esta capacidad en la actualidad. En su lugar, debe escribir una API de Javascript personalizada.

Publicar un servicio de impresión en el portal de ArcGIS Enterprise para habilitar informes

Introducido en 11.2, puede publicar servicios de impresión de ArcGIS Pro 3.2 o posterior para habilitar la impresión de informes basados en plantillas de diseño (.pagx), plantillas de informe (.rptx) o ambas.

Tipos de informes

Existen tres tipos de informes que puede generar a través de un servicio de impresión:

• Diseños con elementos de texto dinámicos: salida de una sola página que incluye un mapa y atributos y estadísticas que se muestran por medio de elementos de texto dinámicos.
• Informes sin mapas: salida de varias páginas que puede incluir atributos, estadísticas, gráficos y adjuntos. Solo admite un formato PDF.
• Diseños con o sin elementos de texto dinámicos y un informe: salida de varias páginas que incluye un diseño y un informe. Solo admite un formato PDF.

Publicar un informe

Para publicar un informe, realice los pasos que figuran abajo:

1. Cree un diseño con elementos de texto dinámicos o una plantilla de informe en ArcGIS Pro.
2. Guarde la plantilla como una plantilla de diseño (.pagx) o informe (.rptx) en la carpeta de archivos de plantilla.
3. En ArcGIS Pro, abra la herramienta Exportar mapa web.
4. Establezca el parámetro Layout Templates Folder en la carpeta de archivos de plantilla en la que ha guardado la plantilla.
5. Ejecute la herramienta Exportar mapa web.
6. Vaya a Cajas de herramientas > Herramientas de servidor > Impresión y haga doble clic en las herramientas de script Get Layout Templates Info o Get Report Templates Info en función de si está publicando diseños, informes o ambos.
7. Publique las plantillas como un servicio de impresión.

Limitaciones

Existen las siguientes limitaciones al utilizar informes:

• Los servicios de impresión predeterminados de los servicios de impresión listos para usar y ArcGIS GIS Server no admiten esta capacidad.
• Visor de mapas y ArcGIS Experience Builder no admiten esta capacidad.
• Los clientes web no admiten esta capacidad en la actualidad. En su lugar, debe utilizar la API de Javascript para crear un widget o una aplicación personalizada.

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 una opción de Modo de ejecución para la herramienta en la sección Parámetros. En la mayoría de casos, deberá elegir Síncrono. 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 valor de Nivel del mensaje de registro para la herramienta.
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. Compruebe que la herramienta web esté publicada correctamente.

   La herramienta web está disponible en su portal ArcGIS Enterprise y su servicio de geoprocesamiento subyacente está 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éguela 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 una opción de Modo de ejecución para la herramienta en la sección Parámetros. En la mayoría de casos, deberá elegir Síncrono. 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 valor de 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.

Actualización de 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 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 tiempo 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) en 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.