Vous pouvez intégrer Case IQ à votre écosystème de gestion de Case IQ grâce à sa fonction de recherche. Celle-ci vous permet de rechercher des données dans un système source externe, tel que le système d'information des ressources humaines ou le système de gestion des tickets de votre organisation, et de les importer dans les champs Case IQ . Ainsi, vous pouvez importer en temps réel des données déjà présentes dans un autre système dans Case IQ , sans avoir à les saisir manuellement.

L'intégration de recherche se présente sous la forme d'une barre de recherche dans un formulaire lors de l'ajout ou de la modification d'un enregistrement. Lorsque vous saisissez des mots clés dans cette barre, Case IQ envoie une requête HTTP à votre système source pour récupérer les données. L'intégration de recherche de Case IQ accepte les données JSON sérialisées et peut traiter automatiquement les réponses aux formats XML ou CSV.

Vous pouvez configurer une intégration de recherche pour une section ou un formulaire. La section suivante de cet article, « Choisir une intégration de recherche pour une section ou un formulaire » , vous guide dans le choix de l'option la plus adaptée à votre cas d'utilisation. Si vous décidez de configurer une section, consultez la section « Ajouter une section de recherche de données » . Pour une intégration de formulaire, consultez plutôt la section « Activer l'intégration de recherche de formulaire » . Une fois votre intégration de recherche ajoutée ou activée, vous pouvez en configurer les paramètres en suivant les instructions de la section « Configurer une intégration de recherche » .

Intégration de recherche de section ou de formulaire

Bien que les intégrations de recherche de données pour les sections et les formulaires utilisent la même fonctionnalité de recherche, nous recommandons chaque option dans des scénarios différents.

Les sections de recherche de données sont idéales si vous devez configurer plusieurs intégrations avec différents systèmes sources pour un même type d'enregistrement. Par exemple, supposons que les enquêteurs doivent documenter les informations relatives aux employés et aux clients pour des dossiers, informations stockées dans deux applications différentes utilisées par votre organisation. Vous pouvez ajouter deux sections de recherche de données au formulaire de dossier Case IQ afin que les enquêteurs puissent extraire des données de chaque système source : une pour les informations relatives aux employés et une autre pour celles relatives aux clients.

En revanche, nous recommandons l'intégration d'une recherche de formulaire si vous devez alimenter des champs statiques de profil ou de participant avec des données sources. Bien qu'il soit possible d'ajouter des sections de recherche de données aux formulaires de profil et de participant, l'intégration ne pourra alimenter que les champs dynamiques de la section de recherche, c'est-à-dire les champs que vous avez ajoutés et configurés pour le type d'enregistrement à l'aide du générateur de formulaires. Grâce à l'intégration d'une recherche de formulaire, vous pouvez associer des données sources à des champs statiques des formulaires de profil et de participant, tels que « Prénom », « Nom » et « Type de participant ».

Consultez le tableau ci-dessous pour plus d'informations sur les sections de recherche et les intégrations de formulaires afin de déterminer l'intégration la mieux adaptée à vos besoins.

Ajouter une section de recherche de données

Pour ajouter une intégration de recherche pour une section d'un type d'enregistrement :

1. Dans les Paramètres, accédez à la page Formulaires sous l'onglet Formulaires. Sélectionnez le formulaire auquel vous souhaitez ajouter la section de recherche de données. Vous pouvez ajouter une section de recherche à tout type de formulaire standard, personnalisé ou de réponse. Si vous souhaitez créer un nouveau type de formulaire personnalisé ou de réponse, consultez l'article « Ajouter et modifier un type de formulaire personnalisé » pour plus d'informations.

2. Cliquez sur le bouton Modifier du générateur de formulaires pour passer le formulaire en mode édition.

3. Cliquez sur la section + Insérer des champs ou sur l'icône de flèche vers la droite pour ouvrir la barre latérale Type de champ.

4. Recherchez « Section de recherche de données » dans la barre latérale Type de champ.

5. Cliquez et maintenez enfoncé « Section de recherche de données » dans la barre latérale Type de champ, faites-la glisser vers le générateur de formulaires et relâchez votre curseur.

