Utilisation de Connexions

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

Exécuter des Demandes depuis Integration Hub

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

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

  2. Cliquez sur la connexion que vous souhaitez utiliser dans mes Connexions, sur le côté gauche de la page.

  3. Sur l’onglet Demandes, cliquez sur Tester en regard de la Demande à exécuter. Une page s’ouvre, contenant la réponse du service Web connecté.

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

  5. Cliquez sur annuler lorsque vous avez terminé d’examiner la réponse.

Utiliser l’authentification dans un script

Connexions peut stocker les informations d'authentification. Vous pouvez les utiliser dans votre script dès que vous en avez besoin, soit seuls soit en complément d’une demande.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'application 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 souhaitez 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. Sous mes Connexions, cliquez sur la coche An icon of a check mark. en regard de la connexion que vous souhaitez 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 une logique de 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 davantage de modifications pour traiter la réponse renvoyée par la ressource à laquelle la demande se connecte. En outre, l'action ConnectRequest peut nécessiter une configuration supplémentaire.

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

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

  3. Ajoutez une ConnectRequest action au script.

  4. Dans les propriétés connectName et requestName, entrée les noms de la connexion et de la demande que vous souhaitez utiliser. Si vous ne connaissez pas ces 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 en regard de la Demande que vous souhaitez affecter à cette action, puis 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 variable. Créez des variables pour contenir les noms, puis utilisez la logique de script pour transmettre les noms à ConnectRequest.

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

Utiliser une Studio ou une Demande 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. Pour utiliser une demande hybride, créez une demande manuelle au lieu d'une 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 les entrées provenant de Studio, c'est pourquoi ces détails sont souvent construits dans une action SNIPPET afin qu'ils puissent être transmis à l'action ConnectRequest.

Le script peut nécessiter davantage de 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 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 vous ne l'avez pas déjà fait.

  2. Dans Studio, ouvrez le script qui contient la demande à utiliser.
  3. Ajoutez une action ConnectRequest 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 ce nom :

    1. Double-cliquez 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'assigner à ConnectRequest.

    5. Dans l’onglet Demandes, cliquez sur la case en regard de la Demande que vous souhaitez affecter à cette action, puis 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 de 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, placez 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éer une demande manuelle dans une connexion Integration Hub.
  2.