Utilisation de Factorial HR avec l' IBM App Connect Enterprise

Factorial HR est un logiciel de gestion des ressources humaines (RH) qui aide les petites et moyennes entreprises à rationaliser l'administration des RH. Avec Factorial HR, vous pouvez suivre la journée de travail et la productivité de chaque employé, enregistrer les heures de travail, suivre les congés restants et planifier les équipes d'employés.

Les étapes suivantes vous montrent comment vous connecter à un compte Factorial HR et configurer un nœud de demande Factorial HR en utilisant la découverte de connecteur.

1. Dans la boîte à outils d' IBM App Connect Enterprise, créez un flux contenant un nœud « Factorial HR Request ».
2. Sélectionnez le nœud Factorial HR Request dans le flux pour afficher les propriétés du nœud dans l'éditeur.
3. Dans l'onglet Base, cliquez sur Lancer la découverte du connecteur.
   Un panneau s'affiche, dans lequel vous indiquez le nom du projet de stratégie et les détails du coffre-fort à utiliser lors de la découverte des connecteurs.
4. Spécifiez les détails du projet de politique et de l'espace de stockage à utiliser lors de la découverte des connecteurs :
   1. Dans le champ Projet de stratégie, indiquez le projet de stratégie utilisé pour stocker les stratégies créées lors de la découverte des connecteurs.
      Vous pouvez également créer un nouveau projet de politique en cliquant sur Nouveau, puis en spécifiant le nom du nouveau projet de politique. Cliquez ensuite sur Terminer.
   2. Spécifier le coffre-fort à utiliser lors de la découverte du connecteur. Par défaut, les informations d'identification utilisées lors de la découverte des connecteurs sont stockées dans un répertoire externe, qui est un répertoire App Connect Enterprise pouvant être utilisé par n'importe quel serveur d'intégration. Vous pouvez également stocker les informations d'identification dans un coffre-fort de serveur d'intégration, qui est créé dans le répertoire de travail du serveur d'intégration et ne peut être utilisé que par ce serveur d'intégration spécifique.
      Pour spécifier le coffre-fort à utiliser pour stocker les informations d'identification, suivez les étapes de la section Utilisation de l'assistant de découverte de connecteur de l 'une des rubriques suivantes :

      • Configuration d'un coffre-fort de répertoire externe
      • Configuration d'une chambre forte de serveur d'intégration
   3. Dans le champ " Clé de voûte, saisissez la clé du coffre-fort qui est utilisée pour accéder aux informations d'identification stockées dans le coffre-fort. La clé de voûte doit comporter au moins 8 caractères.
   4. Facultatif : 'Par défaut, l'emplacement et la clé du coffre spécifiés sont enregistrés en tant que préférences dans la boîte à outils, de sorte que les valeurs sont prédéfinies lorsque vous lancez Connector Discovery. Si vous ne souhaitez pas que les préférences soient enregistrées, désélectionnez l'option Enregistrer dans les préférences de la chambre forte.
