Créer une catégorie Indoors

Disponible pour une organisation ArcGIS disposant d’une licence pour l’extension Indoors.

Les catégories d’une carte ArcGIS Indoors définissent le mode d’interaction des utilisateurs avec des données ponctuelles et surfaciques dans les applications mobiles Indoor Viewer et Indoors. Ces couches peuvent être dérivées de classes d’entités dans le modèle d'information ArcGIS Indoors ou de couches d’entités partagées votre organisation ArcGIS à partir d’autres systèmes métier. Les couches peuvent représenter des bons de travail, des actifs, des locaux à usage de bureaux ou d’autres entités. Il est possible de configurer ces catégories en groupes logiques pour aider les utilisateurs des applications Indoors à trouver rapidement des informations pertinentes, comme un porte-vélos, un ascenseur, une salle de conférence ou un bon de travail.

Conseil :

Planifiez la structure de vos groupes de catégories afin que chaque groupe ne contienne que des catégories issues d’une couche de cartes unique. Inclure des catégories issues de plusieurs couches de cartes dans un groupe de catégories unique peut affecter les performances et l’expérience de la fonctionnalité de recherche et d’exploration des applications Indoors.

L’assistant Create Indoors Category (Créer une catégorie Indoors) peut être utilisé pour créer une catégorie permettant d’interagir avec les entités des applications Indoor Viewer, Indoors for iOS et Indoors for Android. Pour créer des catégories par défaut pour une couche au lieu de créer individuellement chaque catégorie, utilisez l’assistant Create Default Indoors Categories (Créer des catégories Indoors par défaut).

Définir la catégorie

L’assistant est piloté contextuellement par la carte active et utilise des propriétés issues du contenu de la carte pour prérenseigner des paramètres. La catégorie créée par l’assistant est conservée dans la couche de carte sélectionnée. Le fait de modifier la carte active après avoir ouvert l’assistant réinitialise donc l’assistant et supprime la catégorie non terminée.

Il est important de tenir compte des groupes de catégories appropriés pour les entités lors de la création d’une nouvelle catégorie.

1. Démarrez ArcGIS Pro.
2. Ouvrez ou créez une carte ArcGIS Indoors.
3. Cliquez sur l’onglet View (Vue), puis sur Indoors > Configure Indoors Categories (Configurer des catégories Indoors).

   Le volet Configure Indoors Categories (Configurer des catégories Indoors) apparaît.

4. Dans la vue Categories (Catégories), cliquez sur le bouton Create Indoors Category (Créer une catégorie Indoors) .

   L’assistant Create Indoors Category (Créer une catégorie Indoors) apparaît.

   La fenêtre Define (Définir) répertorie les couches d’entités ponctuelles et surfaciques existantes disponibles dans la carte active. Vous pouvez développer la couche pour afficher ces couches ainsi que leurs symboles.

5. Sélectionnez la couche à partir de laquelle les nouveaux éléments de catégorie seront issus.

   Le champ de nom de la nouvelle catégorie que vous créez utilise le nom de la couche que vous choisissez dans la liste sauf si vous le modifiez.

   Remarque :

   La configuration de la catégorie reflète la couche choisie ; si vous changez de couche, les paramètres de l’assistant sont réinitialisés.

6. Si vous le souhaitez, vous pouvez modifier le nom de la catégorie.

   Il s’agit du nom qui apparaît sous forme de catégorie avec une icône dans le volet Explore (Explorer) des applications mobiles Indoor Viewer et Indoors. L’assistant restreint l’utilisation d’un nom de catégorie existant pour ne pas répertorier de catégories en double dans les applications Indoors Web et mobiles.

7. Cliquez sur la flèche de la liste déroulante Category Group (Groupe de catégories) et sélectionnez le groupe auquel vous souhaitez associer la nouvelle catégorie.

   Category Group (Groupe de catégories) répertorie toutes les catégories Indoors existantes. Vous pouvez créer une catégorie autonome en conservant la valeur par défaut None (Aucun).

