Génération de Scripts

Le lancement d'un script vous permet d'exécuter un script manuellement. Elle sert aussi à lancer un script à partir d’autres scripts ou de processus externes.Vous pouvez également l’utiliser pour tester un script. Lors des tests, il peut être utilisé avec les traces de script.

Pour tester des Scripts, vous pouvez les générer :

Pour lancer des scripts à partir d’autres scripts ou de processus :

  • Utilisez l'SPAWN action dans le script appelant.
  • En utilisant POST /scripts/start An icon of a square with an arrow  pointing from the center out to the upper right corner. API. Il s’agit de la solution recommandée pour générer un script à partir d’un processus externe.
  • Utilisez l’URL de raccourci à partir de la page Scripts ACD.
  • Utilisation de la tâche d'automatisation de workflow Call Studio Script URL dans Digital Experience (DX).

Les unités commerciales peuvent exécuter un maximum de 15 000 scripts, sauf configuration contraire. Lorsque cette limite est atteinte, des scripts supplémentaires ne peuvent pas être démarrés ou générés à l'aide de l'une des méthodes décrites sur cette page jusqu'à ce qu'un ou plusieurs scripts s'arrêtent.

Paramètres de script

Les paramètres de script permettent de transmettre des données aux scripts. Les données peuvent provenir d'autres Scripts, y compris des scripts système, ou de Sources externes telles que des CRMClosed Third-party systems that manage such things as contacts, sales information, support details, and case histories. ou des API. Il est transmis dans les scripts dans les variables pX, p1 à pN, où N représente le nombre maximum de paramètres pris en charge par la méthode spawn. Vous pouvez spécifier les données à transmettre lorsque vous générez un script suivant l’une des possibilités répertoriées à la section précédente.

Si vous souhaitez modifier les noms des variables de paramètre, vous pouvez configurer l'action Begin dans le script généré avec de nouveaux noms. Lorsque le script traite l'action BEGIN, les variables pX sont converties en nouveaux noms. Si vous ne spécifiez pas de nouveaux noms, les variables conservent les noms pX.

Lorsque des données sont transmises à un script, vous pouvez les voir dans une trace. Sélectionnez l'action BEGIN pour voir les variables de paramètre dans la liste des variables de sortie de la trace. Si vous avez configuré l'action BEGIN avec de nouveaux noms DE variables, sélectionnez l'action qui suit BEGIN dans la trace du script pour les voir.

Selon la source des valeurs, il est possible que toutes les variables pX s'affichent dans la sortie de trace, ou uniquement celles qui contiennent des valeurs. Le lancement à partir de la page ACD Scripts transmet toutes les variables pX. Celles dont vous ne spécifiez pas la valeur contiennent une chaîne vide. Avec les autres méthodes de génération (spawn), les variables de paramètre sont présentes uniquement si elles contiennent une valeur.

Paramètres personnalisés :

  • Support a maximum of: 
    • 32 Ko par valeur lorsqu'elle est générée à l'aide de l'action SPAWN.
    • 32 Ko au total pour l’ensemble des paramètres, barres verticales comprises, lorsque la génération s’effectue par API.
  • Soutien de la substitution de variable. Entrée le nom de la variable entre accolades ( { } ).
  • Prend en charge 1 à 20 paramètres lors de la génération via l'action SPAWN ou l'API.
  • ne prennent pas en charge les objets de données dynamiques. convertie en chaîne JSON au préalable.

Exemple

Cet exemple montre comment les paramètres personnalisés sont transmis de l’application ou du script d’appel dans le script enfant. Dans cet exemple, certains noms DE variables sont modifiés dans l'action BEGIN, mais pas tous, afin que vous puissiez voir ce qui se produit dans chaque cas.

L'image suivante montre que le script IBVoice a été généré à partir de la page ACD Scripts avec la compétenceClosed Used to automate delivery of interactions based on agent skills, abilities, and knowledge. IBVoice ACD et quatre valeurs de paramètres personnalisés : value1, value2, value3 et value4.

L'image suivante montre les propriétés de l'action BEGIN, dans le script IBVoice, configurée avec de nouveaux noms DE variables dans les trois premières lignes de la propriété Paramètres. Les nouveaux noms sont newVar1, newVar2 et newVar3.

Les deux images suivantes montrent les résultats du spawn dans la sortie de trace. Cette image montre l'action Begin, qui contient les quatre valeurs de paramètre du script dans les variables p1, p2, p3 et p4.

