Utiliser les Connexions

Dans Integration Hub, les connexions définissent les détails de l’authentification et les demandes d’API. Après avoir créé et configuré une connexion, vous pouvez l'utiliser dans NiCE CXone.

Exécuter les Demandes de Integration Hub

Vous pouvez exécuter une demande à partir de la connexion Integration Hub où elle est définie. Uniquement les demandes manuelles peuvent être exécutées depuis Integration Hub.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications et sélectionnez Automatisation et AI > Integration Hub.

  2. Cliquez sur la connexion avec laquelle vous souhaitez travailler dans la section Mes Connexions sur le côté gauche de la page.

  3. Dans l’onglet Demandes, cliquez sur Test en regard de la demande que vous souhaitez exécuter. Une page s’ouvre et affiche la réponse du service Web connecté.

  4. Sélectionnez et copiez le contenu de la réponse de la page si vous souhaitez le conserver.

  5. Cliquez sur Annuler lorsque vous avez fini d’examiner la réponse.

Utiliser l’authentification dans un script

Les connexions peuvent stocker les détails d’authentification. Vous pouvez les utiliser dans votre script partout où vous en avez besoin. Ils peuvent être utilisés seuls ou en complément d’une demande.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications et sélectionnez Studio.

  2. Ouvrez le script auquel vous souhaitez ajouter la demande.

  3. Ajoutez une ConnectAuth action au script.

  4. Dans la propriété connectName de ConnectAuth, entrez le nom de la connexion que vous voulez utiliser. Si vous ne connaissez pas le nom de la connexion : 

    1. Cliquez sur ouvrir l'éditeur Icon of a window. sur ConnectAuth pour ouvrir Integration Hub.
    2. Dans la section Mes Connexions, cliquez sur la coche An icon of a check mark. à côté de la connexion que vous voulez utiliser.
    3. Cliquez sur Oui pour l’affecter à l’action.

    Au lieu d'utiliser le nom d'une connexion spécifique dans la propriété connectName, vous pouvez utiliser la substitution de variable. Créez une variable pour contenir le nom de la connexion, puis utilisez la logique du script pour transmettre le nom à ConnectAuth.

  5. Enregistrez vos modifications.

Utiliser une Demande manuelle dans un script

Vous pouvez utiliser une Demande manuelle dans votre script partout où vous devez effectuer l'Appel api. La demande doit être définie dans une connexion Integration Hub.

Le script peut nécessiter d’autres modifications pour traiter la réponse renvoyée par la ressource à laquelle la demande se connecte. De plus, l’action ConnectRequest action peut nécessiter une configuration supplémentaire.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications et sélectionnez Studio.

  2. Ouvrez le script dans lequel vous souhaitez utiliser la demande.

  3. Ajoutez une action ConnectRequest action au script.

  4. Dans les propriétés connectName et requestName, entrez les noms de la connexion et de la demande que vous souhaitez utiliser. Si vous ne connaissez pas les noms : 

    1. Cliquez sur ouvrir l’éditeur Icon of a window. sur ConnectRequest pour ouvrir Integration Hub.

    2. Sous Mes Connexions, cliquez sur la coche An icon of a check mark. à côté de la connexion que vous souhaitez utiliser.

    3. Cliquez sur Oui pour l’affecter à l’action.

    4. Sélectionnez la connexion que vous venez d’attribuer à ConnectRequest.

    5. Dans l’onglet Demandes, cliquez sur la case de la demande que vous souhaitez affecter à cette action et cliquez sur OK.

    Au lieu d’utiliser le nom d’une connexion et d’une demande spécifiques dans les propriétés connectName et requestName, vous pouvez utiliser la substitution de variables. Créez des variables pour contenir les noms, puis utilisez la logique du script pour transmettre les noms à ConnectRequest.

  5. Pour utiliser une variable de la connexion liée dans le script, mettez le nom de la variable entre doubles crochets, comme suit : [[variableName]].

Utiliser une Demande Studio ou Hybride dans un script

Pour utiliser une Demande Studio, vous devez d’abord l’ajouter à une connexion Integration Hub, puis à un script à l’aide de l’action ConnectRequest action. Pour utiliser une demande hybride, créez une demande manuelle au lieu d’une demande Studio, puis connectez-la à votre script comme vous le feriez pour une demande Studio.

Les détails de la demande peuvent être modifiés par des entrées provenant de Studio, ces détails sont donc souvent créés dans une action SNIPPET action afin de pouvoir être transmis à l’action ConnectRequest action.

Le script peut nécessiter d’autres modifications pour traiter la réponse renvoyée par la ressource à laquelle la demande se connecte. De plus, l’action ConnectRequest ou l’action Snippet action peut nécessiter une configuration supplémentaire.

  1. Créez une demande Studio ou une demande manuelle dans Integration Hub et créez un objet de demande dans votre script, si ce n’est pas déjà fait.

  2. Dans Studio, ouvrez le script qui contient la demande que vous voulez utiliser.
  3. Ajoutez une action ConnectRequest action au script après l’action Snippet qui contient l’objet de demande, puis connectez-les.

  4. Dans la propriété connectName de ConnectRequest, entrez les noms de la connexion que vous souhaitez utiliser. Si vous ne connaissez pas le nom : 

    1. Double-clic sur ConnectRequest pour ouvrir Integration Hub.

    2. Sous Mes Connexions, cliquez sur la coche An icon of a check mark. à côté de la connexion que vous voulez utiliser.

    3. Cliquez sur Oui pour l’affecter à l’action.

    4. Sélectionnez la connexion que vous venez d'attribuer à ConnectRequest.

    5. Dans l’onglet Demandes, cliquez sur la case de la demande que vous souhaitez affecter à cette action et cliquez sur OK.

    Au lieu d'utiliser le nom d'une connexion et d'une demande spécifiques dans les propriétés connectName, vous pouvez utiliser la substitution de variable. Créez une variable pour contenir le nom, puis utilisez la logique du script pour transmettre le nom à ConnectRequest.

  5. Sélectionnez l'action ConnectRequest et configurez le champ RequestPayload avec le nom de la variable qui contient la demande JSON. Vous avez défini cette variable dans l'Snippet.

  6. Pour utiliser une variable de la connexion liée dans le script, mettez le nom de la variable entre doubles crochets, comme ceci :[[variableName]].

  7. Si votre connexion nécessite une autorisation, ajoutez et configurez l'action ConnectAuth dans votre script.

Utiliser une Demande hybride dans un script

  1. Créez une demande manuelle dans une connexion Integration Hub.
  2.