Pour configurer le provisionnement, vous aurez besoin d’accéder à la console de configuration de la plateforme.

1. Ouvrez la zone Administration (symbole d’engrenage).
2. Ouvrez la vue Connecteurs.
3. Choisissez « Nouveau connecteur »

4. Sélectionnez le type de source de données comme REST API générique

5. Donnez un nom au connecteur et ajoutez les paramètres de connexion :

• Nom du connecteur - donnez à votre connecteur un nom convivial (le nom peut être modifié par la suite)
• URL hôte : URL de base pour REST API . Elle peut servir de préfixe pour l'URL finale à appeler.
• Type de connecteur REST - sélectionnez Générique
• Méthode d'authentification - Sélectionner le jeton du porteur
• Jeton du porteur - définir la valeur du jeton du porteur (sans texte du porteur au début)

6. Définissez la pagination correcte

Vous pouvez créer deux connecteurs distincts avec des paramètres identiques, à la différence près que ce paramètre de pagination est différent. Créez un connecteur pour les tâches où API prend en charge la pagination, et un autre pour les tâches où API prend en charge la pagination. ne prend pas en charge la pagination.

A) Définir la pagination pour Matrix42 Enterprise / SAM Connector (pour les tâches appelant API qui ne prennent pas en charge la pagination)
Utiliser désactivé car API de requête de données utilisée dans l'exemple de tâche planifiée ne prend pas en charge la pagination :

B) Définir la pagination pour Matrix42 Enterprise /SAM Connector, pour les tâches appelant API qui prennent en charge la pagination .

• Type de pagination - Incrément de page
• Attribut de page de pagination - numéro de page
• Pagination Début de la page - 1
• Attribut de taille de page de pagination - pagesize
• Taille de page de pagination : définissez cette valeur en fonction de vos données. Vérifiez la valeur maximale dans la documentation Matrix42 Enterprise /SAM ou auprès de nos consultants. Elle doit être inférieure à la quantité minimale de données renvoyée par API que vous appelez. Si vous définissez cette valeur trop élevée Matrix42 Enterprise ou SAM ne renvoie aucune donnée.

7. Remplissez les informations utilisateur API Web

• Utilisateur API Web - sélectionnez l'utilisateur API Web correct qui est utilisé lors de l'écriture de données à partir d'un système externe vers les solutions Matrix42 Core , Pro and IGA
• Mot de passe de API Web - mot de passe de l'utilisateur de l' API Web

8. Enregistrer les informations du connecteur

9. Ajoutez un certificat racine https externe Matrix42 Enterprise ou SAM pour que la gestion des connecteurs (EPE) le confirme. Cette opération est uniquement possible via Matrix42 : Ajouter un certificat.

10. Les solutions Matrix42 Core , Pro and IGA peuvent désormais se connecter à Matrix42 Enterprise et Matrix42 SAM

• L'étape suivante consiste à configurer une tâche planifiée pour la lecture des données ou une tâche événementielle pour l'écriture des données et les actions vers Matrix42 Enterprise et SAM.

1. Ajoutez une tâche planifiée sous le connecteur approprié, en cliquant sur « Nouvelle tâche »

2. Définir les attributs de la tâche

Planification - Définissez la planification si nécessaire

Nom de la tâche - Définir un nom informatif

Utilisation des tâches - Planifiée

Type de mappage - Modèle générique

Requête : la requête dépend du point de terminaison Matrix42 Enterprise ou API que vous souhaitez appeler pour récupérer les données. Consultez la documentation Matrix42 Enterprise pour connaître l'URL et les paramètres API corrects.
Dans cet exemple : /data/fragments/SPSActivityClassBase?columns=ID,Subject,Description,TicketNumber

Sous-requêtes : vous pouvez ajouter des sous-requêtes pour lire davantage de données liées aux résultats renvoyés par la requête. Dans cet exemple, nous n'utilisons pas cette fonctionnalité.

En-têtes de requête - peuvent être laissés vides

Marqueur de valeur - laisser vide

Marqueur d'erreur - laisser vide

Seuil de sécurité pour les appels API : il est recommandé de définir une valeur deux fois supérieure au nombre de pages renvoyées par cette API . Si vous laissez ce seuil vide, il n'y a pas de seuil de sécurité et le connecteur peut basculer en boucle infinie en cas d'erreur de configuration.

