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 de l'hôte - URL de base pour REST API . https://<YOUR_RAYNET_URL>.raynetone.com/v1/resultDatabase (par exemple : https://matrix42-demo-datahub.raynetone.com/v1/resultDatabase)Cela peut être utilisé comme préfixe pour l'URL finale à appeler.
• Type de connecteur REST - sélectionnez Générique
• Méthode d'authentification - En-tête d'authentification
• Nom de l'en-tête d'authentification - ApiKey
• Valeur de l'en-tête d'authentification - valeur de votre clé API
• Type de pagination - Incrément de page
• Attribut de page de pagination - page
• Pagination Début de la page - 1
• Attribut de taille de page de pagination - page_size
• Taille de page de pagination - 500 (si vous souhaitez utiliser une taille de page plus grande, vérifiez dans la documentation Raynet qu'ils prennent en charge cette taille de page)

6. 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 Raynet approuvé par la gestion des connecteurs (EPE). Cette opération ne peut être effectuée que par Matrix42 : Ajouter un certificat.

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

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

Dans ce chapitre, nous ajoutons une tâche planifiée pour lire les données de Raynet .

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 des données que vous souhaitez récupérer.
Dans cet exemple, nous récupérons les utilisateurs à l'aide de : resultTable/paged?tableName=DataTransformation-result_devices qui récupérera essentiellement toutes les données de la table Raynet DataTransformation-result_devices.

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 de sous-requêtes.

En-têtes de requête – pour Raynet nous devons ajouter ces en-têtes :
Accepter / application/json
Type de contenu / application/json

Marqueur de valeur - enregistrements

Marqueur d'erreur - laissez ce champ 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 . Dans ce cas, import_id

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 car nous récupérons les appareils)
• 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.

• Mappages d'attributs
  1. Attribut externe - quel attribut de l' API Raynet 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'identifiant d'importation). Ce mappage doit être effectué sur l'attribut unique du modèle (nom dans cet exemple).
• Le premier mappage utilise une sous-requête pour associer les appartenances des utilisateurs aux groupes à l'attribut multiValueField. Les autres mappages concernent les mappages d'attributs utilisateur de la requête principale.

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 d'une 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 ».

API Raynet contient des fonctionnalités de filtrage, qui peuvent être utilisées à partir de connecteurs natifs.
Documentation API Raynet relative aux fonctionnalités de filtrage Notes de version de Raynet 2025.3 

Pour utiliser le filtre dans l'attribut de requête de la tâche, vous devez encoder la valeur du filtre manuellement ou utiliser un site Web (par exemple https://www.urlencoder.org ) pour effectuer l'encodage.

Exemple de filtre sans encodage d'URL (ne fonctionne pas) : resultTable/paged?tableName=DataTransformation-result_devices&filter=["device_manufacturer","=","HP"]
Même exemple d'URL encodée (fonctionne) : resultTable/paged?tableName=DataTransformation-result_devices&filter= %5B%22device_manufacturer%22%2C%22%3D%22%2C%22HP%22%5D

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.