Servicio de producción topográfica

Licencia:

Para utilizar este recurso, se requiere una licencia ArcGIS GIS Server Advanced y una licencia de extensión de servidor de ArcGIS Topographic Mapping.

El Servicio de producción topográfica es una extensión de objeto servidor (SOE) para un servicio de mapas. Permite realizar tareas de elaboración topográfica en el servicio de mapas, como la creación de mapas topográficos basados en las especificaciones estándar del sector para productos cartográficos.

Más información sobre el Servicio de producción topográfica

Más información sobre REST SOEs

Más información sobre el Directorio de servicios de ArcGIS Server

Publicar el servicio

La extensión Topographic Mapping en ArcGIS Pro le permite publicar el Servicio de producción topográfica.

Configuración en ArcGIS Server

Puede configurar las operaciones que el servicio puede realizar y otras propiedades en ArcGIS Server Manager una vez que el servicio se publique. Estos ajustes aparecen cuando marca la casilla de verificación Producción topográfica o hace clic en Producción topográfica, y solo se aplican si la casilla está marcada.

Operaciones

En SOE se admiten los siguientes recursos y operaciones:

• addProduct: agrega una definición de un producto de mapa al servicio que puede utilizarse para generar un mapa.

• calculateExtent: calcula un área de interés (AOI) personalizada para un producto y una versión concretos.

• delete: elimina los trabajos que se han ejecutado o han sido cancelados, de modo que ya no aparecen en consultas ni ocupan espacio en el servidor.

• generateProduct: automatiza el proceso de producción de un diseño o mapa basado en una definición de producto de mapa existente.

• removeProduct: elimina un producto cartográfico del servicio de producción topográfica.

• updateProduct: actualiza las propiedades de un producto de mapa existente.

• products: obtiene los productos de mapa compatibles con el servicio de producción topográfica.

  • product: obtiene un único producto de mapa de entre los productos compatibles con el servicio de producción topográfica.

• jobs: contiene las operaciones que implican trabajos que se ejecutan.

  • cancel: cancela un trabajo enviado a través del extremo generateProduct.

  • job: rastrea el estado de un trabajo ejecutado por el extremo generateProduct. Devuelve el estado, la fecha de inicio, la fecha de última modificación y los mensajes del trabajo.

  • query: rastrea el estado de los trabajos ejecutados por el extremo generateProduct. Devuelve el estado, la fecha de inicio, la fecha de última modificación y los mensajes de un conjunto de trabajos.

• workflows: contiene los recursos y operaciones relacionados con los flujos de trabajo de producción topográfica que utilizan ArcGIS Workflow Manager.

  • taskGroups: contiene las operaciones en las que participan los grupos de trabajo de SOE.

    • addTaskGroup: combina una definición de flujo de trabajo con los requisitos específicos de una organización en un grupo de tareas SOE que puede utilizarse con la operación createTaskGroupJob para crear trabajos SOE.

    • createTaskGroupJob: utiliza un grupo de tareas SOE para crear un trabajo de grupo de tareas SOE que da lugar a un trabajo padre en Workflow Manager y sus trabajos secundarios.

    • getTaskGroups: retorna detalles sobre un grupo de tareas SOE.

    • insertTasks: inserta un conjunto de tareas en un trabajo de producción existente de un grupo de tareas SOE.

    • removeTaskGroup: elimina un grupo de tareas SOE.

    • updateTaskGroup: actualiza un grupo de tareas SOE.

  • tasks: contiene las operaciones relacionadas con los trabajos del grupo de tareas.

    • updateTask: actualiza los valores de los parámetros de una tarea en un trabajo de grupo de tareas.

    • executeTaskJob: ejecuta el trabajo del grupo de tareas SOE creado por la operación createTaskGroupJob.

    • getTask: devuelve los detalles de una tarea SOE

  • projects: contiene las operaciones que permiten la integración entre el servidor de producción topográfica y los flujos de trabajo basados en servicios de Workflow Manager.

    • addProject: operación de parámetro único que acepta el objeto JSON que define el proyecto y todas sus fases.

    • queryProject: devuelve una matriz de objetos JSON que representa proyectos.

    • removeProject: elimina un proyecto.

    • updateProject: actualiza las propiedades definidas en el JSON de un proyecto.

Base de datos de producción topográfica

El Servicio de producción topográfica utiliza una geodatabase para almacenar datos. El tipo de geodatabase que se utiliza está determinado por un archivo de conexión con el motor de base de datos espacial (SDE). En Server Manager se debe especificar la ruta de acceso a un archivo de conexión SDE en el cuadro de texto Base de datos de producción topográfica. La cuenta de ArcGIS Server debe tener acceso de lectura a la ubicación del archivo de conexión .sde.

Sugerencia:

