Créer une catégorie Indoors

Disponible avec l’extension ArcGIS Indoors Pro ou ArcGIS Indoors Maps.

Categories in a map define how users interact with point and polygon data in Indoor Viewer and Indoors mobile apps. Ces couches peuvent être dérivées de couches d’entités, de couches d’entités Web et de couches d’images de carte. These categories can be organized into logical groups to help  Indoors  app users quickly find relevant information, such as a bike rack, elevator, conference room, or work order.

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.

Vous devez configurer votre carte comme prenant en charge les étages en définissant les propriétés Couches Indoor de la carte avant de créer les catégories.

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. 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 catégorie.

  1. Démarrez ArcGIS Pro.
  2. Open or create an ArcGIS Indoors map.
  3. Assurez-vous que la carte est configurée comme tenant compte des étages.
  4. 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.

  5. Dans la vue Categories (Catégories), cliquez sur le bouton Create Indoors Category (Créer une catégorie Indoors) 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.

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

    Le champ de nom de la 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.

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

  8. 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).

  9. 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 créer 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 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 :

NomChaîneDescription

Nom d’utilisateur

user.username

Remplace le texte dans la chaîne afin d’inclure le nom d’utilisateur de l’organisation ArcGIS de l’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 actif (par exemple, des bons de travail attribués à l’utilisateur actif).

Cela nécessite que l’utilisateur de l’application Indoors soit connecté à l’organisation ArcGIS.

Conseil :

Utilisez une expression simple pour définir les entités à inclure dans la catégorie, telle que 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

When configuring categories, you can provide field mapping to define fields in the layer that describe the fields used in the Indoors web and mobile apps. Cela inclut un champ d’ID unique obligatoire, ainsi que des champs facultatifs pour les propriétés de sous-titre, d’affichage et de bon de travail. Pour configurer la carte comme prenant en charge les étages, définissez les propriétés des couches Indoor de la carte avant de créer des catégories.

Remarque :

Si vous ne configurez pas la carte comme prenant en charge les étages avant de configurer des catégories, vous devez fournir des champs identifiant la ressource et le niveau associés de l’entité.

L’appariement du champ Unique ID (ID unique) est requis.

L’appariement du champ suivant est obligatoire :

  • ID unique

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. A static unique ID is required to support 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 uses the layer’s object ID as the unique ID for a web layer’s features by default. However, this is not always appropriate, as Indoors uses a static unique ID for the features in a web layer that does not change over the lifetime of the feature.

Propriétés supplémentaires

Les appariements de champ suivants sont facultatifs :

PropriétéDescription

Sous-titre

Displays subtitles in Indoor Viewer.

Champ d’affichage

Displays titles for features in Viewer.

Ceci est obligatoire si la 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

These field mappings are required if you want to use the work order listing capabilities of  Indoors. Omitting these additional field mappings in the category definition for a work order feature layer results in the layer being treated as a traditional web layer in Viewer and  Indoors mobile apps with the traditional explore experience for feature layers.

The following properties are required field mappings to configure work orders as Indoors categories:

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 de champs

Pour ajouter l’appariement de champs requis pour une catégorie, procédez comme suit :

  1. Assurez-vous que la carte est configurée comme tenant compte des étages.
  2. If the source layer does not conform to the Indoors model, map the unique ID field.
  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.
    Cette opération est obligatoire si vous configurez une catégorie de bons 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.
    Cette opération est obligatoire si vous configurez une catégorie de bons de travail.
  5. Cliquez sur Next (Suivant).

Exemple d’appariement de champ

The following table shows an example of attribute mapping for Indoors and ServiceNow work order feature layer integration:

Propriété d’appariementNom du champ

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, cochez 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 correspondante 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 les applications web ou mobiles Indoors.

      • Pour les catégories basées sur les couches surfaciques, une icône est créée selon le symbole de la couche. Cette icône est utilisée dans le volet Explore (Explorer) dans les applications 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 Terminer n’est pas disponible et l’assistant Créer une catégorie Indoors indique la fenêtre contenant l’erreur, le cheminement de navigation correspondant étant entouré en rouge. Vous pouvez continuer à évoluer dans l’assistant pour effectuer des modifications.