---
sourceDocument: Xanadu 대화형 인터페이스
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu 대화형 인터페이스

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# 사용자 지정 통제 통합

# 사용자 지정 통제 통합 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 5분

통합에서 사용자 지정 통제 프레임워크를 사용하여 빌드된 사용자 지정 통제를 구현하고 활용합니다.

## 시작하기 전에

필요한 역할: virtual_agent_admin 또는 admin

## 이 태스크 정보

사용자 지정 통제를 제공자 채널에 매핑합니다.

사용자 지정 통제 구현 에서 생성됨 워크플로우 스튜디오
:   예제 스크립트를 사용하여 에서 만든 사용자 지정 컨트롤을 구현합니다 워크플로우 스튜디오.  
    예: 사용자 지정 컨트롤 지원

        {
            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";    
        }


    예: 사용자 지정 통제 스크립트

        (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);

사용자 지정 컨트롤의 공급자별 변환 구현Implement a provider-specific transformation of a custom control
:   사용자 지정 어댑터 구성 \[sys_cs_custom_adapter_config\] 테이블의 하위 형식 필드를 사용하여 각 사용자 지정 컨트롤에 대한 공급자별 변환을 구현할 수 있습니다. 필요한 경우 최신 버전의 사용자 지정 컨트롤 또는 미리 빌드된 ServiceNow 사용자 지정 컨트롤(기본 사용자 지정 컨트롤이라고도 함)을 게시할 수 있습니다. 여기에는 적절한 인바운드 및 아웃바운드 워크플로우 스튜디오 작업 스크립트를 게시하고 사용자 지정 어댑터 구성 \[sys_cs_custom_adapter_config\] 테이블의 구성을 업데이트하는 작업이 포함됩니다.

    * 사용자 지정 컨트롤의 ServiceNow 자체 버전을 게시하는 경우 사용자 지정 어댑터 구성 테이블의 사용자 지정 컨트롤 기록을 고유한 인바운드 및 아웃바운드 작업 스크립트 이름으로 덮어씁니다.
    * 하위 유형이 동일한 기록은 하나만 허용됩니다. 두 개의 서로 다른 당사자가 동일한 사용자 지정 제어를 구현하는 경우 한 당사자만 새 인바운드 및 아웃바운드 변환기로 기존 기록을 업데이트할 수 있습니다.

    {#ccif-integrate-custom-controls__ul_z22_lcx_fqb}  
    주:  
    기존 사용자 지정 통제 기록을 재정의하면 시스템에서 새 버전의 사용자 지정 통제를 사용합니다. 예를 들어, 변환 스크립트는 시간 선택기 및 인증과 같은 여러 사용자 지정 통제를 변환할 수 있습니다. 다른 인바운드 및 아웃바운드 변환을 사용하여 시간 선택기 컨트롤을 추가하는 경우 최신 시간 선택기 컨트롤이 사용됩니다. 사용자 지정 컨트롤의 원래 버전으로 되돌릴 수 없습니다.

## 프로시저

1. 모두로 이동한 다음 필터에 <kbd class="ph userinput"> sys_cs_custom_adapter_config.list</kbd>를 입력합니다.
2. 새로 만들기를 선택합니다.
3. 양식의 필드에 내용을 입력합니다.  
   {#ccif-integrate-custom-controls__table_zbd_nsp_b4b__entry__2}

   | 필드 | 설명 |
   |-|-|
   | 제공자 | 사용자 지정 채팅 통합을 위한 채널 식별자의 이름입니다. 자세한 내용은 [사용자 지정 채팅 통합을 위한 채널 식별자 생성](https://servicenow-prod.fluidtopics.net/SF~3penkYXLKVUhAKY0StQ "제공자 채널 신원 [sys_cs_provider_application] 테이블에서 사용자 지정 채팅 통합을 위한 채널 식별자를 생성합니다.") 문서를 참조하십시오. |
   | 통제 유형 | 디자인한 사용자 지정 컨트롤을 선택합니다. 사용자 지정 컨트롤의 경우 형식은 항상 DefaultCustomControl입니다. 사용자 지정 컨트롤에 대한 자세한 내용은 을 참조하십시오 [사용자 지정 컨트롤을 사용하여 사용자 지정 가상 에이전트](https://servicenow-prod.fluidtopics.net/fzAX2_Seib~4V0e~o6TohA "사용자 지정 컨트롤은 개발자가 주제 또는 주제 블록에서 가상 에이전트 사용하기 위해 만들 수 있는 ServiceNow 구성요소입니다. 이러한 컨트롤에는 슬라이더 또는 비디오 플레이어가 포함됩니다. 사용자 지정 컨트롤은 에서 제공하는 컨트롤을 보완합니다 가상 에이전트 디자이너."). |
   | 하위 유형 | 사용자 지정 컨트롤의 이름입니다. |
   | 인바운드 변환기 작업 | 이 리치 컨트롤에 대한 인바운드 변환기 작업 스크립트의 이름(예: sn_va_sms_twilio.va_sms_twilio_adapter_input_text_inbound_transformer)입니다. |
   | 아웃바운드 변환 작업 | 이 리치 컨트롤에 대한 아웃바운드 변환기 작업 스크립트의 이름(예: sn_va_sms_twilio.va_sms_twilio_adapter_input_text_outbound_transformer)입니다. |
   [표 1. 사용자 지정 어댑터 구성 양식]

   {#ccif-integrate-custom-controls__table_zbd_nsp_b4b}
4. 제출을 선택합니다.