6. La fenêtre contextuelle « Section de recherche de données » s'affiche ; vous pouvez alors configurer les paramètres de l'intégration. Consultez la section « Configurer une intégration de recherche » de cet article pour plus d'informations sur la configuration de l'intégration.

7. Une fois la configuration de l'intégration terminée, cliquez sur Enregistrer dans la fenêtre contextuelle. La section de recherche de données apparaîtra alors dans le générateur de formulaires.

8. Vous pouvez désormais ajouter des champs à la section que vous souhaitez alimenter via l'intégration de recherche. Cliquez sur le bouton « + Insérer des champs » dans la section de recherche de données ou sur l'icône flèche vers la droite pour rouvrir la barre latérale « Type de champ ».

9. Recherchez les types de champs que vous souhaitez ajouter à la section de recherche de données. Consultez la section « Types de champs pris en charge pour la recherche » de cet article pour obtenir la liste complète des champs que Case IQ peut renseigner via une intégration de recherche.

10. Lorsque vous avez trouvé un type de champ que vous souhaitez ajouter à la section, cliquez dessus et maintenez-le enfoncé dans la barre latérale Type de champ, faites-le glisser vers la section de recherche de données et relâchez votre curseur.

11. Ajoutez tous les champs que vous souhaitez renseigner dans la section via une recherche.

12. Une fois tous les champs ajoutés à la section, vous pouvez associer vos données sources aux champs ajoutés à la section de recherche de données. Consultez les sections « Méthode d'association simple » ou « Méthode d'association par expression » de cet article, selon la méthode d'association de champs choisie. Si vous avez sélectionné « Détection automatique des associations » lors de la configuration de votre intégration de recherche, vous pouvez ignorer cette étape.

13. Une fois que vous avez terminé de configurer votre intégration de recherche et vos mappages, cliquez sur le bouton Publier du générateur de formulaires pour rendre la section de recherche de données disponible pour vos utilisateurs.

Activer une intégration de recherche de formulaire

Pour activer l'intégration de recherche pour le formulaire d'un type d'enregistrement :

1. Dans les Paramètres, accédez à la page Formulaires sous l'onglet Formulaires. Sélectionnez le formulaire pour lequel vous souhaitez configurer une intégration de recherche. Si vous souhaitez créer un nouveau type de formulaire personnalisé, consultez l'article Ajouter et modifier un type de formulaire personnalisé pour plus d'informations.

2. Cliquez sur le bouton Modifier du générateur de formulaires pour passer le formulaire en mode édition.

3. Cliquez sur l'icône Modifier à côté du nom du formulaire.

4. Dans la barre latérale Propriétés du formulaire, activez le bouton « Activer la recherche de données » à la fin des propriétés du formulaire.

4. Vous verrez maintenant les champs permettant de configurer les paramètres d'intégration dans la barre latérale Propriétés du formulaire. Consultez la section « Configurer une intégration de recherche » de cet article pour plus de détails sur la configuration de l'intégration.

• Sous le bouton « Activer la recherche de données », vous trouverez également le champ « Libellé de la recherche », dans lequel vous pouvez saisir le texte qui s'affichera à côté de la barre de recherche pour l'intégration de la recherche. Par exemple, si vous configurez une intégration de recherche Workday HR pour votre formulaire d'inscription, vous pouvez nommer la recherche « Recherche d'employés Workday HR » afin que vos utilisateurs sachent que les données proviendront de Workday HR.

5. Vous pouvez maintenant associer vos données sources aux champs du formulaire. Consultez les sections « Méthode d'association simple » ou « Méthode d'association par expression » de cet article, selon la méthode d'association de champs choisie. Si vous sélectionnez « Détecter automatiquement les associations » lors de la configuration de votre intégration de recherche, vous pouvez ignorer cette étape.

6. Une fois la configuration de l'intégration et des mappages de recherche terminée, cliquez sur le bouton Enregistrer en bas de la barre latérale Propriétés du formulaire. Cliquez ensuite sur le bouton Publier dans le générateur de formulaires pour rendre l'intégration de recherche accessible à vos utilisateurs.

Configurer une intégration de recherche

Après avoir ajouté une section de recherche ou activé une intégration de formulaire, renseignez les paramètres suivants pour configurer votre intégration. Les options de configuration sont identiques, que vous configuriez une section ou une intégration de formulaire.