La ruta a este archivo también se puede especificar al publicar el Servicio de producción topográfica en ArcGIS Pro mediante el cuadro de texto tmserverDatabase.

Más información sobre el Servicio de producción topográfica en ArcGIS Pro

La geodatabase del servidor topográfico contiene múltiples tablas. La tabla TPS_Property contiene las propiedades que se definen al publicar el servicio desde ArcGIS Pro y a las que se puede acceder desde ArcGIS Server Manager una vez publicado el servicio. La tabla también almacena las propiedades de cada servicio que se publica con el SOE de producción topográfica habilitado. En ArcGIS Enterprise 11.2, la tabla contiene las siguientes propiedades: ObjectID, ServiceIdentifier, Name y Value.

Nota:

La columna ServiceIdentifier contiene el Id. único del servicio. Si el valor del Id. es -1, la propiedad es una propiedad global que se aplica a todos los servicios.

Cada fila de la tabla TPS_Property es una propiedad. La siguiente tabla describe cada propiedad:

Propiedad	Descripción
AdditionalOutputPaths	Rutas adicionales de archivo de salida para la operación generateProduct. Las rutas de los archivos deben ir separadas por un punto y coma. Precaución: La operación de copiar los resultados a estas ubicaciones fallará si la cuenta de ArcGIS Server no tiene acceso de lectura y escritura al archivo especificado. Los archivos de datos y de salida que se encuentren en cualquiera de las ubicaciones especificadas se eliminan durante las limpiezas definidas por la propiedad CleanupInterval.
AdminGroupId	Una propiedad global que permite a un grupo de usuarios cancelar o eliminar trabajos en las aplicaciones web incluidas en la extensión de servidor ArcGIS Topographic Mapping. Para otorgar estos privilegios a un grupo, actualiza la propiedad AdminGroupId para que coincida con el valor del Id. del grupo que corresponda al grupo que haya creado para una aplicación web. En una implementación independiente de ArcGIS Server, puede asignar estos privilegios a un grupo indicando como valor de esta propiedad el nombre del rol de un usuario con el tipo de rol de administrador de ArcGIS Server. Más información sobre los roles en ArcGIS Server Manager
AllowedSDEAuthMode	El modo de autenticación SDE que está permitido. Son compatibles los siguientes: Precaución: Cambiar el modo modificando este valor supone un riesgo para la seguridad. No se recomienda modificar esta configuración. OSA: Autenticación del sistema operativo: autenticación realizada por el sistema operativo o el dominio de red. Esta es la opción predeterminada. SGBD: el sistema de gestión de bases de datos gestiona el nombre de usuario y la contraseña. Básica: autenticación sencilla mediante nombre de usuario y contraseña; las credenciales se almacenan y gestionan mediante la configuración de ArcGIS Server o SDE.
AllowedServices	Una lista de servicios que se encuentran fuera del entorno federado y que una organización ha considerado seguros. Esta lista solo debe contener servicios públicos y puede estar formada por valores separados por comas. La estructura de la URL del servicio determina qué servicios están permitidos. Por ejemplo: https://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer/3: solo permite el servicio de capas para los estados (3 es estados). https://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer: permite los servicios de capas en ese servidor de mapas. https://sampleserver6.arcgisonline.com/arcgis/: permite todos los servicios del dominio sampleserver6.arcgisonline.com.
AutoUpdateProducts	Especifica si las actualizaciones de las definiciones de los productos cartográficos —realizadas en el archivo .json— se aplican a las definiciones de los productos cartográficos de la base de datos geográficos del servidor topográfico al reiniciar el servidor. True: al reiniciar el servicio, las definiciones de productos cartográficos existentes en la base de datos se actualizan automáticamente con las definiciones de productos cartográficos del archivo .json instalado junto con los archivos de datos del producto Enterprise. Esta es la opción predeterminada. False: al reiniciar el servicio, las definiciones de productos cartográficos existentes no se actualizan automáticamente con las definiciones de productos cartográficos del archivo .json instalado junto con los archivos de datos del producto Enterprise.
CleanupInterval	El número de horas que transcurren antes de que los datos temporales utilizados para generar un producto cartográfico y los propios productos cartográficos resultantes se eliminen del servidor. La opción predeterminada es 24.
DateTimeFormat	El formato de fecha y hora que se utiliza cuando se emplea un token que incluye la fecha o la hora en el nombre de un archivo de salida de un trabajo.
DistributedJobFolders	Esta propiedad está reservada para su uso en una futura versión y, por el momento, no es compatible.
DistributedProcessing	Esta propiedad está reservada para su uso en una futura versión y, por el momento, no es compatible.
ExtractionProgress	Especifica si se actualiza el progreso de un trabajo mientras se extraen los datos para dicho trabajo. La opción predeterminada es False. Sugerencia: Cuando se trabaja con implementaciones de gran volumen, un valor de False reduce el tráfico de la base de datos.
extractionTimeout	El tiempo, en segundos, durante el cual puede ejecutarse la extracción de datos antes de que se agote el tiempo de espera.
<file type>	Nota: Esta es una propiedad global; establece el valor ServiceIdentifier en -1. Los siguientes tipos de archivos son compatibles: .aprx .dt2 .gdb .pagx .pdf .tiff .zip Se pueden utilizar los siguientes tokens para definir el nombre del archivo de salida de un trabajo: [JobName]: el valor del parámetro outputName para la operación SOE generateProduct o el nombre de la exportación en la app MPS. [JobId]: el identificador único global (GUID) que se crea al exportar un producto cartográfico mediante la operación SOE generateProduct o la aplicación MPS. [JobStartDate]: la fecha de inicio del trabajo en formato de hora UTC local. [User]: el usuario que inició el trabajo. [ProductName]: el nombre del producto cartográfico especificado para el trabajo. [ProductVersion]: la versión del producto de mapas especificada para el trabajo. [SheetIdentifier]: el valor del Número de Referencia Nacional (NRN) correspondiente al índice seleccionado. [MGRS:]: Sistema de referencia de cuadrícula militar (MGRS) que indica la ubicación de la hoja. [MGRS]—4Q [MGRS:100km]—4QFJ [MGRS:10km]—4QFJ16 [MGRS:1km]—4QFJ1267 [MGRS:100m]—4QFJ123678 [MGRS:10m]—4QFJ12346789 [MGRS:1m]—4QFJ1234567890 [MGRS:ICM]—1234 [AOI.]: un valor de la tabla de atributos del índice AOI. Nota: Este token aparece en el nombre si el campo especificado contiene un valor nulo. Si el formato no incluye la extensión del tipo de archivo, esta se agrega automáticamente. Precaución: Incluya el identificador [JobId], el identificador [JobStartDate] o ambos para evitar conflictos en los nombres de los archivos.
jobHistory	El número de días durante los que se almacenan en la base de datos los datos relacionados con los trabajos de elaboración de mapas. La opción predeterminada es 365. Los registros relacionados con el trabajo que figuran en la base de datos se eliminarán definitivamente transcurrido el número de días establecido.
LastCleanup	La fecha y la hora en que se eliminaron por última vez del servidor los datos temporales de un trabajo.
productType	Los tipos de mapas compatibles con el servicio. Los valores múltiples deben ir separados por una coma; por ejemplo: TM, JOG. Las definiciones de productos de mapa tienen una propiedad type y el servicio devuelve los productos de mapa cuyo valor coincide con el valor especificado.
resourceCheckInterval	El intervalo de tiempo entre comprobaciones para determinar si se cumplen los umbrales de recursos establecidos para que se activen las limpiezas. Los recursos incluyen el espacio en disco. El valor por predeterminado es 300s (300 segundos). Importante: Esto se considera una limpieza parcial, lo que significa que se eliminan los archivos temporales de los trabajos de la carpeta TopographicProduction, se actualizan los registros de los trabajos de la tabla TPS_JOB con un valor cleaned y los archivos copiados en otros directorios permanecen intactos.
storageHighThreshold	El porcentaje de uso del disco que activa una limpieza obligatoria, comenzando por el trabajo más antiguo. El valor predeterminado es %90 (90 %). Importante: Esto se considera una limpieza parcial, lo que significa que se eliminan los archivos temporales de los trabajos de la carpeta TopographicProduction, se actualizan los registros de los trabajos de la tabla TPS_JOB con un valor cleaned y los archivos copiados en otros directorios permanecen intactos.
storageLowThreshold	El porcentaje de uso del disco que debe alcanzarse para que se active una limpieza obligatoria de SOE debido a un porcentaje elevado de uso del disco. El valor predeterminado es %80 (80 %). Importante: Esto se considera una limpieza parcial, lo que significa que se eliminan los archivos temporales de los trabajos de la carpeta TopographicProduction, se actualizan los registros de los trabajos de la tabla TPS_JOB con un valor cleaned y los archivos copiados en otros directorios permanecen intactos.
UseJobIdFolder	Una propiedad global que especifica si la carpeta de salida predeterminada de un trabajo se nombrará en función del Id. del trabajo. La opción predeterminada es True. Si el valor se establece en False, la URL de salida en la respuesta jobStatus no contendrá ningún Id. de trabajo.
Version	La versión de la geodatabase del servidor topográfico. Nota: A partir de ArcGIS Enterprise 12.1, este valor coincide con la versión actual de Enterprise.
WorkflowItemIdentifier	La cadena de Id. asociada a un elemento del flujo de trabajo de producción topográfica.
WorkflowLocalJobFolder	La ruta de acceso a la ubicación de la carpeta que contiene los datos de los trabajos locales.