계정 수명주기 이벤트 Playbook 데이터 임포트 작업 구성

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기8분
  • 를 사용하여 Playbooks데이터 임포트 작업을 계정 수명주기 이벤트 구성합니다.

    데이터 임포트 작업을 구성하려면 다음 역할이 있어야 합니다.
    • sn_acct_lc.agent
    • 하나 이상의 Playbooks 역할. 자세한 내용은 Playbooks roles 문서를 참조하십시오.

    다음 표에서는 데이터 가져오기 작업 구성과 관련된 다양한 작업을 보여 줍니다.

    표 1. 데이터 임포트 작업
    작업 섹션
    Excel 템플릿을 생성하여 대상 테이블로 데이터를 임포트합니다. Excel 템플릿 작성
    대상 테이블로 이동하기 전에 임포트 데이터를 저장할 수 있는 스테이징 테이블을 만듭니다. 스테이징 테이블 생성
    데이터 소스를 만들고 템플릿 파일을 기록에 첨부합니다. 데이터 원본 만들기
    변환 맵을 구성합니다. 변환 맵 구성
    프로세스에 Playbook 활동을 Playbooks 추가합니다. 데이터 임포트 작업 추가
    주:
    다음 섹션에서는 기본 시스템에서 사용할 수 있는 위치 테이블에 대한 데이터 임포트 작업을 구성하는 방법에 대해 설명합니다. 이 섹션에 사용된 이름과 값은 예제이지만 이 프로세스에 따라 데이터 가져오기 작업에 사용되는 테이블을 구성할 수 있습니다.

    Excel 템플릿 작성

    Excel 템플릿을 생성하여 대상 테이블로 데이터를 임포트합니다.

    1. 모두로 이동하고 검색 필터에 cmn_location.list를 입력합니다.
    2. 개인화 아이콘을 선택하고 템플릿에 포함할 열을 선택합니다. 필요한 경우 필터 조건을 입력하고 열 옵션 아이콘을 선택한 다음 Excel로 내보내기(.xlsx)를 선택합니다.
    3. 다운로드를 선택하여 내보낸 파일을 다운로드합니다.
    4. 다운로드한 Excel 파일을 열고, 기존 데이터를 지우고, 저장을 선택합니다.
    5. 파일에 앞에서 선택한 열이 포함되어 있는 것을 볼 수 있습니다. 이 파일은 데이터를 가져오기 위한 Excel 템플릿으로 사용할 수 있습니다.

    스테이징 테이블 생성

    대상 테이블로 이동하기 전에 임포트 데이터를 저장할 수 있는 스테이징 테이블을 만듭니다.

    1. 다음으로 이동 모두 > 시스템 정의 > 테이블레이블이 표시됩니다.
    2. 새로 만들기를 선택하고 다음 세부 정보를 입력합니다.
      • 레이블: 위치 테이블의 이름을 입력합니다(예: 위치에 대한 데이터 임포트).
      • 이름: 테이블의 내부 이름을 입력합니다. 예: sn_acct_lc_account_onb_import_locations.
      • 테이블 확장: 기술 임포트 행을 선택합니다.
    3. 모듈 만들기 확인란의 선택을 취소하고 컨트롤 탭을 선택합니다.
    4. 사용자 역할 필드에 sn_acct_lc.agent 를 입력하고 저장을 선택합니다.
    5. 열 탭을 선택하고 새로 만들기를 선택합니다. 다음 세부 정보를 입력합니다.
      • 유형: 문자열. 모든 열은 문자열 형식이어야 합니다.
      • 열 레이블: 템플릿 파일의 필드 이름(열 이름)을 입력합니다.
      • 열 이름: u_ 접두사가 있는 열 레이블을 입력합니다. 예를 들어 열 레이블을 Street로 입력한 경우 여기에 u_street 입력합니다.
      • 최대 길이: 필요에 따라 열의 최대 길이를 지정합니다.
      앞의 단계에 따라 템플릿 파일의 모든 열을 추가합니다.
    6. 관련 링크(Related Links)에서 레이아웃 목록(Layout List)을 선택합니다. 목록 뷰 드롭다운에서 새로 만들기 를 선택하고 이 테이블에 대해 두 개의 목록 뷰를 생성합니다.
      • ready_to_publish: 이 보기에 모든 논리 필드를 추가합니다. 이 보기는 데이터 임포트 작업 기록에서 게시 준비 완료 버킷을 선택할 때 나타납니다.
      • needs_attention: 모든 논리 필드와 의견 필드를 이 뷰에 추가합니다. 이 뷰는 데이터 임포트 작업 기록에서 주의 필요 버킷을 선택하면 나타납니다.
    7. 관련 링크에서 레이아웃 양식을 선택합니다.
    8. 뷰 이름 드롭다운에서 새로 만들기 를 선택하고 import_view 만듭니다. 모든 논리 필드와 의견 필드를 이 뷰에 추가합니다. 이 뷰는 데이터 임포트 탭에서 준비 중인 테이블 기록을 열려고 할 때 표시됩니다

    데이터 소스 작성

    데이터 소스를 만들고 템플릿 파일을 기록에 첨부합니다.
    1. 다음으로 이동 모두 > 관리자 > 데이터 소스레이블이 표시됩니다.
    2. 새로 만들기를 선택하고 다음 세부 정보를 입력합니다.
      • 이름: 데이터 원본의 이름을 입력합니다.
      • 임포트 세트 테이블 이름: 내부 테이블 이름을 입력합니다. 예: sn_acct_lc_account_onb_import_locations.
    3. 템플릿 파일을 생성한 데이터 소스 기록에 첨부합니다.

    변환 맵 구성

    변환은 원시 필드 입력 값을 조직에 보다 의미 있는 표준화된 값으로 변환합니다. 관리자는 특정 필드에 대한 규칙과 조건을 정의하여 변환이 발생하는 시기를 제어합니다.

    데이터 임포트 구성의 일부로, 기본 시스템과 함께 제공되는 다음과 같은 필수 변환 스크립트를 구성해야 합니다. 변환 스크립트를 구성하려면 다음 단계를 따르십시오.

    1. 다음으로 이동 모두 > 변환 맵레이블이 표시됩니다.
    2. 계정 수명주기 이벤트 애플리케이션을 검색합니다.
    3. 계정 온보딩 고객 위치 변환 맵을 선택합니다.
      변환 스크립트 탭을 선택합니다. 다음 스크립트를 볼 수 있습니다.
      • onComplete
      • onAfter
      • onBefore
    4. 스크립트 중 하나를 선택하고 필요에 따라 수정한 다음 업데이트를 선택하여 변경 내용을 저장합니다.
    onComplete 스크립트
    (function runTransformScript(source, map, log, target /*undefined onStart*/ ) {
    	//Check if there is any Needs Attention Record is present or not.
    	//If Yes, then script will create a new import set record and attach all the Needs Attention records to the new Import Set.
    	//Also, it will update the new import set reference on the import Task Table.
    	var util = new sn_acct_lc.AlonStagingRecordState();
    	util.onCompleteTransformMap(source, import_set);
    })(source, map, log, target);
    onAfter 스크립트
    (function runTransformScript(source, map, log, target /*undefined onStart*/ ) {
    
    	// Add your code here
    	
    	var alonStagingUtil = new sn_acct_lc.AlonStagingRecordState();
    	alonStagingUtil.afterTransform(source);
    	if(source.sys_import_state == TechOnbEditableContants.SN_IMPORT_TRANFORM_IGNORED) {
    		return;
    	}
    	
    
    })(source, map, log, target);
    onBefore
    (function runTransformScript(source, map, log, target /*undefined onStart*/ ) {
    
    	// Add your code here
    	var alonStagingUtil = new sn_acct_lc.AlonStagingRecordState();
    	var status = alonStagingUtil.beforeTransform(source.import_state);
    	if(status == TechOnbEditableContants.SN_IMPORT_TRANFORM_IGNORE) {
    		ignore = true;
    	}
    
    })(source, map, log, target);

    데이터 임포트 작업 추가

    Process Automation Designer에 정의된 계정 수명주기 온보딩 프로세스에 구성한 데이터 임포트 작업을 추가합니다.

    1. 다음으로 이동 모두 > 프로세스 자동화 디자이너레이블이 표시됩니다.
    2. 계정 수명 주기 온보딩 프로세스를 선택합니다.
    3. Data Capture & Validation 레인으로 이동하여 활동 추가를 선택합니다.
    4. 계정 수명주기 이벤트를 선택하고 기술 작업 기록 생성 및 보기를 선택합니다.
    5. 새로 추가된 작업에서 편집 아이콘을 선택하여 속성을 봅니다.
    6. View all properties(모든 속성 보기)를 선택하고 Advanced(고급)를 선택합니다.
    7. 일반 탭에서 레이블 이름과 설명을 입력합니다.
    8. 시작 시기 필드에서 이전 사용을 선택합니다. 이 옵션을 사용하면 작업의 모든 활동을 병렬로 실행할 수 있습니다.
    9. 자동화 탭을 선택하고 입력 섹션에서 다음을 입력합니다.
      • 테이블: 기록이 생성되는 테이블입니다. Account Lifecycle Import Task (sn_ti_core_imp_task)(계정 수명 주기 임포트 작업())를 선택합니다.
      • 취소된 조건: 작업이 취소됨 상태로 전환되기 전에 충족해야 하는 조건을 지정합니다.
      • 종결 조건: 작업이 종결 상태로 전환되기 전에 충족해야 하는 조건을 지정합니다.
      • 온보딩 케이스: 계정 온보딩 케이스 기록 트리거를 선택하여 이 기록을 계정 온보딩 케이스와 연결합니다.
      • 기록 뷰: Playbook에 표시될 계정 수명주기 이벤트 양식 뷰의 이름입니다. 여기에 tech_pad_imp_task_view 입력합니다.
      • 책임 이름: 목록에서 ServiceNow 개발자/관리자 사용자 역할을 선택합니다. 이 역할은 내부 팀 구성원에게 할당됩니다(Playbook 시작 스테이지의 내부 팀 책임 할당 작업에 정의됨). 자세한 내용은 을 참조하십시오 계정 수명주기 이벤트 Playbook 사용 ). 이 역할을 가진 사용자는 데이터 임포트 작업을 수행할 수 있습니다.
    10. 필드 추가를 선택하고 임포트 작업 테이블의 다음 필드에 계정 수명주기 이벤트 데이터를 입력합니다.
      • 소스 테이블: 준비 중인 테이블의 내부 이름을 추가합니다. 예: sn_acct_lc_account_onb_import_locations.
      • 대상 테이블: 대상 테이블의 내부 이름을 추가합니다. 예: cmn_location.
      • 데이터 소스: 데이터 소스를 선택합니다. 예: cmn_location_template.xlsx.
      • 데이터 임포트 상태: 기본값은 1(데이터가 아직 로드되지 않음)로 설정됩니다.
      • 상태: 기본 상태는 1(개방)로 설정됩니다.
      • 유형: 데이터 캡처를 선택합니다.
      • 계정: 케이스 작업과 연결된 계정 온보딩 케이스를 선택합니다.
      • 상위: 계정 온보딩 케이스와 연결된 상위 기록을 선택합니다.
      • 표시: 이 False를 설정합니다.
    11. 필요에 따라 제목과 설명을 입력하고 완료를 선택한 다음 활성화를 선택합니다.

    데이터 임포트 작업을 구성한 후에는 Playbook을 계정 수명주기 이벤트 사용하여 고객을 온보딩할 수 있습니다. 자세한 내용은 계정 수명주기 이벤트 Playbook 사용 문서를 참조하십시오.