Service Topographic Production (Production topographique)

Licence :

Pour utiliser cette ressource, une licence ArcGIS GIS Server Advanced et une licence d’extension de serveur ArcGIS Topographic Mapping sont requises.

La ressource Service Topographic Production (Production topographique) est une extension d’objet serveur (SOE) vers un service de carte. Elle permet d’exécuter des fonctions de production topographique sur le service de carte en générant des cartes topographiques en fonction des spécifications de produits cartographiques standard du secteur.

En savoir plus sur le service Topographic Production (Production topographique)

En savoir plus sur les SOE REST

En savoir plus sur le répertoire des services ArcGIS Server

Publier le service

L’extension d’ArcGIS Pro Topographic Mapping permet de publier le service Topographic Production (Production topographique).

Configuration dans ArcGIS Server

Vous pouvez configurer les opérations que le service peut effectuer ainsi que d’autres propriétés dans ArcGIS Server Manager après la publication du service. Ces paramètres apparaissent lorsque vous cochez la case Topographic Production (Production topographique) ou que vous cliquez sur Topographic Production (Production topographique) et ne s’appliquent que si la case est cochée.

Opérations

Les ressources et opérations suivantes sont prises en charge dans le SOE :

• addProduct : ajoute la définition d’un produit cartographique au service, qui peut être utilisée pour générer une carte.

• calculateExtent : calcule une zone d’intérêt (AOI) personnalisée pour un produit et une version donnés.

• delete : supprime les tâches qui ont été exécutées ou annulées afin qu’elles n’apparaissent plus dans les requêtes ou n’occupent plus d’espace sur le serveur.

• generateProduct : automatise la génération d’une mise en page ou d’une carte selon une définition de produit cartographique existante.

• removeProduct : supprime un produit cartographique du service Topographic Production (Production topographique).

• updateProduct : met à jour les propriétés d’un produit cartographique existant.

• products : récupère les produits cartographiques pris en charge par le service Topographic Production (Production topographique).

  • product : récupère un seul produit cartographique parmi les produits pris en charge par le service Topographic Production (Production topographique).

• jobs : contient les opérations impliquant les tâches exécutées.

  • cancel : annule une tâche soumise via le point de terminaison generateProduct.

  • job : suit le statut d’une tâche exécutée par le point de terminaison generateProduct. Renvoie le statut, la date de début, la date de dernière modification et les messages pour la tâche.

  • query : suit le statut des tâches exécutées par le point de terminaison generateProduct. Renvoie le statut, la date de début, la date de dernière modification et les messages pour un ensemble de tâches.

• workflows : contient les ressources et opérations impliquant les processus de production topographique qui utilisent ArcGIS Workflow Manager.

  • taskGroups : contient les opérations impliquant les groupes de tâches SOE.

    • addTaskGroup : combine une définition de processus avec les spécificités requises par une organisation en un groupe de tâches SOE qui peut être utilisé par l’opération createTaskGroupJob pour créer des tâches SOE.

    • createTaskGroupJob : utilise un groupe de tâches SOE pour créer une tâche du groupe de tâches SOE qui génère une tâche parent Workflow Manager et ses tâches enfant.

    • getTaskGroups : renvoie des détails sur un groupe de tâches SOE.

    • insertTasks : insère un ensemble de tâches dans une tâche de production existante du groupe de tâches SOE.

    • removeTaskGroup : supprime un groupe de tâches SOE.

    • updateTaskGroup : met à jour un groupe de tâches SOE.

  • tasks : contient les opérations impliquant les tâches du groupe de tâches.

    • updateTask : met à jour les valeurs de paramètre d’une tâche dans une tâche du groupe de tâches.

    • executeTaskJob : exécute la tâche du groupe de tâches SOE créée par l’opération createTaskGroupJob.

    • getTask : renvoie les détails relatifs à une tâche SOE.

  • projects : contient les opérations qui permettent l’intégration entre le serveur de production topographique et les processus basés sur le service Workflow Manager.

    • addProject : opération à un seul paramètre qui accepte l’objet JSON définissant le projet et toutes ses phases.

    • queryProject : renvoie une matrice d’objets JSON qui représente les projets.

    • removeProject : supprime un projet.

    • updateProject : met à jour les propriétés définies dans le JSON d’un projet.

Base de données de production topographique

Une géodatabase est utilisée par le service Topographic Production (Production topographique) pour stocker les données. Le type de géodatabase utilisé est déterminé par un fichier de connexion au moteur de base de données spatiales (SDE). Dans Server Manager, le chemin vers un fichier de connexion SDE doit être spécifié dans la zone de texte Topographic Production Database (Base de données de production topographique). Le compte ArcGIS Server doit posséder des droits d’accès en lecture sur l’emplacement du fichier de connexion .sde.

Conseil :

Le chemin vers ce fichier peut également être spécifié lorsque le service Topographic Production (Production topographique) est publié dans ArcGIS Pro à l’aide de la zone de texte tmserverDatabase.