La dernière image montre les variables dans le script une fois que l'Action BEGIN a terminé son traitement.Vous pouvez le voir en cliquant sur la deuxième action du script ; dans cet exemple, il s'agit de l'action HOURS. Les p1, p2 et p3 ne figurent plus dans le script. Leurs valeurs ont été assignées à newVar1, newVar2 et newVar3. Les variables p4 - p9 sont toujours présentes dans le script. p4 contient la valeur qui lui a été attribuée sur la Page Scripts. Les variables pX restantes sont transmises sous forme de chaînes vides.

Comparaison des actions Studio

Trois actions Studio lancent un nouveau script à partir du script actif. Elles présentent toutefois des différences :

  • RunscriptRunscript : lorsque Runscript déclenche un autre script, il ne revient pas au premier script depuis le second script.
  • RunsubRunsub : lorsque Runsub déclenche un sous-script, le script peut revenir au premier script, à condition que le sous-script comporte une action Return.L'action revenir fournit une valeur à l'action exécuter lorsque l'indice est terminé.
  • SPAWNSPAWN : démarre un deuxième script qui s'exécute en parallèle du premier script. Les scripts générés ne peuvent pas renvoyer de données au premier script, sauf si vous incluez une SIGNAL action dans le script généré.

Lancer depuis un autre script à l'aide de l'Action SPAWN

Si vous n'avez pas besoin de transmettre des valeurs de paramètres au script enfant, il vous suffit d'ajouter et de configurer l'Action SPAWN dans le script parent. Si vous devez transmettre des paramètres, vous devez effectuer les configurations suivantes :

  • Make the following changes in the parent script:
    • Placez l'action SPAWN au point où vous souhaitez générer le script enfant. Configurez la propriété Paramètres dans l'action SPAWN avec les valeurs que vous devez transmettre au script enfant. Les valeurs sont transmises dans des variables p1 à p9.
    • Configurez les autres propriétés de l'action SPAWN.
  • Effectuez les modifications suivantes dans le script enfant :

    • Configurez la propriété Paramètres dans l'action pour modifier le nom des variables de paramètre personnalisées. Si vous ne faites rien, les valeurs de paramètres personnalisés restent dans les variables .
    • Si vous devez renvoyer des valeurs au script parent ou à l'application appelante, ajoutez et configurez une action.

Génération à partir de la page Scripts ACD

Vous pouvez générer un script à partir de la page Scripts dans l’application ACD de NiCE CXone. Lorsque vous utilisez cette méthode, toutes les variables pX sont transmises au script généré. Les variables qui n’ont pas de valeur spécifiée sont transmises sous forme de chaînes vides.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications Icon of three-by-three grid of white squares on a blue background et sélectionnez ACD.
  2. Sous Paramètres du contact, cliquez sur Scripts.
  3. Cliquez sur un script dans la liste présentée sur la page.
  4. Sur la page des propriétés du script, cliquez sur l’onglet Générer.
  5. Sélectionnez une ACDCompétence dans la liste déroulante. La compétence doit :

    • Être active.
    • Faire correspondre le type DE support du script. Par exemple, les scripts téléphoniques doivent être en corrélation avec les compétences en appel téléphonique. Vous pouvez trouver le type de compétence dans l’onglet Détails d’une compétence. Scripts avec le type de travail Générique avec n'importe quelle compétence active.
  6. Pour transmettre les données au script, entrez les valeurs dans les champs Paramètre. Vous pouvez entrer jusqu’à neuf valeurs.
  7. Pour générer le script de manière immédiate sans trace de script, cliquez sur Générer. L'onglet Spawn affiche le Message Script généré. Id du contact : [number].

    L’id du contact dans la réponse ne confirme pas que le script s’est exécuté avec succès. Cela indique uniquement qu'un spawn a été déclenché. Le script peut échouer à tout moment après la génération de l'id du contact.

Spawn avec une URL de raccourci de Page Scripts ACD

La nouvelle option Afficher le raccourci de la page Scripts ACD génère une URL qui peut être exécutée comme une demande GET standard d’API REST. Cette URL utilise des paramètres de chaîne de requête pour indiquer à la plateforme comment lancer le script. Les Paramètres et leurs valeurs doivent être codés dans l’URL.

L’exemple suivant montre une URL de raccourci pour un script appelé IBVoice :

https://home-[clusterName].nice-incontact.com/inContact/Manage/Scripts/Spawn.aspx?scriptName=IBVoice&bus_no=12334567&scriptId=172309310&skill_no=20967527&p1=value1&p2=value2&p3=&p4=&p5=&Guid=abcdefgh-1not-real-2345-6789abcdefgh

L’URL de raccourci contient les paramètres suivants :

