Script avec des Fichiers et des Dossiers

You can work with files in Studio scripts. Files must exist on your NiCE CXone system. You can view the files in NiCE CXone on the Browse ACD Files page. You can upload and download files from this page. You can also upload and download files using Desktop Studio.

Il existe des actions qui vous permettent d'explorer les fichiers de votre système NiCE CXone :

  • Writefile : enregistre les données dans un fichier dans NiCE CXone.
  • Readfile : lit les données d'un fichier.
  • Filesize : détermine la taille d'un fichier en octets.
  • Fileinfo : récupère des informations sur un fichier, telles que son emplacement et si celui-ci a été modifié.
  • Fileexist : Détermine si un fichier spécifique existe.
  • Effacer : supprime des fichiers de NiCE CXone.

Certaines actions vous permettent d'envoyer des fichiers par e-mail ou par FTP/SFTP :

  • EMAIL : Envoie un e-mail avec un fichier joint.
  • EMAIL (Digital Scripts) : envoie un e-mail avec un fichier joint.
  • Joindre: attache des fichiers aux e-mails générés.
  • Sendfile : Envoie des fichiers via FTP ou sftp.

Certaines actions vous permettent d'utiliser des fichiers audio préenregistrés ou des invites dans vos interactions :

  • MENU : Lit un prompt ou un fichier audio pré-enregistré pour le contact et crée un menu d'options qu'il peut choisir parmi.
  • Play : joue des fichiers audio WAV personnalisés ou des invites de synthèse vocale (TTSClosed Allows users to enter recorded prompts as text and use a computer-generated voice to speak the content.). Si vous utilisez un fichier, le fichier entier est lu. Seul le contact peut entendre l'audio.
  • Playlog : Lit des fichiers audio WAV personnalisés que seul le contact peut entendre. Vous pouvez sélectionner des points de début et de fin précis. Il est impossible de lire les fichiers musicaux qui sont intégrés à d'autres actions, comme Music.
  • Reqagent: Lit des fichiers audio WAV personnalisés ou une invite de synthèse vocale que seul l'agent entend. Pour éviter que le contact entende un temps de silence, l’invite est lue avant que l’agent et le contact soient mis en relation.
  • Murmurer : Joue des fichiers WAV personnalisés ou des invites de synthèse vocale. Vous pouvez déterminer que ces fichiers soit audibles par le contact uniquement, l'agent uniquement ou les deux. L’invite est lue après la mise en relation de l’agent et du contact ; par conséquent, si l’action lit l’invite uniquement à l’agent ou au contact, l’autre partie entend un silence pendant ce temps.

Une dernière action est l'CONCATWAV Action, qui vous permet de concaténer deux fichiers WAV.

Une charge excessive est placée sur votre système lorsque ces conditions sont remplies :

  • Votre unité commerciale a plus que ~15 appels simultanés.
  • Les scripts en cours d'exécution contiennent des actions liées aux fichiers, telles que Fichier d'écriture,Lire le fichier et Fichierexiste.

Cela entraîne une limitation (throttling). Votre unité commerciale rencontrera une latence au niveau de l'exécution des script et d'autres fonctions, y compris la gestion des contacts et les changements d'état, jusqu'à ce que le Backlog des processus soit terminé.

Chemins d'accès aux fichiers

Lorsque vous devez faire référence à des chemins de fichiers dans vos scripts, consultez la page d'aide de l'action que vous utilisez. Certaines actions utilisent des chemins absolus.Les Autres nécessitent un chemin relatif. Si la page d'aide ne précise pas le type de chemin à utiliser et que l'un des types ne fonctionne pas dans votre script, réessayez avec l'autre type. La différence entre les chemins d'accès absolus et relatifs est la suivante :

  • Chemin absolu : commence toujours au dossier racine. L'emplacement du fichier de script par rapport au fichier ou au script auquel vous faites référence n'a pas d'importance. Utilisez un tilde suivi d'une barre oblique inversée (~\) pour indiquer le dossier racine. Par exemple, ~\dossier\fichier.wav.
  • Chemin relatif : décrit l'emplacement du fichier auquel vous faites référence par rapport au fichier script, en partant de l'emplacement du fichier script. Si le fichier se trouve dans un sous-dossier situé dans le même Dossier que le script, considérez l'emplacement du script comme la racine et incluez les noms des sous-Dossiers dans votre chemin. Par exemple, si le script se trouve dans \Folder, et que file.wav se trouve dans \Folder\Subfolder1, vous écririez le chemin comme suit : \Subfolder1\file.wav. Si le fichier se trouve hors du dossier du script, ou si un chemin relatif ne fonctionne pas, utilisez plutôt un chemin absolu.

