4.11. 템플릿 단계 추가
흐름에서 템플릿 단계는 소스의 데이터를 가져와 Fuse Online에 업로드하는 템플릿에 정의된 형식으로 삽입합니다. 템플릿 단계의 이점은 사용자가 지정하는 일관된 형식으로 데이터 출력을 제공하는 것입니다.
템플릿에서 자리 표시자를 정의하고 정적 텍스트를 지정합니다. 흐름을 생성할 때 템플릿 단계를 추가하고 소스 필드를 템플릿 자리 표시자에 매핑한 다음 템플릿 콘텐츠를 흐름의 다음 단계에 매핑합니다. Fuse Online에서 흐름을 실행할 때 매핑된 소스 필드에 있는 값을 템플릿 인스턴스에 삽입하고 그 결과를 흐름의 다음 단계에서 사용할 수 있도록 합니다.
흐름에 템플릿 단계가 포함된 경우 해당 흐름의 유일한 템플릿 단계가 포함됩니다. 그러나 흐름에서 두 개 이상의 템플릿 단계가 허용됩니다.
Fuse Online에서는 다음과 같은 유형의 템플릿을 지원합니다. Freemarker,Mustache,Velocity.
사전 요구 사항
- 흐름을 만들거나 편집해야 합니다.
- 간단한 통합을 생성하는 경우 이미 시작 및 연결을 완료해야 합니다.
절차
- 흐름 시각화에서 템플릿 단계를 추가할 를 클릭합니다.
- 템플릿을 클릭합니다. 템플릿 업로드 페이지가 열립니다.
- Freemarker, Mustache 또는 Velocity 템플릿 유형을 지정합니다.
템플릿을 정의하려면 다음 중 하나를 수행합니다.
- 템플릿 파일 또는 템플릿을 생성하기 위해 수정할 텍스트가 포함된 파일을 템플릿 편집기로 드래그 앤 드롭합니다.
- 찾아보기를 클릭하여 업로드 한 후 파일로 이동한 후 업로드합니다.
- 템플릿 편집기에서 입력을 시작하여 템플릿을 정의합니다.
- 템플릿 편집기에서 템플릿이 Fuse Online에서 사용하는 데 유효한지 확인합니다. 유효한 템플릿의 예는 이 절차 뒤에 있습니다. Fuse Online은 구문 오류가 포함된 행 왼쪽에 를 표시합니다. 구문 오류 표시 위에 마우스를 가져가면 오류 해결 방법에 대한 힌트가 표시됩니다.
Done 을 클릭하여 템플릿 단계를 흐름에 추가합니다.
Done 버튼이 활성화되어 있지 않으면 수정해야 하는 구문 오류가 하나 이상 있습니다.
템플릿 단계에 대한 입력은 JSON 오브젝트의 형식이어야 합니다. 따라서 템플릿 단계 앞에 데이터 매핑 단계를 추가해야 합니다.
템플릿 단계 앞에 데이터 매퍼 단계를 추가하려면 다음을 수행합니다.
- 흐름 시각화에서 방금 추가한 템플릿 단계 바로 앞에 있는 를 클릭합니다.
- 데이터 매퍼 를 클릭합니다.
데이터 매퍼에서 소스 필드를 각 템플릿 자리 표시자 필드에 매핑합니다.
예를 들어 이 절차 이후의 예제 템플릿을 사용하여 소스 필드를 각 템플릿 필드에 매핑합니다.
-
time
-
name
-
text
-
- 오른쪽 상단에서 Done 을 클릭하여 데이터 매퍼 단계를 흐름에 추가합니다.
템플릿 단계의 출력은 항상 JSON 오브젝트입니다. 따라서 템플릿 단계 후에 데이터 매퍼 단계를 추가해야 합니다.
템플릿 단계 뒤에 데이터 매퍼 단계를 추가하려면 다음을 수행합니다.
- 흐름 시각화에서 방금 추가한 템플릿 단계 직후에 있는 를 클릭합니다.
- 데이터 매퍼 를 클릭합니다.
- 데이터 매퍼에서 소스 필드를 템플릿에 삽입한 결과가 항상 포함된 템플릿의 메시지 필드를 대상 필드에 매핑합니다. 예를 들어, localhost 연결이 흐름 옆에 있고 템플릿 단계의 결과를Registry 메시지의 콘텐츠로 전송하려는 경우를 가정해 보겠습니다. 이렇게 하려면 메시지 소스 필드를 텍스트 대상 필드에 매핑합니다.
- 오른쪽 상단에서 Done 을 클릭합니다.
템플릿의 예
Mustache 템플릿의 예:
At {{time}}, {{name}} tweeted: {{text}}
Freemarker 및 Velocity는 이 예제 템플릿을 지원합니다.
At ${time}, ${name} tweeted: ${text}
속도에서는 다음 예와 같이 중괄호가 없는 구문도 지원합니다.
At $time, $name tweeted: $text
자리 표시자는 .
(period)를 포함할 수 없습니다.
추가 리소스
매핑 필드에 대한 자세한 내용은 다음 연결의 필드에 통합 데이터 매핑을 참조하십시오.