구성 템플릿 생성
스포크를 설정하는 데 필요한 입력을 정의하는 템플릿을 생성합니다. 정적 키-값 쌍을 설정하여 기록을 생성하고 모든 통합에 적용되는 값을 설정합니다. 동적 키-값 쌍을 설정하여 사용자 입력을 수집하고 다를 수 있는 필드 값을 설정합니다. 이 템플릿을 사용하여 관리자와 플로우 디자이너는 단일 양식에서 스포크를 설정할 수 있습니다.
시작하기 전에
프로시저
- 다음으로 이동 모두 > 통합 허브 > 연결 및 자격 증명 > 구성 템플릿.
- 새로 만들기를 선택합니다.
-
만들려는 구성 템플릿의 유형을 선택합니다.
구성 유형 설명 OAuth 인증 코드 권한 유형을 사용하는 HTTP 연결 인증 코드를 사용하여 타사 시스템을 OAuth 제공자로 등록하기 위한 템플릿을 생성합니다. OAuth JWT 전달자 권한 유형을 사용하는 HTTP 연결 JSON 웹 토큰을 사용하여 외부 공급업체 시스템을 OAuth 제공자로 등록하는 템플릿을 작성합니다. 클라이언트 자격 증명을 사용하는 HTTP OAuth 권한 유형 클라이언트 자격 증명 부여 유형을 사용하는 OAuth 2.0 인증을 통해 외부 공급업체 애플리케이션과 통합하는 템플릿을 생성합니다.
OAuth 클라이언트 자격 증명을 사용하는 HTTP 연결 부여 유형(외부 스토리지) 외부 저장소에 저장된 클라이언트 자격 증명으로 구성된 OAuth 토큰 요청을 MID 서버를 통해 OAuth 서버로 보낼 수 있는 템플릿을 작성합니다.
기본 인증 자격 증명을 사용하는 HTTP 연결 기본 인증을 사용하여 외부 공급업체 시스템과 통합하는 템플릿을 만듭니다. API 키 자격 증명을 사용하는 HTTP 연결 API 키를 사용하여 외부 공급업체 시스템과 통합하는 템플릿을 만듭니다. 기타 구성 사용자 지정 인증을 위한 템플릿을 설정할 수 있는 빈 템플릿을 작성합니다. - 이름 필드에 템플릿을 식별하는 이름을 추가합니다.
-
기본 데이터 템플릿 필드에서 필요한 사항을 변경합니다.
이 필드는 모든 통합에 적용되는 정적 정보를 설정합니다. 예를 들어 값이 모든 통합에 적용되는 경우 API 및 토큰 URL을 설정할 수 있습니다.
기본 데이터 템플릿의 다음 객체는 필수입니다.
자격 증명: 필수 필드가 있는 자격 증명 기록을 생성합니다.연결: 필수 필드가 있는 연결 기록을 생성합니다.extended_attributes자식 개체를 사용하여 연결 속성에 액세스합니다. 예:"connection": { "extended_attributes": { "api_version": "v1" }, "connection_url": "https://<provider-domain-name>.com", "name": "Spoke Connection", "table": "http_connection" }
추가객체를 사용하여 사용자 지정 테이블에 대한 데이터를 설정하고 후처리 스크립트를 사용하여 테이블에 데이터를 삽입할 수 있습니다.주:OAuth 인증 코드 권한 유형에 대한 기본 데이터 템플릿에서oauth_entity_profile_scope및oauth_entity_scope키의 값이 일치해야 합니다. 다음 예에서 두 키 모두읽기 사용자의 이메일값을 갖습니다."oauth_entity_profile": [ { "grant_type": "authorization_code", "name": "<provider-name> Profile", "default": true, "oauth_entity_profile_scope": [ "Read user's email" ] } ], "code_challenge_method": "S256", "type": "consumer", "oauth_entity_scope": [ { "oauth_entity_scope": "Read user's email", "name": "email" } ], -
Dynamic Data Schema 필드에서 필요한 사항을 변경합니다.
이 필드 통합을 설정하기 위해 사용자가 완료해야 하는 정보를 정의합니다. 예를 들어 사용자 이름 및 암호 키-값 쌍을 추가하여 사용자 정의 값을 수집할 수 있습니다.
동적 데이터 스키마의 필드에는 다음 속성이 포함됩니다.
name: 사용자의 입력이 매핑되는 필드입니다. 예를 들어 사용자 입력을 연결 기록의 연결 URL 필드에 매핑하려면connection.connection_url를입력합니다.label: 템플릿을 작성할 때 사용자에게 표시되는 필드 레이블입니다.type: 필드 유형입니다. 이 데이터 유형이 값을 매핑하는 필드의 데이터 유형과 일치하는지 확인하십시오.defaultValue: 선택 사항입니다. 필드의 기본값입니다. 기본값이 제공되지 않으면 힌트가 표시됩니다.hint: 선택 사항입니다. 기본값이 없을 때 표시할 힌트 텍스트입니다.
주:OAuth JWT 전달자 권한 유형 인증을 위한 템플릿을 설정하는 경우jwt_claim_validation배열의 단일 키-값 쌍에 대한 사용자 입력을 원할 수 있습니다. 배열의 인덱스를 참조하여 동적 데이터 스키마의 단일 키-값 쌍을 참조할 수 있습니다. 예를 들어 기본 데이터 템플릿에 이 스니펫이 포함될 수 있습니다."jwt_claim_validation" : [ { "name" : "iss", "is_standard" : true, "data_type" : "string", "value":"<docusign-iss-claim>" }, { "name" : "sub", "is_standard" : true, "data_type" : "string", "value":"<docusign-sub-claim>" }, { "name" : "aud", "is_standard" : true, "data_type" : "string", "value":"<docusign-aud-claim>" }, { "name" : "scope", "is_standard" : false, "data_type" : "string", "value" : "signature impersonation" } ],항목의 0부터 시작하는 인덱스(
credential.jwt_provider.jwt_claim_validation[0].value)를 사용하여iss키-값 쌍을 참조합니다. - 옵션:
후처리 중인 스크립트 필드에서, 다음과 같은 스크립트를 추가합니다.통합에 필요한 추가 레코드를 생성합니다. 예를 들어 스포크에 사용자 지정 테이블이 포함되어 있는 경우 구성 템플릿의 사용자 입력을 기반으로 해당 테이블에 레코드를 만들 수 있습니다. 이 스크립트는 연결 및 자격 증명 레코드가 만들어진 후에 실행 됩니다.
후처리 스크립트는 이러한 전역 객체에 액세스할 수 있습니다.
전역 객체 설명 aliasId 연결 및 자격 증명 별칭 [sys_alias] 테이블의 별칭 기록 Sys_id. connectionSysId 템플릿에서 만든 연결 기록의 Sys_id입니다. jsonDefaultData 기본 데이터 템플릿 필드의 JSON 컨텐츠(문자열 형식)입니다. json동적 데이터 동적 데이터 템플릿 필드의 JSON 컨텐츠(문자열 형식) -
스크립트 사전 편집 필드에 스크립트를 추가하여 연결을 편집할 때 추가 필드를 미리 채웁니다.
이 스크립트는 객체 배열을 반환합니다. 각 객체에는 추가 필드를 채우기 위한 이름-값 쌍이 있습니다. 예를 들어, 연결에 사용자 지정 테이블에 있는 필드가 필요한 경우 이러한 필드를 사용자 지정 테이블에 매핑할 수 있습니다.
편집 전 스크립트는 다음과 같은 전역 객체에 액세스할 수 있습니다.전역 객체 설명 aliasId 연결 및 자격 증명 별칭 [sys_alias] 테이블의 별칭 기록 Sys_id. connectionSysId 템플릿에서 만든 연결 기록의 Sys_id입니다. jsonDefaultData 기본 데이터 템플릿 필드의 JSON 컨텐츠(문자열 형식)입니다. json동적 데이터 동적 데이터 템플릿 필드의 JSON 컨텐츠(문자열 형식) 스크립트의 각 객체에는 다음과 같은 속성이 있습니다.name: 연결의 값을 지정하는 사용자 지정 필드의 이름입니다.값: 사용자 지정 필드를 채우기 위해 매핑하려는 값입니다. 함수, 변수를 사용하거나 하드 코딩하여 필드를 매핑할 수 있습니다.
필드에 지원되는 데이터 형식은 다음과 같습니다.
표 1. 필드에 지원되는 데이터 유형 유형 설명 텍스트 문자열 값입니다. 부울 선택 상자. 선택은 true 값을 나타내고 비선택은 false 값을 나타냅니다. 번호 숫자 값입니다. 날짜 yyyy-mm-dd 형식의 날짜 값입니다. GlideDate 객체를 사용할 수도 있습니다. 선택 동적 데이터 스키마필드에 정의된 유효한 선택 목록입니다. 참조 유효한 GlideRecord입니다. 라디오 그룹 다른 필드 집합을 포함하는 그룹입니다. 이러한 그룹은 연결을 편집할 때 드롭다운 목록에서 선택 항목으로 사용할 수 있습니다. 드롭다운 목록에서 필요한 그룹을 선택하면 각 그룹의 필드가 나타납니다. 예를 들어, 동적 데이터 스키마 필드에 정의된 라디오 그룹의 다음 구조를 고려하십시오.{ "name": "radio_groups", "label": "Radio Groups", "type": "radio", "groups": [{ "name": "radio_group1", "label": "Radio Group 1", "fields": [{ "name": "radio_field1", "label": "Radio Field 1", "type": "text", "defaultValue": "efgh", "mandatory": true }] }, { "name": "radio_group2", "label": "Radio Group 2", "fields": [{ "name": "radio_field2", "label": "Radio Field 2", "type": "text", "defaultValue": "abcd", "mandatory": true }], "default_group": true }이 예제에서는 다음 코드 조각을 사용하여 닷워킹을 통해 스크립트에서 라디오 그룹이 사용되는 방식을 이해할 수 있습니다.
{ name: "radio_field.first_radio_group.radio_field1", value: "radio field 1" }, { name: "radio_field.second_radio_group.radio_field2", value: "radio field 2" }, { name: “radio_groups”, value: gr.getValue(‘radio_groups’) }닷워킹을 사용하는 방법에 대한 자세한 내용은 닷워킹을 참조하세요.
팁:연결을 편집하는 동안 미리 채워진 값이 필드에 표시되지 않으면 다음으로 이동하십시오. 시스템 진단 > 세션 디버그 > 디버그 로그 문제를 진단합니다. - 옵션:
테스트 작업 필드에 테스트 작업의 이름을 입력합니다. 테스트 작업을 생성하면 의 플로우 뷰 워크플로우 스튜디오에서 통합 작업으로부터 직접 연결을 테스트할 수 있습니다. 테스트 작업은 작업 정의를 사용하여 템플릿이 현재 연결되어 있는 별칭을 테스트합니다. 자세한 내용은 Create a test action to test a connection alias from a configuration template 문서를 참조하십시오.
-
연결 및 자격 증명 별칭에 템플릿을 추가합니다.
- 다음으로 이동 통합 허브 > 연결 및 자격 증명 > 연결 및 자격 증명 별칭.
- 스포크의 별칭 기록을 엽니다.
- 구성 템플릿 필드에서 조회 아이콘을 클릭합니다.
- 목록에서 생성한 템플릿을 선택합니다.
- 업데이트를 클릭합니다.