Il s'agit d'une bonne pratique dans Studio que d'utiliser des chemins absolus lorsque cela est possible, même lorsque des chemins relatifs sont également pris en charge. Cela est particulièrement important lorsque vous faites référence à un fichier situé dans un autre dossier. Cette bonne pratique s'applique chaque fois que vous faites référence à des fichiers dans les Scripts, et pas uniquement lorsque vous travaillez avec les étapes du Workflow de développement.

Gestion du chemin d’accès dans Scripts

Les Scripts dans Studio existent rarement de façon isolée. Ils sont généralement organisés dans plusieurs dossiers pour faciliter la réutilisation et la personnalisation. Les autres fichiers utilisés avec les scripts, tels que les invites audio ou les fichiers de grammaire ASRClosed Automatic Speech Recognition. Allows contacts to respond to prompts by speaking, pressing phone keys, or both., se trouvent dans des dossiers séparés. Si votre entreprise utilise les Studio étapes du workflow de développement, vous disposez également de dossiers liés aux étapes qui permettent une Promotion contrôlée. Les scripts font souvent référence à d'autres scripts situés dans des dossiers différents ; la gestion des chemins est donc nécessaire pour le succès du scripting.

Vous pouvez utiliser la substitution de variable dans les chemins de fichiers pour créer un moyen cohérent et fiable de gérer les chemins dans vos Scripts. Cela permet de garantir que les références aux autres Scripts, aux invites audio, aux grammaire ASR et aux autres fichiers soient plus exactes dans l'ensemble de votre écosystème de script.

La gestion des chemins permet aux Scripts de trouver et d'exécuter d'autres scripts ou d'utiliser d'autres fichiers au-delà des limites des dossiers. En utilisant la substitution de variable pour les chemins de fichiers, vous disposez de chemins définis en un petit nombre d'endroits. Si des dossiers ou des fichiers changent, vous n'avez besoin de mettre à jour le chemin qu'en un seul endroit, au lieu de devoir trouver chaque référence au fichier.

Substitution variable pour les Chemins d'accès aux fichiers

Le recours à la substitution de variable pour les chemins de fichiers vous permet de définir :

  • Le chemin absolu vers les dossiers contenant des Scripts ou des fichiers que vous référencez dans des Scripts. Lorsque vous faites référence à des Scripts ou à des fichiers situés dans d'autres dossiers, vous devez utiliser un chemin absolu.

  • Chemins qui se mettent à jour automatiquement lorsqu'un script est promu. Cette option s'applique uniquement si votre entreprise utilise Studio étapes de workflow de développement.

  • Chemins d'accès aux dossiers et aux fichiers dans un seul emplacement, ou dans un petit nombre d'emplacements. Cela facilite la mise à jour du chemin, car vous savez où les variables ont été créées.

Vous pouvez créer des variables pour contenir le chemin d'accès à chaque type de fichier que vous référencez, comme les invites, la grammaire, les messages vocaux, d'autres scripts, etc. Si un script enregistre des fichiers dans un dossier ou lit des fichiers à partir d'un dossier, vous pouvez également utiliser des variables pour ces chemins.

Lorsque vous devez faire référence à un fichier, utilisez la variable à la place du chemin. Par exemple, créez une variable pour le chemin d’accès à vos fichiers prompt et utilisez-la dans les propriétés de l’actionClosed Performs a process within a Studio script, such as collecting customer data or playing music. lorsque vous spécifiez un prompt. Cela pourrait ressembler à l’exemple suivant : {promptPath}Message d’accueil.wav.