• Point de terminaison : saisissez l’URL du point de terminaison fournie par votre système source, qui indique Case IQ où envoyer la requête de recherche de données. Utilisez le format suivant pour l’URL du point de terminaison et terminez-la par la valeur dynamique permettant de rechercher les données : https://end.point/route?q={dynamicValue}.
  • Vous pouvez utiliser « {searchValue} » comme variable d'espace réservé pour la valeur dynamique saisie dans le champ de recherche du formulaire. Par exemple, si vous saisissez « Daniel » dans ce champ, {searchValue} prendra la valeur « Daniel » et Case IQ enverra une requête à votre système source pour extraire les données contenant « Daniel ».
  • Vous pouvez également utiliser l'un des champs du type d'enregistrement comme valeur dynamique au format suivant : « {<nomTypeenregistrement>.<nomChamp>} ». Par exemple, si vous ajoutez une section de recherche de données au formulaire de requête, en saisissant « {requête.typeRequête} » dans le point de terminaison, Case IQ enverra une requête à votre système source pour récupérer les données contenant le type de requête sélectionné pour la requête actuelle.
• Méthode HTTP : indiquez si Case IQ doit envoyer une requête GET, POST ou PUT pour récupérer les données du système source. Sélectionnez la méthode HTTP en fonction des exigences de votre système source.
  • L'API de votre système source peut n'accepter que certaines méthodes de requête. Bien que GET soit la méthode la plus courante pour récupérer des données, certains systèmes peuvent exiger POST ou PUT, notamment lorsque la requête doit inclure un corps avec des paramètres spécifiques.
• Corps de la requête HTTP : si vous sélectionnez « POST » ou « PUT » comme « Méthode HTTP », le champ « Corps de la requête HTTP » s’affiche. Vous pouvez alors y saisir une expression renvoyant un objet sérialisé. Consultez les exemples de corps de requête HTTP suivants pour POST et PUT.
  • Exemple de requête POST :

{
 "caseId": "12345",
 "caseType": "Fraude Enquête"
}

• Exemple de PUT :

{
 "searchCriteria": {
  "caseId": "12345",
  "statut": "Ouvrir"
 }
}

• Méthode d’authentification : sélectionnez la méthode d’authentification des requêtes par votre système source parmi les options suivantes : « Aucune », « Basique » ou « OAuth ».

• Propriété Result : si nécessaire, vous pouvez utiliser la « Propriété Result » pour spécifier le chemin d’accès au tableau dans la réponse API de votre système source, ce qui indique à Case IQ où trouver les données dans votre système source.
  • Pour déterminer la propriété résultante :
    1. Examinez la réponse de l'API de votre système source et trouvez le tableau contenant les données dont vous avez besoin.
    2. Identifiez la clé qui contient le tableau.
    3. Saisissez cette clé dans le champ « Propriété du résultat ».
  • Par exemple, supposons que l'API de votre système source renvoie l'objet JSON suivant. Vous saisirez alors « users » dans le champ « Propriété du résultat » afin que l'intégration récupère les données utilisateur.

{
 "utilisateurs": [
  {
   "identifiant": 1,
   "prénom": "John"
  }
 ]
}

• Méthode de mappage des champs : choisissez comment mapper vos données sources aux champs Case IQ dans la section ou le formulaire. Vous pouvez choisir l’une des options suivantes :
  • Méthode simple : associez manuellement les données sources à chaque champ cible de la section ou du formulaire. Vous pouvez configurer l’association des champs après avoir enregistré les paramètres d’intégration ; consultez la section « Méthode d’association simple » .
  • Expression : mappez les données sources aux champs cibles Case IQ à l’aide d’une expression ISEL , ce qui vous permet de définir un mappage de données complexe. La sélection de cette option affiche un champ « Expression ISEL ». Consultez la section Méthode de mappage d’expression pour obtenir des instructions sur la rédaction d’expressions.
• Détection automatique des correspondances : si vous sélectionnez « Simple » comme « Méthode de correspondance des champs », vous pouvez activer l’option « Détection automatique des correspondances ». Case IQ effectuera alors automatiquement la correspondance des champs en comparant les noms des champs de votre système source transmis dans la requête et les noms des champs Case IQ dans la section ou le formulaire. Le système associera les données sources aux champs Case IQ dont les noms correspondent, en ignorant la casse et en supprimant les symboles.