Ne modifiez pas le GUID. D’ailleurs, le GUID doit être traité comme un mot DE passe. Le GUID ne peut jamais être réinitialisé.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications Icon of three-by-three grid of white squares on a blue background et sélectionnez ACD.
  2. Sous Paramètres du contact, cliquez sur Scripts.
  3. Cliquez sur un script dans la liste présentée sur la page.
  4. Sur la page des propriétés du script, cliquez sur l’onglet Générer.
  5. Sélectionnez une ACDCompétence dans la liste déroulante. La compétence doit :

    • Être active.
    • Faire correspondre le type DE support du script. Par exemple, les scripts téléphoniques doivent être en corrélation avec les compétences en appel téléphonique. Vous pouvez trouver le type de compétence dans l’onglet Détails d’une compétence. Scripts avec le type de travail Générique avec n'importe quelle compétence active.
  6. Pour transmettre les données au script, entrez les valeurs dans les champs Paramètre. Vous pouvez entrer jusqu’à neuf valeurs.
  7. Cliquez sur Show Afficher le raccourci.
  8. Clic droit sur le lien Shortcut to [Name of Script] qui apparaît dans la zone d'informations de l'onglet Spawn, puis sélectionnez Copy link address. Le nom de l’option permettant de copier peut varier selon le navigateur utilisé.
  9. Collez l’URL copiée dans la barre d’adresse d’un navigateur web, puis appuyez sur la touche Entrée.
  10. Le navigateur affiche le message suivant en guise de réponse :

    Script généré. Id du contact : [number]

    L’id du contact dans la réponse ne confirme pas que le script s’est exécuté avec succès. Il indique uniquement que le déclenchement a été effectué. Le script peut échouer à tout point après la génération de l'id du contact.

Génération à partir de la page Scripts ACD avec une trace

Vous pouvez générer un script de manière immédiate et capturer une trace dans Studio. Cela est utile si vous effectuez des tests sur le script. Si vous avez déjà généré le script et qu’il a échoué, la génération avec trace peut vous aider à déterminer ce qui pose problème.

  1. Ouvrez Studio dans un nouvel onglet, puis ouvrez le script que vous générez.
  2. Dans l’onglet du script, cliquez sur Trace et sélectionnez Capturer un contact actif.
  3. Cliquez sur Démarrer la capture.
  4. Dans NiCE CXone, cliquez sur le sélecteur d'applications Icon of three-by-three grid of white squares on a blue background et sélectionnez ACD.
  5. Sous Paramètres du contact, cliquez sur Scripts.
  6. Cliquez sur un script dans la liste présentée sur la page.
  7. Sur la page des propriétés du script, cliquez sur l’onglet Générer.
  8. Remplissez les champs de l’onglet Générer.
  9. Execute the spawn: 
    • Dans l'onglet Générer du script dans l'ACDapplication, cliquez sur Générer.
    • Copiez-collez l’URL de raccourci dans la barre d’adresse d’un navigateur, puis appuyez sur Entrée.
  10. Revenez dans Studio et observez la sortie de trace.
  11. Si vous avez spécifié des valeurs de paramètres, vous pouvez les voir dans la sortie de trace. Cliquez sur l'action BEGIN dans la sortie de trace et localisez les variables p1 à p9. Si vous avez spécifié de nouveaux noms pour les variables, cliquez sur la deuxième action dans le script pour voir la modification.

Déclencher un script par API

Utilisez l'API POST /scripts/start An icon of a square with an arrow  pointing from the center out to the upper right corner. pour générer un script.

Si vous utilisez cette API, il est important de noter les points suivants :

  • The following parameters are required: 
    • skillId: The value must be an integer when sending as JSON, but not if sending as query parameters. Skills must: 
        • Être active.
        • Faire correspondre le type DE support du script. Par exemple, les scripts téléphoniques doivent être en corrélation avec les compétences en appel téléphonique. Vous pouvez trouver le type de compétence dans l’onglet Détails d’une compétence. Scripts avec le type de travail Générique avec n'importe quelle compétence active.
    • ou scriptPath: L'utilisation de scriptPath est recommandée. L’id du script change à chaque fois que vous enregistrez des modifications du script ; il doit donc être mis à jour dans le paramètre.

  • Vous pouvez inclure jusqu’à 20 paramètres.
  • Les paramètres doivent être envoyés sous forme de liste séparée par des barres verticales.
  • L’API prend en charge un maximum de 32 Ko pour tous les paramètres, barres verticales comprises.
  • Les paramètres ne peuvent pas inclure de barres verticales hormis comme séparateurs.
  • Si vous envoyez la demande au format JSON, les caractères réservés doivent être assortis de caractères d’échappement appropriés.
  • Si vous envoyez la demande par URL, les paramètres de la requête doivent être codés dans l’URL.