사용자 지정 통제 통합

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기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 자체 버전을 게시하는 경우 사용자 지정 어댑터 구성 테이블의 사용자 지정 컨트롤 기록을 고유한 인바운드 및 아웃바운드 작업 스크립트 이름으로 덮어씁니다.
    • 하위 유형이 동일한 기록은 하나만 허용됩니다. 두 개의 서로 다른 당사자가 동일한 사용자 지정 제어를 구현하는 경우 한 당사자만 새 인바운드 및 아웃바운드 변환기로 기존 기록을 업데이트할 수 있습니다.
    주:
    기존 사용자 지정 통제 기록을 재정의하면 시스템에서 새 버전의 사용자 지정 통제를 사용합니다. 예를 들어, 변환 스크립트는 시간 선택기 및 인증과 같은 여러 사용자 지정 통제를 변환할 수 있습니다. 다른 인바운드 및 아웃바운드 변환을 사용하여 시간 선택기 컨트롤을 추가하는 경우 최신 시간 선택기 컨트롤이 사용됩니다. 사용자 지정 컨트롤의 원래 버전으로 되돌릴 수 없습니다.

    프로시저

    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. 제출을 선택합니다.