Méthode de cartographie simple

Si vous choisissez « Simple » comme « Méthode de mappage des champs » lors de la configuration de votre intégration de recherche, consultez les étapes suivantes pour mapper les données sources aux champs Case IQ :

1. Accédez aux paramètres de mappage des champs en procédant comme suit :

• Pour une section de recherche de données, cliquez sur le bouton Ajouter un mappage de champ dans l'en-tête de la section.

• Pour intégrer une recherche de formulaire, cliquez sur le bouton Ajouter un mappage dans la barre latérale Propriétés du formulaire.

2. Dans la fenêtre contextuelle « Ajouter un mappage de champ », vous pouvez indiquer Case IQ les données de votre système source à insérer dans les champs.

• Dans chaque champ « Source », saisissez le nom d'un champ que votre système source enverra à Case IQ dans le cadre de l'intégration.
• Dans la liste déroulante « Cible », sélectionnez le champ correspondant dans la section ou le formulaire de recherche de données dans lequel Case IQ doit insérer les données sources.

3. Une fois que vous avez mappé tous les champs cibles, cliquez sur le bouton Enregistrer dans la fenêtre contextuelle.

4. Si vous avez terminé la configuration de votre intégration, cliquez sur le bouton Publier du générateur de formulaires pour rendre l'intégration de recherche disponible pour vos utilisateurs.

Méthode de mappage d'expressions

Si vous choisissez « Expression » comme méthode de mappage des champs pour l’intégration de recherche, vous pouvez écrire une expression ISEL pour indiquer Case IQ les données du système source à renseigner dans les champs Case IQ . Le format de base des expressions de mappage est le suivant :

{caseIqFieldName1: résultat.sourceSystemName1, nom_du_champ_caseIq2 : résultat.sourceSystemName2, ...}

Au lieu de `result.sourceSystemName` , vous pouvez utiliser les fonctions ISEL pour créer des expressions de mappage dynamiques. Consultez la documentation sur le langage d'expression Case IQ pour connaître toutes les fonctions ISEL . Outre ces fonctions, vous pouvez également utiliser `result` , `this` et `lookupFields` dans les expressions de mappage.

• « result » ou « this » : l’objet de contexte, c’est-à-dire l’enregistrement de votre système source à partir duquel vous extrayez les données. Par exemple, si vous créez une section de recherche de données pour importer des informations sur les employés de votre SIRH dans Case IQ , « result » et « this » feront référence aux enregistrements des employés dans votre SIRH.
• lookupFields : variable de contexte contenant un tableau des noms de champs Case IQ de la section ou du formulaire de recherche de données. Par exemple, supposons que la section de recherche de données contienne trois champs : firstName , lastName et active . Dans une expression, lookupFields serait un tableau de ces champs, soit [firstName, lastName, active] .

Vous trouverez ci-dessous un exemple d'expression de mappage permettant de faire correspondre les informations des employés du système source aux champs de partie Case IQ :

{prénom: résultat.employeePreName,lastName: résultat.nom_de_fam_employé, Entitéprincipale : typederésultat == "Sujet" ? vrai : FAUX}

Cette expression associe les champs firstName , lastName et primaryEntity de Case IQ aux champs employeeFirstName , employeeLastName et type du système source, respectivement. Le système renseignera les champs firstName et lastName avec les valeurs de employeeFirstName et employeeLastName . Pour le champ primaryEntity , le système vérifiera d'abord le champ type du résultat avant de renseigner les données. Si le type est « Sujet » , le système définira le champ « Principal » de la partie sur « Oui ». Sinon, Case IQ laissera le champ « Principal » à « Non ».

Types de champs pris en charge pour la recherche

Les types de champs suivants sont pris en charge par l'intégration de recherche de Case IQ . Vous pouvez ainsi associer des données sources à ces types de champs afin que les utilisateurs puissent les renseigner avec des données provenant de votre système source.

• case à cocher
• Date Heure
• E-mail
• Entier
• Argent
• Nombre
• Liste de sélection
• Liste de sélection multiple
• Radio
• Zone de texte
• Éditeur de texte
• zone de texte