Pour automatiser la mise à jour des variables de chemin, vous pouvez utiliser une action SNIPPET et écrire du code permettant de déterminer dans quel dossier de phase de développement se trouve le script, puis mettre à jour le chemin en conséquence. Le reste de cette page d'aide décrit un exemple d'Extrait que vous pouvez utiliser comme modèle dans votre script.

Si votre organisation compte plusieurs développeurs de script, collaborez afin d'élaborer une stratégie d'utilisation de la substitution de variables pour les chemins d'accès aux fichiers. Cela permettra de gagner du temps et garantira que tout le monde sait quelles variables utiliser.

Exemple de substitution variable du chemin d’accès

L'exemple de substitution de variable pour les chemins d'accès est configuré comme un script d'entrée. Un script d'entrée est le script par défaut configuré dans un point of contactClosed The entry point that an inbound contact uses to initiate an interaction, such as a phone number or email address. (Pda). Dans l'exemple, le script d'entrée s'exécute vers un autre script qui effectue le routage pour le canal. Vous pouvez également utiliser un script d'entrée comme script par défaut pour plus que un Pda et le faire s'exécuter vers le script de routage approprié en fonction de critères tels que la ACD compétenceClosed Used to automate delivery of interactions based on agent skills, abilities, and knowledge. ou le DNISClosed The number dialed on inbound or outbound voice calls.. L'avantage d'utiliser un seul script d'entrée pour plusieurs Pda est de réduire les risques d'erreurs en définissant vos substitutions de variable de chemin d'accès en un seul endroit.

L'exemple de script d'entrée contient une action BEGIN connectée à une action SNIPPET et à une action RUNSCRIPT, comme illustré dans l'image suivante.

L'action SNIPPET contient du code qui détermine le nom et le chemin d'accès du script en cours d'exécution. Ces informations sont utilisées pour créer un chemin absolu vers les dossiers contenant les scripts, les invites, etc. Vous pouvez écrire votre propre code ou utiliser cet exemple :

SELECT
 {
  CASE runScript.length > 0 //Voice, Legacy Chat, Work Item
  {
   ASSIGN normalizedScriptName = "{runScript}"
  }
  CASE __runScript.length > 0 //Legacy Email
  {
   ASSIGN normalizedScriptName = "{__runScript}"  
  }
  CASE __targetScript.length > 0 //Simulate Inbound
  {
   ASSIGN normalizedScriptName = "{__targetScript}"
  }
  CASE __scriptName.length > 0 //Digital
  {
   ASSIGN normalizedScriptName = "{__scriptName}"
  }
  CASE customScript.length > 0 //Custom Outbound script
  {
   ASSIGN normalizedScriptName = "{customScript}"  
  }
  CASE __reskillscript.length > 0 //Custom Script assigned to skill on reskill
  {
   ASSIGN normalizedScriptName = "{__reskillscript}"  
  }
  CASE global:callSuppScript.length > 0 //Suppression script
  {
   ASSIGN normalizedScriptName = "{global:callSuppScript}"
  }
}
IF normalizedScriptName.length > 0
{
 ASSIGN folderArray = "{normalizedScriptName.split('\')}"
 ASSIGN env = "{folderArray[1]}"
 FOR i = 1 TO folderArray.size - 1
 {
  ASSIGN folderPath = "{folderPath}\{folderArray[i]}"
  }
}
IF env.length = 0
 {
  ASSIGN env = "DEV"
 }
ASSIGN scriptPath = "~{folderPath}\"
ASSIGN promptPath = "~{folderPath}\Prompts\"
ASSIGN grammarPath = "~{folderPath}\Grammars\"

