사용자 지정 통제 통합

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 4분
  • 통합에서 사용자 지정 통제 프레임워크를 사용하여 빌드된 사용자 지정 통제를 구현하고 활용합니다.

    시작하기 전에

    필요한 역할: 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);
    사용자 지정 컨트롤의 공급자별 변환 구현
    사용자 지정 어댑터 구성 [sys_cs_custom_adapter_config] 테이블의 하위 유형 필드를 사용하여 각 사용자 지정 컨트롤에 대한 공급자별 변환을 구현할 수 있습니다. 필요한 경우 최신 버전의 사용자 지정 컨트롤 또는 기본 사용자 지정 컨트롤이라고도 하는 미리 빌드 ServiceNow 된 사용자 지정 컨트롤을 게시할 수 있습니다. 여기에는 적절한 인바운드 및 아웃바운드 워크플로우 스튜디오 작업 스크립트를 게시하고 사용자 지정 어댑터 구성 [sys_cs_custom_adapter_config] 테이블의 구성을 업데이트하는 작업이 포함됩니다.
    • 사용자 지정 컨트롤의 ServiceNow 고유한 버전을 게시하는 경우 사용자 지정 어댑터 구성 테이블의 사용자 지정 컨트롤 기록을 사용자 고유의 인바운드 및 아웃바운드 작업 스크립트 이름으로 덮어씁니다.
    • 하위 유형이 동일한 기록은 하나만 허용됩니다. 서로 다른 두 당사자가 동일한 사용자 지정 컨트롤을 구현하는 경우 한 당사자만 기존 기록을 새 인바운드 및 아웃바운드 변환기로 업데이트할 수 있습니다.
    주:
    기존 사용자 지정 통제 기록을 재정의하면 시스템이 새 버전의 사용자 지정 통제를 사용합니다. 예를 들어, 변환 스크립트는 시간 선택기 및 인증과 같은 여러 사용자 지정 컨트롤을 변환할 수 있습니다. 인바운드 및 아웃바운드 변환이 다른 시간 선택기 컨트롤을 추가하면 최신 시간 선택기 컨트롤이 사용됩니다. 사용자 지정 컨트롤의 원래 버전으로 되돌릴 수 없습니다.

    프로시저

    1. 모두로 이동한 다음 필터에 sys_cs_custom_adapter_config.list를 입력합니다.
    2. 새로 만들기를 선택합니다.
    3. 양식에서 필드를 채웁니다.
      표 1. 사용자 지정 어댑터 구성 양식
      필드 설명
      제공자 사용자 지정 채팅 통합의 채널 식별자 이름입니다. 자세한 내용은 사용자 지정 채팅 통합을 위한 채널 식별자 만들기 문서를 참조하십시오.
      통제 유형

      디자인한 사용자 지정 컨트롤을 선택합니다. 사용자 지정 컨트롤의 경우 형식은 항상 DefaultCustomControl입니다.

      사용자 지정 컨트롤에 대한 자세한 내용은 다음 문서를 참조하십시오 사용자 지정 통제를 가상 에이전트 사용하여 사용자 지정.

      하위 유형 사용자 지정 컨트롤의 이름입니다.
      인바운드 변환기 작업 이 리치 컨트롤에 대한 인바운드 변환기 작업 스크립트의 이름입니다(예: sn_va_sms_twilio.va_sms_twilio_adapter_input_text_inbound_transformer).
      아웃바운드 변환 작업 이 리치 컨트롤에 대한 아웃바운드 변환기 작업 스크립트의 이름입니다(예: sn_va_sms_twilio.va_sms_twilio_adapter_input_text_outbound_transformer).
    4. 제출을 선택합니다.