AgentList

Renvoie tous les agents affectés à l’unité commerciale Regroupement organisationnel de haut niveau utilisé pour gérer le soutien technique, la facturation et les paramètres globaux de votre système NiCE CXone., sauf s’ils se trouvent dans un tableau contenant les informations de profil de chaque agent. Peut renvoyer des informations sur un agent spécifique en saisissant un ID d'agent dans la propriété AgentID. Les champs suivants sont renvoyés dans la variable spécifiée dans le paramètre ListVar : • BusinessUnitID • UserName • MiddleName • Email • TeamId • ReportToId • ReportToMiddleName • IsSupervisor • LastModified • Custom1 • Custom3 • Custom5 • AgentID • FirstName • LastName • IsActive • TeamName • ReportToFirstName • ReportToLastName • LastLogin • Location • Custom2 • Custom4 • InternalId Vous pouvez utiliser cette action pour vérifier si un agent spécifique est actif, trouver l'adresse e-mail de l'agent, vérifier à quelle équipe ils appartiennent ou un grand nombre d'autres options personnalisées. La Liste Agent est l'une des API disponibles Vous pouvez l’utiliser dans Studio. Vous devez avoir les actions et les autorisations Framework activées sur votre unité d’exploitation pour tirer parti de cette action.

Dépendances

Assurez-vous toujours que l’action SetSecurityUser précède cette action et que la variable de sortie de cette action correspond à la variable d’entrée SecurityUser des propriétés d’action Agent List.

Types de scripts pris en charge

Générique	Email	Conversation	Téléphone	Messagerie vocale	Élément de travail	SMS

Propriétés d'entrée

Ces propriétés définissent les données que l'action utilise lors de son exécution.

Propriété	Description
Caption	Entrez une courte phrase qui identifie cette action dans le script de manière unique. La légende est affichée sur le canevas de script sous l’icône de l’action. La valeur par défaut est le nom de l’action.
SecurityUser	La valeur de sortie de l'action SetSecurityUser, qui authentifie un Agent sélectionné en fonction de ses autorisations dans le profil de sécurité. La valeur par défaut est SecurityUser (identique à la valeur de sortie par défaut de SetSecurityUser). Il n'est pas nécessaire d'utiliser des accolades ( {} ) avec cette propriété.
AgentID	L'ID de l'agent. Entrez un ID ou tapez pour trouver un agent spécifique. Vous pouvez utiliser une variable pour ce champ, telle que {agentId}. Lorsqu'il est vide, tous les utilisateurs associés à l'unité d’exploitation seront renvoyés dans un tableau. Ce champ accepte des variables.

Propriétés de sortie

Ces propriétés contiennent des variables qui stockent les données renvoyées par l'exécution de l'action. Elles sont disponibles à des fins de référence et d’utilisation lorsque l'action est terminée.

Propriété	Description
ListVar (out)	Contient les données renvoyées. Le contenu de cette variable est stocké sous forme de tableau. La variable par défaut est Agents.

Conditions de branche résultantes

Les conditions de branche de résultat vous permettent de créer des branches dans votre script afin de gérer différents résultats lors de l'exécution d'une action.

Condition	Description
Par défaut	Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.
OnError	Path taken when the action fails to execute properly. For example, when there is an unexpected problem such as poor connectivity, syntax errors, and so on. The _ERR variable, with a single underscore character, should be populated with a condensed explanation of the problem.

Autres options

En fonction des données que vous voulez obtenir, d'autres actions de l'API Cadre peuvent s'avérer utiles. Par exemple, All Agent Skill Assignments, Agent States V4, Get Agents List, Get Agent Details by Agent ID, etc.