En savoir plus sur la publication du service Topographic Production (Production topographique) dans ArcGIS Pro

La géodatabase du serveur topographique contient plusieurs tables. La table TPS_Property contient les propriétés définies lors de la publication du service depuis ArcGIS Pro et peut être consultée depuis ArcGIS Server Manager après la publication du service. Elle stocke également les propriétés de chaque service publié avec le SOE de production topographique activé. Dans ArcGIS Enterprise 11.2, la table contient les propriétés suivantes : ObjectID, ServiceIdentifier, Name et Value.

Remarque :

La colonne ServiceIdentifier contient l’ID unique du service. Si la valeur de l’ID est -1, la propriété est globale et s’applique à tous les services.

Chaque ligne de la table TPS_Property est une propriété. Le tableau suivant décrit chaque propriété :

Propriété	Description
AdditionalOutputPaths	Chemins d’accès aux fichiers en sortie supplémentaires pour l’opération generateProduct. Les chemins d’accès aux fichiers doivent être séparés par des points-virgule. Attention : L’opération de copie des sorties vers ces emplacements échoue si le compte ArcGIS Server ne dispose pas d’un accès en lecture et écriture au fichier spécifié. Les données et les fichiers en sortie à l’un des emplacements spécifiés sont supprimés lors des nettoyages définis par la propriété CleanupInterval.
AdminGroupId	Propriété globale qui permet à un groupe d’utilisateurs d’annuler ou de supprimer des tâches dans les applications Web incluses avec l’extension de serveur ArcGIS Topographic Mapping. Pour fournir ces privilèges à un groupe, mettez à jour la propriété AdminGroupId pour qu’elle corresponde à la valeur d’un ID de groupe correspondant à un groupe que vous créez pour une application Web. Dans un déploiement ArcGIS Server autonome, vous pouvez attribuer ces privilèges à un groupe en fournissant la valeur du nom de rôle d’un utilisateur avec un type de rôle Administration ArcGIS Server comme valeur pour cette propriété. En savoir plus sur les rôles dans ArcGIS Server Manager
AllowedSDEAuthMode	Mode d’authentification SDE autorisé. Les produits suivants sont pris en charge : Attention : La modification du mode en mettant à jour cette valeur représente un risque pour la sécurité. Il n’est pas recommandé de changer ce paramètre. OSA (authentification du système d’exploitation) : authentification effectuée par le système d’exploitation ou le domaine réseau. Il s’agit de l’option par défaut. SGBD : système de gestion de base de données qui gère le nom d’utilisateur et le mot de passe. Basic : authentification simple par nom d’utilisateur et mot de passe. Les informations d’identification sont stockées et gérées par la configuration ArcGIS Server ou SDE.
AllowedServices	Liste de services en dehors de l’environnement fédéré qu’une organisation a jugés sûrs. Cette liste ne doit contenir que des services publics et peut être composée de valeurs séparées par une virgule. La structure de l’URL du service a une incidence sur les services autorisés. Par exemple : https://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer/3 : n’autorise que le service de couche pour les états (3 est états). https://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer : autorise les services de couche dans ce serveur de carte. https://sampleserver6.arcgisonline.com/arcgis/ : autorise tous les services sur le domaine sampleserver6.arcgisonline.com.
AutoUpdateProducts	Indique si les mises à jour des définitions de produits cartographiques (effectuées dans le fichier .json) sont propagées aux définitions de produits cartographiques dans la géodatabase du serveur topographique lors du redémarrage du serveur. True : lors du redémarrage du service, ses définitions de produits cartographiques existantes dans la base de données sont automatiquement mises à jour avec les définitions de produits cartographiques provenant du fichier .json installé avec les fichiers de données de produit Enterprise. Il s’agit de l’option par défaut. False : lors du redémarrage du service, ses définitions de produits cartographiques existantes ne sont pas automatiquement mises à jour avec les définitions de produits cartographiques provenant du fichier .json installé avec les fichiers de données de produit Enterprise.
CleanupInterval	Nombre d’heures avant que les données temporaires utilisées pour générer un produit cartographique et les produits cartographiques en sortie ne soient supprimés du serveur. La valeur par défaut est 24.
DateTimeFormat	Format de date et d’heure lorsqu’un jeton impliquant une date ou une heure est utilisé dans le nom de fichier en sortie d’une tâche.
DistributedJobFolders	Cette propriété est réservée à une utilisation dans une version ultérieure et n’est pas prise en charge actuellement.
DistributedProcessing	Cette propriété est réservée à une utilisation dans une version ultérieure et n’est pas prise en charge actuellement.
ExtractionProgress	Indique si l’avancement d’une tâche est mis à jour pendant l’extraction des données pour la tâche. La valeur par défaut est False. Conseil : Lors de l’utilisation de déploiements sur de grands volumes, la valeur False réduit le trafic de la base de données.
extractionTimeout	Durée d’extraction des données (en secondes) avant l’expiration du délai.
<file type>	Remarque : Il s’agit d’une propriété globale, dont la valeur ServiceIdentifier doit être définie sur -1. Les types de fichiers suivants sont pris en charge : .aprx .dt2 .gdb .pagx .pdf .tiff .zip Les jetons suivants peuvent être utilisés pour définir le nom de fichier en sortie d’une tâche : [JobName] : valeur du paramètre outputName dans l’opération SOE generateProduct ou nom de l’exportation dans l’application MPS. [JobId] : identifiant unique global (GUID) créé lors de l’exportation d’un produit cartographique à l’aide de l’opération SOE generateProduct ou de l’application MPS. [JobStartDate] : date de début de la tâche au format de date UTC local. [User] : utilisateur à l’origine de la tâche. [ProductName] : nom du produit cartographique spécifié par la tâche. [ProductVersion] : version du produit cartographique spécifiée par la tâche. [SheetIdentifier] : valeur du numéro de référence national (NRN) pour l’index sélectionné. [MGRS:] : Système de référence de carroyage militaire (MGRS, Military Grid Reference System) qui fournit l’emplacement de la feuille. [MGRS] : 4Q [MGRS:100km] : 4QFJ [MGRS:10km] : 4QFJ16 [MGRS:1km] : 4QFJ1267 [MGRS:100m] : 4QFJ123678 [MGRS:10m] : 4QFJ12346789 [MGRS:1m] : 4QFJ1234567890 [MGRS:ICM] : 1234 [AOI.] : valeur de la table attributaire d’un index AOI. Remarque : Ce jeton apparaît dans le nom si le champ spécifié contient une valeur nulle. S’il manque l’extension du type de fichier dans le format, elle est automatiquement ajoutée. Attention : Incluez le jeton [JobId], le jeton [JobStartDate], ou les deux, pour éviter les conflits de noms de fichiers.
jobHistory	Nombre de jours pendant lesquels les données relatives aux tâches de production de cartes sont stockées dans la base de données. La valeur par défaut est 365. Les enregistrements relatifs à la tâche dans la base de données sont définitivement supprimés après le nombre de jours défini.
LastCleanup	Date et heure de la dernière suppression des données temporaires d’une tâche sur le serveur.
productType	Types de produits cartographiques pris en charge par le service. Si plusieurs valeurs sont indiquées, elles doivent être séparées par une virgule. Par exemple : TM, JOG. Les définitions de produits cartographiques contiennent une propriété type. Le service renvoie les produits cartographiques avec une valeur correspondant à celle indiquée.
resourceCheckInterval	Délai entre les vérifications pour voir si les seuils de ressources définis pour déclencher les nettoyages sont respectés. Les ressources incluent l’espace disque. La valeur par défaut est 300s (300 secondes). Important : Cela est considéré comme un nettoyage en douceur, ce qui signifie que les fichiers de tâches temporaires sous le dossier TopographicProduction sont supprimés, les enregistrements de tâches dans la table TPS_JOB sont mis à jour avec la valeur cleaned et les fichiers copiés dans d’autres répertoires demeurent intacts.
storageHighThreshold	Pourcentage d’utilisation du disque qui déclenche un nettoyage obligatoire en commençant par la tâche la plus ancienne. La valeur par défaut est %90 (90 %). Important : Cela est considéré comme un nettoyage en douceur, ce qui signifie que les fichiers de tâches temporaires sous le dossier TopographicProduction sont supprimés, les enregistrements de tâches dans la table TPS_JOB sont mis à jour avec la valeur cleaned et les fichiers copiés dans d’autres répertoires demeurent intacts.
storageLowThreshold	Pourcentage d’utilisation du disque à atteindre lorsqu’un nettoyage SOE obligatoire est déclenché en raison d’un pourcentage élevé d’utilisation du disque. La valeur par défaut est %80 (80 %). Important : Cela est considéré comme un nettoyage en douceur, ce qui signifie que les fichiers de tâches temporaires sous le dossier TopographicProduction sont supprimés, les enregistrements de tâches dans la table TPS_JOB sont mis à jour avec la valeur cleaned et les fichiers copiés dans d’autres répertoires demeurent intacts.
UseJobIdFolder	Propriété globale qui indique si le dossier en sortie par défaut d’une tâche est nommé en fonction de l’ID de tâche. La valeur par défaut est True. Si la valeur est définie sur False, l’URL en sortie dans la réponse jobStatus ne contient aucun ID de tâche.
Version	Version de la géodatabase du serveur topographique. Remarque : À partir d’ArcGIS Enterprise 12.1, cette valeur correspond à la version actuelle d’Enterprise.
WorkflowItemIdentifier	Chaîne ID associée à un élément de processus de production topographique.
WorkflowLocalJobFolder	Chemin d’accès à l’emplacement d’un dossier contenant les données des tâches locales.