5. Cliquez sur Lancer la découverte pour lancer l'assistant de découverte de connecteur pour le connecteur Factorial HR.
   La fenêtre de découverte du connecteur s'affiche. Si des connexions (comptes) Factorial HR sont disponibles, une liste de ces connexions s'affiche. S'il n'y a pas de connexions existantes, le statut du connecteur Factorial HR est indiqué comme " Not connected.
   • Si une ou plusieurs connexions (comptes) Factorial HR sont disponibles, effectuez les étapes suivantes :
     1. Sélectionnez la connexion (compte) que vous souhaitez utiliser en cliquant dessus.
     2. Cliquez sur le type d'objet requis, puis sélectionnez l'action à effectuer sur l'objet. Par exemple, pour récupérer les détails d'une catégorie d'absence dans Factorial HR, cliquez sur Catégories d'absence, puis sur Récupérer les détails d'une catégorie d'absence.
   • S'il n'y a pas de connexions existantes (comptes), effectuez les étapes suivantes :
     1. Cliquez sur le type d'objet requis, puis sélectionnez l'action à effectuer sur cet objet. Par exemple, pour récupérer les détails d'une catégorie d'absence dans Factorial HR, cliquez sur Catégories d'absence, puis sur Récupérer les détails d'une catégorie d'absence.
     2. Cliquez sur Connexion.
        Une fenêtre s'affiche dans laquelle vous saisissez les détails de connexion de votre compte Factorial HR. Saisissez les informations suivantes dans l'assistant de connexion :

        • Serveur URL : Spécifiez le URL pour le serveur API qui effectue les appels d'exécution.
          Note : https://api.factorialhr.com est le serveur par défaut URL.
        • ID du client de l'application: Indiquez l'identifiant unique du client à utiliser pour l'authentification.
        • Secret du client de l'application: spécifiez le secret du client unique à utiliser pour l'authentification.
        • Jeton d'accès: Le jeton d'accès est généré à partir de l'identifiant et du secret du client de l'application.
        • Jeton de rafraîchissement: Le jeton de rafraîchissement généré à partir de l'identifiant et du secret du client de l'application.
        • Autoriser les certificats auto-signés: Sélectionnez True ou False dans le menu déroulant.
        • Remplacer le serveur URL : Requis si vous voulez vous connecter à un point d'extrémité dans un réseau privé en utilisant le client de réseau privé, ou si vous voulez remplacer le serveur URL. Spécifiez une valeur de remplacement pour l'hôte et le port du connecteur au format " <http or https>://<host_name>:<port>. Si vous n'utilisez pas le client de réseau privé ou si vous n'avez pas besoin d'une dérogation, laissez ce champ vide.
     3. Cliquez sur Connexion.

     Pour plus d'informations sur la manière d'identifier ces informations de connexion, consultez la section « Comment utiliser IBM App Connect avec Factorial HR » dans la documentation sur la livraison continue (CD) de IBM App Connect in containers.

6. Définissez les propriétés requises du connecteur dans l'assistant.
   Vous pouvez également définir des propriétés qui précisent le nombre maximal d'enregistrements à extraire et l'action à entreprendre si cette limite est dépassée.
7. Lorsque vous avez fini de spécifier les propriétés dans l'assistant de découverte de connecteur, cliquez sur Enregistrer.
   L'identifiant utilisé pour se connecter à Factorial HR est stocké dans le coffre-fort, et les autres détails de connexion sont enregistrés dans la politique Factorial HR. Les valeurs des propriétés que vous définissez dans l'assistant sont transmises au nœud « Factorial HR Request » dans la boîte à outils « IBM App Connect Enterprise ».
8. Lorsque vous avez terminé la découverte et enregistré les valeurs des propriétés, quittez l'assistant de découverte de connecteur en cliquant sur le X dans le coin supérieur droit de la fenêtre ou en appuyant sur Alt+F4
9. Revenir à la modification du nœud « Factorial HR Request » dans la boîte à outils « IBM App Connect Enterprise ».
   Les propriétés du connecteur qui ont été définies dans l'assistant de découverte du connecteur (à l'étape 6) sont maintenant visibles sur le nœud Factorial HR Request dans l'éditeur de propriétés. L'onglet Basique affiche les valeurs des propriétés Action et Objet que vous avez définies dans l'assistant. Par exemple, si vous avez sélectionné Types d'absence > Récupérer les détails du type d'absence dans l'assistant, les propriétés suivantes sont visibles dans l'onglet Basique du nœud :

   • Action - " RETRIEVEALL
   • Objet - " getApiV1TimeLeaveTypes_model

   Les valeurs des propriétés Action et Objet sont affichées en lecture seule. Si vous souhaitez modifier ces valeurs, vous pouvez le faire en cliquant à nouveau sur Lancer la découverte du connecteur et en définissant de nouvelles valeurs dans l'assistant de découverte du connecteur.

   La propriété Schema base name spécifie le nom de base des fichiers de schéma qui décrivent le format des messages de demande et de réponse qui sont envoyés et reçus du connecteur Factorial HR. Le nom de base du schéma est défini automatiquement la première fois que vous exécutez la recherche pour le nœud, et il est basé sur le nom du flux et le nom du nœud actuels. Si vous définissez cette propriété manuellement avant de lancer la découverte pour la première fois, c'est la valeur que vous avez définie qui est utilisée. Si vous renommez les schémas après la découverte, vous devez modifier cette propriété afin qu'elle corresponde au nom de base du schéma utilisé par les schémas renommés dans le projet. Si vous modifiez cette propriété après la recherche, vous devez soit renommer les noms des schémas pour qu'ils correspondent, soit relancer la recherche.

   En fonction de l'action sélectionnée lors de la découverte, l'assistant de découverte de connecteur génère soit un schéma de demande et un schéma de réponse, soit un schéma de réponse uniquement. Un schéma de demande n'est généré que si l'action et l'objet sélectionnés nécessitent un message de demande. Le schéma de demande généré est utilisé pour la validation du message de demande. Si l'action était " RETRIEVE ou " DELETE, seul le schéma de réponse est renvoyé par le connecteur.

   Les fichiers de schéma générés sont ajoutés au projet et peuvent être utilisés par un nœud de mappage pour transformer les données d'entrée ou de sortie. Le nom de fichier complet du schéma est dérivé du nom de base du schéma (tel que " gen/factorialhr.Factorial_HR_Request), suivi de " response.schema.json ou " request.schema.json. Vous pouvez ouvrir le schéma en cliquant sur Ouvrir le schéma de demande ou Ouvrir le schéma de réponse.