Attribut unique : Attribut unique dans le jeu de résultats API . Généralement, il s'agit de l'ID de l' API Matrix42 Enterprise , mais vérifiez-le dans la documentation.

3. Remplissez les informations d'échec

Paramètres facultatifs pour la gestion des échecs : en cas d'échec d'une tâche planifiée, une carte de données peut être créée dans ESM, affichant l'erreur. Si des paramètres d'échec sont définis, l'administrateur n'a pas besoin de vérifier manuellement l'état des tâches planifiées.

• Modèle d'échec - Sélectionnez un modèle de carte de données qui sera créé en cas d'erreur lors de l'approvisionnement (connexion aux sources de données, délais d'attente, etc.)
• Dossier d'échec - Sélectionnez le dossier dans lequel la carte de données d'échec est stockée.
• Attribut d'échec - Sélectionnez un attribut dans lequel les informations d'erreur doivent être stockées dans le modèle d'échec. Sélectionnez l'attribut de type texte.

4. Remplissez les informations de mappage générique

Dans la section Mappages, vous configurez quel attribut du message JSON est lu sur quel attribut sur la carte de données Matrix42 Core , Pro and IGA .

• Modèle cible - Sélectionnez un modèle pour définir les mappages d'attributs (dans cet exemple, Ticket)
• Dossier cible : sélectionnez un dossier dans une liste. La liste est réduite pour correspondre au modèle sélectionné. (Dans cet exemple, Tickets)
• Mappage du type de source de données : facultatif. S'il est défini, le type de connecteur est écrit dans cet attribut.
• Mappage d'ID de tâche : l'ID de tâche est inscrit dans cet attribut. Le choix de l'attribut approprié dépend de la configuration de votre modèle.
• Définir la valeur de la carte de données pour un objet supprimé du système source : cette fonctionnalité est activée en cochant la case correspondante. Lorsqu'un objet précédemment lu depuis un système tiers vers la solution est supprimé, cette tâche planifiée détecte la suppression et attribue la valeur souhaitée à l'attribut de la carte de données sélectionnée. Cela peut par exemple être utilisé pour définir l'attribut Statut sur 09 (Fermé) (comme illustré dans la capture d'écran ci-dessous). Le nom et la valeur de l'attribut doivent être définis en fonction de la configuration de votre modèle.

• Mappages d'attributs
  1. Attribut externe - quel attribut de l' API du système Matrix42 Enterprise est lu à partir du corps JSON
  2. Attribut local - auquel l'attribut dans Matrix42 Core , Pro and IGA est mappé
• Il est possible de définir des attributs supplémentaires pour les mappages d'attributs, en choisissant Nouvel attribut
• Vous devez également ajouter un mappage à l'attribut unique (dans cet exemple, il s'agit de l'ID). Celui-ci doit être mappé à l'attribut unique du modèle (texte1 dans cet exemple).

5. Enregistrez la tâche de provisionnement à partir du bouton Enregistrer.

Si certains attributs requis sont manquants, le bouton Enregistrer s'affiche en gris et affiche ce qui manque dans les paramètres.

6. Vous avez maintenant configuré la tâche de connecteur planifiée

• Vous pouvez désormais attendre que la tâche soit démarrée en fonction de la planification ou
• Exécuter la tâche manuellement : en cliquant sur le bouton « Exécuter la tâche » en haut de la fenêtre d'édition, la tâche est configurée pour être planifiée et démarrer immédiatement. Ceci est généralement utilisé pour des tests ou si vous ne souhaitez pas modifier les paramètres de planification, mais souhaitez exécuter la tâche immédiatement.

Exemple de message de démarrage d'exécution de tâche manuelle :

Si la tâche est exécutée manuellement (exécuter la tâche) ou si elle est exécutée selon la planification, l'état de la tâche peut être consulté à partir de la colonne de gestion de la liste des tâches planifiées, en cliquant sur le bouton « Afficher l'historique ».

1. Ajoutez une tâche planifiée sous le connecteur approprié, en cliquant sur « Nouvelle tâche »

2. Définir les attributs de la tâche

Planification - Définissez la planification si nécessaire

Nom de la tâche - Définir un nom informatif

Utilisation des tâches - Planifiée

Type de mappage - Modèle générique