8. Cliquez sur Next (Suivant).

Filtrer un sous-ensemble d’entités

Vous pouvez filtrer les entités de la nouvelle catégorie et obtenir un sous-ensemble d’entités à partir de la couche source en appliquant une expression de filtre. Une catégorie sans expression renvoie tous les enregistrements de la couche source. L’assistant définit automatiquement une expression si vous avez sélectionné un sous-type de couche pour la nouvelle catégorie dans la fenêtre Define (Définir). Trois méthodes permettent de définir ou de modifier une expression existante :

• Mode Clause : vous pouvez saisir des requêtes à l’aide des menus déroulants dans un générateur de requête SQL.
• Mode SQL : si vous connaissez les expressions SQL, vous pouvez créer une nouvelle expression dans l’éditeur SQL en bénéficiant d’une aide de syntaxe et du remplissage automatique.

  Remarque :

  Utilisez l’option Verify (Vérifier) pour vous assurer de la validité de votre expression avant de passer à l’étape suivante.

• Ajout d’expression : vous pouvez charger une requête prédéfinie à partir d’un fichier d’expression de requête (extension de fichier .exp) dans l’assistant et la modifier en mode Clause ou en mode SQL si nécessaire.

Indoors permet également d’utiliser des jetons pour la substitution de chaînes dans les expressions de requête. Vous pouvez configurer des catégories pour filtrer de manière dynamique des informations gérées par l’application. Définissez des jetons à l’aide de la syntaxe suivante :

{user.username}

Le jeton figure entre des accolades dans l’exemple précédent.

L’exemple d’éditeur SQL suivant représente un jeton utilisé dans une clause WHERE :

Field1 = ‘{user.username}’

L’exemple suivant identifie le jeton d’URL pris en charge par Indoors :

Nom	Chaîne	Description
Nom d’utilisateur	user.username	Remplace le texte dans la chaîne afin d’inclure le nom de l’utilisateur du portail Enterprise comme utilisateur connecté. Ce jeton est principalement utilisé dans une expression de requête pour construire des sous-catégories limitées aux éléments associés à l’utilisateur actuel (par exemple, des bons de travail attribués à l’utilisateur actuel). Il exige que l’utilisateur de l’application Indoors soit connecté au portail Enterprise.

Conseil :

Utilisez une expression simple pour définir les entités à inclure dans la catégorie, comme dans les exemples suivants :

• CATEGORY_SUBTYPE = 'DOORS'
• USE_TYPE = 'ENTRYWAY'

Définissez les catégories en indiquant les mêmes champs pour toutes les catégories devant être regroupées. Par exemple, si vous définissez des catégories pour le groupe de catégories Places + Things (Lieux et objets), toutes les catégories font référence au même champ, comme USE_TYPE dans leur expression.

1. Si vous le souhaitez, créez ou mettez à jour une expression.
2. Cliquez sur Suivant.

Apparier des champs au modèle Indoors

Lors de la configuration des catégories, vous pouvez indiquer un appariement pour définir les champs de la couche qui décrivent les champs requis lorsque la structure de la couche n’est pas conforme au modèle Indoors. Pour simplifier le processus de configuration des catégories, configurez votre carte comme tenant compte des étages en configurant les propriétés des couches Indoor de la carte avant de créer des catégories. Lors de la configuration des catégories pour les couches à partir d'une carte tenant compte des étages, les propriétés Facility (Ressource) et Level (Niveau) sont reconnues automatiquement et les sections d'appariement de ces propriétés ne sont pas affichées.

Remarque :

Si vous configurez des catégories pour les couches à partir d'un jeu de données Indoor dans une carte qui ne tient pas compte des étages, vous devez apparier les propriétés Facilities (Ressources) et Levels (Niveaux) dans l'assistant de création des catégories. Cela peut nécessiter l'ajout d'autres champs à vos couches d'entités s'ils n'existent pas déjà, comme le champ Facility ID (ID de la ressource). La configuration de votre carte pour qu'elle tienne compte des étages simplifie grandement le processus de création des catégories.

