--- sourceDocument: Interfaces conversationnelles Yokohama sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/conversational-interfaces Release : - yokohama ft:locale : - fr-FR ft:publication_title : - Interfaces conversationnelles Yokohama ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # Intégrer les contrôles personnalisés # Intégrer les contrôles personnalisés {#ariaid-title1} * Rversion finale: Yokohama * * Mis à jour 30 janv. 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes de lecture Implémentez et exploitez les contrôles personnalisés créés à l'aide du cadre de travail de contrôle personnalisé dans votre intégration. ## Avant de commencer Rôle requis : virtual_agent_admin ou admin ## Pourquoi et quand exécuter cette tâche Mappez les contrôles personnalisés à un canal de fournisseur. Implémenter les contrôles personnalisés créés dans Studio de workflow : Utilisez l'exemple de script pour implémenter les contrôles personnalisés créés dans Studio de workflow. Exemple : prise en charge des contrôles personnalisés { uiType: "CustomControl", group: "DefaultCustomControl", name: "The name of the Custom Control (sys_cs_custom_control.name)", required: true/false, uxComponentDefinitionSysId: "seismicComponentId" // or null if not isInput: true/false, // whether to wait for a response value or if just output serializedControlData: "User defined JSON from generateControlData function"; } Exemple : script de contrôles personnalisés (function execute(inputs, outputs) { var rich_controls = inputs.rich_control; //this is the data returned from the 'serialized control data function' defind in designer var serializedControlData = rich_control['serializedControlData']; // if this rich control will require a response to move forward in topic flow var isInput = rich_control['isInput']; // if the component is suggesting using a Seismic control (web) that handles this var uxComponentDefinitionId = rich_control['uxComponentDefinitionSysId']; // the name of the custom control var name - rich_control['name']; // 1) now perform some logic to transform this data into a custom ui (slack/facebook/sms ascii art/html/etc) // 2) attach to outputs, i.e. outputs.text_message='foo :)'; for sms twillio // basic flow is to take the serializedControlData/Name/compId(optional) and create a custom UI component here // that your client understands (i.e. a slack rich form payload) })(inputs, outputs); Implémenter une transformation spécifique au fournisseur d'un contrôle personnalisé : Vous pouvez implémenter une transformation spécifique au fournisseur pour chaque contrôle personnalisé à l'aide du champ Sous-type dans la table Configuration d'adaptateur personnalisé \[sys_cs_custom_adapter_config\]. Vous pouvez publier une version plus récente d'un contrôle personnalisé ou un contrôle personnalisé prédéfini, ServiceNow également appelé contrôle personnalisé par défaut, si nécessaire. Cela implique la publication des scripts d'action entrants et sortants Studio de workflow appropriés et la mise à jour de la configuration dans la table Configuration d'adaptateur personnalisé \[sys_cs_custom_adapter_config\]. * Si vous publiez votre propre version d'un ServiceNow contrôle personnalisé, remplacez l'enregistrement du contrôle personnalisé dans la table Configuration de l'adaptateur personnalisé par vos propres noms de script d'action entrante et sortante. * Un seul enregistrement avec le même sous-type est autorisé. Si le même contrôle personnalisé est mis en œuvre par deux parties différentes, une seule peut mettre à jour l'enregistrement existant avec de nouveaux transformateurs entrants et sortants. {#ccif-integrate-custom-controls__ul_z22_lcx_fqb} Remarque : Une fois que vous avez remplacé un enregistrement de contrôle personnalisé existant, le système utilise la nouvelle version du contrôle personnalisé. Par exemple, les scripts de transformation peuvent transformer plusieurs contrôles personnalisés, tels que le sélecteur d'heure et l'authentification. Si vous ajoutez un contrôle Sélecteur d'heure avec différentes transformations entrantes et sortantes, le nouveau contrôle Sélecteur d'heure est utilisé. Vous ne pouvez pas revenir à la version d'origine du contrôle personnalisé. ## Procédure 1. Accédez à Tout, puis saisissez sys_cs_custom_adapter_config.list dans le filtre. 2. Sélectionnez Nouveau. 3. Remplissez les champs du formulaire. {#ccif-integrate-custom-controls__table_zbd_nsp_b4b__entry__2} | Champ | Description | |-|-| | Fournisseur | Nom de l'identificateur de canal pour votre intégration de messagerie instantanée personnalisée. Pour plus de détails, voir [Créer un identificateur de canal pour votre intégration de messagerie instantanée personnalisée](https://servicenow-prod.fluidtopics.net/PSpfnBtlv9CFGsrWY_aR4w "Créez un identificateur de canal pour votre intégration de messagerie instantanée personnalisée dans la table Identités des canaux des fournisseurs [sys_cs_provider_application]."). | | Type de contrôle | Sélectionnez le contrôle personnalisé que vous avez conçu. Pour les contrôles personnalisés, le type est toujours DefaultCustomControl. Pour en savoir plus sur les contrôles personnalisés, reportez-vous à la section [Personnalisation à l'aide de Agent virtuel contrôles personnalisés](https://servicenow-prod.fluidtopics.net/TVcrEKwgP689s_af1hM5dg "Les contrôles personnalisés sont des composants que ServiceNow les développeurs peuvent créer pour être utilisés dans des rubriques ou des Agent virtuel blocs de rubriques. Ces commandes incluent des curseurs ou des lecteurs vidéo. Des commandes personnalisées complètent celles fournies dans Concepteur d'agent virtuel."). | | Sous type | Nom du contrôle personnalisé. | | Action du transformateur entrant | Nom du script d'action du transformateur entrant pour ce contrôle enrichi, par exemple sn_va_sms_twilio.va_sms_twilio_adapter_input_text_inbound_transformer. | | Action de transformation sortante | Nom du script d'action du transformateur sortant pour ce contrôle enrichi, par exemple sn_va_sms_twilio.va_sms_twilio_adapter_input_text_outbound_transformer. | [Tableau 1. Formulaire Configurations d'adaptateur personnalisé] {#ccif-integrate-custom-controls__table_zbd_nsp_b4b} 4. Sélectionnez Envoyer.