Requête : la requête dépend du point de terminaison API Matrix42 SAM que vous souhaitez appeler pour récupérer les données. Consultez la documentation Matrix42 SAM pour connaître l'URL et les paramètres corrects API .
Dans cet exemple : dataquery/aad704de-a242-c667-123b-08d45a5faa97

Remarque ! Si vous utilisez API Dataquery Matrix42 Enterprise /SAM (comme dans cet exemple), elle ne renvoie par défaut que 10 000 objets. API Dataquery ne prend pas en charge la pagination. Si vous devez récupérer plus de 10 000 objets, contactez Matrix42 et demandez une augmentation de la limite de votre environnement. Plus d'informations ci-dessous :

« Nombre d'enregistrements de réponse aux requêtes de données
Le paramètre PDRDwpConfigurationClass.DataQueryMaxResponseRecords définit le nombre maximal d'enregistrements renvoyés par le service Web « Requête de données ».
Valeur par défaut : 10 000 enregistrements. »

Sous-requêtes : vous pouvez ajouter des sous-requêtes pour lire davantage de données liées aux résultats renvoyés par la requête. Dans cet exemple, nous n'utilisons pas cette fonctionnalité.

En-têtes de requête - peuvent être laissés vides

Marqueur de valeur - laisser vide

Marqueur d'erreur - laisser vide

Seuil de sécurité pour les appels API : il est recommandé de définir une valeur deux fois supérieure au nombre de pages renvoyées par cette API . Si vous laissez ce seuil vide, il n'y a pas de seuil de sécurité et le connecteur peut basculer en boucle infinie en cas d'erreur de configuration.

Attribut unique : Attribut unique dans le jeu de résultats API . Généralement, il s'agit de l'identifiant de API SAM Matrix42 , mais il est confirmé par la documentation.

3. Remplissez les informations d'échec

Paramètres facultatifs pour la gestion des échecs : en cas d'échec d'une tâche planifiée, une carte de données peut être créée dans ESM, affichant l'erreur. Si des paramètres d'échec sont définis, l'administrateur n'a pas besoin de vérifier manuellement l'état des tâches planifiées.

• Modèle d'échec - Sélectionnez un modèle de carte de données qui sera créé en cas d'erreur lors de l'approvisionnement (connexion aux sources de données, délais d'attente, etc.)
• Dossier d'échec - Sélectionnez le dossier dans lequel la carte de données d'échec est stockée.
• Attribut d'échec - Sélectionnez un attribut dans lequel les informations d'erreur doivent être stockées dans le modèle d'échec. Sélectionnez l'attribut de type texte.

4. Remplissez les informations de mappage générique

Dans la section Mappages, vous configurez quel attribut du message JSON est lu sur quel attribut sur la carte de données Matrix42 Core , Pro and IGA .

• Modèle cible - Sélectionnez un modèle pour définir les mappages d'attributs (dans cet exemple, Appareil)
• Dossier cible : sélectionnez un dossier dans une liste. La liste est réduite pour correspondre au modèle sélectionné (dans cet exemple, Ressources/Serveurs).
• Mappage du type de source de données : facultatif. S'il est défini, le type de connecteur est écrit dans cet attribut.
• Mappage d'ID de tâche : l'ID de tâche est inscrit dans cet attribut. Le choix de l'attribut approprié dépend de la configuration de votre modèle.
• Définir la valeur de la carte de données pour un objet supprimé du système source : cette fonctionnalité est activée en cochant la case correspondante. Lorsqu'un objet précédemment lu depuis un système tiers vers la solution est supprimé, cette tâche planifiée détecte la suppression et attribue à l'attribut de la carte de données sélectionnée la valeur souhaitée. Cela peut par exemple être utilisé pour définir l'attribut « Statut » sur « Supprimé ». Le nom et la valeur de l'attribut doivent être définis en fonction de la configuration de votre modèle. Dans cet exemple, cette fonctionnalité n'est pas utilisée.

• Mappages d'attributs
  1. Attribut externe - quel attribut de l' API du système Matrix42 SAM est lu à partir du corps JSON
  2. Attribut local - auquel l'attribut dans Matrix42 Core , Pro and IGA est mappé