Si vous configurez des catégories pour une couche d'entités conforme au modèle Indoors, l'appariement de champ est automatiquement renseigné.

L'appariement de champ suivant est obligatoire :

• ID unique

Les appariements de champ suivants sont obligatoires si votre carte ne tient pas compte des étages :

• Au moins l’un des champs de bâtiment
• Au moins l’un des champs de niveau

Les appariements de champ suivants sont facultatifs :

• Champ de sous-titre
• Champ d’affichage (disponible uniquement pour les couches Web)
• Champs de bon de travail

ID unique

Certains systèmes disponibles pour la publication des couches d’entités n’indiquent pas d’ID d’objet statique fiable et un ID unique statique est requis pour la prise en charge de Indoors. Appariez ce champ à un ID unique représenté dans un autre champ disponible.

Propriété	Description
ID unique	ID unique statique de l’entité. Indoors utilise par défaut l’ID d’objet de la couche comme ID unique pour les entités d’une couche Web. Cela n’est toutefois pas toujours approprié car Indoors attend un ID unique statique pour les entités d’une couche Web qui ne change pas pendant la durée de vie de l’entité.

Lors de l’appariement de champs pour des catégories basées sur une couche d’entités, les champs suivants doivent être appariés pour que les étages d’un emplacement soient pris en compte dans les représentations sous forme de catégories dans les applications mobiles Indoor Viewer et Indoors. Les appariements de champ sont obligatoires lorsqu’un ou plusieurs champs requis sont manquants dans la couche source de la catégorie ou lors de la configuration de catégories pour un bon de travail, par exemple, dans le cas de couches d’entités publiées à partir d’un système de bons de travail ou d’un autre système de tickets.

Propriétés de ressource

Si vous n'avez pas configuré votre carte pour qu'elle tienne compte des étages, au moins l'un des appariements de champ suivants est obligatoire :

Propriété	Description
Facility ID (ID du bâtiment)	ID du bâtiment pour l’emplacement de l’entité.
Facility Name (Nom du bâtiment)	Nom du bâtiment pour l’emplacement de l’entité.

Propriétés de niveau

Si vous n'avez pas configuré votre carte pour qu'elle tienne compte des étages, au moins l'un des appariements de champ suivants est obligatoire :

Propriété	Description
ID de niveau	ID du niveau pour l’emplacement de l’entité.
Nom du niveau	Nom du niveau pour l’emplacement de l’entité.
Level Number (Numéro du niveau)	Numéro du niveau pour l’emplacement de l’entité.
Vertical Order (Ordre vertical)	Ordre vertical pour l’emplacement de l’entité.

Propriétés supplémentaires

Ces appariements de champ sont facultatifs :

Propriété	Description
Sous-titre	Utilisé pour afficher des sous-titres dans les différentes parties de Indoor Viewer.
Champ d’affichage	Utilisé pour afficher les titres des entités dans les différentes parties de Viewer. Obligatoire si votre couche d’entités n’inclut pas de propriété de champ d’affichage ou si vous souhaitez remplacer la propriété de champ d’affichage de la couche.

Propriétés du bon de travail

Ces appariements de champ sont obligatoires si vous souhaitez bénéficier des fonctions de liste des bons de travail dans Indoors. Si vous n’incluez pas ces appariements de champ supplémentaires dans la définition de catégorie d’une couche d’entités de bon de travail, la couche est considérée comme une couche Web traditionnelle dans les applications mobiles Viewer et Indoors avec l’expérience d’exploration traditionnelle des couches d'entités.

Voici les appariements de champ obligatoires pour la configuration des bons de travail en tant que catégories Indoors :

