Mappage de tables et de champs
Un Mappage de table Jira définit qu'une table Business Central est synchronisée avec un type d'entité Jira donné.
Combinaisons prises en charge
Les combinaisons actuellement prises en charge sont :
| Table source BC | Type d'entité Jira | Ressource REST Jira |
|---|---|---|
| Client | Organisation | /rest/servicedeskapi/organization |
| Contact (type Personne uniquement) | Client | /rest/servicedeskapi/customer |
Un seul mappage de table activé est autorisé par combinaison de table BC et de type d'entité Jira.
Configuration d'entité
La page Configurations d'entité Jira définit, par type d'entité Jira, le point de terminaison REST et les règles de traitement utilisés par chaque mappage de table pour cette entité :
| Champ | Signification |
|---|---|
| Point de terminaison API Jira | Ressource REST relative utilisée pour créer ou mettre à jour l'entité |
| Point de terminaison API Jira (Suppression) | Ressource REST relative utilisée pour supprimer l'entité ; prend en charge les espaces réservés {entityId}/{organizationId} |
| Priorité de traitement par défaut | Priorité par défaut utilisée pour les messages de ce type d'entité lorsque le mappage ne la remplace pas (numéro plus petit = traité en premier) |
| Empêcher la suppression | Empêche la mise en file d'attente d'opérations de suppression pour ce type d'entité |
| Empêcher la modification des champs standard | Empêche la modification des champs standard une fois l'enregistrement synchronisé |
| Créer si la mise à jour échoue | Met en file d'attente un nouveau message de création lorsqu'une mise à jour échoue parce que la cible n'existe plus dans Jira |
Les configurations d'entité par défaut pour Organisation et Client sont créées automatiquement lors de la première exécution de l'assistant d'intégration ou de l'action Initialiser les configurations par défaut. L'action Tester la configuration de la fiche de configuration d'entité affiche le point de terminaison résolu ainsi que tous les mappages de table activés qui l'utilisent.
Mappage de table
Sur la fiche Mappage de table Jira, les sections Source Business Central et Cible Jira définissent la table BC et le type d'entité Jira ; elles ne peuvent plus être modifiées une fois le mappage Activé. La section Connexion sélectionne le Code de configuration OAuth2 à utiliser, avec une URL de base facultative qui remplace celle de la configuration. La section Statut affiche la Description du mappage et le nombre de Champs actifs.
L'activation d'un mappage n'est possible que si :
- une configuration OAuth2 est sélectionnée et dispose à la fois d'un ID client et d'un secret client,
- la configuration OAuth2 dispose d'un ID Cloud (c'est-à-dire que l'autorisation a été effectuée), et
- une URL de base est disponible, soit sur le mappage, soit sur la configuration OAuth2.
La désactivation d'un mappage est bloquée tant qu'il existe encore pour celui-ci des messages en attente, en cours de traitement ou à réessayer.
Actions disponibles sur la fiche de mappage de table :
- Créer les mappages par défaut - crée un jeu recommandé de mappages de champs pour le type d'entité sélectionné (voir Mappage de champs).
- Sélectionner les enregistrements à synchroniser - active en masse la synchronisation pour des enregistrements existants (voir ci-dessous).
- Règles d'activation - configure l'activation automatique de la synchronisation (voir Activation automatique).
- Ouvrir la configuration d'entité - ouvre la fiche de configuration d'entité du type d'entité mappé.
- Obtenir les espaces disponibles - charge les espaces Jira Service Management pour l'attribution d'espaces.
- Tester le mappage - construit un exemple de charge utile à partir du premier enregistrement de la table source, sans l'envoyer à Jira.
- Valider par rapport à Jira - vérifie que les champs personnalisés utilisés dans les mappages de champs existent réellement dans Jira.
Mappage de champs
Les mappages de champs, affichés dans la partie Mappages de champs de la fiche de mappage de table, définissent quel champ Business Central est envoyé vers quel champ Jira :
| Champ | Signification |
|---|---|
| Catégorie de champ | Champ standard (champ Jira intégré, par ex. le nom) ou Champ personnalisé (champ Jira propre à l'organisation) |
| Champ source BC | Le champ Business Central à synchroniser |
| ID du champ Jira | L'ID ou le nom du champ cible dans Jira |
| Type de champ Jira | Texte, E-mail, URL, Date, Nombre, Booléen, Téléphone, Sélectionner ou Sélection multiple |
| Valeur par défaut si le champ BC est vide | Valeur envoyée à Jira lorsque le champ BC est vide |
| Mappage activé | Indique si le mappage de champs est actif |
| Description de l'objet/utilisation du champ | Note en texte libre décrivant l'objet du champ (masqué par défaut) |
Les mappages de type Champ personnalisé sont envoyés à Jira via l'API des champs de détail des organisations/clients plutôt que par l'appel standard de création/mise à jour, ce qui nécessite des portées OAuth2 supplémentaires - voir Portées supplémentaires - uniquement en cas d'utilisation de champs de détail.
Un seul mappage de champs est autorisé par champ BC au sein d'un mappage de table. Pour les champs personnalisés, l'ID du champ Jira doit comporter au moins deux caractères, ne peut pas contenir ? : ; . = " et ne peut pas être l'un des mots réservés Name, Key, Created, Updated ou Label. L'action Tester la valeur du champ affiche la valeur résolue pour le premier enregistrement de la table source.
L'action Créer les mappages par défaut de la fiche de mappage de table permet de renseigner un jeu recommandé de mappages de champs pour le type d'entité choisi ; les mappages existants sont supprimés après confirmation.
Nom combiné
L'activation de Activer le nom combiné sur le mappage de table permet à Jira de recevoir un nom composé de plusieurs champs Business Central, à l'aide d'un Modèle de nom combiné contenant des noms de champs entre accolades, par exemple :
{No.} - {Name}
La valeur obtenue est enregistrée dans le champ Nom combiné Jira de la fiche client ou contact. Elle est recalculée automatiquement chaque fois qu'un champ du modèle est modifié sur l'enregistrement et - lorsque le nom combiné est activé pour la première fois sur le mappage - pour chaque enregistrement dont la synchronisation est déjà activée, avec suivi dans une boîte de dialogue de progression.
Activation en masse de la synchronisation pour des enregistrements existants
L'action Sélectionner les enregistrements à synchroniser du mappage de table permet d'activer la synchronisation pour de nombreux enregistrements existants en une seule fois au lieu de un par un :
- Sélectionnez Sélectionner les enregistrements à synchroniser sur la fiche ou la liste des mappages de table.
- Utilisez la boîte de dialogue de filtre standard pour restreindre les enregistrements à inclure.
- Confirmez la sélection.
Tous les enregistrements correspondants dont la synchronisation n'est pas encore activée sont mis à jour, et un message de confirmation indique le nombre d'enregistrements traités. Les enregistrements ne sont mis en file d'attente que si le mappage de table et ses mappages de champs sont déjà entièrement configurés, comme décrit ci-dessus. Pour les contacts, seuls les enregistrements de type Personne sont pris en compte, conformément aux combinaisons prises en charge.
Attribution d'enregistrements à des espaces Jira Service Management
Un espace désigne un service desk Jira Service Management. Les organisations et les clients peuvent être liés automatiquement à un ou plusieurs espaces lors de leur synchronisation :
- Sur la fiche de mappage de table, sélectionnez Obtenir les espaces disponibles pour charger les espaces depuis Jira Service Management (nécessite une configuration OAuth2 autorisée).
- Sélectionnez les espaces à utiliser et confirmez ; ils sont ajoutés à la partie Espaces attribués de la fiche de mappage de table.
Par défaut, chaque enregistrement synchronisé est lié à tous les espaces attribués. Pour limiter un espace aux seuls enregistrements correspondants :
- Dans la partie Espaces attribués, activez Activer le filtre pour l'espace.
- Sélectionnez Modifier le filtre pour ouvrir le générateur de filtres et définir les critères.
- Utilisez Afficher les enregistrements correspondants pour vérifier quels enregistrements correspondent actuellement, ou Effacer le filtre pour supprimer de nouveau la restriction (tous les enregistrements sont alors attribués).
Le générateur de filtres est prérempli avec des champs couramment utilisés, mais d'autres champs de la table source peuvent également être ajoutés :
| Table source | Champs de filtre préremplis |
|---|---|
| Client | N°, Code pays/région, Groupe compta. client, Groupe prix client |
| Contact | N°, Code pays/région, Type, N° société |
Lorsqu'un client ou un contact est synchronisé et créé dans Jira, le connecteur lie automatiquement l'organisation ou le client Jira obtenu à chaque espace attribué dont le filtre correspond (ou à tous les espaces attribués si aucun filtre n'est défini pour cet espace).