6.2. HTTP 요청이 트리거할 수 있는 통합 생성
HTTP GET
또는 POST
요청과의 통합 실행을 트리거하려면 Webhook 연결을 통합 시작 연결로 추가합니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 Webhook 연결을 클릭합니다.
작업 선택 페이지에서 다음 Webhook 작업을 선택합니다.
Webhook 구성 페이지에서 Fuse Online은 이 통합을 위해 Fuse Online에서 생성하는 Webhook 토큰을 표시합니다.
HTTP 요청을 생성할 때 이 토큰은 URL의 마지막 부분입니다. 이 통합을 게시하고 실행 중인 후 Fuse Online에 이 토큰이 있는 Fuse Online 외부 URL이 표시됩니다.
Webhook 구성 페이지에는 기본 응답 및 오류 처리 섹션도 포함됩니다. Webhook 단계는 이를 호출한 HTTP 클라이언트에 응답을 보냅니다. 응답에는 반환 코드 중 하나를 포함하며 기본적으로 반환된 메시지의 본문에 있는 오류 메시지입니다.
- 기본 응답 에서는 반환 코드 필드에서 Fuse Online에서 표시하는 기본 응답을 수락하거나 드롭다운 목록을 사용하여 원하는 기본 응답을 선택합니다. 흐름은 작업 흐름 실행 시 구성된 오류 응답 중 하나를 반환하지 않으면 이 응답을 보냅니다. 일반적으로 기본 응답 반환 코드는 성공적인 작업을 나타냅니다.
오류 처리 에서 반환된 메시지의 본문에 오류 메시지를 포함할지 여부를 나타냅니다.
개발 중에 일반적으로 오류 메시지를 반환하려고 합니다. 그러나 프로덕션에서는 민감한 정보 또는 독점 정보가 포함된 경우 오류 메시지를 숨기고자 할 수 있습니다. 오류 메시지는
responseCode
,category
,message
,error
요소가 포함된 JSON 형식의 문자열입니다. 예를 들면 다음과 같습니다.{ responseCode: 404, category: "ENTITY_NOT_FOUND_ERROR", message: "SQL SELECT did not SELECT any records" error: SYNDESIS_CONNECTION_ERROR }
개발 중에 오류가 발생했음을 확인하는 가장 신뢰할 수 있는 방법은 호출자에 대한 응답에서
HTTP_RESPONSE STATUS
헤더를 확인하는 것입니다.INFO
메시지에 대한 통합 Pod의 로그를 확인할 수도 있습니다. 통합의 활동 로그에 성공적인 교환 및 오류가 항상 활동 로그에 표시되지는 않습니다.- Webhook 단계가 반환될 수 있는 각 오류에 대해 기본 반환 코드를 수락하거나 드롭다운 목록을 사용하여 다른 HTTP 상태 반환 코드를 선택합니다.
- 다음을 클릭합니다.
출력 데이터 유형 지정 페이지에서 다음을 수행합니다.
- 유형 선택 필드를 클릭하고 JSON 스키마 를 선택합니다.
- 정의 필드에 HTTP 요청에 있는 매개변수의 데이터 유형을 정의하는 JSON 스키마를 붙여넣습니다. 요청 매개변수를 지정하려면 JSON 스키마 정보를 참조하십시오.
- 데이터 유형 이름 필드에서 이 데이터 유형의 이름을 지정합니다. 이 값은 선택 사항이지만 이름을 지정하면 데이터 매퍼 소스 목록에 표시되어 필드를 보다 쉽게 매핑할 수 있습니다.
- 선택적으로 데이터 유형 설명 필드에 이 데이터 유형을 구분하는 데 도움이 되는 몇 가지 정보를 제공합니다.
- 다음을 클릭합니다.
- 통합에 완료 연결을 추가합니다.
- 필요한 다른 연결을 추가합니다.
- 필요한 다른 단계를 추가합니다.
- 시작 연결 직후 데이터 매퍼 단계를 추가합니다.
- 게시 를 클릭하고 통합 이름을 지정하고 선택적으로 설명을 지정한 다음 저장 및 게시 를 클릭합니다.