Cet exemple de code utilise une SELECT instruction avec plusieurs CASEs. Chaque CASE représente l'une des variables système qui peuvent contenir le nom et le chemin du script actuel. La variable utilisée dans un script particulier dépend du type de script. L'extrait :

  1. Recherche la variable système qui contient le chemin et le nom du script actuel. Pour ce faire, il :

    1. Évalue chaque CASE pour vérifier si la valeur de la variable spécifiée a une longueur supérieure à 0.
    2. Si c'est le cas, l'extrait sélectionne ce CASE et attribue la valeur de la variable à la variable normalizedScriptName.
  2. Détermine le nom du dossier d'étape du workflow de développement dans lequel le script est situé. Pour ce faire, il :

    1. Utilise la fonction split() pour convertir la valeur de normalizedScriptName en un tableau à l'aide du caractère barre oblique inverse (\) comme délimiteur, et attribue la valeur convertie à folderArray. Ceci remplace toutes les barres oblique inverse du chemin du script par un caractère barre verticale (|), ce qui convertit le chemin et le nom du script en un tableau. Par exemple, si la valeur de normalizedScriptName est Prod\ScriptFolder3\ScriptExample1, la valeur de folderArray devient Prod|ScriptFolder3|ScriptExample1.

    2. Crée une variable appelée env pour contenir le nom du dossier de l'étape de la phase du workflow de développement actuelle. L'extrait remplit env avec le contenu du premier élément du tableau. En suivant l'exemple de l'étape précédente, env aurait pour valeur Prod.

  3. Construit le chemin d'accès au dossier du script actuel et le stocke dans une Variable. La valeur du chemin n'inclut pas le nom du script. Pour ce faire, l'extrait :

    1. Utilise une boucle FOR pour ajouter la valeur de chaque élément de folderArray à une nouvelle variable, folderPath, séparés par une barre oblique inverse (\).

  4. Contient une instruction IF qui vérifie que la variable env est renseignée avec une valeur (IF env.length = 0). Si ce n'est pas le cas, elle lui applique dev comme valeur par défaut. Cette instruction IF agit comme une sauvegarde en cas de problème pendant l'instruction IF précédente et si env n'est pas renseigné.

    Il est important que cette variable ait une valeur appropriée, car elle est couramment utilisée dans Studio scripts pour déterminer l'environnement utilisé dans diverses situations où le script interagit avec un système pouvant disposer d'une version bac à sable ou de développement et d'une version de production. Par exemple, cela est courant avec les intégrations avec des CRMsClosed Third-party systems that manage such things as contacts, sales information, support details, and case histories.. Vous pouvez modifier la valeur pour qu'elle corresponde au nom du dossier de phase de développement de votre organisation.

  5. Définit et renseigne des variables pour contenir le chemin absolu de l'emplacement des dossiers suivants en fonction du folderPath :

    • Les dossiers qui contiennent les scripts que l'action RUNSCRIPT lance, valeur :

      ASSIGN scriptPath = "~{folderPath}\"

    • Le dossier qui contient les invites utilisées par le ou les scripts suivants :

      ASSIGN promptPath = "~{folderPath}\Prompts\"

    • Le dossier qui contient les fichiers de grammaire utilisés par le ou les scripts suivants :
      ASSIGN grammarPath = "~{folderPath}\Grammars\"

    Vous pouvez créer des variables supplémentaires pour contenir les chemins d'accès aux emplacements d'autres fichiers utilisés par votre organisation, comme la messagerie vocale.

L'extrait précédent crée un chemin d'accès absolu. Vous pouvez utiliser cette Variable dans n'importe quel script ultérieur qui nécessite un chemin d'accès au dossier dans un extrait ou une configuration de propriété d'Action. Si l'Action que vous utilisez prend en charge les chemins relatifs, vous pouvez choisir de ne pas utiliser la Variable folderPath. Toutefois, la bonne pratique dans Studio consiste à utiliser des chemins absolus dans la mesure du possible, même lorsque les chemins relatifs sont également pris en charge.

Personnaliser l'Extrait de script d'entrée