Propriété	Description
ID de la commande de travail	Définit un numéro d’identification pour chaque bon de travail.
Titre	Courte description du bon de travail qui peut être un titre lisible pour l’enregistrement.
Priorité	Séquence ou priorité selon laquelle un bon de travail doit être résolu. La valeur doit être un texte descriptif de la priorité pouvant être affiché pour l’utilisateur de l’application. Exemple : Critique, Élevée, Moyenne
Statut	Statut ou position actuel du bon de travail dans son cycle de vie. La valeur doit être un texte descriptif du statut pouvant être affiché pour l’utilisateur de l’application. Exemple : Planification, Attribué
Created On Date (Date de création)	Date et heure de création du bon de travail.
Auteur	Personne ayant signalé le bon de travail ou étant concernée par le bon de travail.
Assigned To (Attribué à)	Nom de l’agent auquel l’ordre est attribué.

Processus d'appariement des champs

Suivez les étapes ci-dessous pour ajouter les appariements de champ obligatoires pour une catégorie :

1. Si la couche source n’est pas conforme au modèle Indoors, appariez le champ d'identifiant unique.
2. Si la carte n'est pas définie pour tenir compte des étages, appariez au moins un champ dans la section Facility Properties (Propriétés de ressource) et un dans la section Level Properties (Propriétés de niveau).
3. Si vous le souhaitez, appariez les propriétés supplémentaires pour définir un champ de sous-titre et un champ d’affichage à utiliser dans Viewer. Ceci est obligatoire si vous configurez une catégorie de bon de travail.

   Remarque :

   L’appariement de champ d’affichage est disponible uniquement pour les couches d’entités. Dans le cas de couches autonomes, définissez le champ d’affichage dans les propriétés de la couche.

4. Si vous le souhaitez, effectuez l’appariement de champ pour l’intégration du bon de travail. Ceci est obligatoire si vous configurez une catégorie de bon de travail.
5. Cliquez sur Next (Suivant).

Exemple d'appariement de champ

Voici un exemple d’appariement des attributs pour l’intégration de Indoors et de la couche d’entités du bon de travail ServiceNow.

Propriété d’appariement	Nom du champ
Facility Name (Nom du bâtiment)	location_facility_name
Nom du niveau	location_level_name
ID de la commande de travail	nombre
Titre	short_description
Priorité	priority_level
Statut	state_label
Created On Date (Date de création)	sys_created_on
Auteur	called_id_name
Assigned To (Attribué à)	assigned_to_name

Spécifier des champs de recherche

Des champs de recherche sont requis pour la prise en charge de l’expérience de recherche dans les applications mobiles Viewer et Indoors. Des mots-clés de recherche sont appariés à ces champs. Vous pouvez choisir un ou plusieurs champs comme champ de recherche par défaut, mais au moins un champ est requis pour la prise en charge de la fonction de recherche.

1. Sélectionnez les champs dans lesquels vous souhaitez que les applications Indoors effectuent des recherches.

   Remarque :

   Seuls les champs de type texte sont pris en charge par la recherche Indoors. Certains champs, comme ObjectID, GlobalID ou des champs qui ne sont pas pris en charge, ne peuvent pas être utilisés et ne sont pas disponibles.

2. Cliquez sur Suivant.

Spécifier un modèle de suggestion

Vous pouvez configurer un modèle pour les suggestions de recherche. Ce modèle prend en charge la fonction de recherche Indoors en proposant une liste de correspondances possibles au fur et à mesure que vous saisissez le mot-clé de recherche.

1. Cliquez sur la flèche de la liste déroulante Available Fields (Champs disponibles) et sélectionnez un champ.

   Remarque :

   Un champ au moins est requis pour la prise en charge de la fonction de suggestion de recherche Indoors. Lorsque vous ajoutez un nouveau champ, il est ajouté au modèle existant. L’assistant construit automatiquement une expression prise en charge par Indoors.