10. Vérifiez que les paramètres de propriété du nœud Factorial HR Request sont corrects, puis enregistrez le flux de messages.
11. Dans l'onglet " Connexion du nœud " Demande de RH factorielle, la propriété " Politique indique le nom de la politique qui contient les détails de l'identité de sécurité à utiliser pour la connexion. La police a un type de " Factorial HR.
    Pour plus d'informations, voir la politique de ressources humaines de Factorial.
12. Facultatif : Définissez la propriété Timeout dans l'onglet Connection pour spécifier le temps (en secondes) pendant lequel le nœud attend que Factorial HR traite l'opération.
13. L'onglet " Filtre du nœud " Demande de RH factorielle contient des propriétés qui contrôlent la manière dont le flux de messages sélectionne les données. Les valeurs initiales de ces propriétés proviennent des valeurs des propriétés qui ont été définies pour le connecteur Factorial HR dans l'assistant de découverte des connecteurs, y compris les propriétés des options de filtrage et toutes les conditions qui ont été spécifiées (comme décrit à l'étape 6). Ensuite, si vous revenez à l'assistant de découverte de connecteur et que vous modifiez les valeurs des propriétés (en ajoutant de nouvelles conditions, par exemple), ces mises à jour sont reflétées dans les propriétés définies sur le nœud.

    Les propriétés des options de filtrage déterminent les objets qui doivent être utilisés lors de l'exécution du nœud Factorial HR Request. Les propriétés Limite du filtre contrôlent le nombre maximum d'éléments à extraire et l'action à entreprendre si la limite est dépassée.

    Vous pouvez modifier les valeurs en cliquant sur Modifier à côté de la valeur que vous souhaitez modifier dans la section Options du filtre, et en changeant les valeurs des propriétés qui ont été définies dans la section Limite du filtre.

    Les valeurs des propriétés peuvent être des valeurs textuelles ou des expressions ESQL ou XPATH qui sont résolues à partir du contenu du message transmis au nœud Factorial HR Request lors de son exécution.

14. Dans l'onglet " Demande, définissez la propriété " Localisation des données pour spécifier l'emplacement dans l'arbre des messages entrants qui contient les données de l'objet à créer dans " RH factorielle. Ces données constituent la demande envoyée par le nœud Factorial HR Request au système Factorial HR.
15. Dans l'onglet Résultat, définissez la propriété Emplacement des données de sortie pour spécifier l'emplacement dans l'arbre des messages de sortie qui doit contenir les données de l'enregistrement créé dans Factorial HR.
16. Par défaut, les messages de demande sont validés par rapport au schéma de demande qui a été généré lors de la découverte du connecteur. Vous pouvez désactiver la validation de la demande ou modifier les paramètres de validation en utilisant les propriétés de validation du nœud Factorial HR Request.
17. Sauvegarder le flux de messages.