• Il est possible de définir des attributs supplémentaires pour les mappages d'attributs, en choisissant Nouvel attribut
• Vous devez également ajouter un mappage à l'attribut unique (dans cet exemple, il s'agit de l'ID). Cet attribut doit être mappé à l'attribut unique du modèle (dans cet exemple, l'ID Intune).

5. Enregistrez la tâche de provisionnement à partir du bouton Enregistrer.

Si certains attributs requis sont manquants, le bouton Enregistrer s'affiche en gris et affiche ce qui manque dans les paramètres.

6. Vous avez maintenant configuré la tâche de connecteur planifiée

• Vous pouvez désormais attendre que la tâche soit démarrée en fonction de la planification ou
• Exécuter la tâche manuellement : en cliquant sur le bouton « Exécuter la tâche » en haut de la fenêtre d'édition, la tâche est configurée pour être planifiée et démarrer immédiatement. Ceci est généralement utilisé pour des tests ou si vous ne souhaitez pas modifier les paramètres de planification, mais souhaitez exécuter la tâche immédiatement.

Exemple de message de démarrage d'exécution de tâche manuelle :

Si la tâche est exécutée manuellement (exécuter la tâche) ou si elle est exécutée selon la planification, l'état de la tâche peut être consulté à partir de la colonne de gestion de la liste des tâches planifiées, en cliquant sur le bouton « Afficher l'historique ».

Voici un exemple simple de tâche événementielle et de nœud d'orchestration, utilisés pour créer des tickets de type d'activité 6 pour Matrix42 Enterprise. En production, vous devez définir le type de tickets à créer et les attributs à leur attribuer.

1. Ajoutez une tâche basée sur un événement sous le connecteur approprié, en cliquant sur « Nouvelle tâche ».

2. Définir les attributs de la tâche

Nom de la tâche - nom unique descriptif
Utilisation des tâches - Événement
Type de mappages - Modèle générique
Requête : URL de l' API à appeler. Dans cet exemple, nous créons un ticket. Nous utilisons donc la requête : /ticket/ (l'URL finale API à appeler est construite en concaténant l'URL du connecteur, l'URL de cette requête et l'URL REST du nœud d'orchestration). Vous pouvez également laisser la requête vide et définir l'URL de l'API sur l'attribut URL REST du nœud d'orchestration.

Formateur d'attributs de date : définissez le format correct si vous provisionnez des attributs de date

Formateur d'attributs DateTime : définissez le format correct si vous provisionnez des attributs DateTime

Définir des mappages génériques

Modèle cible - modèle à partir duquel vous allez appeler cette tâche
Dossier cible - dossier pour vos données

Aucun attribut n'est défini dans la table de mappage (attribut externe - attribut local). Le mappage des attributs est effectué sur le nœud d'orchestration du workflow.

3. Enregistrer la tâche

4. Créez un nœud d'orchestration dans votre flux de travail pour appeler cette tâche basée sur les événements

Orchestrate - Moteur Pro
Source de données - REST API générique
Activité - Appel REST générique
Cible - Créer un ticket en tant que demande de service (nom de votre tâche basée sur un événement)
Action - Dans cet exemple, POST car nous créons des tickets avec API qui crée un ticket.
URL REST - dans cet exemple, create?activitytype=6 car nous créons des tickets avec activitytype 6
Corps REST : vous pouvez générer le corps de l'appel API directement ici. Dans les cas plus complexes, vous pouvez également le générer séparément (dans un nœud de script) dans un attribut, puis utiliser cet attribut ici. Dans ce cas, le corps du ticket est créé directement ici, à l'aide des variables de code des attributs « sujet » et « détails ».
Le corps que nous utilisons dans cet exemple a des valeurs d'utilisateur codées en dur (vous pourriez envisager d'utiliser une autre logique pour cela), le sujet et la description sont lus à partir des attributs de sujet et de détails des cartes de données.
{
"Sujet": "$sujet$",
"Description": "$détails$",
"Priorité" : 0,
"Impact": 0,
« Urgence » : 0,
"Utilisateur": "0e8aac28-b2df-ef11-58b1-005056905558"
}

Attribut de réponse REST - la réponse de l'appel API sera stockée dans cet attribut
Exception de Pro : en cas de problème avec l'appel API , l'exception sera stockée dans cet attribut

Finalisez votre flux de travail avec d'autres nœuds et flux

Enregistrer le flux de travail et le publier

5. Tester le flux de travail et les tâches basées sur les événements

Restrictions en 2025.3

Plusieurs niveaux de sous-requêtes pour les tâches planifiées ne sont pas pris en charge, pour des raisons de performances.