2. Cliquez sur Add To Template (Ajouter au modèle).

   Ce modèle contient désormais une expression qui désigne des valeurs de données spécifiques dans la couche d’entités ou la classe d’entités source.

   Conseil :

   Le modèle est également un éditeur d’expression qui permet d’ajouter ou de supprimer des champs manuellement. Veillez à respecter la syntaxe correcte lors de l’ajout ou de la mise à jour de l’expression. L’inclusion d’espaces ou de texte pour constituer une expression est prise en charge.

   Exemple

   "{MODEL} by {MFG}"

   "{MODEL}{MFG}"

   Remarque :

   Seuls les champs de type texte sont pris en charge par la suggestion de recherche Indoors. Certains champs, comme ObjectID, GlobalID ou des champs qui ne sont pas pris en charge, ne peuvent pas être utilisés et ne sont pas disponibles.

3. Cliquez sur Suivant.

Choisir des icônes

Vous devez configurer les symboles d’icône de la nouvelle catégorie à afficher dans le volet Explore (Explorer) et dans d’autres zones des applications mobiles Indoor Viewer et Indoors. Si la couche source utilise un seul symbole ou un moteur de rendu à valeur unique, les icônes employées pour la nouvelle catégorie sont automatiquement renseignées à partir de la symbologie de la couche source. L’assistant met les icônes à l’échelle selon la taille appropriée à employer dans les applications mobiles Viewer et Indoors, et présente un aperçu. Si la couche sélectionnée utilise un type de symbole non pris en charge, les icônes restent vides dans l’assistant et vous devez ajouter manuellement un symbole pour toutes les résolutions requises.

Remarque :

Il est recommandé d’utiliser des symboles SVG car ils peuvent être mis à l’échelle à des résolutions différentes. D’autres symboles vectoriels peuvent perdre en qualité et sembler flous ou pixelisés lorsqu’ils sont redimensionnés ou reformatés à la résolution requise.

1. Sélectionnez un symbole d’icône.

   Vous pouvez remplacer un symbole d’icône de deux manières :

   • Load from File (Charger depuis un fichier) : charge une icône .png à partir de votre ordinateur.

     Remarque :

     Vérifiez que la taille de l’image est appropriée à la résolution.

   • Load from Style (Charger depuis un style) : charge une icône ArcGIS Pro. Cette option ouvre une bibliothèque ArcGIS Pro contenant des styles importés (.stylx) et des symboles par défaut. Une fois le symbole sélectionné, l’assistant le met automatiquement à l’échelle selon la résolution requise.

     Indoors est préconfiguré avec des symboles par défaut dans ArcGIS Pro sous la forme d’un fichier de styles. Si les symboles par défaut ne correspondent pas à vos attentes, vous pouvez modifier le jeu de symboles existant ou créer le vôtre.

     Lorsque vous configurez un symbole, veillez à cocher la case Scale Proportionally (Mettre à l’échelle proportionnellement) dans les propriétés de symbole, ce qui permet au symbole d’être correctement redimensionné et mis à l’échelle lorsqu’il est appliqué sous forme d’icône de catégorie.

     Conseil :

     • L’icône de catégorie et le symbole utilisés pour l’affichage de la couche de catégorie sur la carte doivent être cohérents. Toute disparité pourrait entraîner une déconnexion entre l’icône du volet Explore (Explorer) et la couche de carte dans Indoors.

     • Dans le cas des zones d’intérêt, une icône est créée selon la symbologie de la couche si un sous-ensemble symbolisé est sélectionné sur la page Define (Définir). Cette icône est utilisée dans le volet Explore (Explorer) dans les applications Indoors, mais elle n’affecte pas la symbologie de polygone sur la carte Indoors.
2. Cliquez sur Finish (Terminer) pour enregistrer la configuration de la catégorie.

   Remarque :

   En cas de paramètres non valides ou manquants, l’option Finish (Terminer) n’est pas disponible et l’assistant Create Indoors Category (Créer une catégorie Indoors) indique le volet contenant l’erreur, le cheminement de navigation correspondant étant entouré en rouge. Vous pouvez toujours vous déplacer dans l’assistant pour effectuer des modifications.