Pour permettre à l'extrait de script d'entrée d'exemple de fonctionner avec vos scripts, vous devez personnaliser certaines des variables :

  • scriptPath : Modifiez la valeur pour inclure les noms de sous-dossiers non déjà inclus dans la variable scriptPath, le cas échéant.

  • promptPath : dans la valeur attribuée, remplacez \Prompts\ par le nom du dossier dans lequel sont sauvegardés vos fichiers audio d'Invites préenregistrées. Inclure tout nom de sous-dossier, le cas échéant.

  • grammarPath: Si vous utilisez ASRClosed Automatic Speech Recognition. Allows contacts to respond to prompts by speaking, pressing phone keys, or both., remplacez \Grammaire\ dans la valeur attribuée par le nom du dossier où sont sauvegardés vos fichiers de grammaire, en incluant les noms de sous-dossiers, le cas échéant. Si vous n'utilisez pas ASR, vous pouvez supprimer cette variable.

Vous pouvez modifier ces noms DE variables si vous le souhaitez. Toutefois, si vous changez les noms DE variables qui ont déjà été utilisées dans d'autres scripts, vous devez changer chaque instance de l'ancien nom dans vos scripts. Ne changez pas le nom de env.

Vous pouvez également effectuer les personnalisations supplémentaires suivantes :

  • Si vous avez d'autres dossiers auxquels vous faites référence dans vos Scripts, ajoutez des variables et configurez leurs valeurs de manière appropriée, en suivant l'exemple des variables existantes.

  • Dans l'instruction IF suivante, modifiez la valeur par défaut attribuée à env pour qu'elle corresponde au dossier de niveau supérieur de votre phase de développement :

    
    IF env.length = 0
     {
      ASSIGN env = "DEV"
     }

Configurer un script d'entrée pour lancer plusieurs scripts

Vous pouvez configurer un script d'entrée pour choisir quel script l'action RUNSCRIPT lance. Cela est utile si vous souhaitez utiliser le même script d'entrée pour plusieurs scripts principaux.

Pour configurer cela, ajoutez une logique de script à l'SNIPPET dans le script d'entrée qui définit comment le script approprié est sélectionné. L'exemple suivant utilise une instruction SWITCH avec DNISClosed The number dialed on inbound or outbound voice calls. comme critère de décision. Vous pouvez toute logique de script et tout critère pris en charge pour répondre aux besoins de votre organisation. Pour personnaliser ce code, veillez à ce que la valeur de chaque variable nextScript définisse le script approprié pour son critère. Incluez des commentaires avec des doubles barres obliques (//) pour fournir des explications sur chaque script.

SWITCH DNIS // choose the next script based on a DNIS
{
CASE 8885551234  {
	ASSIGN nextScript = "{scriptPath}MainGreeting1"
  }
CASE 8005552345
  {
    ASSIGN nextScript = "{scriptPath}MainGreeting2" 
  }
CASE 6145554567  {
    ASSIGN nextScript = "{scriptPath}MainGreeting3" 
  }
DEFAULT
  {
    ASSIGN nextScript = "{scriptPath}MainGreeting4" 
  }

Utiliser des variables Chemin dans Scripts

Après avoir configuré votre entry script, vous devez utiliser les variables qui y sont définies dans vos autres scripts.

Ne modifiez pas les scripts de production. Travaillez toujours avec la version de développement d'un script, lorsque cela est possible. Test toutes les modifications avant de remettre le script en production. Apporter des modifications directement aux scripts de production peut entraîner le non-routage des contacts pour le point de contactClosed The entry point that an inbound contact uses to initiate an interaction, such as a phone number or email address. concerné.

  1. Dans Studio, parcourez vos scripts et recherchez les instances où des chemins de fichiers sont utilisés. Les Chemins peuvent apparaître dans les configurations de propriétés, les légendes, les valeurs de variable et le code d'extrait. En particulier, examinez les actions telles que RUBSUB, RUNSCRIPT, SPAWN, MUSIC, PLAY, WHISPER, ainsi que toute ASR ou tout action liée aux fichiers. Vous pouvez rechercher des scripts qui contiennent certaines actions ou dont les légendes comportent des noms de dossiers.

  2. Remplacez la partie appropriée du chemin d’accès par la variable correspondante telle que définie dans votre script d’entrée. Par exemple, si une action MENU a une propriété Séquence configurée pour lire 01MainGreetingMenu.wav, vous la remplaceriez par "{promptPath}01MainGreetingMenu.wav". L'image suivante montre plusieurs exemples de cela dans un script.