Create Source Map

This help page is for Desktop Studio. This information is also available for CXone Studio.

Crée une légende ou une carte utilisée pour interpréter les structures de données entre le système CXone et votre CRMFermé Systèmes tiers qui gèrent des éléments tels que les contacts, les informations de vente, les détails de l’assistance et les historiques de cas..

Dépendances

Create Source Map est destiné à être utilisé avec Proactive XS uniquement.

Types de scripts pris en charge

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

Téléphone

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

Saisissez une courte phrase qui identifie de manière unique cette action dans le script. La légende apparaît dans le canevas de script sous l’icône d’action. The default is the action name.

SourceName Le nom de la source d’où proviennent les dossiers. Fournit un regroupement logique d’enregistrements dans le système. Si vous avez un mappage source non valide ou manquant, vous pourriez recevoir le message d’erreur « ID externe manquant ».
Mapping La structure de données dynamiques qui permet au système CXone d'interpréter les données de votre système (CRM).

Conditions de la branche de résultat

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

Default Chemin emprunté à moins que le script ne remplisse une condition exigeant qu’il prenne l’une des autres branches. Elle est également prise si les autres branches de l’action ne sont pas définies.
InvalidSource Chemin emprunté si le nom de source fourni n'existe pas.
InvalidRootNode Chemin emprunté si CXone ne peut pas déterminer la présence d'un champ système ou d'une définition personnalisée pour ce nom de champ.
InvalidFieldName Chemin emprunté si CXone ne peut pas déterminer la présence d'un champ système ou d'une définition personnalisée pour ce nom de champ.
MissingRequiredField Chemin emprunté si un champ obligatoire nécessaire pour traiter le contact est introuvable. Les champs obligatoires comprennent un champ numéro de téléphone et ExternalID.
Error Chemin emprunté lorsque l’action ne s’exécute pas correctement. Par exemple, en cas de problème inattendu tel qu’une mauvaise connectivité, des erreurs de syntaxe, etc. La variable _ERR, avec un seul caractère de soulignement, doit être remplie avec une explication condensée du problème.
FieldsInUseCantApply Chemin emprunté en cas de tentative de modification ou de suppression d'une valeur actuellement utilisée par un filtre.
NoChangesMade Chemin emprunté si le mappage entre CXone et votre système correspond exactement.
ExceededMaxDestinations Chemin emprunté si le nombre de numéros de téléphone par contact dépasse le montant indiqué. Par exemple, si le système permet d'utiliser six numéros par contact et que vous en fournissez sept, le système empruntera cette branche.

Mappage de champs

En conjonction avec l’action Create Source Map, vous devez inclure une Snippet action qui définit les correspondances de champs entre CXone et votre CRMFermé Systèmes tiers qui gèrent des éléments tels que les contacts, les informations de vente, les détails de l’assistance et les historiques de cas.. Vous trouverez ci-dessous les champs système vers lesquelles vous pouvez réaliser le mappage.

  • Adresse
  • Agent
  • CallerID
  • Minutes Périmées de Demande d’Appel
  • Ville
  • Conformité
  • ConfirmationRequired
  • CustomerField1
  • CustomerField2
  • ExternalID
  • Prénom
  • Nom
  • Notes
  • PhoneNumber (Numéro de téléphone)
  • PreferredCallTime
  • Priorité
  • Score
  • État
  • Fuseau horaire
  • Code postal

Vous pouvez également mapper à la Définition de données personnalisées que vous avez créée dans CXone.

Exemple de script

Cet exemple montre comment cette action peut être utilisée dans les scripts. Il ne s’agit pas d’un texte complet. Des scripts supplémentaires peuvent être nécessaires.

Le script ci-dessous peut être utilisé pour récupérer un mappage de sources (en utilisant Get Source Map) ou pour créer un nouveau mappage de sources (en utilisant Create Source Map). Prenez note de tous les mappages provenant de Create Source Map, qui permettent de composer les enregistrements provenant du CRM.

Ce script contient deux actions Snippet, qui nécessitent quelques modifications lorsque vous intégrez cet exemple dans votre script.

L’extrait de code Make Changes Here GET SOURCE contient la ligne de code suivante :

ASSIGN sourceName = "Nick Desk"		

L’extrait de code Make Changes Here CREATE SOURCE contient le code suivant :

DYNAMIC testData
// CHANGE BELOW VALUE DEPENDING ON TEST
ASSIGN switchValue = "No Changes Made"

SWITCH switchValue
	{
		CASE "Invalid Source"
			{
			sourceName = "I Don't Exist"
			}
		CASE "Invalid Root Node"
			{
			testData.Fail.Phone = ""
			}
		CASE "Invalid Field Name"
			{
			testData = initialResult
			testData.Mappings.MyCustomField = ""
			}
		CASE "Missing Required Fields"
			{
			testData.Mappings.City = "City"
			testData.Mappings.State = "State"
			}
		CASE "Field In Use Cant Apply"
			{
			// Switch ValueString with a CDD or SDD that you currently have applied to a source and using to filter
			testData = initialResult
			testData.Mappings.FilterOnMe = "City"
			}
		CASE "No Changes Made"
			{
			// Don't Change anything just pass in the exact same mapping we've already got
			testData = initialResult
			}
		CASE "Create Mapping System"
			{
			// SYSTEM DATA DEFINITIONS
			testData = initialResult
			testData.Mappings.TimeZone = "Time Zone"
			testData.Mappings.Compliance = "Is Cell Phone"
			testData.Mappings.ConfirmationRequired = "Confirmation Required"
			testData.Mappings.CallerID = "Caller ID"
			testData.Mappings.Score = "Score"
			testData.Mappings.CustomerField1 = "Customer Field 1"
			testData.Mappings.CustomerField2 = "Customer Field 2"
			testData.Mappings.ExternalID = "External ID"
			testData.Mappings.Priority = "Priority"
			testData.Mappings.Zip = "Zip"
			testData.Mappings.State = "State"
			testData.Mappings.City = "City"
			testData.Mappings.Address = "Address"
			testData.Mappings.LastName = "Last Name"
			testData.Mappings.FirstName = "First Name"
			testData.Mappings.PhoneNumber = "Phone Number"
			}
		CASE "Update Mapping System"
			{
			// SYSTEM DATA DEFINITIONS
			testData = initialResult
			testData.Mappings.TimeZone = "My TimeZone"
			testData.Mappings.ConfirmationRequired = "Requires Confirmation"
			testData.Mappings.CallerID = "Phone Number"
			testData.Mappings.State = "Contacts State"
			}
		CASE "Create Mapping Custom"
			{
			// CUSTOM DATA DEFINITIONS
			testData = initialResult
			testData.Mappings.YourCDDName = "[COLUMN TO MAP IT TO]"
			}
		CASE "Update Mapping Custom"
			{
			// CUSTOM DATA DEFINITIONS
			testData = initialResult
			testData.Mappings.YourCDDName = "[COLUMN TO MAP IT TO]"
			}
		}	

Télécharger ce script.