Fuse Online을 애플리케이션 및 서비스에 연결
애플리케이션 및 서비스에 대한 연결 생성
초록
머리말
애플리케이션을 통합하려면 통합할 각 애플리케이션 또는 서비스에 대한 연결을 생성합니다. 그런 다음 통합을 생성하고 통합할 각 통합 또는 서비스에 대한 연결을 추가합니다.
Fuse Online 은 연결 생성을 위한 템플릿 역할을 하는 다양한 커넥터를 지원합니다. 다음 주제에서는 연결을 생성하고 통합에 추가하는 데 필요한 세부 정보를 제공합니다.
- 2장. Amazon Web Services에 연결
- 3장. AMQ에 연결
- 4장. AMQP에 연결
- 5장. API 클라이언트에 연결
- 6장. 박스에 연결
- 7장. Dropbox에 연결
- 8장. 이메일 서버 연결(IMAP, POP3, SMTP)
- 9장. FHIR에 연결
- 10장. FTP 또는 SFTP 서버에 연결
- 11장. Google 애플리케이션에 연결
- 12장. HTTP 및 HTTPS 끝점에 연결
- 13장. IRC에 연결
- 14장. JIRA에 연결
- 15장. Kafka에 연결
- 16장. Apache Kudu에 연결
- 17장. MongoDB에 연결
- 18장. MQTT에 연결
- 19장. OData에 연결
- 20장. Cryostat에 연결
- 21장. SAP Concur에 연결
- 22장. ServiceNow에 연결
- 23장. Slack에 연결
- 24장. SQL 데이터베이스에 연결
- 25장. Telegram에 연결
- 26장. Twitter에 연결
보다 포괄적 수용을 위한 오픈 소스 용어 교체
Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 용어를 교체하기 위해 최선을 다하고 있습니다. 먼저 마스터(master), 슬레이브(slave), 블랙리스트(blacklist), 화이트리스트(whitelist) 등 네 가지 용어를 교체하고 있습니다. 이러한 변경 작업은 작업 범위가 크므로 향후 여러 릴리스에 걸쳐 점차 구현할 예정입니다. 자세한 내용은 CTO Chris Wright의 메시지에서 참조하십시오.
1장. Fuse Online에서 지원하는 커넥터
Fuse Online에서는 다음 커넥터를 지원합니다.
| 이름 | 설명 |
|---|---|
| Amazon Cryostat 테이블에서 데이터를 수집, 추가, 업데이트 또는 삭제합니다. | |
| Amazon Cryostat 항목에 메시지를 보냅니다. | |
| Amazon SQS 대기열에서 메시지를 검색하거나 메시지를 보냅니다. | |
| Amazon S3 버킷에서 데이터를 검색하거나 데이터를 버킷에 복사합니다. | |
| Red Hat AMQ(Apache ActiveMQ) 브로커에서 메시지를 얻거나 Red Hat AMQ(Apache ActiveMQ) 브로커에 메시지를 게시합니다. | |
| 고급 메시지 큐 프로토콜 브로커에서 메시지를 얻거나 AMQP 브로커에 메시지를 게시합니다. | |
| 박스에서 파일을 다운로드하거나 박스에 파일을 업로드합니다. | |
| Dropbox에서 파일을 다운로드하거나 Dropbox에 파일을 업로드합니다. | |
| Cryostat 또는 POP3 이메일 서버에서 이메일을 검색하거나 SMTP 이메일 서버에 연결하여 이메일을 보냅니다. | |
| FHIR 서버에서 리소스를 얻거나 FHIR 서버의 리소스를 업데이트합니다. | |
| FTP 또는 SFTP 서버에서 파일을 다운로드하거나 FTP 또는 SFTP 서버에 파일을 업로드합니다. | |
| 특정lusterAutoscaler 계정으로 전송된 메시지를 받고 특정Registry 계정에서 메시지를 보냅니다. | |
| 사용자가 지정하는 Google Cryostat에서 이벤트를 얻거나 지정하는 Google calendar에서 이벤트를 추가/업데이트합니다. | |
| 사용자가 지정, 추가/업데이트 details 데이터를 추가/업데이트, 차트를 만들거나, 지정한 reportray에서 피벗 테이블을 만들 수 있는 데이터 가져오기입니다. | |
|
HTTP 또는 HTTPS 엔드포인트에 연결하고 | |
| IRC 닉네임 또는 채널로 전송되는 메시지를 수신하거나 특정 채널의 IRC 닉네임으로 메시지를 보냅니다. | |
| Jira 서버에서 문제를 수집, 생성 또는 업데이트합니다. | |
| Apache Kudu 데이터 저장소의 테이블에서 레코드를 얻거나 Kudu 데이터 저장소의 테이블에 레코드를 추가합니다. | |
| MongoDB 데이터베이스에서 데이터를 얻거나 MongoDB 데이터베이스의 데이터를 업데이트합니다. | |
| MQ Telemetry Transport 브로커에서 메시지를 얻거나 MQTT 브로커에 메시지를 게시합니다. | |
| OData 서비스에서 관리하는 엔터티를 OData 서비스 또는 업데이트, 생성 또는 삭제에서 가져옵니다.Gets entities from an OData service or update, create, or delete entities that are managed by an OData service. | |
| OpenAPI 문서를 업로드하여 사용자 정의 REST API 클라이언트 커넥터를 생성합니다. 그런 다음 해당 REST API에 대한 연결을 생성할 수 있습니다. 통합 실행을 트리거하는 작업을 정의하는 OpenAPI 문서를 업로드하여 REST API 공급자 통합을 생성합니다. Fuse Online 을 사용하여 애플리케이션 통합에서 REST API 호출에 의해 트리거되는 통합 생성 을 참조하십시오. | |
| Cryostat 레코드를 생성, 업데이트, 가져오기 또는 삭제합니다. | |
| 다양한 SAP Concur 작업 중 하나를 수행합니다. | |
| ServiceNow 인스턴스에서 레코드를 가져오거나 레코드를 복사합니다. | |
| 채널에서 메시지를 얻거나 Slack 채널 또는 사용자에게 메시지를 보냅니다. | |
| WSDL 파일을 업로드하여 사용자 지정 Cryostat API 클라이언트 커넥터를 만듭니다. 그런 다음 해당 Cryostat API 클라이언트에 대한 연결을 만들 수 있습니다. | |
| Apache Derby, MySQL 또는 PostgreSQL 데이터베이스에서 SQL 문 또는 SQL 저장 프로시저를 호출합니다. 다른 유형의 SQL 데이터베이스에 연결하려면 해당 데이터베이스에 대한 JDBC 드라이버가 포함된 Fuse Online 라이브러리 확장을 업로드합니다. | |
| Telegram 채팅 봇을 사용하여 채팅에서 메시지를 얻거나 채팅에 메시지를 보냅니다. | |
| 사용자 또는 사용자가 지정하는 데이터가 포함되어 있음을 언급하는 report에서 간단한 통합 실행을 트리거합니다. | |
|
HTTP |
Fuse Online에서 필요한 커넥터를 제공하지 않으면 숙련된 개발자가 사용자 지정 커넥터를 정의하는 확장을 만들 수 있습니다. 확장자 코딩 및 Fuse Online에 업로드하는 .jar 파일을 만드는 방법에 대한 자세한 내용은 다음을 참조하십시오.
2장. Amazon Web Services에 연결
Fuse Online 통합은 다음 Amazon 웹 서비스에 연결할 수 있습니다.
- DynamoDB
- SNS(Simple Notification Service)
- SQS(Simple Queue Service)
- S3(Simple Storage Service)
Amazon 웹 서비스에 대한 연결을 생성하려면 먼저 AWS 인증 정보를 가져와야 합니다. 자세한 내용은 다음을 참조하십시오.
2.1. Amazon 서비스에 대한 연결을 생성하기 위한 AWS 인증 정보 가져오기
Amazon 서비스에 대한 연결을 생성하려면 AWS 계정과 연결된 액세스 키가 있어야 합니다. Fuse Online 연결에 액세스할 리소스를 생성하거나 생성할 AWS 계정입니다. 리소스는 S3 버킷, Cryostat 주제 또는 SQS 대기열일 수 있습니다.
AWS 액세스 키에는 다음 두 부분이 있습니다.
- Amazon 액세스 키 ID
- Amazon 시크릿 액세스 키
AWS는 액세스 키를 사용하여 Fuse Online 연결의 요청을 인증합니다. 액세스 키 생성 및 관리에 대한 많은 AWS 문서가 있습니다. 이미 AWS Identity and Access Management(IAM) 사용자를 생성하고 해당 사용자와 연결된 액세스 키를 캡처한 경우 해당 값을 지정하여 S3, Cryostat 또는 SQS에 대한 Fuse 온라인 연결을 생성할 수 있습니다.
액세스 키를 가져와야 하는 경우 아래 절차는 이를 수행하는 한 가지 방법입니다.
사전 요구 사항
- 연결할 리소스를 생성한 AWS 계정의 로그인 인증 정보입니다.
- 또는 새 리소스를 생성하는 데 사용할 AWS 계정의 로그인 인증 정보입니다.
절차
- https://aws.amazon.com/ 으로 이동하여 콘솔에 로그인합니다.
- 콘솔의 오른쪽 상단에서 사용자 이름 옆에 있는 아래쪽 화살표를 클릭하고 My Security Credentials 를 클릭합니다.
팝업 대화 상자에서 IAM 사용자 시작하기 를 클릭합니다.
이 버튼이 있는 팝업이 나타나지 않으면 왼쪽에서 사용자를 클릭합니다.
사용자를 추가합니다.
- 사용자 추가를클릭합니다.
- 사용자 이름을 입력하고 Programmatic Access 를 선택합니다.
- Next: Permissions 를 클릭합니다.
- 그룹에 새 사용자를 추가하라는 프롬프트에 응답합니다.
- 다음: 태그 를 클릭합니다.
- 태그 추가를 건너뛰고 Next: Review 를 클릭합니다.
- 사용자 생성을 클릭합니다.
- 다운로드 .csv 를 클릭하여 액세스 키의 로컬 사본을 가져옵니다. 다운로드한 파일에는 Amazon 서비스에 대한 연결을 생성하도록 지정해야 하는 액세스 키 ID와 시크릿 액세스 키가 포함되어 있습니다.
- 닫기를 클릭합니다.
추가 리소스
2.2. Amazon Cryostat에 연결
통합을 통해 Amazon Cryostat 테이블의 데이터를 검색하거나, data를 Cryostat 테이블에 추가하거나, Cryostat 테이블에서 데이터를 제거할 수 있습니다. 이렇게 하려면 Amazon Cryostat 연결을 생성한 다음 통합 흐름에 해당 연결을 추가합니다.
자세한 내용은 다음을 참조하십시오.
2.2.1. Amazon Cryostat 연결 생성
통합에서 Amazon Cryostat에 연결하려면 먼저 Amazon Cryostat 연결을 생성해야 합니다.
사전 요구 사항
- AWS 액세스 키가 있어야 합니다. Amazon 서비스에 대한 연결을 생성하기 위해 AWS 인증 정보 수집을 참조하십시오.
- 연결을 액세스할 수 있는 Cryostat 테이블이 포함된 AWS 리전을 알아야 합니다.
- 연결을 액세스할 수 있는 Cryostat 테이블의 이름을 알아야 합니다. 통합이 Cryostat에 연결하는 경우 이 테이블이 있어야 합니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 생성 을 클릭하여 Fuse Online 커넥터를 표시합니다.
- Amazon Cryostat 커넥터를 클릭합니다.
- 액세스 키 필드에 연결하려는 Cryostat 테이블을 관리하는 AWS 계정의 사용자 액세스 키 ID인 Amazon 액세스 키 ID를 입력합니다.
- 시크릿 키 필드에 사용자가 지정한 Amazon 액세스 키 ID의 Amazon 시크릿 액세스 키를 입력합니다.
- Region 필드에서 Cryostat 테이블이 있는 AWS 리전을 선택합니다.
- 테이블 이름 필드에 이 연결에 액세스할 Cryostat 테이블의 이름을 입력합니다.
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 필요에 따라 구성 세부 정보를 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어 Cryostat
West를입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
서부 리전의 영업 데이터에 액세스하는 Sample Cryostat 연결을 입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 Cryostat West 가 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
결과
Fuse Online에서 통합에 추가하라는 메시지가 표시되면 방금 만든 Cryostat 연결이 표시됩니다. 이 연결은 연결을 만들 때 지정한 Cryostat 테이블에 항상 액세스합니다.
2.2.2. Amazon Cryostat 테이블에서 데이터 가져오기
통합 흐름에서 Amazon Cryostat 테이블에서 항목을 가져오려면 흐름 중간에 Amazon Cryostat 연결을 추가합니다.
Cryostat 연결은 간단한 통합을 시작할 수 없습니다. Cryostat 테이블에서 정기적으로 데이터를 가져오려면 타이머와 간단한 통합을 시작한 다음 테이블을 쿼리하는 Cryostat 연결을 시작합니다.
사전 요구 사항
- Amazon Cryostat 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다.
절차
- 흐름 시각화에서 Amazon Cryostat 연결을 추가할 더하기 기호를 클릭합니다.
- 연결 선택 페이지에서 데이터를 가져올 테이블에 액세스하도록 구성된 Amazon Cryostat 연결을 클릭합니다.
- 작업 선택 페이지에서 쿼리 작업을 선택합니다.
필터 필드에서 연결이 반환되어야 하는 항목의 키 특성을 식별하는 JSON 표기법을 지정합니다.
:#을 사용하여 입력 매개변수를 지정할 수 있습니다. 예를 들어 두 가지 주요 속성이 있는 항목을 가져오려면 사양이 다음과 같을 수 있습니다.{"key1":":#PARAM1", "key2":":#PARAM2"}선택 사항: 쿼리할 속성 필드에 연결을 반환할 데이터가 포함된 특성 이름의 쉼표로 구분된 목록을 입력합니다. 예를 들면 다음과 같습니다.
key1,key2,attribute3,attribute4,attribute5
특성을 지정하지 않으면 쿼리에서 키 특성을 반환합니다.
- 다음을 클릭합니다.
결과
이제 통합에 데이터를 가져오는 Cryostat 연결이 있습니다. 런타임 시 연결에서 쿼리 결과가 포함된 JSON 인스턴스 문서를 반환합니다.
다음 단계
필터 필드에서 자리 표시자 매개 변수를 지정한 경우 이 연결 앞에 데이터 매퍼 단계를 추가합니다. 데이터 매퍼 단계에서 소스 필드를 Cryostat 연결의 대상 자리 표시자 필드에 매핑합니다.
2.2.3. Amazon Cryostat 테이블에 데이터 추가
흐름 중간에 또는 간단한 통합을 완료하기 위해 Cryostat 연결은 items를 테이블에 추가할 수 있습니다. 이렇게 하려면 흐름 중 또는 간단한 통합의 완료 연결로 Cryostat 연결을 추가합니다.
이번 릴리스에서는 Cryostat 연결은 Cryostat 테이블의 항목을 업데이트할 수 없습니다. 이는 향후 릴리스에서 변경될 것으로 예상됩니다.
사전 요구 사항
- Amazon Cryostat 연결을 생성했습니다.
- 간단한 통합을 만들거나 편집하고 Fuse Online에서 통합에 추가하거나 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 연결 선택 페이지에서 추가할 테이블에 액세스하도록 구성된 Amazon Cryostat 연결을 클릭합니다.
- 작업 선택 페이지에서 Put Item 을 선택합니다.
요소 필드의 JSON 정의에서 추가할 테이블 항목을 정의하는 JSON 표기법을 입력합니다. 항목의 키 특성을 지정해야 합니다.
:#접두사가 붙은 입력 매개 변수 자리 표시자는 허용됩니다. 저장할 모든 특성/값을 지정해야 합니다. 다음 예에서userID는 키입니다.{"userID":"aslan","attr1":"some-value","attr2":"another-value"}- 다음을 클릭합니다.
결과
연결은 사용자가 추가한 위치의 통합 시각화에 나타납니다. 실행하는 동안 연결은 정의된 JSON 항목을 연결에서 액세스하도록 구성된 Cryostat 테이블에 추가합니다.
다음 단계
항목의 JSON 정의에 자리 표시자 매개 변수를 지정한 경우 이 연결 앞에 데이터 매퍼 단계를 추가합니다. 데이터 매퍼 단계에서 소스 필드를 Cryostat 연결의 대상 자리 표시자 필드에 매핑합니다.
2.2.4. Amazon Cryostat 테이블에서 데이터 제거
흐름 중간에 또는 간단한 통합을 완료하기 위해 Cryostat 연결은 Cryostat 테이블에서 항목을 제거할 수 있습니다. 이렇게 하려면 흐름 중 또는 간단한 통합의 완료 연결로 Cryostat 연결을 추가합니다.
사전 요구 사항
- Amazon Cryostat 연결을 생성했습니다.
- 간단한 통합을 만들거나 편집하고 Fuse Online에서 통합에 추가하거나 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 연결 선택 페이지에서 제거할 항목이 포함된 테이블에 액세스하도록 구성된 Amazon Cryostat 연결을 클릭합니다.
- 작업 선택 페이지에서 항목 제거를 선택합니다.
요소 필드의 JSON 필터 에서 제거할 항목을 식별하는 JSON 표기법을 입력합니다. 항목의 키 특성을 지정해야 합니다.
:#접두사가 지정된 입력 매개 변수는 허용됩니다. 다음 예제 입력에서userID는 키 속성입니다.{"userID":"aslan"}- 다음을 클릭합니다.
결과
연결은 추가한 흐름 시각화에 표시됩니다.
다음 단계
요소 필드의 JSON 필터에 자리 표시자 매개 변수를 지정한 경우 이 연결 앞에 데이터 매퍼 단계를 추가합니다. 데이터 매퍼 단계에서 source 필드를 Cryostat 연결의 각 대상 자리 표시자 필드에 매핑합니다.
2.3. Amazon SNS(Simple Notification Service)에 연결
통합을 통해 AWS Simple Notification Service 항목에 메시지를 보낼 수 있습니다. 이렇게 하려면 AWS Cryostat 연결을 생성한 다음 통합 흐름에 연결하거나 간단한 통합을 위한 완료 연결로 추가합니다. 자세한 내용은 다음을 참조하십시오.
2.3.1. Amazon Cryostat 연결 생성
통합에 Amazon Cryostat 연결을 추가하려면 먼저 Amazon Cryostat 연결을 생성해야 합니다.
사전 요구 사항
- AWS 액세스 키 AWS 인증 정보 수집을 참조하십시오.
- Cryostat 주제가 있는 리전을 알아야 합니다. 이 주제는 메시지를 전송하기 위해 생성 중인 Cryostat 연결을 원하는 항목입니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 생성 을 클릭하여 Fuse Online 커넥터를 표시합니다.
- Amazon Cryostat 커넥터를 클릭합니다.
Access Key 필드에 메시지를 보낼 주제를 관리하는 AWS 계정의 사용자 액세스 키 ID에 포함된 Amazon 액세스 키 ID를 입력합니다.
액세스하려는 연결이 아직 존재하지 않는 경우 Fuse Online에서 통합 실행을 시작하려고 할 때 이 액세스 키와 연결된 AWS 계정을 사용하여 주제를 생성합니다. 그러나 다른 AWS 계정에 항목이 이미 있는 경우 연결은 주제를 생성할 수 없으며 통합을 시작할 수 없습니다.
- 시크릿 키 필드에 사용자가 지정한 Amazon 액세스 키 ID의 Amazon 시크릿 액세스 키를 입력합니다.
- Region 필드에서 항목이 있는 AWS 리전을 선택합니다. 연결이 주제를 생성하면 선택한 지역에 해당 주제를 생성합니다.
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 필요에 따라 구성 세부 정보를 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어, Cryostat
North를 입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어, 미국
북부 주제로 메시지를 보내는 Sample Cryostat 연결을 입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력한 경우 Cryostat North가 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
2.3.2. Amazon Cryostat로 메시지 전송
Amazon Cryostat 항목에 메시지를 보내려면 흐름 중간 또는 간단한 통합에서 완료 연결로 Amazon Cryostat 연결을 추가합니다.
사전 요구 사항
- Amazon Cryostat 연결을 생성했습니다.
- Fuse Online에서는 통합에 추가하거나 간단한 통합에 완료 연결을 추가할 것을 요청하고 있습니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 메시지를 보내는 데 사용할 Amazon Cryostat 연결을 클릭합니다.
- Send Object (오브젝트 전송) 작업을 클릭합니다.
Topic Name 또는 Amazon Resource Name 필드에 message to send a message to or enter the Amazon Resource Name (ARN) 항목을 입력하거나 입력합니다.
connection에 액세스할 수 있는 권한이 있는 AWS 계정 또는 다른 AWS 계정에 있는 Cryostat 항목이 아직 없는 경우 연결은 AWS 계정에 액세스하도록 구성된 항목을 만듭니다.
- 다음을 클릭하여 통합에 연결을 추가합니다.
결과
연결은 이를 추가한 통합 흐름에 표시됩니다.
2.4. Amazon SQS(Simple Queue Service)에 연결
통합을 통해 Amazon SQS 대기열에서 메시지를 검색하거나 Amazon SQS 큐로 메시지를 보낼 수 있습니다. 이렇게 하려면 Amazon SQS 연결을 생성한 다음 통합 흐름에 해당 연결을 추가합니다. 자세한 내용은 다음을 참조하십시오.
2.4.1. Amazon SQS 연결 생성
통합에 Amazon SQS 연결을 추가하려면 먼저 Amazon SQS 연결을 생성해야 합니다.
사전 요구 사항
- AWS 액세스 키 AWS 인증 정보 수집을 참조하십시오.
- SQS 큐가 있는 리전을 알아야 합니다. 이는 메시지를 보내거나 메시지를 검색하도록 만드는 SQS 연결을 원하는 큐입니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 생성 을 클릭하여 Fuse Online 커넥터를 표시합니다.
- Amazon SQS 커넥터를 클릭합니다.
액세스 키 필드에 연결하려는 큐를 관리하는 AWS 계정의 사용자 액세스 키 ID에 포함된 Amazon 액세스 키 ID를 입력합니다.
액세스하려는 큐가 아직 존재하지 않는 경우 Fuse Online에서 통합 실행을 시작하려고 할 때 이 액세스 키와 연결된 AWS 계정을 사용하여 큐를 생성합니다. 그러나 다른 AWS 계정에 큐가 이미 있는 경우 연결은 큐를 생성할 수 없으며 통합을 시작할 수 없습니다.
- 시크릿 키 필드에 사용자가 지정한 Amazon 액세스 키 ID의 Amazon 시크릿 액세스 키를 입력합니다.
- Region 필드에서 큐가 상주하는 AWS 리전을 선택합니다. 연결이 큐를 생성하면 선택한 지역에 큐가 생성됩니다.
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 필요에 따라 구성 세부 정보를 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
SQS South를 입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
남부 지역 큐로 메시지를 보내는 샘플 SQS 연결을 입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 SQS South 가 통합에 추가하도록 선택할 수 있는 연결로 표시됩니다.
2.4.2. 통합 실행을 트리거하기 위해 Amazon SQS에서 메시지 가져오기
Amazon SQS 대기열에서 메시지를 가져와 통합을 시작하려면 간단한 통합의 시작 연결로 Amazon SQS 연결을 추가합니다.
사전 요구 사항
- 메시지를 가져오려는 큐에 액세스하도록 구성된 Amazon SQS 연결을 생성하셨습니다.
- 연결을 통해 메시지를 가져올 SQS 큐의 이름을 알고 있습니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 통합을 시작하는 데 사용할 Amazon SQS 연결을 클릭합니다.
- 작업 선택 페이지에서 Amazon SQS 대기열 폴링을 선택하여 SQS 대기열에서 정기적으로 메시지를 검색합니다.
이 작업을 구성합니다.
- Delay 필드에서 폴링 사이에 경과되는 시간으로 기본 500밀리초를 수락합니다. 또는 다른 폴링 간격을 지정하려면 번호를 입력하고 시간 단위를 선택합니다.
최대 개체에서 검색 필드에 하나의 폴링 작업에서 가져올 수 있는 최대 메시지 수를 입력합니다. 기본값은 10입니다.
가져올 수 있는 메시지 수를 제한하지 않으려면
0또는 음수 정수를 지정합니다. 검색할 최대 개체가 무제한이면 폴링 작업은 SQS 큐의 모든 메시지를 가져옵니다.- 큐 이름 또는 Amazon 리소스 이름 필드에서 메시지를 검색할 SQS 대기열 또는 큐의 ARN을 지정합니다. 이 이름의 큐가 없으면 연결에서 해당 이름을 생성합니다. 이 필드는 유일한 필수 필드입니다.
- 메시지를 탐색하고 큐에서 삭제할지 여부를 나타냅니다. 큐에서 메시지를 가져온 다음 삭제하는 것이 기본 동작입니다. 이 옵션을 선택 해제하여 메시지를 검색하고 큐에 남기는 경우에만 이 옵션을 선택 해제합니다. 즉, 메시지가 다시 검색됩니다.
- Camel 필터를 통해 메시지를 추출하고 메시지를 삭제할 지 여부를 나타냅니다. 이 옵션은 기본적으로 선택됩니다. 검색된 메시지를 필터를 통해 전달하여 큐에서 삭제할지 여부를 결정할 때 선택한 상태로 두십시오. 선택 취소 메시지를 취소한 다음 대기열에서 삭제할 필요가 없습니다. Fuse Online은 메시지 Obtain을 선택하고 Camel 필터를 통해 메시지를 삭제하는 경우 올바른 동작을 확인합니다.
- 다음을 클릭합니다.
결과
연결은 통합 흐름 시작 부분에 나타납니다.
다음 단계
메시지를 수신하고 Camel 필터를 통해 메시지를 삭제하면 이 SQS 연결 뒤에 필터 단계를 추가해야 합니다. 필터 단계는 SQS 연결 직후에 있을 필요가 없습니다. 통합에 대한 모든 연결을 추가한 다음 필터 단계를 추가합니다. 실행 중에 필터를 전달하는 메시지가 있는 경우 Fuse Online에서 동일한 연결인 SQS 시작 연결을 사용하여 큐에서 해당 메시지를 삭제합니다.
2.4.3. Amazon SQS 큐에 메시지 전송
흐름 중간에 또는 간단한 통합을 완료하기 위해 Amazon SQS 큐에 메시지를 보낼 수 있습니다.
사전 요구 사항
- 메시지를 보낼 큐에 액세스하도록 구성된 Amazon SQS 연결을 생성했습니다.
- 연결을 통해 메시지를 보낼 SQS 대기열의 이름을 알고 있습니다.
- Fuse Online에서는 통합에 추가하거나 간단한 통합을 위한 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 메시지를 보내는 데 사용할 Amazon SQS 연결을 클릭합니다.
연결을 수행할 작업을 선택합니다.
- Send Object 는 하나의 메시지를 큐에 보냅니다.
- Batch Object 는 큐로 메시지 배치를 보냅니다.
Message group ID 전략 필드에서 FIFO(First-in, first-out) 큐에 대해
ConstantMessageGroupIdStrategy를 수락하거나 필드를 클릭하고 다른 전략을 선택합니다.이 매개변수의 설정은 간단한 큐에 영향을 미치지 않습니다. 메시지 그룹 ID는 메시지가 속한 그룹을 식별합니다. 동일한 메시지 그룹에 속하는 메시지는 메시지 그룹을 기준으로 엄격한 순서로 항상 하나씩 처리됩니다. 메시지 그룹 ID 전략에 따라 연결이 메시지에 그룹 ID를 할당하는 방법이 결정됩니다. 옵션은 다음과 같습니다.
-
ConstantMessageGroupIdStrategyCryostat- everything 연결은 상수를 사용하여 메시지를 그룹화합니다. -
각 메시지에있는 교환 ID를 사용하여 메시지를 그룹화합니다. -
PropertyValueMessageGroupIdStrategyCryostat- everything 연결에서는 내부 속성 값을 사용하여 메시지를 그룹화합니다.
FIFO 큐는 메시지가 전송 및 수신되는 순서가 엄격하게 보존되고 각 메시지가 정확히 한 번 처리되도록 설계되었습니다. FIFO 큐 이름에는 접미사로
.fifo가 있습니다.-
메시지 중복 ID 전략 필드에서 FIFO 큐의 경우
NullMessageDeduplicationIdStrategy를 수락하거나 필드를 클릭하여ExchangeIdMessageDeduplicationIdStrategy를 선택합니다.이 매개변수의 설정은 간단한 큐에 영향을 미치지 않습니다. FIFO 대기열의 경우 연결은 선택한 전략을 사용하여 중복 메시지를 큐에 보내지 않도록 합니다.
-
NullMessageDeduplicationIdStrategy는 메시지 본문을 중복 제거 요소로 사용합니다. 즉, 연결은 메시지 본문을 비교하여 중복 메시지를 식별합니다. -
ExchangeIdMessageDeduplicationIdStrategy는 메시지의 교환 ID를 중복 제거 요소로 사용합니다. 즉, 연결은 교환 ID를 비교하여 중복 메시지를 식별합니다.
-
- 큐 이름 또는 Amazon 리소스 이름 필드에 메시지를 보낼 큐의 이름을 입력합니다. 큐가 없으면 연결에서 해당 큐를 생성합니다.
- Delay 필드에서 기본값을 수락합니다. 이 기본값은 지연 없이 0입니다. 또는 지연을 추가하려면 번호를 지정합니다. 통합은 메시지를 보내기 전에 이 시간(초)을 기다립니다. 이 기능은 메시지 소비자가 연결을 보내는 메시지에 즉시 준비되지 않을 때 유용합니다.
- 다음을 클릭합니다.
결과
연결은 이를 추가한 통합 흐름에 표시됩니다.
2.5. Amazon S3(Simple Storage Service)에 연결
통합을 통해 Amazon S3 버킷에서 데이터를 검색하거나 데이터를 Amazon S3 버킷에 복사할 수 있습니다. 이렇게 하려면 Amazon S3 연결을 생성한 다음 통합 흐름에 해당 연결을 추가합니다. 자세한 내용은 다음을 참조하십시오.
2.5.1. Amazon S3 연결 생성
통합에 Amazon S3 연결을 추가하려면 먼저 Amazon S3 연결을 생성해야 합니다.
사전 요구 사항
- AWS 액세스 키 AWS 인증 정보 수집을 참조하십시오.
연결 액세스하려는 버킷이 이미 존재하는 경우 다음을 알아야 합니다.
- 버킷이 있는 영역입니다.
- 버킷의 이름 또는 ARM(Amazon Resource Name)입니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 생성 을 클릭하여 Fuse Online 커넥터를 표시합니다.
- Amazon S3 커넥터를 클릭합니다.
액세스 키 필드에 연결하려는 버킷을 관리하는 AWS 계정의 사용자 액세스 키 ID인 Amazon 액세스 키 ID를 입력합니다.
액세스하려는 버킷이 아직 존재하지 않는 경우 Fuse Online에서 통합을 실행하려고 할 때 이 액세스 키와 연결된 AWS 계정을 사용하여 버킷을 생성합니다. 그러나 버킷이 다른 AWS 계정에 이미 있는 경우 연결은 버킷을 생성할 수 없으며 통합을 시작할 수 없습니다.
- 시크릿 키 필드에 사용자가 지정한 Amazon 액세스 키 ID의 Amazon 시크릿 액세스 키를 입력합니다.
- Region 필드에서 버킷이 있는 AWS 리전을 선택합니다. 연결이 버킷을 생성하면 선택한 리전에 생성됩니다.
버킷 이름 또는 Amazon 리소스 이름 필드에 이 연결에 액세스할 버킷의 이름을 입력하거나 버킷의 ARN을 입력합니다.
지정한 버킷이 아직 존재하지 않으면 연결은 지정한 이름으로 버킷을 생성하려고 합니다. S3에서는 버킷을 공개적으로 액세스할 수 있는 URL로 사용할 수 있으므로 지정하는 버킷 이름은 전역적으로 고유해야 합니다. 또한 S3 버킷 이름 지정 요구 사항을 충족해야 합니다.
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 필요에 따라 구성 세부 정보를 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
Obtain S3 Data를 입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
northeast 버킷에서 데이터를 가져오는 샘플 S3 연결을 입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 Obtain S3 Data 가 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
2.5.2. 통합 실행을 트리거하기 위해 Amazon S3에서 데이터 가져오기
Amazon S3 버킷에서 데이터를 가져와 통합을 시작하려면 간단한 통합의 시작 연결로 Amazon S3 연결을 추가합니다.
사전 요구 사항
Amazon S3 연결을 생성하셨습니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 통합을 시작하는 데 사용할 Amazon S3 연결을 클릭합니다.
작업 선택 페이지에서 연결을 수행할 작업을 선택합니다.
- get Object 는 연결에 액세스하는 버킷에서 파일을 가져옵니다. 파일 이름 필드에 가져올 파일의 이름을 입력합니다. 지정된 파일이 버킷에 없는 경우 런타임 오류입니다.
Amazon S3 버킷을 주기적으로 폴링하면 연결에 액세스하는 버킷에서 파일을 얻을 수 있습니다. 이 작업을 구성하려면 다음을 수행합니다.
- Delay 필드에서 폴링 사이에 경과되는 시간으로 기본 500밀리초를 수락합니다. 또는 다른 폴링 간격을 지정하려면 번호를 입력하고 시간 단위를 선택합니다.
최대 개체에서 검색 필드에 하나의 폴링 작업에서 가져올 수 있는 최대 파일 수를 입력합니다. 기본값은 10입니다.
가져올 수 있는 파일 수를 제한하지 않으려면
0또는 음수 정수를 지정합니다. Retrieve할 최대 개체 가 무제한일 때 폴링 작업은 버킷의 모든 파일을 가져옵니다.버킷에 지정된 최대 파일 수를 초과하는 경우 작업은 가장 최근에 수정되거나 생성된 파일을 가져옵니다.
- Prefix 필드에서 선택적으로 문자열로 평가되는 정규식을 지정합니다. 접두사를 지정하면 이 작업은 이름이 해당 문자열로 시작되는 경우에만 파일을 검색합니다.
- 파일을 가져온 다음 버킷에서 삭제할지 여부를 나타냅니다.
- 작업을 구성한 후 다음을 클릭하여 작업의 출력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 출력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
이제 통합이 시작 연결되고 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
2.5.3. 통합을 완료하기 위해 Amazon S3에 데이터 추가
Amazon S3에 데이터를 복사하여 통합을 완료하려면 Amazon S3 연결을 간단한 통합의 완료 연결로 추가합니다.
사전 요구 사항
- Amazon S3 연결을 생성하셨습니다.
- 간단한 통합을 만들거나 편집하고 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 연결 선택 페이지에서 통합을 완료하는 데 사용할 Amazon S3 연결을 클릭합니다.
연결을 수행할 작업을 선택합니다.
Copy Object 는 하나 이상의 오브젝트를 버킷에 추가합니다.
버킷에 하나의 파일을 추가하려면 파일 이름 필드에 해당 이름을 입력합니다.
버킷에 여러 파일을 추가하려면 파일 이름을 지정하지 마십시오. 이 경우 작업은 이전 통합 단계에서 가져오는 모든 오브젝트를 추가합니다.
poll 작업을 사용하여 여러 파일을 가져오고 파일 이름을 지정하면 Copy Object 작업은 폴링 작업에서 수신된 마지막 파일만 추가합니다.
- 삭제 오브젝트 는 버킷에서 오브젝트를 삭제합니다. 파일 이름 필드에서 삭제할 오브젝트의 이름을 지정합니다. 지정된 파일이 버킷에 없는 경우 통합이 오류 없이 계속됩니다.
- 선택한 작업을 구성한 후 다음을 클릭하여 작업의 입력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 입력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
통합 시각화가 끝나면 연결이 나타납니다.
2.5.4. 통합 중 Amazon S3에 데이터 추가
통합 중에 Amazon S3에 데이터를 추가하려면 흐름 중앙에 Amazon S3 연결을 추가합니다.
사전 요구 사항
- Amazon S3 연결을 생성하셨습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다.
절차
- 흐름 시각화에서 Amazon S3 연결을 추가할 더하기 기호를 클릭합니다.
- 흐름 중간에서 사용할 Amazon S3 연결을 클릭합니다.
연결을 수행할 작업을 선택합니다.
Copy Object 는 하나 이상의 오브젝트를 버킷에 추가합니다.
버킷에 하나의 파일을 추가하려면 파일 이름 필드에 해당 이름을 입력합니다.
버킷에 여러 파일을 추가하려면 파일 이름을 지정하지 마십시오. 이 경우 작업은 이전 통합 단계에서 가져오는 모든 오브젝트를 추가합니다.
poll 작업을 사용하여 여러 파일을 가져오고 파일 이름을 지정하면 Copy Object 작업은 폴링 작업에서 수신된 마지막 파일만 추가합니다.
- 삭제 오브젝트 는 버킷에서 오브젝트를 삭제합니다. 파일 이름 필드에서 삭제할 오브젝트의 이름을 지정합니다. 지정된 파일이 버킷에 없는 경우 통합이 오류 없이 계속됩니다.
- 선택한 작업을 구성한 후 다음을 클릭하여 작업의 입력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 입력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
연결은 추가한 흐름 시각화에 표시됩니다.
3장. AMQ에 연결
통합에서는 Red Hat AMQ 브로커에서 메시지를 얻거나 Red Hat AMQ 브로커에 메시지를 게시할 수 있습니다. Red Hat AMQ는 클라이언트와 메시지 브로커 간의 통신에 OpenWire 프로토콜을 사용합니다. 다음 브로커 유형과 통신하려면 Red Hat AMQ 커넥터를 사용하여 관심 브로커에 대한 연결을 생성합니다.
- AMQP를 지원하지 않는 Apache ActiveMQ 브로커
- AMQ 6 브로커
다음 브로커 유형 중 하나와 통신하려면 AMQP 커넥터를 사용하여 관심 브로커에 대한 연결을 생성합니다.
- AMQP를 지원하는 Apache ActiveMQ 브로커
- Apache ActiveMQ Artemis
- AMQ 7 브로커
- EnMasse - 오픈 소스 메시징 플랫폼
Red Hat AMQ 커넥터를 사용하려면 다음을 참조하십시오.
3.1. AMQ 연결 생성
통합에서 메시지를 얻거나 메시지에 게시하려면 다음을 수행합니다.
- AMQP를 지원하지 않는 Apache ActiveMQ 브로커
- AMQ 6 브로커
통합에 추가할 수 있는 Red Hat AMQ 연결을 생성합니다.
사전 요구 사항
연결하려는 Red Hat AMQ 브로커의 경우 다음이 있습니다.
- 브로커 URL
- 사용자 계정 인증 정보
- 브로커의 PEM 인증서 텍스트
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 커넥터를 표시합니다.
- Red Hat AMQ 커넥터를 클릭합니다.
연결을 구성합니다.
-
Broker URL 필드에 데이터를 보내거나 가져올 위치를 입력합니다(예:
tcp://localhost:61616). - 사용자 이름 필드에 이 브로커에 액세스하는 데 사용할 계정의 사용자 이름을 입력합니다.
- 암호 필드에 이 브로커에 액세스하는 데 사용할 계정의 암호를 입력합니다.
- 클라이언트 ID 필드에 메시지가 누락된 메시지 없이 연결을 닫고 다시 열 수 있는 ID를 입력합니다. 대상 유형은 주제여야 합니다.
- 이 연결을 개발 환경에서 사용하는 경우 Check certificates 를 비활성화하여 시간을 절약할 수 있습니다. 인증서 확인을 비활성화하는 것은 개발 환경의 편의성입니다. 안전한 프로덕션 환경의 경우 항상 인증서 검사를 활성화합니다.
- Broker 인증서 필드에 Red Hat AMQ 브로커의 PEM 인증서 텍스트를 붙여넣습니다. 인증서 확인을 비활성화한 경우를 제외하고 이 작업이 필요합니다.
- 클라이언트 인증서 필드에 Red Hat 클라이언트의 PEM 인증서 텍스트를 붙여넣습니다. 이 필드의 콘텐츠는 항상 선택 사항입니다.
-
Broker URL 필드에 데이터를 보내거나 가져올 위치를 입력합니다(예:
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 필요에 따라 구성 세부 정보를 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
Red Hat AMQ 1을 입력할 수 있습니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
제공된 브로커를 사용하는 샘플 Red Hat AMQ 연결을 입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 Red Hat AMQ 1 이 통합에 추가하도록 선택할 수 있는 연결로 표시됩니다.
3.2. 메시지를 수신할 때 통합 실행을 트리거하기 위해 AMQ 연결 추가
Red Hat AMQ 브로커에서 메시지를 수신할 때 통합 실행을 트리거하려면 Red Hat AMQ 연결을 시작 연결로 추가합니다.
사전 요구 사항
메시지를 가져오려는 Red Hat AMQ 브로커에 대한 Red Hat AMQ 연결을 생성하셨습니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 통합을 시작하는 데 사용할 Red Hat AMQ 연결을 클릭합니다.
- 작업 선택 페이지에서 지정한 큐 또는 항목에서 메시지를 받으려면 메시지 구독 작업을 선택합니다.On the Choose an action page, select the Subscribe for messages action to receive messages from the queue or topic that you specify.
작업을 구성합니다.
- 대상 이름 필드에 데이터를 수신할 큐 또는 주제의 이름을 입력합니다.
- 대상 유형에 대해 큐 를 수락하거나 Topic 을 선택합니다.
- Durable 서브스크립션 ID 필드에 메시지 누락 없이 연결을 닫거나 다시 열 수 있도록 하려면 Cryostat 서브스크립션 ID를 입력합니다. 대상 유형은 주제여야 합니다.
메시지 선택기 필드에 특정 조건을 충족하는 데이터만 수신하려면 필터 표현식을 입력합니다.
메시지 선택기는 표현식이 포함된 문자열입니다. 표현식 구문은 SQL92 조건부 표현식 구문의 하위 집합을 기반으로 합니다. 다음 예제의 메시지 선택기는 값이 Cryostat 또는
Opinion으로 설정된 newsType속성이 있는메시지를선택합니다.newsType = 'Sports' 또는 newsType = 'Opinion'메시지 소비자는 헤더 및 속성이 메시지 선택기 표현식과 일치하는 메시지만 받습니다. 메시지 선택기는 메시지 본문의 콘텐츠에 따라 메시지를 선택할 수 없습니다.
- 다음을 클릭하여 작업의 출력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 출력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
연결은 통합 흐름 시작 부분에 나타납니다.
3.3. AMQ 메시지를 게시하여 통합을 완료
Red Hat AMQ 브로커에 메시지를 게시하여 간단한 통합을 완료하려면 Red Hat AMQ 연결을 간단한 통합 연결로 추가합니다.
사전 요구 사항
- 메시지를 게시하려는 Red Hat AMQ 브로커에 대한 연결을 생성했습니다.
- 통합을 생성하고 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되거나 통합을 편집하여 최종 연결을 변경할 수 있습니다.
절차
- 연결 선택 페이지에서 통합을 완료하는 데 사용할 Red Hat AMQ 연결을 클릭합니다.
- 작업 선택 페이지에서 메시지 게시 작업을 선택하여 지정한 큐 또는 항목에 메시지를 게시합니다.On the Choose an action page, select the publish messages action to publish messages to the queue or topic that you specify.
- 대상 이름 필드에 메시지를 보낼 큐 또는 주제의 이름을 입력합니다.
- 대상 유형에 대해 큐 를 수락하거나 Topic 을 선택합니다.
- 연결이 실패하더라도 메시지 전달을 보장하기 위해 영구 을 선택합니다.
- 다음을 클릭하여 작업의 입력/출력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 입력/출력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
통합 시각화가 끝나면 연결이 나타납니다.
3.4. 통합 중 AMQ 메시지 게시
통합 중에 Red Hat AMQ 브로커에 메시지를 게시하려면 흐름 중간에 Red Hat AMQ 연결을 추가합니다.
사전 요구 사항
- 메시지를 게시하려는 Red Hat AMQ 브로커에 대한 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 흐름 중 원하는 Red Hat AMQ 연결을 클릭합니다.
작업 선택 페이지에서 다음 작업 중 하나를 선택합니다.
지정한 큐 또는 항목에 메시지를 게시하는 메시지를 게시합니다. 이 작업을 구성하려면 다음을 수행합니다.
- 대상 이름 필드에 메시지를 보낼 큐 또는 주제의 이름을 입력합니다.
- 대상 유형에 대해 큐 를 수락하거나 Topic 을 선택합니다.
- 연결이 실패하더라도 메시지 전달을 보장하기 위해 영구 을 선택합니다.
메시지를 사용하여 응답을 요청 하여 지정한 JMS 대상에 메시지를 전송하고 응답을 수신합니다. 이 작업을 구성하려면 다음을 수행합니다.
- 대상 이름 필드에 메시지를 보낼 큐 또는 주제의 이름을 입력합니다.
- 대상 유형에 대해 큐 를 수락하거나 Topic 을 선택합니다.
메시지 선택기 필드에 특정 조건을 충족하는 응답만 수신하려면 필터 표현식을 입력합니다.
메시지 선택기는 표현식이 포함된 문자열입니다. 표현식 구문은 SQL92 조건부 표현식 구문의 하위 집합을 기반으로 합니다. 다음 예제의 메시지 선택기는 값이 Cryostat 또는
Opinion으로 설정된 newsType속성이 있는메시지를선택합니다.newsType = 'Sports' 또는 newsType = 'Opinion'메시지 소비자는 헤더 및 속성이 메시지 선택기 표현식과 일치하는 메시지만 받습니다. 메시지 선택기는 메시지 본문의 콘텐츠에 따라 메시지를 선택할 수 없습니다.
- Named reply to 필드에 큐 또는 주제의 이름을 입력합니다. 대상에서 이 큐 또는 항목에 대한 응답을 보냅니다.
- 연결이 실패하더라도 메시지 전달을 보장하기 위해 영구 을 선택합니다.
- 응답 시간 초과 필드에서 이 연결이 런타임 예외를 throw하기 전에 응답 메시지를 기다리는 시간(밀리초)을 지정합니다. 기본값은 5000밀리초(5초)입니다.
- 다음을 클릭하여 작업의 입력 유형 및 작업의 출력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 입력/출력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
4장. AMQP에 연결
통합에서는 AMQP(Advanced Message Queue Protocol) 브로커에서 메시지를 얻거나 메시지를 게시할 수 있습니다. AMQP는 클라이언트와 메시지 브로커 간의 통신을 정의합니다. 다음 브로커 유형과 통신하려면 AMQP 커넥터를 사용하여 관심 브로커에 대한 연결을 생성합니다.
- AMQP를 지원하는 Apache ActiveMQ 브로커
- Apache ActiveMQ Artemis
- AMQ 7 브로커
- EnMasse - 오픈 소스 메시징 플랫폼
다음 브로커 유형 중 하나와 통신하려면 Red Hat AMQ 커넥터를 사용하여 관심 브로커에 대한 연결을 생성합니다.
- AMQP를 지원하지 않는 Apache ActiveMQ 브로커
- AMQ 6 브로커
AMQP 커넥터를 사용하여 AMQP 또는 AMQ 6 브로커를 지원하지 않는 Apache ActiveMQ 브로커에 대한 연결을 생성할 수 있습니다. 이렇게 하려면 브로커의 전송 구성이 필요합니다. 브로커 구성에 대한 자세한 내용은 Red Hat JBoss A-MQ 관리 및 모니터링 브로커 추가, 클라이언트 연결 지점을 참조하십시오. 지정할 구성 값에 대한 자세한 내용은 Red Hat JBoss A-MQ 연결 참조, AMQP(Advanced Message Queuing Protocol) 를 참조하십시오.
AMQP 커넥터를 사용하려면 다음을 참조하십시오.
4.1. AMQP 연결 생성
통합을 통해 메시지를 AMQP 브로커에 전송하거나 게시하려면 통합에 추가할 수 있는 AMQP 연결을 생성합니다.
사전 요구 사항
연결하려는 AMQP 브로커의 경우 다음이 있습니다.
- 해당 URI
- 사용자 계정 인증 정보
- PEM 인증서 텍스트
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 커넥터를 표시합니다.
- AMQP 메시지 브로커 커넥터를 클릭합니다.
연결을 구성합니다.
- 연결 URI 필드에 데이터를 보내거나 데이터를 가져올 위치를 입력합니다.
- 사용자 이름 필드에 이 브로커에 액세스하는 데 사용할 계정의 사용자 이름을 입력합니다.
- 암호 필드에 이 브로커에 액세스하는 데 사용할 계정의 암호를 입력합니다.
- 클라이언트 ID 필드에 메시지가 누락된 메시지 없이 연결을 닫고 다시 열 수 있는 ID를 입력합니다. 대상 유형은 주제여야 합니다.
- 이 연결을 개발 환경에서 사용하는 경우 Check certificates 를 비활성화하여 시간을 절약할 수 있습니다. 인증서 확인을 비활성화하는 것은 개발 환경의 편의성입니다. 안전한 프로덕션 환경의 경우 항상 인증서 검사를 활성화합니다.
- Broker 인증서 필드에 브로커의 PEM 인증서 텍스트를 붙여넣습니다. 이는 인증서 검사를 비활성화한 경우를 제외하고 필요합니다.
- 클라이언트 인증서 필드에 클라이언트의 PEM 인증서 텍스트를 붙여넣습니다. 이 필드의 콘텐츠는 항상 선택 사항입니다.
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 필요에 따라 구성 세부 정보를 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
AMQP 1을 입력할 수 있습니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
샘플 AMQP 연결을입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 AMQP 1 이 통합에 추가하도록 선택할 수 있는 연결로 표시됩니다.
4.2. 메시지 수신 시 통합 실행을 트리거하기 위해 AMQP 연결 추가
AMQP 브로커에서 메시지를 수신할 때 통합을 트리거하려면 AMQP 연결을 통합 시작 연결로 추가합니다.
사전 요구 사항
- 메시지를 수신하려는 AMQP 브로커에 대한 연결을 생성했습니다.
- 통합을 생성하고 Fuse Online에서 시작 연결을 선택하라는 메시지를 표시합니다.
절차
- 연결 선택 페이지에서 통합을 시작하는 데 사용할 AMQP 연결을 클릭합니다.
- 작업 선택 페이지에서 지정한 큐 또는 항목에서 메시지를 받으려면 메시지 구독 작업을 선택합니다.On the Choose an action page, select the Subscribe for messages action to receive messages from the queue or topic that you specify.
작업을 구성합니다.
- 대상 이름 필드에 데이터를 수신할 큐 또는 주제의 이름을 입력합니다.
- 대상 유형에 대해 큐 를 수락하거나 Topic 을 선택합니다.
- Durable 서브스크립션 ID 필드에 메시지 누락 없이 연결을 닫거나 다시 열 수 있도록 하려면 Cryostat 서브스크립션 ID를 입력합니다. 대상 유형은 주제여야 합니다.
메시지 선택기 필드에 특정 조건을 충족하는 데이터만 수신하려면 필터 표현식을 입력합니다.
메시지 선택기는 표현식이 포함된 문자열입니다. 표현식 구문은 SQL92 조건부 표현식 구문의 하위 집합을 기반으로 합니다. 다음 예제의 메시지 선택기는 값이 Cryostat 또는
Opinion으로 설정된 newsType속성이 있는메시지를선택합니다.newsType = 'Sports' 또는 newsType = 'Opinion'메시지 소비자는 헤더 및 속성이 메시지 선택기 표현식과 일치하는 메시지만 받습니다. 메시지 선택기는 메시지 본문의 콘텐츠에 따라 메시지를 선택할 수 없습니다.
- 다음을 클릭하여 작업의 출력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 출력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
연결은 통합 흐름 시작 부분에 나타납니다.
4.3. 흐름 중 AMQP에 메시지 게시 또는 통합을 완료
흐름 중간에 AMQP 브로커에 메시지를 게시하거나 간단한 통합을 완료할 수 있습니다. 이렇게 하려면 흐름 중 또는 간단한 통합의 완료 연결로 AMQP 연결을 추가합니다.
사전 요구 사항
- 메시지를 게시할 AMQP 브로커에 대한 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 간단한 통합 연결 완료를 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 메시지를 게시하는 데 사용할 AMQP 연결을 클릭합니다.
작업 선택 페이지에서 다음 작업 중 하나를 선택합니다.
응답을 수신하지 않고 지정하는 큐 또는 항목에 메시지를 게시하도록 메시지를 게시합니다. 이 작업을 구성하려면 다음을 수행합니다.
- 대상 이름 필드에 메시지를 보낼 큐 또는 주제의 이름을 입력합니다.
- 대상 유형에 대해 큐 를 수락하거나 Topic 을 선택합니다.
- 연결이 실패하더라도 메시지 전달을 보장하기 위해 영구 을 선택합니다.
메시지를 사용하여 응답을 요청 하여 지정하는 큐 또는 항목에 메시지를 게시하고 응답을 수신합니다.
참고간단한 통합에서 완료 연결이 메시지 작업을 사용하여 Request 응답을 수행하는 AMQP 연결인 경우 연결은 메시지를 게시하지만 응답이 삭제됩니다. 응답 손실을 방지하려면 메시지 작업을 사용하여 요청 응답을 수행하는 중간 연결로 AMQP 연결을 추가하고 로그 단계와 간단한 통합을 완료합니다.
이 작업을 구성하려면 다음을 수행합니다.
- 대상 이름 필드에 메시지를 보낼 큐 또는 주제의 이름을 입력합니다.
- 대상 유형에 대해 큐 를 수락하거나 Topic 을 선택합니다.
- Durable 서브스크립션 ID 필드에 메시지 누락 없이 연결을 닫거나 다시 열 수 있도록 하려면 Cryostat 서브스크립션 ID를 입력합니다. 대상 유형은 주제여야 합니다.
메시지 선택기 필드에 특정 조건을 충족하는 응답만 수신하려면 필터 표현식을 입력합니다.
메시지 선택기는 표현식이 포함된 문자열입니다. 표현식 구문은 SQL92 조건부 표현식 구문의 하위 집합을 기반으로 합니다. 다음 예제의 메시지 선택기는 값이 Cryostat 또는
Opinion으로 설정된 newsType속성이 있는메시지를선택합니다.newsType = 'Sports' 또는 newsType = 'Opinion'메시지 소비자는 헤더 및 속성이 메시지 선택기 표현식과 일치하는 메시지만 받습니다. 메시지 선택기는 메시지 본문의 콘텐츠에 따라 메시지를 선택할 수 없습니다.
- 다음을 클릭하여 작업의 입력 및 출력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 입력/출력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
5장. API 클라이언트에 연결
통합에서 REST 또는 Cryostat API에 연결하려면 해당 API에 대한 커넥터를 생성해야 합니다. Fuse Online으로 애플리케이션 통합, API 클라이언트 커넥터 추가 및 관리를 참조하십시오.
연결하려는 API의 커넥터가 Fuse Online에서 사용할 수 있는 경우 해당 API에 연결하는 단계는 다음과 같습니다.
5.1. Fuse Online을 REST API 클라이언트로 등록
Fuse Online에서 REST API 클라이언트 커넥터를 생성하기 전에 API의 보안 요구 사항을 표시하라는 메시지가 표시됩니다. OAuth 프로토콜을 사용하는 API의 경우 Fuse Online에서 커넥터를 생성할 때 API의 항목도 Fuse Online Settings 페이지에 추가합니다. 여기에서 Fuse Online에서 API에 액세스할 수 있도록 권한을 부여하는 API 클라이언트 ID와 API 클라이언트 시크릿을 제공합니다.
연결하려는 API에서 OAuth를 사용하지 않는 경우 이 섹션을 건너뛰고 REST API 클라이언트 연결 생성을 참조하십시오.
사전 요구 사항
연결하려는 REST API의 OAuth 사용자 지정 애플리케이션 설정 페이지의 URL을 알아야 합니다.
절차
Fuse Online에서:
-
설정 페이지에서 콜백 URL 오른쪽에 있는 상단에서
를 클릭하여 Fuse Online 환경의 콜백 URL을 클립보드에 복사합니다. 이 URL은 이 절차의 뒷부분에서 필요합니다.
- 연결할 API의 이름을 찾아 클릭하여 클라이언트 ID 및 클라이언트 시크릿 필드를 표시합니다.
-
설정 페이지에서 콜백 URL 오른쪽에 있는 상단에서
다른 브라우저 창에서 연결하려는 API의 OAuth 클라이언트로 Fuse Online을 등록해야 합니다. 이 작업을 수행하는 정확한 단계는 API 서비스마다 다릅니다. 일반적으로 API 서비스는 OAuth 사용자 지정 애플리케이션 설정 페이지를 제공합니다. 해당 페이지로 이동하여 다음을 수행합니다.
- 이 절차의 시작 시 복사한 Fuse 온라인 콜백 URL을 제공합니다.
- 입력이 필요한 다른 프롬프트에 응답합니다.
- API 서비스가 Fuse Online 환경에 할당하는 클라이언트 ID 및 클라이언트 시크릿을 가져옵니다.
등록하려는 API 서비스의 Fuse Online Settings 페이지 항목으로 돌아가서 다음을 수행합니다.
- 할당된 클라이언트 ID를 붙여넣습니다.
- 할당된 클라이언트 시크릿을 붙여넣습니다.
- 저장을 클릭합니다.
5.2. REST API 클라이언트 연결 생성
통합에서 REST API에 연결하려면 해당 REST API에 대한 연결을 생성한 다음 원하는 통합에 추가할 수 있습니다.
사전 요구 사항
- 연결하려는 REST API에 대한 커넥터를 생성했습니다.
- REST API에서 OAuth 프로토콜을 사용하는 경우 해당 REST API에 액세스할 수 있는 클라이언트 애플리케이션으로 Fuse Online 환경을 등록했습니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 사용 가능한 커넥터를 표시합니다.
- 연결을 생성할 API의 커넥터를 클릭합니다.
구성 페이지에서 요청된 정보를 제공합니다. API 정의에는 Fuse Online에서 묻는 프롬프트가 결정됩니다.
일반적으로 API 서비스에는 보안 요구 사항이 있으며 Fuse Online에서 OpenAPI 문서에서 정의하는 특정 보안 유형에 따라 보안 입력을 요청하는 메시지를 표시합니다. 보안 유형은 다음 중 하나일 수 있습니다.
보안 유형
Fuse Online 디스플레이
HTTP 기본 인증
사용자 이름 및 암호에 대한 입력 필드입니다.
OAuth 2.0
Fuse Online에서 API에 연결하기 위한 등록 자격 증명을 확인할 수 있도록 클릭할 수 있는 버튼입니다. 이러한 인증 정보는 커넥터가 생성될 때 제공되었습니다.
API 키
API 서비스에서 가져와야 하는 API 키의 입력 필드입니다.
- Validate 를 클릭합니다. Fuse Online에서 연결 매개 변수 확인. 예를 들어 유효한 호스트/주소 URL이 있는지 확인합니다.
- 다음을 클릭합니다.
이름 연결 페이지에서 다음을 수행합니다.
- 이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다.
- 설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다.
- 저장을 클릭합니다. 이제 생성한 연결을 선택하고 통합에 추가할 수 있습니다.
5.3. Cryostat API 클라이언트 연결 생성
통합에서 Cryostat API에 연결하려면 해당 Cryostat API에 대한 연결을 만든 다음 모든 통합에 추가할 수 있습니다.
사전 요구 사항
- 연결하려는 Cryostat API에 대한 커넥터를 생성했습니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 사용 가능한 커넥터를 표시합니다.
- 연결을 생성할 API의 커넥터를 클릭합니다.
- 구성 페이지에서 요청된 정보를 제공합니다. API 정의에는 Fuse Online에서 묻는 프롬프트가 결정됩니다.
연결 구성 페이지에서 다음을 수행합니다.
- Cryostat 엔드 포인트 주소를 수락하거나 편집합니다.
WSDL 끝점을 호출할 때 사용할 인증 유형(None, Basic 또는 WS-Security Username Token)을 선택합니다. 기본 인증의 경우 HTTPS가 지원됩니다. 일반적으로 API 서비스에는 보안 요구 사항이 있으며 Fuse Online에서 WSDL 파일에서 정의하는 특정 보안 유형에 따라 보안 입력을 요청하는 메시지를 표시합니다.
참고: SAML은 지원되지 않습니다.
-
WS-Security Password Type (
None,text, 또는Digest)을 선택합니다. - 사용자 이름 및 암호를 지정합니다.
- Fuse Online에서 WS-Security 헤더에 타임스탬프를 추가하려면 Timestamp 를 선택합니다.
Fuse Online에서 WS-Security Username Token 헤더에 Nonce 요소를 추가하려면 Username Token Nonce 를 선택합니다. 사용자 이름 토큰 프로필의 경우 text 및 Digest 암호가 모두 지원됩니다.
WSS(Web Services Security) 사양에서 UsernameToken을 사용하는 방법에 대한 자세한 내용은 이 OA Cryostat 문서를 참조하십시오.
Fuse Online에서 WS-Security Username Token 헤더에 timestamp 요소를 추가하려면 Username Token Created 를 선택합니다.
참고: Cryostat 엔드포인트에 대한 연결을 확인하기 위한 OA Cryostat/W3C 표준이 없기 때문에 Cryostat 커넥터는 유효성 검사를 지원하지 않습니다.
- 다음을 클릭합니다.
이름 연결 페이지에서 다음을 수행합니다.
- 이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다.
- 설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다.
- 저장을 클릭합니다. 이제 생성한 연결을 선택하고 통합에 추가할 수 있습니다.
5.4. 통합에 API 클라이언트 연결 추가
통합에서 REST 또는 Cryostat API에 연결하려면 해당 API에 연결하는 단계를 추가합니다.
이번 릴리스에서는 REST 또는 Cryostat API에 대한 연결이 흐름 중간에 있거나 간단한 통합에서 완료 연결일 수 있는 단계가 될 수 있습니다. 즉, REST 또는 Cryostat API에 대한 연결은 시작 연결이 될 수 없습니다.
사전 요구 사항
- REST 또는 Cryostat API에 대한 연결을 생성했습니다.
- 흐름을 만들거나 편집하고 있습니다.
- 흐름에는 이미 시작 연결이 있습니다.
- Fuse Online에서 완료 연결을 선택하거나 통합에 추가할 것을 요청하고 있습니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 사용 가능한 단계를 표시하는 페이지에서 흐름에 추가할 API 연결을 클릭합니다.
- 연결을 수행할 작업을 선택합니다. 사용 가능한 작업은 Fuse Online에 업로드되고 연결 중인 API를 설명하는 OpenAPI 문서 또는 WSDL 파일에 지정된 리소스 작업을 기반으로 합니다.
- 선택한 작업에 따라 Fuse Online에서 묻는 메시지를 표시하는 매개변수를 입력합니다.
- 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
6장. 박스에 연결
통합에서는 박스에서 파일을 다운로드하거나 박스에 파일을 업로드할 수 있습니다.
박스에 대한 연결은 간단한 통합을 시작할 수 없습니다. 즉, Box 연결을 사용하여 통합 실행을 트리거할 수 없습니다.
다음 주제에서는 세부 정보를 제공합니다.
6.1. Fuse Online을 Box 클라이언트로 등록
Fuse Online 환경을 Box에 액세스할 수 있는 클라이언트 애플리케이션으로 등록해야 합니다. 이를 통해 Box에 연결되는 통합 수를 만들 수 있습니다. 즉, 특정 Fuse Online 환경을 Box에 한 번만 등록해야 합니다.
각 Fuse Online 환경에는 Fuse Online 등록은 Box 클라이언트 애플리케이션으로 하나만 등록할 수 있습니다. 그러나 각 Box 연결은 동일한 등록을 사용하지만 다른 사용자 자격 증명을 사용할 수 있습니다.
사전 요구 사항
- 박스 개발자 계정이 있습니다. https://app.box.com/developers/console 에서 얻을 수 있습니다.
절차
Fuse Online에서:
- 왼쪽 패널에서 설정을 클릭합니다.
-
설정 페이지에서 콜백 URL 오른쪽에 있는 상단에서
를 클릭하여 Fuse Online 환경의 콜백 URL을 클립보드에 복사합니다. 이 URL은 이 절차의 끝에 필요합니다.
다른 브라우저 탭에서 https://app.box.com/developers/console 에서 Box 개발자 포털로 이동하여 다음을 수행합니다.
- 로그인.
- 새 앱 만들기를 클릭합니다.
- Custom App 을 클릭한 다음 Next 를 클릭합니다.
- Authentication Method 의 경우 Standard OAuth 2.0 (User Authentication) 을 클릭한 다음 Next.
- 앱 이름(예: Fuse Online Client )을 입력하고 Create App 을 클릭합니다.
- 앱 보기를 클릭합니다.
- 선택 사항: OAuth 2.0 인증 정보 섹션에서 클라이언트 ID와 클라이언트 시크릿을 안전한 위치에 복사합니다. 이러한 값은 Box에 대한 연결을 만드는 데 필요합니다.
- 변경 사항 저장을 클릭합니다.
결과
Fuse Online 환경은 이제 Box 클라이언트로 등록되므로 Fuse Online에서 사용자가 로그인한 Box 계정의 콘텐츠에 액세스할 수 있습니다.
6.2. Box 연결 만들기
통합을 통해 Box 파일을 다운로드하거나 업로드하려면 통합에 추가할 수 있는 Box 연결을 만듭니다. 통합에 동일한 연결을 추가할 수 있습니다.
사전 요구 사항
- Fuse Online 환경을 Box에 액세스할 수 있는 애플리케이션으로 등록하는 Box 클라이언트 애플리케이션이 있습니다.
- 해당 애플리케이션을 생성한 Box 개발자 계정에 로그인하거나 해당 애플리케이션의 Box 클라이언트 ID 및 Box 클라이언트 시크릿을 사용할 수 있습니다.
- 이 연결에 사용할 Box 계정의 사용자 이름과 암호를 알고 있습니다.
절차
이미 Box 클라이언트 ID와 클라이언트 시크릿이 있는 경우 다음 단계로 건너뜁니다. 그렇지 않으면 새 브라우저 탭에서 해당 값을 얻으려면 https://app.box.com/developers/console 로 이동하여 다음을 수행합니다.
- Fuse Online 환경에서 Box에 대한 액세스 권한을 등록하는 앱을 만든 Box 계정에 로그인합니다.
- 내 앱 페이지에서 Fuse Online 앱을 클릭하여 설정을 표시합니다.
- 왼쪽에서 구성 을 클릭합니다.
- OAuth 2.0 인증 정보 섹션에서 클라이언트 ID를 클립보드에 복사합니다.
다른 브라우저 탭에서 Fuse Online에서 다음을 수행합니다.
- 연결을 클릭합니다.
- 연결 생성을 클릭합니다.
- 박스 커넥터를 클릭합니다.
- 사용자 이름 필드에 Box 파일을 다운로드하거나 업로드하는 데 이 연결을 사용할 Box 계정의 사용자 이름을 입력합니다.
- 사용자 암호 필드에 해당 계정의 암호를 입력합니다.
- 클라이언트 ID 필드에 박스 클라이언트 ID를 붙여넣습니다.
- 선택 사항: 필요한 경우 Box 앱의 OAuth 2.0 인증 정보로 돌아가서 클라이언트 시크릿을 클립보드에 복사한 다음 Fuse Online으로 돌아갑니다.
- 클라이언트 시크릿 필드에 Box 클라이언트 시크릿 문자열을 붙여넣습니다.
- Validate 를 클릭합니다. Fuse Online에는 이 연결의 유효성을 검사할 수 있는지 여부를 나타내는 메시지가 표시됩니다. 유효성 검사가 실패하면 다시 시도한 후 올바른 값을 입력해야 합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
Box Sales Account를 입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
회사 sales Box 계정의 콘텐츠에 액세스할 수 있는 Sample Box 연결을 입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력한 경우 Box Sales Account 가 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
6.3. 통합 중간에 Box 파일 다운로드 또는 업로드
Box에서 파일을 다운로드하거나 흐름 중간에 Box에 파일을 업로드하려면 흐름 중앙에 Box 연결을 추가합니다.
사전 요구 사항
- Box 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다.
- 통합을 사용할 Box 연결을 클릭합니다.
작업 선택 페이지에서 다음 중 하나를 선택합니다.
- 이 연결에 액세스하는 Box 계정에서 파일을 가져오려면 을 다운로드합니다.
- 이 연결에 액세스하는 Box 계정에 파일을 업로드하려면 업로드합니다.
선택한 작업을 구성합니다.
파일을 다운로드하려면 다음을 수행합니다.
-
파일 인코딩 필드에서
UTF-8을 수락하거나 연결을 가져올 파일의 인코딩을 지정합니다. 선택 사항: 파일 ID 필드에서 가져올 파일의 Box ID를 지정합니다. Box에서 파일을 볼 때 파일 ID는 URL의 끝에 있습니다. 예를 들어 이 URL에서
https://app.box.com/file/537364588548파일 ID는537364588548입니다.또는 이 연결 전에 데이터 매퍼 단계를 추가하고 이전 단계의 파일 ID를 이 연결에 매핑할 수 있습니다.
이번 릴리스에서는 단일 파일만 다운로드할 수 있습니다. 그러나 이전 단계의 파일 ID를 매핑하면 파일 동적(예: 데이터베이스 테이블에서 ID)을 식별할 수 있습니다. 즉, 각 실행에서 다른 파일을 다운로드할 수 있습니다.
파일을 업로드 하려면 다음을 수행합니다.
상위 폴더 ID 필드에 파일을 업로드할 Box 폴더의 ID를 입력합니다.
박스 폴더 ID는 Box에서 폴더 내용을 볼 때 URL 끝에 있습니다. 이 예에서
https://app.box.com/folder/89490291417에서는 폴더 ID는89490291417입니다. 이번 릴리스에서는 단일 파일만 업로드할 수 있습니다.선택 사항: 파일 이름 필드에 새 파일의 이름을 입력합니다. 지정된 Box 폴더에 이미 있는 파일의 이름을 지정하면 연결에 폴더에 있는 파일을 덮어씁니다.
연결에 대한 입력은 박스에 업로드할 파일이어야 합니다. 파일 이름을 지정하지 않으면 연결이 해당 이름의 파일이 아직 존재하지 않는 한 입력 파일과 동일한 이름을 가진 파일을 연결에 업로드합니다.
- 다음을 클릭하여 업로드 작업의 입력 유형을 지정합니다.
- 유형 선택 필드에서 유형 사양을 수락하지 않고 Next 를 클릭합니다.
-
파일 인코딩 필드에서
결과
연결은 이를 추가한 통합 흐름에 표시됩니다.
6.4. 통합을 완료하기 위해 Box에 파일 업로드
Box에 파일을 업로드하여 통합을 완료하려면 통합의 완료 연결로 Box 연결을 추가합니다.
사전 요구 사항
- Box 연결을 생성했습니다.
- 간단한 통합을 만들거나 편집하고 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 연결 선택 페이지에서 통합을 완료하는 데 사용할 Box 연결을 클릭합니다.
- 작업 선택 페이지에서 이 연결에 액세스하는 Box 계정에 파일을 업로드할 업로드 작업을 선택합니다.
상위 폴더 ID 필드에 파일을 업로드할 Box 폴더의 ID를 입력합니다.
박스 폴더 ID는 Box에서 폴더를 선택할 때 URL의 끝에 있습니다. 이 예에서
https://app.box.com/folder/89490291417에서는 폴더 ID는89490291417입니다. 이번 릴리스에서는 단일 파일만 업로드할 수 있습니다.선택 사항: 파일 이름 필드에 새 파일의 이름 또는 기존 파일을 입력합니다. 지정된 Box 폴더에 이미 있는 파일의 이름을 지정하면 연결에 폴더에 있는 파일을 덮어씁니다.
연결에 대한 입력은 박스에 업로드할 파일이어야 합니다. 파일 이름을 지정하지 않으면 연결에서 입력 파일과 이름이 같은 파일을 연결에 업로드합니다.
- 다음을 클릭합니다.
- 유형 선택 필드에서 유형 사양을 수락하지 않고 Next 를 클릭합니다.
결과
통합 시각화가 끝나면 연결이 나타납니다.
7장. Dropbox에 연결
통합에서는 Dropbox에서 파일을 다운로드하거나 Dropbox에 파일을 업로드할 수 있습니다. 다음 주제에서는 세부 정보를 제공합니다.
7.1. Fuse Online을 Dropbox 클라이언트로 등록
Fuse Online 환경을 Dropbox에 액세스할 수 있는 클라이언트 애플리케이션으로 등록해야 합니다. 이를 통해 Dropbox에 연결된 여러 통합을 만들 수 있습니다. 즉, Dropbox에 특정 Fuse Online 환경을 한 번만 등록해야 합니다.
각 Fuse Online 환경에는 Dropbox 클라이언트 애플리케이션으로 Fuse Online 등록은 하나만 있을 수 있습니다. 그러나 각 Dropbox 연결은 동일한 등록을 사용하지만 다른 사용자 자격 증명을 사용할 수 있습니다.
사전 요구 사항
파일을 다운로드하거나 업로드하는 데 통합할 때 사용할 Dropbox 계정에 로그인할 수 있습니다.
절차
Fuse Online에서:
- 왼쪽 패널에서 설정을 클릭합니다.
-
설정 페이지에서 콜백 URL 오른쪽에 있는 상단에서
를 클릭하여 Fuse Online 환경의 콜백 URL을 클립보드에 복사합니다. 이 URL은 이 절차의 끝에 필요합니다.
다른 브라우저 탭에서
https://www.dropbox.com로 이동하여 다음을 수행합니다.- 통합에서 액세스하려는 데이터가 있는 Dropbox 계정에 로그인합니다.
- 로그인한 후 https://www.dropbox.com/developers/apps 로 이동합니다.
- 앱 생성을 클릭합니다.
- Dropbox API 를 선택합니다.
-
페이지 상단에
During registration으로 시작하는 문장에 이 콜백 URL을 입력합니다. , 이절차의 시작 부분에 클립보드에 복사한 URL을 붙여넣습니다. 예를 들어, 붙여넣는 URL은https://app-proj9128.7b63.fuse-ignite.openshiftapps.com/api/v1/credentials/callback과 같습니다. - Fuse Online에서 단일 폴더 또는 모든 폴더와 파일에 액세스할 수 있는지 여부를 선택합니다.
-
Dropbox 앱의 이름을 지정합니다. 예를 들어
Fuse Online Access From Aslan LLC를 지정할 수 있습니다. 지정한 이름은 Dropbox 앱 이름 집합에서 고유해야 합니다. - 상자를 선택하여 Dropbox API 사용 약관에 동의함을 나타냅니다.
- 앱 생성을 클릭합니다.
- 새 앱의 Dropbox 설정 페이지에서 OAuth2 리디렉션 URI의 입력 필드에 이 절차를 시작할 때 클립보드에 복사한 Fuse Online URL을 붙여넣습니다.
- 추가를 클릭합니다.
결과
이제 Fuse Online 환경이 Dropbox 클라이언트로 등록되므로 Fuse Online에서 로그인한 Dropbox 계정의 콘텐츠에 액세스할 수 있습니다.
7.2. Dropbox 연결 만들기
통합에서 Dropbox 파일을 다운로드하거나 업로드하려면 통합에 추가할 수 있는 Dropbox 연결을 만듭니다. 통합에 동일한 연결을 추가할 수 있습니다.
사전 요구 사항
Fuse Online 환경을 Dropbox에 액세스할 수 있는 애플리케이션으로 등록했습니다.
절차
새 브라우저 탭에서
https://www.dropbox.com로 이동하여 다음을 수행합니다.- Fuse Online 환경에서 액세스 권한을 등록하는 앱을 만든 Dropbox 계정에 로그인합니다.
- https://www.dropbox.com/developers/apps 로 이동합니다.
- Fuse Online 앱을 클릭하여 설정을 표시합니다.
다른 브라우저 탭에서 Fuse Online에서 다음을 수행합니다.
- 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 사용 가능한 커넥터를 표시합니다.
- Dropbox 커넥터를 클릭합니다.
앱의 Dropbox 설정 화면으로 돌아가서 다음을 수행합니다.
- 아래로 스크롤하여 생성된 액세스 토큰을 확인합니다.
- 생성 을 클릭합니다.
- 생성된 액세스 토큰을 클립보드에 복사합니다.
- Fuse Online으로 돌아가 연결 구성 페이지의 액세스 토큰의 액세스 토큰을 붙여넣습니다.
- 클라이언트 식별자 필드에 Dropbox 앱을 만들 때 지정한 이름을 입력합니다.
- Validate 를 클릭합니다. Fuse Online에는 이 연결의 유효성을 검사할 수 있는지 여부를 나타내는 메시지가 표시됩니다. 유효성 검사가 실패하면 다시 시도한 후 올바른 값을 입력해야 합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
Dropbox Connect 1을 입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
회사 Dropbox 계정의 모든 콘텐츠에 액세스할 수 있는 샘플 Dropbox 연결을 입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 Dropbox Connect 1 이 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
7.3. Dropbox에서 통합 실행을 트리거하기 위해 파일 가져오기
Dropbox에서 파일을 다운로드하여 통합을 시작하려면 Dropbox 연결을 시작 연결로 추가합니다.
사전 요구 사항
Dropbox 연결을 생성하셨습니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 통합을 시작하는 데 사용할 Dropbox 연결을 클릭합니다.
- 작업 선택 페이지에서 이 연결에 액세스하는 Dropbox 계정에서 하나 이상의 파일을 얻으려면 다운로드 작업을 선택합니다.
- 작업을 구성하려면 다운로드를 위한 폴더 또는 파일 이름 경로에서 통합을 가져올 콘텐츠의 파일 이름 경로를 지정합니다. 이번 릴리스에서는 단일 파일만 다운로드할 수 있습니다.
- 다음을 클릭하여 작업의 출력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 출력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
연결은 간단한 통합을 시작하고 Fuse Online에서 완료 연결을 선택하라는 메시지를 표시합니다.
7.4. Dropbox에 파일을 추가하여 통합을 완료
Dropbox에 파일을 업로드하여 통합을 완료하려면 Dropbox 연결을 통합 완료 연결로 추가합니다.
사전 요구 사항
- Dropbox 연결을 생성하셨습니다.
- 통합을 만들거나 편집하고 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 연결 선택 페이지에서 통합을 완료하는 데 사용할 Dropbox 연결을 클릭합니다.
- 작업 선택 페이지에서 Upload 작업을 선택하여 현재 통합 데이터를 이 연결에 액세스하는 Dropbox 계정에 추가합니다.
- 원격 경로 필드에 업로드할 파일의 로컬 파일 이름 경로를 입력합니다. Dropbox는 동일한 경로와 이름으로 파일을 저장합니다. 이번 릴리스에서는 단일 파일만 업로드할 수 있습니다.
업로드 모드 의 경우:
- Add 를 선택하여 동일한 이름의 파일이 동일한 Dropbox 폴더에 없는 경우에만 파일을 업로드합니다. 동일한 이름의 파일이 이미 동일한 Dropbox 폴더에 있는 경우 파일이 업로드되지 않고 통합이 계속됩니다. 업로드하려는 파일의 콘텐츠가 업데이트되었는지 여부와 관계없이 이 동작이 업데이트됩니다.
- 동일한 이름을 가진 파일이 동일한 Dropbox 폴더에 있는 경우에도 파일이 업로드되었는지 확인하려면 Force 를 선택합니다. Dropbox는 이미 있는 파일을 업로드 중인 파일로 덮어씁니다.
- 다음을 클릭하여 작업의 입력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 입력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우
벤더를 데이터 유형 이름으로 지정할 수 있습니다.이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
통합 시각화가 끝나면 연결이 나타납니다.
7.5. 통합 중 Dropbox에 액세스
흐름 중간에 Dropbox에 파일을 업로드하려면 흐름 중간에 Dropbox 연결을 추가합니다.
사전 요구 사항
- Dropbox 연결을 생성하셨습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 통합을 사용할 Dropbox 연결을 클릭합니다.
- 작업 선택 페이지에서 업로드 를 선택하여 현재 통합 데이터를 이 연결에 액세스하는 Dropbox 계정에 추가합니다.
이 작업을 구성합니다.
- 원격 경로 필드에서 업로드할 파일의 로컬 경로와 파일 이름을 지정합니다. Dropbox는 동일한 경로와 이름으로 파일을 저장합니다. 이번 릴리스에서는 단일 파일만 업로드할 수 있습니다.
업로드 모드 의 경우:
- Add 를 선택하여 동일한 이름의 파일이 동일한 Dropbox 폴더에 없는 경우에만 파일을 업로드합니다. 동일한 이름의 파일이 이미 동일한 Dropbox 폴더에 있는 경우 파일이 업로드되지 않고 통합이 계속됩니다. 업로드하려는 파일의 콘텐츠가 업데이트되었는지 여부와 관계없이 이 동작이 업데이트됩니다.
- 동일한 이름을 가진 파일이 동일한 Dropbox 폴더에 있는 경우에도 파일이 업로드되었는지 확인하려면 Force 를 선택합니다. Dropbox는 이미 있는 파일을 업로드 중인 파일로 덮어씁니다.
- 다음을 클릭하여 작업의 입력 및 출력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 입력/출력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
연결은 이를 추가한 통합 흐름에 표시됩니다.
8장. 이메일 서버 연결(IMAP, POP3, SMTP)
통합은 email 메시지를 검색하거나 이메일 메시지를 전송하기 위해 SMTP 이메일 서버에 연결하기 위해 Cryostat 또는 POP3 이메일 서버에 연결할 수 있습니다. 이메일을 검색할 때 통합 실행을 트리거하려면 Cryostat 또는 POP3 이메일 서버에 대한 연결을 생성한 다음 해당 연결을 간단한 통합의 시작 연결로 추가합니다. 흐름에서 이메일을 보내려면 SMTP 이메일 서버에 대한 연결을 만든 다음 흐름 중간 또는 간단한 통합을 완료하기 위해 해당 연결을 추가합니다.
자세한 내용은 다음을 참조하십시오.
8.1. Cryostat 또는 POP3 이메일 서버에 대한 연결 생성
수신 이메일에 의해 실행이 트리거되는 간단한 통합을 생성하려면 먼저 Cryostat 또는 POP3 이메일 서버에 대한 연결을 생성해야 합니다.
사전 요구 사항
이 연결에 액세스하는 이메일 서버에 대해 잘 알고 있어야 합니다. 구체적으로는 다음을 알아야 합니다.
- 이메일 서버가 Cryostat 또는 POP3 프로토콜을 사용하는지 여부입니다.
- 인증 자격 증명이 필요한지 여부입니다. 사용자 이름 및 암호가 있어야 합니다.
- 보안 방법이 구현되었는지 여부입니다. 하나가 있는 경우 어떤 방법을 알아야 합니다.
- 서버 인증서가 필요한지 여부입니다. 이 경우 지정할 수 있어야 합니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 생성 을 클릭하여 Fuse Online 커넥터를 표시합니다.
- 수신자 이메일 커넥터 를 클릭합니다.
연결을 구성합니다.
- Protocol 필드에서 imap 을 수락하거나 pop3 을 선택합니다.
- Email Host Name 필드에 이메일 서버 호스트 이름, 가상 호스트 이름 또는 IP 주소를 입력합니다.
- Email Server Port Number 필드에 이메일 서버가 수신 대기하는 포트 번호를 입력합니다.
사용자 이름 필드에서 이 연결에 액세스할 수 있는 권한이 있는 이메일 계정의 사용자 이름을 지정합니다. 통합을 실행하는 동안 이 연결은 이 이메일 계정을 메시지로 폴링합니다.
이메일 서버가 액세스를 인증하지 않는 경우는 거의 없습니다. 이 경우 사용자 이름 및 암호 사양이 필요하지 않습니다.
- 암호 필드에서 이 연결에 액세스할 수 있는 권한이 있는 이메일 계정의 암호를 지정합니다.
- 선택 사항: 보안 방법 필드에서 이메일 서버가 보안 방법을 구현하는 경우 StartTLS 또는 SSL/TLS 를 선택합니다.
- 선택 사항: 서버 인증서 필드에서 이메일 서버가 공용이 아니며, 즉 내부 네트워크에 있고, StartTLS 또는 SSL/TLS 를 보안 방법으로 선택한 경우 이 필드에 자체 서명된 이메일 서버 인증서를 붙여넣습니다. Fuse Online은 서버 인증서가 필요하고 지정하지 않은 경우 이 연결을 확인할 수 없습니다.
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 필요에 따라 구성 세부 정보를 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
Obtain 정보 이메일을입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
회사 이메일 서버에 연결을 입력하여 info@ourcompany.com로 보낸 메시지를 가져옵니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력했으면 Obtain Info Emails 가 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
8.2. SMTP 이메일 서버에 대한 연결 생성
이메일을 보내기 위해 SMTP 이메일 서버에 연결하도록 통합 흐름을 편집하려면 SMTP 이메일 서버에 대한 연결을 만들어야 합니다.
사전 요구 사항
이 연결에 액세스하는 이메일 서버에 대해 잘 알고 있어야 합니다. 구체적으로는 다음을 알아야 합니다.
- 인증 자격 증명이 필요한지 여부입니다. 사용자 이름 및 암호가 있어야 합니다.
- 보안 방법이 구현되었는지 여부입니다. 하나가 있는 경우 어떤 방법을 알아야 합니다.
- 서버 인증서가 필요한지 여부입니다. 이 경우 지정할 수 있어야 합니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 생성 을 클릭하여 Fuse Online 커넥터를 표시합니다.
- Send email connector를 클릭합니다.
연결을 구성합니다.
- Email Host Name 필드에 이메일 서버 호스트 이름, 가상 호스트 이름 또는 IP 주소를 입력합니다.
- Email Server Port Number 필드에 이메일 서버가 수신 대기하는 포트 번호를 입력합니다.
사용자 이름 필드에서 이 연결에 액세스할 수 있는 권한이 있는 이메일 계정의 사용자 이름을 지정합니다. 통합 실행 중에 이 이메일 계정을 사용하여 메시지를 보냅니다.
이메일 서버가 액세스를 인증하지 않는 경우는 거의 없습니다. 이 경우 사용자 이름 및 암호 사양이 필요하지 않습니다.
- 암호 필드에서 이 연결에 액세스할 수 있는 권한이 있는 이메일 계정의 암호를 지정합니다.
- 선택 사항: 보안 방법 필드에서 이메일 서버가 보안 방법을 구현하는 경우 StartTLS 또는 SSL/TLS 를 선택합니다.
- 선택 사항: 서버 인증서 필드에서 이메일 서버가 공용이 아니며, 즉 내부 네트워크에 있고, StartTLS 또는 SSL/TLS 를 보안 방법으로 선택한 경우 이 필드에 자체 서명된 이메일 서버 인증서를 붙여넣습니다. Fuse Online은 서버 인증서가 필요하고 지정하지 않은 경우 이 연결을 확인할 수 없습니다.
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 필요에 따라 구성 세부 정보를 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어, Lead
에 이메일 보내기를 입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
회사 이메일 서버에 연결을 입력하여 info@ourcompany.com에서 메시지를 보냅니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 Send Emails to Leads 가 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
8.3. 통합 실행을 트리거하기 위한 이메일 가져오기
이메일 수신 시 통합 실행을 트리거하려면 Cryostat 또는 POP3 이메일 서버 연결을 간단한 통합 시작 연결로 추가합니다.
사전 요구 사항
- email을 가져올 계정에 액세스하도록 구성된 Cryostat 또는 POP3 이메일 서버 연결을 생성했습니다.
- 메시지를 검색할 폴더의 이름을 알고 있습니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 통합을 시작하는 데 사용할 이메일 서버 연결을 클릭합니다.
- 작업 선택 페이지에서 이메일 수신 페이지를 선택하여 연결이 액세스할 수 있는 권한이 부여된 이메일 계정에서 정기적으로 메시지를 검색합니다.
작업을 구성합니다.
받은 편지함에서 이메일을 얻으려면 폴더 필드를 비워 둡니다. 또는 특정 폴더에서 메시지를 가져오려면 해당 폴더의 이름을 입력합니다.
이 연결이 POP3 이메일 서버에 액세스하는 경우 Inbox 또는 Sent 와 같은 표준 폴더만 지원됩니다.
- 이메일 서버에서 읽지 않은 것으로 표시된 메시지만 가져오려면 Unseen Only 확인란을 선택합니다.
- Delay 필드에서 메시지를 폴링하는 시간으로 기본값인 5초를 수락합니다. 또는 다른 폴링 간격을 지정하려면 번호를 입력하고 시간 단위를 선택합니다.
최대 이메일 필드에 폴링 작업에서 반환할 수 있는 가장 큰 메시지 수를 입력합니다. 기본값은 5입니다. 받은 편지함 또는 폴더에 반환할 수 있는 최대 메시지 수보다 많은 경우 연결에서 Maximum Emails 에 대해 설정된 수까지 가장 오래된 메시지를 반환합니다.
각 폴링을 얻으려면 최대 이메일을
-1로 설정합니다.- Unseen Only 가 선택된 경우 지정된 폴더의 모든 새 메시지입니다.
- Unseen Only 가 선택되지 않은 경우 지정된 폴더의 모든 메시지가 선택되어 있지 않습니다.
- 다음을 클릭합니다.
결과
연결은 통합 흐름 시작 부분에 나타납니다. 실행하는 동안 폴링에서 이메일을 반환하는 경우 연결은 메시지를 통합의 다음 단계로 전달합니다. 설문 조사에서 이메일을 반환하지 않으면 통합이 계속 실행되지만 Fuse Online에서는 통합 단계가 트리거되지 않습니다.
예제
다음과 같이 구성된 수신자 이메일 작업을 고려하십시오.
- 연결이 상자를 폴링하도록 Folder 필드가 비어 있습니다.
- 보이지 않는 유일한 항목이 선택됩니다.
- Delay (5초) 및 최대 이메일 (5)의 기본값이 허용됩니다.
다음 폴링 전에 지연하는 동안 10 개의 메시지가 받은 편지함에 도착한다고 가정합니다. 연결에서 가장 오래된 5개의 메시지를 반환합니다. 다음 폴링에서는 5초 후 연결이 다른 5개의 메시지를 반환합니다. 새 메시지가 도착하더라도 최대 이메일에 대해 설정된 수보다 더 많은 메시지가 있는 경우 연결에 가장 오래된 메시지를 반환하기 때문입니다.
8.4. 통합에서 이메일 전송
흐름 중에 또는 간단한 통합을 완료하기 위해 메시지를 보내는 이메일 서버 연결을 추가할 수 있습니다.
사전 요구 사항
- 메시지를 보낼 계정에 액세스하도록 구성된 SMTP 이메일 서버 연결을 생성했습니다.
- Fuse Online에서는 통합에 추가하거나 간단한 통합을 위한 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 메시지를 보내는 데 사용할 이메일 서버 연결을 클릭합니다.
- 이메일 전송 작업을 선택합니다.
- Email from 필드에 메시지를 보내는 이메일 주소를 입력합니다. 이는 이전 통합 단계의 이메일 주소를 이 연결에 매핑하는 데이터 매퍼 단계를 추가하려는 경우에도 필요합니다.
권장 사항: 다음 필드 각각에 값을 지정합니다. 여러 이메일 주소를 쉼표로 구분합니다.
- 이메일 주소
- 이메일 제목
- 이메일 텍스트
- 이메일 cc
- 이메일 bcc
Parameter Priority 필드에서 Input Values 를 수락하거나 Consumed Data 를 선택합니다. 다음 중 우선순위가 있는 것이 결정됩니다.
- 이 작업 구성의 입력 값
- 이 연결에 매핑되는 데이터 값
권장 사항은 사용 데이터를 선택하는 것입니다. 즉, 여기에서 이메일 필드에 지정하는 값은 기본값으로 사용됩니다.
- 다음을 클릭하여 흐름에 연결을 추가합니다.
결과
연결은 이를 추가한 통합 흐름에 표시됩니다.
다음 단계
흐름에 대한 연결에 필요한 다른 모든 항목을 추가합니다. 그런 다음 이메일을 보내는 연결 앞에 데이터 매퍼 단계를 추가합니다. 데이터 매퍼 단계에서 소스 필드를 대상 필드에 매핑하여 이메일을 보냅니다.
9장. FHIR에 연결
FHIR(Quality Interoperability Resources)는 의료 데이터를 교환하기 위한 표준입니다. 통합에서는 하나 이상의 FHIR 리소스를 얻거나, 리소스를 생성하거나 업데이트하거나, 리소스에서 하나 이상의 필드를 업데이트하거나, 트랜잭션을 사용하여 여러 리소스를 생성할 수 있습니다. 이렇게 하려면 흐름 중간 또는 간단한 통합의 완료 연결로 FHIR 연결을 추가합니다.
FHIR에 대한 Fuse 온라인 연결:
- OAuth(기본 또는 전달자 토큰) 인증을 사용하는 FHIR 서버와 통신할 수 있습니다.
- FHIR DSTU3을 준수하는 모든 FHIR 리소스에서 작동할 수 있습니다.
- 리소스에 사용자 지정 데이터를 저장할 수 있는 확장 프로그램에서 작동할 수 없습니다. 확장 기능이 FHIR 서버에서 수신되는 데이터에 있는 경우 통합은 자동으로 이를 무시합니다.
데이터 매퍼 단계에서 FHIR에 연결하는 통합에서는 FHIR 목록 필드에 대해 하나의 수준의 깊이만 매핑할 수 있습니다. 즉, FHIR 목록에 목록이 포함된 경우 중첩된 목록의 필드를 매핑할 수 없습니다. 이 제한을 완화하기 위해 Fuse Online은 일부 FHIR 리소스 목록 필드를 단일 값 필드로 변환합니다. 예를 들어 목록 필드에 있는 주소가 데이터 매퍼에 단일 필드로 표시될 수 있습니다.
FHIR에 연결하기 위한 세부 사항은 다음과 같습니다.
9.1. FHIR 서버에 대한 연결 생성
통합에서 FHIR 리소스에서 작동하려면 FHIR 서버에 대한 연결을 만든 다음 흐름 중간 또는 간단한 통합의 완료 연결로 해당 연결을 추가합니다.
FHIR 연결은 간단한 통합의 시작 연결이 될 수 없습니다. 그러나 주기적으로 FHIR 연결을 트리거하는 타이머와 간단한 통합을 시작할 수 있습니다.
사전 요구 사항
- 연결하려는 FHIR 서버의 URL을 알아야 합니다.
- FHIR 서버에 액세스하기 위한 권한 부여 자격 증명이 있어야 합니다. 이 파일은 FHIR 서버 관리자에서 가져와야 합니다. FHIR 서버에는 인증이 필요하지 않으며 인증 정보를 지정하지 않고 연결을 생성할 수 있습니다. 예를 들어, 공용 FHIR 서버 또는 사설 네트워크의 FHIR 서버는 인증이 필요하지 않을 수 있습니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 커넥터를 표시합니다.
FHIR 커넥터를 클릭하고 다음과 같이 연결을 구성합니다.
- FHIR 버전 필드에서 필요한 DSTU3 을 수락합니다.
-
FHIR 서버 URL 필드에 액세스하려는 FHIR 서버의 URL을 입력합니다. 통합을 생성하는 동안 기본 테스트 서버
http://fhirtest.uhn.ca/baseDstu3를 허용할 수 있습니다. - FHIR 서버 사용자 이름 필드에 사용자 이름을 입력합니다. 이는 기본 인증을 사용하는 FHIR 서버에 필요합니다.
- FHIR 서버 암호 필드에 기본 인증을 사용하는 FHIR 서버에서 요구하는 암호를 입력합니다.
- FHIR 서버 전달자 토큰 필드에 토큰 을 입력합니다. 이는 OAuth 인증을 사용하는 FHIR 서버에 필요합니다.
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 입력 매개 변수를 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어,
FHIR West를 입력할 수 있습니다. - 설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다.
- 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 FHIR West 가 통합에 추가하도록 선택할 수 있는 연결로 표시됩니다.
9.2. FHIR 서버에서 리소스 가져오기
통합에서는 사용자가 지정하는 유형의 하나의 리소스를 가져올 수 있습니다. 이렇게 하려면 흐름 중앙에 FHIR 연결을 추가합니다.
사전 요구 사항
- 가져올 리소스가 있는 FHIR 서버에 대한 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다.
- 가져올 리소스에 액세스할 수 있는 FHIR 연결을 클릭합니다.
- 작업 선택 페이지에서 읽기 를 선택합니다.
- 리소스 유형 필드를 클릭하여 FHIR 리소스 유형 목록을 표시합니다. 가져올 리소스 유형을 선택하거나 입력합니다.
Contained Resource Types 필드에서 원하는 리소스 유형에 다른 리소스 유형이 포함된 경우 선택합니다. 둘 이상의 키를 선택해야 하는 경우 Ctrl 키를 사용합니다.
포함된 리소스 유형을 식별하면 데이터 매퍼에서 포함된 리소스에 있는 필드를 표시할 수 있습니다. 포함된 리소스 유형을 지정하지 않으면 포함된 리소스에 있는 필드에서 매핑할 수 없습니다. 실제로 포함되지 않은 리소스를 선택하는 데는 문제가 없습니다.
- 리소스 ID 필드에 원하는 리소스의 ID를 입력합니다. 또는 흐름에 있는 이전 단계에서 매핑하려는 경우 이 필드를 비워 둡니다.
- 리소스 버전 필드에서 필요한 경우 리소스의 버전 ID를 지정합니다. 이 필드를 비워 두면 가장 최신 버전의 리소스를 가져오거나 이전 단계에서 가져올 리소스의 버전 ID를 매핑합니다.
- 다음을 클릭하여 이 연결을 흐름에 추가합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다. 이 연결은 실행 중에 하나의 리소스를 반환합니다.
다음 단계
Resource Id 필드 또는 리소스 버전 필드에 값을 매핑하려면 이 연결 전에 데이터 매퍼 단계를 추가합니다.
9.3. 리소스에 대한 FHIR 서버 쿼리
통합에서는 FHIR 서버를 쿼리하여 지정한 쿼리를 충족하는 특정 FHIR 리소스의 인스턴스를 가져올 수 있습니다. 예를 들어, 65세 이상의 모든 환자들이 결핵을 받을 수 있는지 확인하고자 한다고 가정해 보겠습니다. 1955 년 이전에 태어 났던 환자의 리소스를 얻는 쿼리를 지정합니다. 이렇게 하려면 흐름 중앙에 FHIR 연결을 추가합니다.
사전 요구 사항
- 가져올 리소스가 있는 FHIR 서버에 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다.
- 가져올 리소스가 있는 FHIR 연결을 클릭합니다.
- 작업 선택 페이지에서 검색을 선택합니다.
- 리소스 유형 필드를 클릭하여 FHIR 리소스 유형 목록을 표시합니다. 가져올 리소스 유형을 선택하거나 입력합니다.
- 쿼리 필드에서 FHIR 쿼리를 지정하거나 이 필드를 비워서 이전 단계의 쿼리를 매핑합니다. FHIR 쿼리 형성에 대한 자세한 내용은 FHIR Release 3 검색을 참조하십시오.
- 다음을 클릭하여 이 연결을 흐름에 추가합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다. 이 연결은 사용자가 지정한 쿼리를 충족하는 리소스 목록을 반환합니다. Fuse Online에서는 이 목록을 컬렉션으로 처리합니다.
다음 단계
쿼리를 지정하지 않은 경우 이 연결 전에 데이터 매퍼 단계를 추가하고 쿼리를 이 연결에 매핑합니다. 반환된 목록 컬렉션이 아닌 개별 반환된 리소스에서 작동하려면 이 연결 후 흐름에 분할 단계를 추가합니다.
9.4. FHIR 서버에서 리소스 생성
통합에서는 리소스를 생성하고 FHIR 서버에 추가할 수 있습니다. 연결의 생성 작업을 구성할 때 생성할 리소스 유형을 지정합니다. 예를 들어 FHIR 서버에 새 환자 리소스를 추가할 수 있습니다. 리소스를 만들려면 흐름 중간에 FHIR 연결을 추가하거나 간단한 통합의 완료 연결로 추가합니다.
새 리소스의 값을 채우려면 이 절차에 추가하는 FHIR 연결 직전에 데이터 매퍼 단계를 흐름에 추가합니다. 흐름의 이전 단계에서 새 리소스를 포함할 데이터를 제공해야 합니다. 이전 단계의 필드를 이 FHIR 연결이 생성하는 대상 리소스의 필드에 매핑합니다. 새 리소스에는 매핑할 필드만 포함됩니다.
연결에서 FHIR 서버에서 새 리소스를 생성하는 생성 작업을 수행하면 새 리소스에 자동으로 생성된 FHIR 리소스 ID가 있습니다. 새 리소스의 리소스 ID를 지정하려면 Create 작업을 선택하는 대신 수행할 연결에 대한 Update 작업을 선택합니다.
사전 요구 사항
- 리소스를 추가할 FHIR 서버에 대한 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 추가하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 리소스를 추가할 서버에 대한 FHIR 연결을 클릭합니다.
- 작업 선택 페이지에서 만들기 를 선택합니다.
- 리소스 유형 필드를 클릭하여 FHIR 리소스 유형 목록을 표시합니다. 생성할 리소스 유형을 선택하거나 입력합니다.
Contained Resource Types 필드에서 생성할 리소스 유형에 다른 리소스 유형이 포함된 경우 선택합니다. 둘 이상의 키를 선택해야 하는 경우 Ctrl 키를 사용합니다.
포함된 리소스 유형을 식별하면 데이터 매퍼에서 포함된 리소스에 있는 필드를 표시할 수 있습니다. 포함된 리소스 유형을 지정하지 않으면 포함된 리소스에 있는 필드에 매핑할 수 없습니다. 실제로 포함되지 않은 리소스를 선택하는 데는 문제가 없습니다.
- 다음을 클릭하여 이 연결을 흐름에 추가합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다. 실행하는 동안 연결은 FHIR 서버에 새 리소스를 생성합니다. 연결은 id.idPart 필드를 포함하는 MethodOutcome 리소스를 반환합니다. 이 필드에는 흐름의 후속 단계에 매핑할 수 있는 새 리소스의 리소스 ID가 포함되어 있습니다.
다음 단계
이 흐름에 새 리소스가 포함할 데이터를 얻기 위해 추가 단계가 필요한 경우 이 FHIR 연결 전에 추가합니다. 이러한 단계를 수행한 후 새 리소스를 생성하는 FHIR 연결 직전에 데이터 매퍼 단계를 흐름에 추가합니다. 데이터 매퍼 단계에서 생성할 리소스의 필드에 매핑합니다.
새 리소스를 생성하는 FHIR 연결 직전에 데이터 매퍼 단계가 없으면 연결은 빈 리소스를 만들려고 합니다. FHIR 서버 구성에 따라 이 기능이 작동하지 않거나 작동하지 않을 수 있습니다.
9.5. FHIR 서버의 리소스의 모든 필드 업데이트
통합에서는 FHIR 서버에 있는 리소스를 업데이트할 수 있습니다. 업데이트된 값을 제공하려면 리소스를 업데이트하는 FHIR 연결 직전에 데이터 매퍼 단계를 흐름에 추가합니다. 흐름의 이전 단계에서 업데이트된 리소스에 포함할 데이터를 제공해야 합니다. 이전 단계의 필드를 이 FHIR 연결이 업데이트되는 대상 리소스의 필드에 매핑합니다.
업데이트된 리소스에는 매핑할 필드만 포함됩니다. 즉, 값이 변경되는 필드를 매핑하는 것 외에도 리소스에 있을 필드와 값이 변경되지 않는 필드를 매핑해야 합니다. 특정 리소스 필드를 매핑하지 않으면 연결은 업데이트된 리소스에서 해당 필드를 삭제합니다.
이전 단계의 리소스 ID를 이 연결의 리소스 ID에 매핑해야 합니다. 연결이 변경되지 않는 유일한 리소스 필드입니다. FHIR 서버에 업데이트할 리소스의 리소스 ID가 있는 리소스가 아직 없는 경우 연결은 해당 리소스 ID로 새 리소스를 생성합니다. 선택한 리소스 ID가 있는 새 리소스를 추가할 수 있는 유일한 방법입니다.
리소스를 업데이트하거나 생성하려면 흐름 중간 또는 간단한 통합의 완료 연결로 FHIR 연결을 추가합니다.
사전 요구 사항
- 리소스를 업데이트하거나 생성하려는 FHIR 서버에 대한 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 추가하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- FHIR 서버에서 리소스를 업데이트하는 데 사용할 FHIR 연결을 클릭합니다.
- 작업 선택 페이지에서 업데이트를 선택합니다.
- 리소스 유형 필드를 클릭하여 FHIR 리소스 유형 목록을 표시합니다. 업데이트 또는 생성할 리소스 유형을 선택하거나 입력합니다.
Contained Resource Types 필드에서 업데이트 또는 생성하려는 리소스 유형이 다른 리소스 유형을 포함하는 경우 선택합니다. 둘 이상의 키를 선택해야 하는 경우 Ctrl 키를 사용합니다.
포함된 리소스 유형을 식별하면 데이터 매퍼에서 포함된 리소스에 있는 필드를 표시할 수 있습니다. 포함된 리소스 유형을 지정하지 않으면 포함된 리소스에 있는 필드에 매핑할 수 없습니다. 실제로 포함되지 않은 리소스를 선택하는 데는 문제가 없습니다.
- 다음을 클릭하여 이 연결을 흐름에 추가합니다.
- 업데이트된 리소스를 가져올 데이터를 얻기 위해 이 흐름에 추가 단계가 필요한 경우 이 FHIR 연결 전에 추가합니다.
- 통합 시각화에서 리소스를 업데이트하는 FHIR 연결 전에 더하기 기호를 클릭합니다.
- 데이터 매퍼 를 클릭합니다.
데이터 매퍼에서 다음을 수행합니다.
- 리소스 ID를 대상 리소스 ID에 매핑합니다. 이는 새 리소스의 리소스 ID를 지정하는 유일한 방법입니다.
- 업데이트 또는 새 리소스를 포함할 각 리소스 필드에 매핑됩니다. 값이 변경되지 않은 필드와 값을 업데이트해야 하는 필드를 매핑해야 합니다.
- Done 을 클릭하여 데이터 매퍼 단계를 흐름에 추가합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다. 실행 중에 연결은 FHIR 서버에서 리소스를 업데이트하거나 만들고 id.idPart 필드를 포함하는 MethodOutcome 리소스를 반환합니다. 이 필드에는 업데이트/생성된 리소스의 ID가 포함되어 있으며 흐름의 후속 단계에 매핑할 수 있습니다.
9.6. FHIR 서버의 리소스에서 지정된 필드 업데이트
통합에서는 FHIR 서버에 있는 리소스에서 개별 필드를 업데이트할 수 있습니다. 이렇게 하려면 흐름 중간 또는 간단한 통합의 완료 연결로 FHIR 연결을 추가합니다.
사전 요구 사항
- 업데이트하려는 리소스가 있는 FHIR 서버에 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 리소스를 업데이트하는 데 사용할 FHIR 연결을 클릭합니다.
- 작업 선택 페이지에서 패치 를 선택합니다.
- 리소스 유형 필드를 클릭하여 FHIR 리소스 유형 목록을 표시합니다. 업데이트할 필드가 있는 리소스 유형을 선택하거나 입력합니다.
- Number of Operations 필드에서 업데이트할 필드 수를 지정합니다.
- 일반적으로 수행할 작업인 흐름의 이전 단계의 값을 매핑하려면 리소스 ID 필드를 비워 둡니다. 그렇지 않으면 업데이트할 필드가 있는 리소스의 리소스 ID를 지정합니다.
업데이트를 설명하는 JSON 패치를 지정합니다. JSON 패치에는 JSON 패치란 무엇입니까? 에 설명된 형식이 있어야 합니다.
Patient리소스에 대한 패치의 예:활성필드를true로 설정합니다.[{ "op":"replace", "path":"/active", "value": true }]환자
이름 배열인 이름필드의 값을 바꿉니다. 이 경우 환자의 이름은 한 가지입니다. 환자의 이름이 두 개 이상인 경우 유사하게 포맷된 패치는 모든 환자 이름을 대체할 수 있습니다.[{ "op":"replace", "path":"/name", "value": [{"given": ["Bob"]}] }]환자의 이름을 변경합니다.
[{ "op":"replace", "path":"/name/0/given/0", "value": "John" }]이름 앞에 다른 이름을 추가합니다.
[{ "op":"add", "path":"/name/0", "value": {"given": ["Anthony"]} }]일부 업데이트의 경우 Patch 작업을 구성할 때 JSON 패치를 지정해야 합니다. 예를 들어 리소스 필드의 값을 다른 필드에 복사하려는 경우입니다. 다른 업데이트의 경우 JSON Patch 필드를 비워 두고 대신 각 업데이트를 정의하는 맵 값을 유지할 수 있습니다.
- 다음을 클릭하여 이 연결을 흐름에 추가합니다.
JSON 패치 및/또는 리소스 ID를 지정하지 않은 경우 데이터 매퍼 단계를 추가합니다.
- 흐름 시각화에서 방금 추가한 FHIR 연결 앞에 있는 더하기 기호를 클릭합니다.
데이터 매퍼 를 클릭합니다.
대상 패널에 업데이트하려는 각 필드에 대해 번호가 지정된 폴더가 표시됩니다. Patch 작업을 구성할 때 업데이트할 필드 수를 지정했습니다. 데이터 매퍼는 대상 패널에 이 폴더 수를 표시합니다. 예를 들어 업데이트할 필드 수로 3을 지정하면 레이블
1,2및3이 있는 세 개의 대상 폴더가 표시됩니다.업데이트할 각 필드에 대해 하나의 대상 폴더의 필드에 매핑합니다.
-
대상 패널에서 폴더를 확장하여
op,path,value에 대한 세 개의 필드를 표시합니다. -
소스 필드, 상수 또는 속성을 대상
경로필드에 매핑합니다. 경로는 업데이트할 리소스 필드를 식별합니다. 경로 값에서 숫자는 목록 필드의 인덱스를 나타내며 슬래시는 자식 필드로 이어집니다. 예를 들어 이 경로/name/1/given/1/value를 매핑하여 지정된 이름 필드의 값을 업데이트합니다. -
필드의 현재 값을 대체하는 기본 업데이트 작업을 수락하거나 소스 필드, 상수 또는 속성을
op필드에 매핑하여 필드를 업데이트하려는 방법을 나타냅니다. 가능한 작업에 대한 자세한 내용은 JSON 패치 작업을 참조하십시오. -
새 값을 갖도록 필드를 업데이트하는 경우 소스 필드, 상수 또는 속성을 대상
값에매핑합니다. 필드에 포함할 새 값입니다.
-
대상 패널에서 폴더를 확장하여
- Patch 작업을 구성할 때 리소스 ID를 지정하지 않은 경우 리소스 ID를 대상 ID 필드에 매핑 합니다.
- Done 을 클릭하여 데이터 매퍼 단계를 흐름에 추가합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다. 실행하는 동안 연결은 지정된 리소스 필드를 업데이트하고 id.idPart 필드를 포함하는 MethodOutcome 리소스를 반환합니다. 이 필드에는 업데이트된 리소스의 ID가 포함되어 있습니다.
9.7. FHIR 서버에서 다양한 유형의 리소스 생성
통합에서는 FHIR 서버에서 두 개 이상의 리소스를 생성할 수 있으며 각 리소스는 다른 유형일 수 있습니다. 예를 들어 FHIR 서버에 하나의 연결에 새 환자 리소스와 새 공급자 리소스를 추가할 수 있습니다. 이렇게 하려면 흐름 중간에 FHIR 연결을 추가하거나 간단한 통합의 완료 연결로 추가합니다.
사전 요구 사항
- 리소스를 추가할 FHIR 서버에 대한 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 생성에 사용할 FHIR 연결을 클릭하고 FHIR 서버에 새 리소스를 추가합니다.
- 작업 선택 페이지에서 트랜잭션 을 선택합니다.
- 포함 리소스 유형 필드에서 이 연결이 생성하는 리소스 유형을 선택합니다. Ctrl 키를 사용하여 여러 리소스 유형을 선택합니다. 연결에서는 선택한 유형마다 하나의 리소스를 생성합니다.
- 다음을 클릭하여 이 연결을 흐름에 추가합니다.
새 리소스에서 필드를 채우려면 이 연결 전에 데이터 매퍼 단계를 추가합니다.
- 흐름 시각화에서 방금 추가한 연결 앞에 있는 더하기 기호를 클릭합니다.
- 데이터 매퍼 를 클릭합니다.
- 데이터 매퍼에서 소스 필드를 대상 리소스 필드에 매핑합니다. 새 리소스에는 매핑 대상 필드만 포함됩니다.
- 다음을 클릭하여 데이터 매퍼 단계를 흐름에 추가합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다. 실행 중에 연결은 FHIR 서버에 모든 리소스를 추가하거나 오류가 있는 경우 연결에서 FHIR 서버에 리소스를 추가하지 않습니다. 성공적인 작업은 각 새 리소스의 리소스 ID를 포함하는 트랜잭션 리소스를 반환합니다. 이러한 리소스 ID를 흐름의 후속 단계에 매핑할 수 있습니다.
9.8. FHIR 서버에서 리소스 삭제
통합에서는 FHIR 서버에서 리소스를 삭제할 수 있습니다. 이렇게 하려면 흐름 중간 또는 간단한 통합의 완료 연결로 FHIR 연결을 추가합니다.
사전 요구 사항
- 삭제할 리소스가 있는 FHIR 서버에 대한 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 리소스를 삭제하는 데 사용할 FHIR 연결을 클릭합니다.
- 작업 선택 페이지에서 삭제 를 선택합니다.
- 리소스 유형 필드를 클릭하여 FHIR 리소스 유형 목록을 표시합니다. 삭제할 리소스 유형을 선택하거나 입력합니다.
- Resource Id 필드에서 통합의 이전 단계에서 리소스 ID를 매핑하려는 경우 삭제하려는 리소스의 리소스 ID를 지정하거나 이 필드를 비워 둡니다.
- 리소스 버전 필드에서 필요한 경우 리소스의 버전 ID를 지정합니다. 이 필드를 비워 두면 최신 버전의 리소스를 삭제하거나 이전 단계에서 삭제하려는 리소스의 버전 ID를 매핑합니다.
- 다음을 클릭하여 이 연결을 흐름에 추가합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다. 실행 중에 연결은 FHIR 서버에서 지정된 리소스를 삭제하고 id.idPart 필드를 포함하는 MethodOutcome 리소스를 반환합니다. 이 필드에는 삭제된 리소스의 리소스 ID가 포함되어 있습니다.
다음 단계
Resource Id 필드 또는 리소스 버전 필드에 값을 매핑하려면 이 연결 전에 데이터 매퍼 단계를 추가합니다.
10장. FTP 또는 SFTP 서버에 연결
통합에서는 FTP 또는 SFTP 서버에 연결하여 파일을 다운로드하거나 업로드할 수 있습니다. 이렇게 하려면 FTP 또는 SFTP 연결을 생성한 다음 통합 흐름에 추가합니다.
통합의 첫 번째 단계에서는 Apache Camel File Language 표현식으로 정의된 파일을 다운로드할 수 있습니다.
통합의 중간 단계 또는 마지막 단계의 경우 Apache Camel File Language 표현식으로 정의한 파일을 업로드할 수 있습니다. FTP 서버의 경우에만 이름이 지정된 파일을 다운로드하거나 업로드할 수 있습니다(통합의 이전 단계에서 파일 이름이 제공됨).
다음 주제에서는 세부 정보를 제공합니다.
10.1. FTP 또는 SFTP 연결 생성
통합에서/에서 FTP 또는 SFTP 서버에 파일을 다운로드하거나 업로드하려면 해당 FTP 또는 SFTP 서버에 대한 연결을 만듭니다. 통합에 동일한 연결을 추가할 수 있습니다.
사전 요구 사항
연결할 서버의 호스트 이름을 알아야 합니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 생성 을 클릭하여 Fuse Online 커넥터를 표시합니다.
파일 전송 프로토콜을 사용하는 연결을 만들려면 FTP 커넥터를 클릭합니다.
또는 Secure File Transfer Protocol을 사용하는 연결을 생성하려면 SFTP 커넥터를 클릭합니다.
연결을 구성합니다.
FTP 연결의 경우:
-
host 는 지정해야 하는 유일한 매개변수입니다. 연결할 서버의 호스트 이름을 입력합니다. 예를 들어 FTP 호스트의 이름이
FTP.WEST인 경우FTP.WEST임을 정확히 입력합니다. 예를 들어 프로토콜을 지정하지 마십시오.ftp://FTP.WEST. -
port 는 필수이며 기본값은
21입니다. FTP 서버가 수신 대기 중인 포트입니다. - 다른 모든 매개변수는 필요하지 않거나 기본값이 있습니다. 기본값은 대부분의 통합에 적합합니다. 이러한 매개변수에 대한 설명은 이 절차 뒤에 있습니다.
-
host 는 지정해야 하는 유일한 매개변수입니다. 연결할 서버의 호스트 이름을 입력합니다. 예를 들어 FTP 호스트의 이름이
SFTP 연결의 경우 다음 매개변수에 대한 값이 있어야 합니다.
-
host는 연결할 SFTP 서버의 호스트 이름입니다. 예를 들어 SFTP 호스트의 이름이
SFTP.EAST인 경우SFTP.EAST를 정확하게 입력합니다. 예를 들어 다음과 같은 프로토콜을 지정하지 마십시오:sftp://SFTP.EAST. -
port 의 기본값은
22입니다. SFTP 서버가 수신 대기 중인 포트입니다. - SFTP 서버에 액세스하는 데 사용할 계정의 사용자 이름입니다.
- 해당 사용자 이름과 연결된 암호 입니다.
- 다른 모든 매개 변수에는 기본값이 있습니다. 기본값은 대부분의 통합에 적합합니다. 이러한 매개변수에 대한 설명은 이 절차 뒤에 있습니다.
-
host는 연결할 SFTP 서버의 호스트 이름입니다. 예를 들어 SFTP 호스트의 이름이
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 필요에 따라 구성 세부 정보를 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
XLight FTP Server를 입력합니다. - 설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다.
- 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력한 경우 XLight FTP Server 가 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
다른 매개변수에 대한 설명
- 연결 제한 시간은 기본값은 10000 밀리초이며 연결을 설정하는 데 최대 10초의 대기 시간을 나타냅니다. 연결 없이 10초가 경과하면 Fuse Online은 Reconnect 지연으로 정의된 밀리초 동안 기다린 다음 다시 연결을 시도합니다.
- 지연 을 다시 연결하면 기본값은 1000 밀리초이며 다시 연결을 시도하기 전에 대기 시간을 나타냅니다.
- 최대 다시 연결 시도 의 기본값은 3 입니다. Fuse Online은 최대 3회 연결을 시도합니다.
- 바이너리 파일 전송 모드는 기본적으로 사용됩니다. ASCII 전송 모드에 대해 아니요 를 선택합니다.
- 패시브 연결 모드는 기본적으로 예, 일반적으로 기본 모드입니다. Passive 모드에서 클라이언트는 방화벽 문제를 방지하기 위해 서버와의 통신 채널을 엽니다. 아니요 를 선택하면 활성 모드가 사용됩니다.
- 사용 후 서버에서 연결을 끊은 후 기본값은 No 입니다. 연결은 작업을 수행한 후 설정된 상태로 유지됩니다. 연결에서 업로드 또는 다운로드를 수행한 후 서버에서 연결을 끊려는 경우 Yes 를 선택합니다.
- 데이터 시간 제한은 기본적으로 30000 밀리초이며 Fuse Online에서 응답을 기다리는 최대 시간을 나타냅니다.
10.2. FTP 또는 SFTP 서버에서 파일 가져오기
FTP 또는 SFTP 연결이 관심 있는 파일을 찾을 때 통합 실행을 트리거하려면 FTP 또는 SFTP 연결을 통합 시작 연결로 추가합니다.
사전 요구 사항
FTP 또는 SFTP 연결을 생성했습니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 FTP 또는 SFTP 서버를 폴링하는 데 사용할 FTP 또는 SFTP 연결을 클릭합니다.
- 작업 선택 페이지에서 다운로드를 선택합니다.
파일 이름 표현식 필드에 다운로드할 파일 또는 파일을 지정하는 Apache Camel File 언어 표현식을 입력합니다. (일반 표현식을 지정할 수 없습니다.)
예를 들어 FTP 서버의 특정 확장자가 있는 모든 파일을 필터링할 수 있습니다. 다음 예제에서는
.doc확장자가 있는 모든 파일을 지정합니다.'${file:onlyname.noext}.doc'FTP 디렉터리에 있는 모든 파일을 다운로드하려면 파일 이름 표현식 필드를 비워 둡니다.
런타임 시 연결에서 서버에서 파일 또는 파일을 폴링하고 찾으면 다운로드합니다.
- FTP 디렉토리 필드에 폴링할 서버 디렉터리의 절대 또는 상대 경로를 입력합니다. 이 연결은 이 디렉터리에서 모든 콘텐츠를 감시하고 콘텐츠를 찾을 때 모든 파일을 다운로드합니다.
- 폴링을 시작하기 전 Milliseconds에서 기본값 1000 밀리초를 수락하거나 밀리초 수를 변경합니다.
- 다음 폴링 필드 앞의 Milliseconds에서 기본값인 500 밀리초를 사용하거나 밀리초 수를 변경합니다. 폴링 간격입니다.
- 다운로드 후 삭제 필드의 기본값을 수락하거나 Yes 를 선택하여 파일을 다운로드한 다음 서버에서 삭제합니다.
- 다음을 클릭하여 작업의 출력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 출력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
통합 시각화가 시작될 때 연결이 나타납니다.
10.3. FTP 서버에서 이름이 지정된 파일 가져오기
통합에서는 흐름 중 FTP 서버에서 특정 파일을 다운로드하거나 간단한 통합을 완료할 수 있습니다. 이렇게 하려면 흐름 중 또는 간단한 통합의 완료 연결로 FTP 연결을 추가합니다.
사전 요구 사항
- FTP 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 파일을 다운로드하는 데 사용할 FTP 연결을 클릭합니다.
- 작업 선택 페이지에서 Download NamedFile 을 선택합니다.
- 다운로드 후 삭제 필드의 기본값을 수락하거나 예 를 선택하여 파일을 다운로드한 다음 서버에서 삭제합니다.
- FTP 디렉토리 필드에 서버 디렉터리의 절대 또는 상대 이름을 입력합니다. 런타임 시 연결은 이 디렉터리를 통해 이름이 지정된 파일을 감시하고 이를 찾을 때 다운로드합니다.
- 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
10.4. FTP 또는 SFTP 서버에 파일 업로드
통합에서는 흐름 중 FTP 또는 SFTP 서버에 파일을 업로드하거나 간단한 통합을 완료할 수 있습니다. 이렇게 하려면 흐름 중 또는 간단한 통합의 완료 연결로 FTP 또는 SFTP 연결을 추가합니다.
사전 요구 사항
- FTP 또는 SFTP 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 파일을 업로드하는 데 사용할 FTP 또는 SFTP 연결을 클릭합니다.
- 작업 선택 페이지에서 업로드 를 선택합니다.
파일 이름 표현식 필드에 업로드할 파일 또는 파일을 지정하는 Apache Camel File 언어 표현식을 입력합니다. (일반 표현식을 지정할 수 없습니다.)
예를 들어 FTP 서버의 특정 확장자가 있는 모든 파일을 필터링할 수 있습니다. 다음 예제에서는
.doc확장자가 있는 모든 파일을 지정합니다.'${file:onlyname.noext}.doc'FTP 디렉터리에 있는 모든 파일을 업로드하려면 파일 이름 표현식 필드를 비워 둡니다.
- FTP 디렉토리 필드에 서버 디렉터리의 절대 또는 상대 이름을 입력합니다. File name expression 필드에 표현식이 포함된 경우 연결에서 지정된 파일을 이 디렉터리에 저장합니다. 파일 이름 표현식 필드가 비어 있으면 연결이 이 디렉터리에 업로드되고 이전 단계에서 수신한 모든 파일이 업로드됩니다.
If file exists 필드에서 서버에 있는 파일과 동일한 경로 및 이름을 가진 파일을 업로드할 때 동작을 나타냅니다. 기본 Override Override를 수락하여 서버에 있는 파일을 업로드하는 파일로 덮어씁니다. 또는 다음 중 하나를 선택합니다.
- append 는 서버에 있는 파일에 업로드 중인 파일에 내용을 추가합니다.
-
fail throws
GenericFileOperationException. 통합이 오류 상태가 되지 않습니다. - 무시해 도 파일을 업로드하지 않습니다. 통합은 모든 것이 정상이라는 가정하에 계속 실행됩니다.
- move 는 파일 중 하나의 이름을 변경합니다.
- TryRename 은 임시 이름으로 파일을 업로드하고 파일 이름을 원하는 이름으로 변경합니다. 이 작업은 원하는 이름이 있는 파일이 있는지 확인하지 않으므로 대부분의 서버에서 존재 확인을 완료할 때보다 작업을 더 빠르게 수행할 수 있습니다.
- 필드를 복사하는 동안 임시 파일 접두사 에서 문자열을 지정합니다. 연결 앞에 이 문자열을 업로드할 때 파일 이름에 추가합니다. 이렇게 하면 서버에서 임시 파일에 대한 연결을 작성한 다음 해당 임시 파일의 이름을 올바른 이름으로 변경할 수 있습니다. 이 기능은 매우 큰 파일을 업로드할 때 잠금을 줄이는 데 유용합니다.
- 필드를 복사하는 동안 임시 파일 이름에 문자열을 지정합니다. 연결은 업로드되는 동안 이 이름을 갖도록 업로드 중인 파일의 이름을 바꿉니다. 이렇게 하면 서버에서 임시 파일에 대한 연결을 작성한 다음 해당 임시 파일의 이름을 올바른 이름으로 변경할 수 있습니다. 이 기능은 매우 큰 파일을 업로드할 때 잠금을 줄이는 데 유용합니다.
- 다음을 클릭하여 작업의 입력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 입력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
10.5. FTP 서버에 이름이 지정된 파일 업로드
통합에서는 흐름 중에 특정 파일을 FTP 서버에 업로드하거나 간단한 통합을 완료할 수 있습니다. 이렇게 하려면 흐름 중 또는 간단한 통합의 완료 연결로 FTP 연결을 추가합니다.
사전 요구 사항
- FTP 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 파일을 업로드하는 데 사용할 FTP 연결을 클릭합니다.
- 작업 선택 페이지에서 Upload NamedFile 을 선택합니다.
- FTP 디렉토리 필드에 서버 디렉터리의 절대 또는 상대 이름을 입력합니다. 런타임 시 연결은 이름이 지정된 파일(이전 단계에서 수신됨)을 이 디렉터리로 업로드합니다.
If file exists 필드에서 서버에 있는 파일과 동일한 경로 및 이름을 가진 파일을 업로드할 때 동작을 나타냅니다. 기본 Override Override를 수락하여 서버에 있는 파일을 업로드하는 파일로 덮어씁니다. 또는 다음 중 하나를 선택합니다.
- append 는 서버에 있는 파일에 업로드 중인 파일에 내용을 추가합니다.
-
fail throws
GenericFileOperationException. 통합이 오류 상태가 되지 않습니다. - 무시해 도 파일을 업로드하지 않습니다. 통합은 모든 것이 정상이라는 가정하에 계속 실행됩니다.
- move 는 파일 중 하나의 이름을 변경합니다.
- TryRename 은 임시 이름으로 파일을 업로드하고 파일 이름을 원하는 이름으로 변경합니다. 이 작업은 원하는 이름이 있는 파일이 있는지 확인하지 않으므로 대부분의 서버에서 존재 확인을 완료할 때보다 작업을 더 빠르게 수행할 수 있습니다.
- 필드를 복사하는 동안 임시 파일 접두사 에서 문자열을 지정합니다. 연결 앞에 이 문자열을 업로드할 때 파일 이름에 추가합니다. 이렇게 하면 서버에서 임시 파일에 대한 연결을 작성한 다음 해당 임시 파일의 이름을 올바른 이름으로 변경할 수 있습니다. 이 기능은 매우 큰 파일을 업로드할 때 잠금을 줄이는 데 유용합니다.
- 필드를 복사하는 동안 임시 파일 이름에 문자열을 지정합니다. 연결은 업로드되는 동안 이 이름을 갖도록 업로드 중인 파일의 이름을 바꿉니다. 이렇게 하면 서버에서 임시 파일에 대한 연결을 작성한 다음 해당 임시 파일의 이름을 올바른 이름으로 변경할 수 있습니다. 이 기능은 매우 큰 파일을 업로드할 때 잠금을 줄이는 데 유용합니다.
- 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
11장. Google 애플리케이션에 연결
통합은 Google 애플리케이션에 연결할 수 있습니다:업그레이드, Cryostat,합니다. 자세한 내용은 다음 항목을 참조하십시오.
11.1. Fuse Online을 Google 클라이언트 애플리케이션으로 등록
통합으로, BPG, Google Cryostat 또는 Google에 연결하려면 Fuse Online 환경을 Google 클라이언트 애플리케이션으로 등록해야 합니다. 등록하는 동안 Google API를 활성화하고 Fuse Online에서 활성화한 Google API에 액세스하는 데 사용하는 인증 정보를 생성합니다.
등록하면 controlPlane, Google Cryostat 및 Google에 대한 여러 연결을 만들 수 있습니다. 각 연결을 여러 통합에서 사용할 수 있습니다. Google 애플리케이션에 대한 각 연결은 등록 중에 얻는 동일한 Google 클라이언트 ID와 Google 클라이언트 시크릿을 사용할 수 있지만 각 연결은 사용자가 선택한 다른 Google 계정에 액세스할 수 있습니다.
이 절차에서는 GPO API, Google Cryostat API 및 Google의 API를 활성화하도록 지시합니다. 그러나 세 가지 API 모두 대신 필요한 API만 활성화할 수 있습니다. 나중에 활성화하지 않은 API가 있는 애플리케이션에 대한 연결을 생성해야 하는 경우 여기로 돌아가서 지침에 따라 API를 활성화할 수 있습니다.
Fuse Online용 새 Google 클라이언트 애플리케이션을 생성해야 합니다. Google이 새 클라이언트 애플리케이션에 제공하는 인증 정보에는 만료된 액세스 토큰을 새로 고치는 데 사용되는 새로 고침 토큰이 포함되어 있습니다. 이 새로 고침 토큰은 Fuse Online 클라이언트 애플리케이션에서 자격 증명을 처음 사용하는 경우에만 사용할 수 있습니다. Fuse Online에서는 모두 동일한 Google 클라이언트 ID와 Google 클라이언트 시크릿을 사용할 수 있습니다. 이 경우 Google 애플리케이션에 대한 모든 연결에 새로 고침 토큰을 사용할 수 있습니다. Fuse Online 사용자 인터페이스에서 연결 세부 정보를 볼 때 Validate 버튼을 클릭하지 마십시오. 검증은 자격 증명을 두 번째로 사용하며 새로 고침 토큰은 더 이상 클라이언트 인증 정보의 일부가 아닙니다. 그러나 Google 애플리케이션에 다시 연결할 수 있습니다.
개발 환경에서는 다른 비 Fuse Online, OAuth 클라이언트에 사용하는 Google 클라이언트 ID 및 Google 클라이언트 시크릿을 사용하도록 선택하는 경우 주의하십시오. Fuse Online에서는 첫 번째 OAuth 교환에서 요청된 오프라인 액세스가 필요합니다. 다른 OAuth 클라이언트가 이미 OAuth 교환에 입력되어 오프라인 액세스를 요청하지 않은 경우 Fuse Online은 후속 OAuth 교환에 대한 오프라인 액세스를 얻을 수 없습니다. 첫 번째 교환에서 오프라인 액세스가 요청되었는지 확실하지 않은 경우 Fuse Online용 새 Google 클라이언트 애플리케이션을 생성합니다.
사전 요구 사항
- Fuse Online을 Google 클라이언트 애플리케이션으로 등록하는 데 사용할 Google 계정에 로그인할 수 있어야 합니다.
절차
Fuse Online에서:
- 왼쪽 탐색 패널에서 설정을 클릭합니다.
-
설정 페이지에서 콜백 URL 오른쪽에 있는 상단에서
를 클릭하여 Fuse Online 환경의 콜백 URL을 클립보드에 복사합니다. 이 URL은 이 절차의 뒷부분에서 필요합니다.
다른 브라우저 탭에서
https://console.developers.google.com로 이동하여 다음을 수행합니다.Fuse Online을 Google 클라이언트 애플리케이션으로 등록하는 데 사용할 Google 계정에 로그인되어 있는지 확인합니다. 또는 다른 Google 계정을 선택하고 해당 계정에 로그인합니다.
현재 Google 프로젝트의 이름은 Google API 페이지 상단에 표시됩니다.
- 현재 프로젝트를 사용하여 Fuse Online에 권한을 부여하려면 다음 단계를 계속합니다. 다른 Google 프로젝트의 Fuse Online에 권한을 부여하려면 해당 프로젝트를 선택하거나 생성합니다. 이 Google 계정에 프로젝트가 아직 없는 경우 계정을 생성해야 합니다.
다음을 활성화하려는 각 Google API( Cryostat, everything 또는 Cryostat)에 대해 다음을 활성화합니다.
-
왼쪽 상단에서
을 클릭한 다음 API 및 서비스 > 라이브러리 를 선택합니다.
- 필요한 경우 아래로 스크롤하여 Google Workspace 카드 행을 확인합니다.
Google API 카드(calendar, everything , orCryostats ) 를클릭합니다.
Google API의 요약 페이지가 열립니다.
- Enable 을 클릭합니다. Google은 API를 활성화하고 API의 개요 페이지를 엽니다.
- 아래로 스크롤하여 Registry API 카드를 클릭하면 controlPlane API가 활성화되어 있음을 나타내는 페이지가 표시됩니다.
-
왼쪽 상단에서
클라이언트 애플리케이션에 이름을 지정합니다.
API 개요 페이지의 왼쪽 탐색 패널에서 인증 정보를 클릭한 다음 Configure Consent Screen 을 클릭합니다.
OAuth 승인 화면이 표시됩니다.
애플리케이션 이름 필드에서 외부 를 선택합니다.
참고: Google Workspace 사용자인 경우 Internal 를 대체할 수 있습니다.
- 생성을 클릭합니다.
-
Fuse Online 클라이언트 애플리케이션의 이름을 입력합니다. 예를 들어
Fuse Online 클라이언트 애플리케이션을입력합니다. - 다른 필드를 건너뜁니다.
- 저장을 클릭하고 계속 진행합니다.
- 범위 및 사용자 테스트 페이지에서 옵션을 건너뛰고 저장을 클릭하고 계속 진행합니다.
다음과 같이 클라이언트 애플리케이션 인증 정보를 가져옵니다.
- 자격 증명 생성 오른쪽에 있는 아래쪽 화살표를 클릭하여 메뉴를 표시하고 OAuth 클라이언트 ID 를 선택합니다.
- 표시되는 페이지에서 애플리케이션 유형에 대해 웹 애플리케이션을 선택합니다.
-
이름 필드에 Fuse Online 환경의 OAuth 클라이언트 ID의 이름을 입력합니다. 이는 클라이언트 애플리케이션 자체에 입력한 이름과 다릅니다. 예를 들어
Fuse Online의 OAuth 클라이언트 ID를입력합니다. - 인증된 JavaScript 출처를 건너뜁니다.
- Authorized redirect URIs 필드에 이 절차의 시작 부분에 Fuse Online 환경에서 복사한 콜백 URL을 붙여넣습니다.
- 생성 을 클릭하여 Fuse Online 환경의 클라이언트 ID 및 클라이언트 시크릿을 표시합니다.
-
클라이언트 ID 필드 오른쪽에 있는
를 클릭하여 클라이언트 ID를 클립보드에 복사합니다.
Fuse Online Settings 페이지로 돌아가서 다음을 수행합니다.
- Registry, Google Cryostat 및 Google의 항목을 확장합니다.
- 각 Google 애플리케이션의 클라이언트 ID 필드에 방금 복사한 Google 클라이언트 ID를 붙여넣습니다.
-
Google 개발자 사이트로 돌아가서 클라이언트 시크릿 필드 오른쪽에
를 클릭하여 클라이언트 시크릿을 클립보드에 복사합니다.
Fuse 온라인 설정 페이지로 돌아가서 각 Google 애플리케이션의 항목에서 다음을 수행합니다.
- 클라이언트 시크릿 필드에 방금 복사한 Google 클라이언트 시크릿을 붙여넣습니다.
- 저장을 클릭합니다. 등록 Successful! 알림을 받아야 합니다.
- 항목을 축소합니다.
결과
활성화한 각 Google 애플리케이션 API에 대해 해당 애플리케이션에 대한 연결을 생성할 수 있습니다.
Fuse Online과 Google 애플리케이션에서의 모든 연결은 동일한 Google 클라이언트 ID와 Google 클라이언트 시크릿을 사용합니다.
Google 클라이언트 ID 및 Google 클라이언트 시크릿에는 Google 애플리케이션에 연결된 통합이 지속적으로 올바르게 작동하도록 하는 토큰 새로 고침 정보가 포함되어 있습니다. 따라서 새 인증 정보를 가져올 수 없습니다. 이 경우 각 Google 연결을 다시 만들고 이전 연결을 새 연결로 교체한 다음 Google 연결을 사용하는 각 통합을 다시 게시해야 합니다.
11.2. controlPlane에 연결
특정Registry 계정이 이메일을 수신할 때 통합 실행을 트리거하려면 시작 연결로 simple integration에 대해 localhost 연결을 추가합니다. 통합에서 특정 BP 계정의 이메일을 보내려면 다음 중 하나를 수행하십시오.
- 흐름 중간에 controlPlane 연결을 추가합니다.
- simple integration을 완료하기 위해 controlPlane 연결을 추가합니다.
통합에서 controlPlane에 연결하기 위한 일반적인 단계는 다음과 같습니다.
- Fuse Online을 Google 클라이언트 애플리케이션으로 등록합니다.
- GPO 연결 만들기. 이렇게 하면 연결에 액세스할 수 있는 권한이 부여된lusterAutoscaler 계정을 선택합니다.
- 통합이 ESP 계정에서 이메일을 보내는 경우 보낼 이메일을 채우는 방법을 결정합니다.
- 통합 흐름에 BP 연결 추가.
- 이메일을 전송하는 GPO 연결의 경우 선택적으로 통합 데이터를 이메일 필드에 매핑합니다.
정보 및 지침은 다음 항목에 있습니다.
11.2.1. GPO 연결 생성
GPO 연결을 생성할 때 하나의 특정 Cryostat 계정에 액세스할 수 있는 연결에 권한을 부여합니다. GPO 연결을 생성한 후 여러 통합에 추가할 수 있습니다.
사전 요구 사항
- Fuse Online을 Google 클라이언트 애플리케이션으로 등록하고 ESP API를 활성화했습니다.
- ReplicaSet의 Fuse 온라인 설정 페이지 항목에는 클라이언트 ID 및 클라이언트 시크릿의 값이 있으며, 이 값은 Fuse Online을 Google 클라이언트 애플리케이션으로 등록하여 얻은 것입니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 사용 가능한 커넥터를 표시합니다. 커넥터는 하나 이상의 연결을 생성하는 데 사용하는 템플릿입니다.
- Registry 커넥터 를 클릭합니다.
Configure Connection (연결 구성) 페이지에서 Connect email 을 클릭합니다. 이 에서는 ESP로 로그인할 때 로그인 페이지로 이동합니다.
ConnectGCM 이 표시되지 않으면 Fuse Online 환경이 Google 클라이언트 애플리케이션으로 등록되지 않습니다. Fuse Online 등록을 Google 클라이언트 애플리케이션으로 참조하십시오. GPO 연결을 만들고 Fuse Online 환경이 Google 클라이언트 애플리케이션으로 등록되지 않은 경우 Fuse Online에서 권한 부여 정보를 요청하는 여러 필드를 표시합니다. 이러한 필드에 값을 입력하여 localhost 연결을 생성할 수는 있지만 권장되지는 않습니다.
- localhost에 로그인하라는 메시지가 표시되는 페이지에 이 연결이 Fuse Online에서 액세스할 Google 계정의 이메일 주소를 입력하고 다음을 클릭합니다.
- openshiftapps.com에 대한 응답으로 Google 계정에 액세스하려는 경우 허용 을 클릭하여 Fuse Online으로 돌아갑니다.
-
Fuse Online Name 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어,Registry
Connect 1을 입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
jkimDefinition 계정 자격 증명을 사용하는 SampleRegistry 연결을 입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력한 경우, ESP Connect 1 이 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
11.2.2. 전송할 이메일을 채우는 대안
간단한 통합을 완료하거나 흐름의 한가운데에 있는 controlPlane 연결은 해당 연결이 액세스할 수 있는 JPEG 계정에서 이메일을 보냅니다. 연결이 전송하는 이메일의 내용을 채우는 방법은 여러 가지가 있습니다. 이메일을 보내는 GPO 연결을 추가하기 전에 해당 이메일을 채우려는 방법을 고려하십시오.
보낼 이메일을 채우는 대안은 다음과 같습니다.
이메일을 보내는 GPO 연결 직전에 데이터 매퍼 단계를 추가합니다. 이 데이터 매퍼 단계에서 이전 단계의 출력된 데이터 필드를 controlPlane 연결 Send Email 작업 필드에 매핑합니다. 이메일 전송 작업 필드는 다음과 같습니다.
- 이메일 주소
- 이메일 제목
- 이메일 텍스트
- 이메일 cc
- 이메일 bcc
데이터 매퍼 단계를 추가하는 경우 하나, 일부 또는 모든 이메일 전송 작업 필드를 매핑할 수 있습니다.
- 흐름에Registry 연결을 추가하면 Send Email 작업 필드에 값을 지정하여 작업을 구성합니다. 하나, 일부 또는 모든 필드에 값을 지정할 수 있습니다.
데이터 매퍼 단계와 Send Email 작업 구성을 모두 사용하여 필드를 채웁니다. 즉, 하나 이상의 필드를 지정하여 이메일 전송 작업을 구성하고 다른 필드를 채우는 데이터 매퍼 단계를 추가할 수도 있습니다.
Send Email 작업 필드에 직접 지정하는 값은 Send Email 작업 필드에 매핑된 값보다 우선합니다. 즉, 연결을 추가하고 작업을 구성하고 값을 동일한 필드에 매핑하여 값을 지정하여 이메일 보내기 필드를 채우고 있다고 가정합니다. 작업 구성에 지정하는 값은 항상 매핑된 값을 재정의합니다. 예를 들어 Email to action 필드에서
people@redhat.com를 지정하고 이전 단계의 이메일 필드도Registry Email to 필드에 매핑한다고 가정합니다. 통합은 항상 이메일 주소로people@redhat.com를 사용합니다.
이메일을 보내는 GPO 연결을 추가하면 모든 작업 구성 매개변수가 선택 사항입니다. 이는 통합 데이터를 Send Email 작업 필드에 매핑하여 이메일을 완전히 채우도록 선택할 수 있기 때문입니다. 그러나 작업 구성 사양 또는 매핑을 통해 Email to 필드에 이메일 주소가 있어야 합니다. 메시지를 보낼 이메일 주소가 없으면 Fuse Online에서 런타임 오류가 발생하고 통합이 실행을 중지합니다.
11.2.3. 폴링 시 integration을 트리거하면 GPO 메시지 반환
특정 controlPlane 계정에서 수신한 이메일을 기반으로 통합 실행을 트리거하려면 simple integration의 시작 연결로 MCS 연결을 추가합니다. 통합이 실행 중일 때 localhost 연결은 사용자가 제어하는 간격에 따라 이 계정을 확인합니다. 연결이 읽지 않은 이메일을 찾으면 통합의 다음 단계로 이메일을 전달하고 기본적으로 이메일을 읽기 로 표시합니다.
사전 요구 사항
- 이메일을 받을 수 있는 GPO 계정에 액세스할 수 있는 GPO 연결이 생성되었습니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 통합을 시작하는 데 사용할 GPO 연결을 클릭합니다.
- 작업 선택 페이지에서 이메일 수신 작업을 선택합니다.
수신자 이메일 작업을 구성하려면 다음을 수행합니다.
- Delay 필드에서 기본값을 30초로 수락하거나 통합에서 새 이메일을 확인하는 빈도를 지정합니다.
- 읽지 않은 이메일을 받으려면 레이블 필드를 비워 둡니다. 특정 이메일만 얻으려면 연결이 액세스하는 money 계정에 사용되는 쉼표로 구분된 레이블 목록을 지정합니다. 기본적으로 통합은 해당 레이블이 있는 읽지 않은 이메일을 가져옵니다.
- Mark as read 를 선택하여 연결이 동일한 이메일을 두 번 반환하지 않는지 확인합니다. Mark as read 가 선택되지 않은 경우 연결은 이전에 읽혀졌는지 여부에 관계없이 계정의 상자에 있는 이메일을 반환합니다. 또는 하나 이상의 레이블을 지정하면 통합 반환 이메일이 이미 읽혀졌는지 여부에 관계없이 해당 레이블이 있는 이메일을 반환합니다.
Max Results 필드에서 기본값을 수락하거나 각 폴링에 대해 연결을 반환할 수 있는 최대 이메일 수를 나타냅니다. 연결에서 읽지 않은 이메일 수보다 많은 경우 최신 Max Results 이메일이 반환됩니다.
GPO 연결이 두 개 이상의 이메일을 반환하면 통합에서 이메일을 일괄 처리로 처리합니다. 즉, Fuse Online은 일괄 처리에 대해 한 번 통합을 실행합니다.
- 다음을 클릭하여 통합에서 이lusterAutoscaler 연결을 시작으로 추가합니다. 연결은 통합 흐름의 첫 번째 단계로 나타납니다.
11.2.4. ESP 계정에서 이메일 전송
통합에서는 흐름 중간 또는 간단한 통합을 완료하기 위해 BP 계정의 이메일을 보낼 수 있습니다. 이렇게 하려면 흐름 중 또는 간단한 통합의 완료 연결로Registry 연결을 추가합니다.
사전 요구 사항
- GPO 연결을 생성했습니다.
- 보낼 이메일을 채우는 대안에 익숙하고 이러한 이메일을 채울 계획이 있습니다.
- Fuse Online에서는 통합에 추가하거나 간단한 통합을 위한 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 이메일을 보내는 데 사용할 GPO 연결을 클릭합니다.
- 작업 선택 페이지에서 이메일 전송을 선택합니다.
Configure Send Email 페이지에서 다음 중 하나를 수행합니다.
- 이 연결 직전에 데이터 매퍼 단계를 추가하고 통합 데이터를 Send Email 필드에 매핑하려는 경우 모든 필드를 비워 둡니다.
다음 전송 이메일 필드 중 하나에 정보를 입력합니다. 여러 이메일 주소를 쉼표로 구분합니다.
- 이메일 주소
- 이메일 제목
- 이메일 텍스트
- 이메일 cc
- 이메일 bcc
일부 필드를 비워 두고 일부 필드에 정보를 입력합니다.
이 localhost 연결 바로 전에 데이터 매퍼 단계를 추가하고 통합 데이터를 일부 이메일 필드에 매핑하려면 해당 필드를 작업 구성에 비워 둡니다. 필요에 따라 다른 작업 필드에 값을 입력합니다.
Send Email 작업 구성 필드에 지정하는 값은 이전 단계에서 매핑된 값보다 우선합니다.
- 다음을 클릭하여 흐름에 연결을 추가합니다.
결과
연결은 이를 추가한 통합 흐름에 표시됩니다.
다음 단계
이 연결 전에 데이터 매퍼 단계를 추가하려면 먼저 이 흐름에 추가할 다른 연결을 추가합니다. 그런 다음 데이터 매퍼 단계를 추가합니다.
11.3. Google Cryostat에 연결
폴링에서 Google 캘린더에 대한 업데이트를 반환할 때 통합 실행을 트리거하려면 시작 연결로 간단한 통합에 Google calendar 연결을 추가합니다. 일정에 이벤트를 추가하거나 일정에서 이벤트를 업데이트하려면 다음 중 하나를 수행할 수 있습니다.
- 흐름 중간에 Google Cryostat 연결을 추가합니다.
- 간단한 통합을 완료하기 위해 Google Cryostat 연결을 추가합니다.
Google Cryostat에 연결하는 방법에 대한 자세한 내용은 다음 항목을 참조하십시오.
11.3.1. Google calendar 연결 생성
Google Cryostat 연결을 만들 때 하나의 특정 Google 계정과 연결된 Google Cryostat에 액세스할 수 있는 연결을 승인합니다. Google Cryostat 연결을 만든 후 여러 통합에 추가할 수 있습니다.
사전 요구 사항
- Fuse Online을 Google 클라이언트 애플리케이션으로 등록하고 Google Cryostat API를 활성화했습니다.
- Google Cryostat의 Fuse 온라인 설정 페이지 항목에는 클라이언트 ID 및 클라이언트 시크릿의 값이 있으며, 이 값은 Fuse Online을 Google 클라이언트 애플리케이션으로 등록하여 얻은 것입니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 사용 가능한 커넥터를 표시합니다. 커넥터는 하나 이상의 연결을 생성하는 데 사용하는 템플릿입니다.
- Google calendar 커넥터를 클릭합니다.
연결 구성 페이지에서 Google 로그인 페이지로 이동합니다.In the Configure Connection page, click Connect Google calendar, which takes you to a Google sign-in page.
Connect Google Cryo stat가 표시되지 않으면 Google Cryostat API가 활성화된 Google 클라이언트 애플리케이션으로 Fuse Online 환경이 등록되지 않습니다. Fuse Online 등록을 Google 클라이언트 애플리케이션으로 참조하십시오. 사용자 환경이 Google에 등록되지 않은 경우 Google calendar 연결을 만들려고 하면 Fuse Online에서 권한 부여 정보를 요청하는 여러 필드를 표시합니다. 이러한 필드에 값을 입력하여 Google Cryostat 연결을 만들 수는 있지만 권장되지는 않습니다.
- Google 로그인 페이지에서 Fuse Online에서 이 연결에 액세스할 Google 계정을 선택하고 Next 를 클릭합니다.
- openshiftapps.com에 대한 응답으로 Google 계정 프롬프트에 액세스하려는 경우 허용 을 클릭하여 Fuse Online으로 돌아갑니다.
-
Fuse Online Name 필드에 이 연결을 다른 연결과 구분하는 데 도움이 되는 이름을 선택합니다. 예를 들어
Google Cryostat 작업 연결을입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
내 Google 작업 계정을 사용하는 샘플 Google Cryostat 연결을 입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력한 경우 통합에 추가할 수 있는 연결로 Google Cryostat Work Connection 이 표시되는 것을 확인할 수 있습니다.
11.3.2. 폴링 시 통합을 트리거하여 Google Cryostat에서 이벤트를 반환합니다.
사용자가 지정하는 Google Cryostat에서 이벤트를 가져올 때 통합 실행을 트리거하려면 시작 연결로 간단한 통합에 Google Cryostat 연결을 추가합니다. 통합이 실행되면 Google calendar 연결은 사용자가 제어하는 간격에 따라 Google의 events를 확인합니다. 연결이 Google calendar Get Events 작업을 구성한 방식을 준수하는 이벤트를 찾으면 연결은 통합의 다음 단계로 이벤트를 전달합니다.
Google Cryostat 연결이 두 개 이상의 이벤트를 반환하면 Fuse Online에서 반환된 각 이벤트에 대해 통합을 실행합니다. 예를 들어 폴링에서 5개의 이벤트를 반환하는 경우 Fuse Online은 통합을 5회 실행합니다.
사전 요구 사항
- Google calendar 연결을 생성했습니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 통합을 시작하는 데 사용할 Google Cryostat 연결을 클릭합니다.
- 작업 선택 페이지에서 이벤트 가져오기 작업을 선택합니다.
이벤트 가져오기 작업을 구성하려면 다음을 수행합니다.
- Delay 필드에서 기본값을 30초로 수락하거나 통합에서 일정을 확인하는 빈도를 지정합니다.
- Cryostat 이름 필드에 이 Google Cryostat 연결이 액세스할 수 있는 권한이 있는 Google 계정에서 액세스할 수 있는 일정 이름을 입력합니다.
- Max Results 필드에서 기본값을 수락하거나 각 폴링에 대해 연결을 반환할 수 있는 최대 이벤트 수를 나타냅니다.
다음 중 하나를 선택하여 이벤트 확인을 시작하는 데 사용할 날짜를 나타냅니다. 연결은 해당 날짜 및 후속 날짜를 확인합니다.
현재 날짜에 앞서 있는 현재 날짜 부터 사용합니다.
예를 들어 이 옵션을 선택하고 Max Results 가 5인 경우 Google Cryostat 연결은 현재 날짜의 이벤트 검사를 시작하고 찾은 처음 5개의 이벤트를 반환하지 않습니다. 이러한 이벤트가 마지막 폴링 이후 업데이트되거나 추가되었는지 여부는 중요하지 않습니다.
다음 폴링의 마지막 이벤트 업데이트 날짜에서 소비는 이전 폴링 에서 반환된 가장 최근 업데이트된 이벤트 날짜에 시작됩니다.
예를 들어 이 옵션을 선택하고 Max Results 가 5인 경우 Google Cryostat 연결은 더 이상 업데이트되거나 새 이벤트를 반환하지 않습니다. 연결은 이전 폴링에서 반환된 가장 최근에 업데이트된 이벤트의 날짜에서 새 이벤트 또는 업데이트된 이벤트를 확인하기 시작합니다.
필요한 경우 쿼리 for events 필드에서 폴링에서 반환할 이벤트를 필터링하는 텍스트를 지정합니다. 연결은 하나 이상의 이벤트 필드에 지정된 텍스트를 포함하는 이벤트만 반환합니다.
예를 들어 쿼리 필드에
Standup 회의를지정한다고 가정합니다. 폴링은 이벤트 필드에Standup 회의가있는 이벤트만 반환합니다.
- 다음을 클릭하여 통합의 시작 연결로 이 Google Cryostat 연결을 추가합니다.
결과
연결은 간단한 통합의 첫 번째 단계로 나타납니다.
11.3.3. Google Cryostat에서 특정 이벤트 가져오기
통합에서는 흐름 중 특정 Google Cryostat 이벤트를 얻을 수 있습니다. 예를 들어 다음과 같은 경우 특정 이벤트를 얻는 것이 유용합니다.
- 후속 Google Cryostat 연결에서 이벤트를 업데이트합니다.
- 후속 Twitter 연결을 사용하여 이벤트를 알립니다.
하나의 이벤트를 얻으려면 흐름 중간에 Google Cryostat 연결을 추가합니다.
이번 릴리스에서는 간단한 통합의 완료 연결에서 특정 이벤트를 가져오는 동안 지원되지만 특히 유용합니다. 이는 향후 릴리스에서 변경될 것으로 예상됩니다.
사전 요구 사항
- 가져올 이벤트가 있는 Google Cryostat에 액세스할 수 있는 권한이 부여된 Google Cryostat 연결을 생성하셨습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다.
- 연결할 일정에 액세스할 수 있는 권한이 있는 Google calendar 연결을 클릭합니다.
- 작업 선택 페이지에서 특정 이벤트 가져오기를 선택합니다.
- 원하는 이벤트가 포함된 일정의 이름을 지정합니다.
가져올 이벤트의 ID를 지정합니다. 이벤트 ID를 가져오려면 다음 중 하나를 수행합니다.
- 이전 Google Cryostat 연결에서 매핑합니다.
다음과 같이 일정에서 수동으로 가져옵니다.
- 브라우저에서 가져올 이벤트가 포함된 일정을 표시합니다.
-
?gsessionid=OK&eventdeb=1을 URL에 추가하고 일정을 다시 표시합니다. - 일정에서 가져올 이벤트를 클릭합니다.
-
이벤트 팝업에서
를 클릭하고 문제 해결 정보를 선택합니다.
-
Google Cryostat가 표시되는 팝업에서
eid=.를 따르는 문자열을 복사합니다. 예를 들어 이벤트 ID는p1pva2a4t504gbsha12di6k_20181107T150000Z*와 유사합니다.
- 다음을 클릭하여 흐름에 연결을 추가합니다.
결과
연결은 사용자가 추가한 흐름에 나타납니다.
다음 단계
이전 단계의 값을 이 연결의 필드에 매핑하려면 데이터 매퍼 단계를 추가합니다. 먼저 흐름에 필요한 모든 연결을 추가합니다. 그런 다음 이 연결 직전에 데이터 매퍼 단계를 추가합니다.
11.3.4. Google Cryostat에 이벤트 추가
통합에서는 흐름 중 Googleundercloud에 이벤트를 추가하거나 간단한 통합을 완료할 수 있습니다. 이렇게 하려면 흐름 중 또는 간단한 통합의 완료 연결로 Google Cryostat 연결을 추가합니다.
사전 요구 사항
- 이벤트를 추가할 Google Cryostat에 액세스할 수 있는 권한이 부여된 Google Cryostat 연결을 생성하셨습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 이벤트를 추가할 일정에 액세스할 수 있는 권한이 부여된 Google calendar 연결을 클릭합니다.
- 작업 선택 페이지에서 이벤트 생성 작업을 선택합니다.
이벤트 생성 작업을 구성합니다.
- 새 이벤트의 제목을 입력합니다.
- 이벤트를 추가할 Google Cryostat의 이름을 입력합니다.
- 다른 입력 매개 변수의 경우 데이터를 입력하거나 이전 Google Cryostat 연결에서 가져온 이벤트에서 값을 매핑할 수 있습니다.
- 다음을 클릭하여 흐름에 연결을 추가합니다.
결과
연결은 이를 추가한 통합 흐름에 표시됩니다.
다음 단계
이 Google Cryostat 연결의 필드에 값을 매핑하려면 데이터 매퍼 단계를 흐름에 추가합니다. 먼저 흐름에 필요한 모든 연결을 추가합니다. 그런 다음 이 Google Cryostat 연결 직전에 데이터 매퍼 단계를 추가합니다.
11.3.5. Google Cryostat에서 이벤트 업데이트
통합에서는 흐름 중 Google에서 이벤트를 업데이트하거나 간단한 통합을 완료할 수 있습니다. 이렇게 하려면 흐름 중 또는 간단한 통합의 완료 연결로 Google Cryostat 연결을 추가합니다.
이번 릴리스에서는 업데이트 이벤트 작업에 각 이벤트 필드의 값이 필요합니다. 대부분의 경우, 이는 업데이트하려는 이벤트를 가져오는 Google Cryostat 연결을 추가한 다음 이벤트를 업데이트하는 Google Cryostat 연결을 추가한 다음 두 Google Cryostat 연결 사이에 데이터 매퍼 단계를 삽입해야 함을 의미합니다.
사전 요구 사항
- 업데이트하려는 이벤트가 있는 Google Cryostat에 액세스할 수 있는 권한이 부여된 Google Cryostat 연결을 생성하셨습니다.
- 흐름에는 이전 연결이 있고 해당 연결은 업데이트하려는 이벤트를 가져옵니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 업데이트하려는 이벤트가 있는 일정에 액세스할 수 있는 권한이 있는 Google calendar 연결을 클릭합니다.
- 작업 선택 페이지에서 이벤트 업데이트를 선택합니다.
업데이트 이벤트 작업을 구성하려면 다음을 수행합니다.
- 업데이트하려는 이벤트의 제목을 입력합니다.
- 업데이트할 각 이벤트 필드에 콘텐츠를 입력합니다. 해당 필드의 콘텐츠를 변경하지 않으려면 이벤트 필드에 내용을 입력하지 마십시오.
- 다음을 클릭하여 흐름에 연결을 추가합니다. 연결은 통합 시각화에서 추가한 위치에서 나타납니다.
- 통합 시각화에서 방금 추가한 연결 직전에 있는 더하기 기호를 클릭합니다.
- 데이터 매퍼 를 클릭합니다.
데이터 매퍼에서 업데이트된 이벤트에서 동일하게 남아 있는 각 이벤트 필드에 대해 이벤트를 업데이트한 Google Cryostat 연결의 해당 필드에 해당 필드를 매핑합니다.
업데이트 중인 필드를 매핑하지 마십시오. 필드를 매핑하고 Update Event 작업을 구성할 때 해당 필드에 대한 업데이트도 지정하는 경우 Fuse Online은 매핑된 값을 사용합니다.
- 오른쪽 상단에서 Done 을 클릭하여 데이터 매퍼 단계를 추가합니다.
11.4. Google에 연결
Google의 연결에서 달라짐 데이터 또는 브레인드 속성을 반환할 때 통합 실행을 트리거하려면 시작 연결로 간단한 통합에 Google의 연결을 추가합니다. font 값 또는 속성을 업데이트하여 간단한 통합을 완료하거나 차트 또는 피벗 테이블을 제도에 삽입하여 간단한 통합을 완료하기 위해 간단한 통합에 Google connection을 추가합니다.
흐름의 중간에서는 확보하거나, 만들기 또는 업데이트할 수 있는 Google 가이드라인 연결을 추가하거나, 스케일링에서 값을 생성하거나, 차트 또는 피벗 테이블을 스페어에 삽입할 수 있습니다.
Google에 연결하는 방법에 대한 자세한 내용은 다음 항목을 참조하십시오.
11.4.1. Google의 연결 만들기
Google의 연결을 만들 때, 사용자는 사용자가 선택한 하나의 특정 Google 계정과 연결된 Google의 데이터 시트에 액세스할 수 있는 연결을 승인합니다. Google에서 연결을 만든 후 여러 통합에 추가할 수 있습니다.
사전 요구 사항
- Fuse Online을 Google 클라이언트 애플리케이션으로 등록하고 Google의 API를 활성화했습니다.
- Google의 Fuse 온라인 설정 페이지 항목에는 클라이언트 ID 및 클라이언트 시크릿의 값이 있으며, 이 페이지는 Fuse Online을 Google 클라이언트 애플리케이션으로 등록하여 얻은 것입니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 사용 가능한 커넥터를 표시합니다. 커넥터는 하나 이상의 연결을 생성하는 데 사용하는 템플릿입니다.
- Google connector를 클릭합니다.
연결 구성 페이지에서 Google 로그인 페이지로 이동합니다.In the Configure Connection page, click Connect Google, which takes you to a Google sign-in page.
Connect Google Cryo stat가 표시되지 않으면 Google이 활성화된 Google 클라이언트 애플리케이션으로 Fuse Online 환경이 등록되지 않습니다. Fuse Online 등록을 Google 클라이언트 애플리케이션으로 참조하십시오. 사용자 환경이 Google에 등록되지 않은 경우 Google 연결을 만들려고 하면 Fuse Online에서 권한 부여 정보를 요청하는 여러 필드를 표시합니다. 이러한 필드에 값을 입력하여 Google#159 연결을 만들 수는 있지만 권장되지는 않습니다.
- Google 로그인 페이지에서 Fuse Online에서 이 연결에 액세스할 Google 계정을 선택하고 Next 를 클릭합니다.
- openshiftapps.com에 대한 응답으로 Google 계정 프롬프트에 액세스하려는 경우 허용 을 클릭하여 Fuse Online으로 돌아갑니다.
-
Fuse Online Name 필드에 이 연결을 다른 연결과 구분하는 데 도움이 되는 이름을 선택합니다. 예를 들어
Google의 작업 연결을입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
내 Google 작업 계정을 사용하는 샘플 Google Cryostat 연결을 입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 Google 이 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
11.4.2. 통합 또는 흐름 중간을 트리거하기 위해 데이터 수집
Google에서 데이터를 가져올 때 통합을 트리거하려면 시작 연결로 간단한 통합에 Google 연결을 추가합니다. 통합이 실행되면 Google connection은 사용자가 지정한 간격으로 정보를 폴링하고, 식별한 데이터를 얻고, 통합의 다음 단계로 데이터를 전달합니다.
흐름 중간의 조각화 데이터를 얻으려면 Google connection을 중간 연결로 추가합니다. 실행 중에 Fuse Online은 이 연결 처리를 시작하는 즉시 지정된 데이터에 대한 정보를 폴링합니다. 다시 말해, 연결은 시뮬레이터를 폴링하기 전에 간격이 경과할 때까지 기다리지 않습니다.
스프레드 시트의 특정 시트에서 데이터를 가져오려면 Google에 대한 작업을 구성할 때 시트 이름을 지정합니다. 특정 연결은 하나의 시트에서만 데이터를 가져올 수 있습니다.
폴링 사이에 연결이 반환되도록 구성된 시트 값에 대한 변경 사항이 없으면 다음 폴링에서 이전 폴링과 동일한 값을 반환합니다.
사전 요구 사항
- 데이터를 가져올 수 있는 데이터 정렬에 액세스할 수 있는 권한이 있는 Google connection을 생성하셨습니다.
- 이 Google의 연결이 통합 실행을 트리거하는 경우 통합을 생성하고 Fuse Online에서 시작 연결을 선택하라는 메시지를 표시합니다.
- 이 Google의 연결이 흐름 중간에 있는 경우 통합에는 이미 시작 연결 및 완료 연결이 있으며 Fuse Online에서 단계를 선택하여 통합에 추가하라는 메시지가 표시됩니다.
절차
- 사용하려는 Google 연결을 클릭합니다.
- 작업 선택 페이지에서 시작 연결의 시트 값 가져오기 작업 또는 중간 연결의 경우 Retrieve sheet values 작업을 선택합니다.
작업을 구성하려면 다음을 수행합니다.
SpreadsheetId 필드에 이 Google account가 액세스할 수 있는 Google 계정의 ID를 입력합니다.
MeteringConfig ID를 얻으려면 브라우저에 이미지 정보를 표시합니다. ID는
d/과/edit사이의 URL의 일부입니다.범위 필드에 가져올 데이터를 식별하는 Google A1 표기법을 입력합니다. 기본값은 A:A 입니다.
예를 들어 4개의 열이 있는 한 개의 시트가 있는 시트의 모든 데이터를 원하는 경우를 예로 들 수 있습니다.
A:D를 지정합니다. 또는 행 5에서 15까지의 데이터를 얻으려면A5:D15를 지정합니다.데이터를 얻는 인시피드에 두 개 이상의 시트가 있는 경우 시트 이름과 시작 셀 좌표와 최종 셀 좌표를 지정합니다. 시트가 두 개 이상 있고 시트 이름을 지정하지 않으면 연결에서 제도의 첫 번째 시트에서 데이터를 가져옵니다. 예를 들어
2019!A1:D5의 사양은 이름이2019인 시트에서 데이터를 가져오도록 지정합니다. 이 시트에서는 1~5행의 경우 A~D 열에 있는 데이터를 원합니다.주요 차원 필드에서 기본값인 행을 수락하거나 열을 선택합니다.In the major dimension field, accept Rows, which is the default, or select Columns.
행은 각 행 개체에 원하는 각 열에 대한 값이 포함된 행 개체의 컬렉션을 반환하는 작업을 구성합니다.Rows configures the action to return a collection of row objects where each row object contains a value for each desired column. 주요 차원이 Rows 인 경우 Fuse Online은 A,B,C 가 아닌 데이터 매퍼에서 의미 있는 열 제목을 필드 이름으로 표시할 수 있습니다.
열에서는 각 열 개체에 원하는 각 행에 대한 값이 포함된 열 개체의 컬렉션을 반환하는 작업을 구성합니다. columns configures the action to return a collection of column objects where each column object contains a value for each desired row.
헤더 행 번호 필드에서 메이저 차원이 행으로 설정된 경우 선택적으로 연결이 가져오는 데이터의 열 제목이 포함된 행 수를 입력합니다.In the Header row number field, if major dimension is set to Rows, optionally enter the number of the row that contains the column headings in the data that the connection obtains. 헤더 행의 사양을 사용하면 Fuse Online에서 축소에서 제목을 얻을 수 있습니다. 헤더 행을 지정하지 않으면 열 제목이 연결이 가져오는 데이터 범위의 각 열에 대한 문자 제목으로 기본 설정됩니다. 후속 페이지에서 가져온 제목 또는 문자 제목을 편집할 수 있습니다.
참고Google의 중간 연결을 구성하는 경우 나머지 구성 옵션은 필요하지 않으며 Fuse Online에서 메시지를 표시하지 않습니다. 4단계로 건너뜁니다.
분할 결과 필드에서 기본값인 No 를 수락하거나 Yes 를 선택합니다. No 로 설정하면 데이터를 값 컬렉션으로 반환하는 작업을 구성합니다. 즉, 연결은 행 개체 또는 열 개체의 컬렉션을 흐름의 다음 단계로 전달합니다. 예 를 선택하여 대규모 차원의 설정에 따라 반환된 데이터를 분할할 수 있도록 합니다. 예를 들어 메이저 차원이 행으로 설정된 경우 연결에서 행 개체를 반환합니다.For example, if major dimension is set to Rows then the connection returns row objects. 각 행 오브젝트는 흐름의 별도의 실행을 트리거합니다. 즉, Fuse Online은 반환된 각 행 오브젝트에 대해 한 번 흐름을 실행합니다. 예를 들어 폴링에서 5행을 반환하는 경우 Fuse Online은 흐름을 5회 실행합니다.
Fuse Online에서는 흐름에 추가할 수 있는 별도의 분할 및 집계 단계도 제공합니다. 하나 이상의 단계에서 개별 개체를 처리한 다음 행 또는 열 개체를 집계하려면 Google의 연결 결과를 분할하지 마십시오. 대신 기본값 No 를 수락한 다음 이 연결 후 흐름에 분할 단계를 추가합니다. 흐름의 집계 단계를 원하는 경우 분할 단계가 필요합니다.
- Delay 필드에서 기본값을 30초로 수락하거나, 연결 빈도를 지정하여 개체 데이터를 가져올 빈도를 지정합니다.
최대 결과 필드에서 폴링할 수 있는 행 또는 열 수를 제한하지 않으려면 기본값 0 을 수락합니다. 최대 결과 설정은 결과 매트릭스의 주요 차원 설정에 적용됩니다. 연결이 메이저 차원에 대해 반환되는 데이터를 제한하려면 정수를 지정합니다.
예를 들어 메이저 차원이 행이고 Max 결과가 25 로 설정되어 있다고 가정합니다. 폴링은 25개 이상의 값 행을 반환하지 않습니다.
Range 가 주요 차원을 지정하고 최대 결과를 지정하는 경우 폴링은 더 낮은 수를 사용하여 반환할 데이터 양을 결정합니다. 결과적으로 Max 결과에 대한 값을 설정하면 Range 에 대한 마이너 차원만 지정할 때 더 유용합니다. 예를 들어 각 행에 세 개의 값이 있는 30개의 행이 있는 시트를 고려해 보십시오. 주요 차원 은 행 및 범위 A:C 입니다. Max 결과를 10 으로 설정하면 폴링은 10개의 데이터 행을 반환합니다. 최대 결과 설정으로 0 을 수락하면 폴링은 30개의 행을 반환합니다. 그러나 Range 를 A1:C15 로 지정하고 Max 결과를 25 로 지정하면 폴링은 15개의 행을 반환합니다. Range 를 A1:C30 으로 지정하고 Max 결과를 25 로 지정하면 폴링에서 25행을 반환합니다.
Next 를 클릭하여 메이저 차원이 행으로 설정될 때 연결이 가져오는 데이터에서 열 이름을 확인합니다. 주요 차원이 열 이므로 이 필드의 콘텐츠가 무시되고 다음 지금 클릭하여 이 절차를 완료할 수 있습니다.
열 이름 필드에 표시되는 값은 데이터 매퍼 단계가 표시하는 필드 이름이 됩니다. 헤더 행 번호를 지정하면 Fuse Online에서 데이터를 가져오는 시트에 해당 행의 제목을 표시합니다. 헤더 행 번호 필드를 비워 두면 Fuse Online에서 가져오는 데이터 범위의 각 열에 대한 문자(A,B,C 등)를 표시합니다.
-
선택적으로 데이터 매퍼 단계에서 표시할 필드 이름을 포함하도록 열 이름 필드를 편집합니다. 필드에는 공백 없이 쉼표로 구분된 목록(예:
Name,Address,City,State,Zip)이 포함되어야 합니다. - 다음을 클릭하여 이 Google의 흐름에 대한 연결을 추가합니다.
다음 단계
Google의 연결을 시작 연결로 추가한 경우 Fuse Online에서 통합의 완료 연결을 추가하라는 메시지를 표시합니다. 통합에서 시작 및 완료 연결을 사용하면 통합에서 원하는 다른 연결을 추가합니다.
시트 값을 가져오는 연결 후 데이터 매퍼 단계를 추가합니다. 데이터 매퍼에서 Fuse Online은 journalctl 값을 가져오는 작업을 구성하는 방법에 따라 소스 필드를 표시합니다. 즉, 메이저 차원이 행 인 경우 데이터 매퍼는 열에 매핑할 수 있는 필드로 나열됩니다. 주요 차원이 열인 경우 데이터 매퍼는 행에 매핑할 수 있는 필드로 행 인덱스를 나열합니다.If the major dimension is Columns, then the data mapper lists row indexes as fields that you can map to the target.
추가 리소스
Google A1 표시에서 셀 그룹을 지정하기 위한 표시
11.4.3. 폴링을 반환할 때 integration 트리거
Google에서 속성을 얻을 때 통합을 트리거하려면 시작 연결로 간단한 통합에 Google 연결을 추가합니다. 통합이 실행 중일 때 Google의 연결은 사용자가 지정한 간격에 따라 달라짐을 폴링하고, 프로젝트별 속성을 확보하고, 결과를 통합의 다음 단계로 전달합니다.
속성에는 프로젝트 제목, 로케일 및 시간대가 포함됩니다.Properties include the title, locale, and time zone. 폴링 사이에 시트 속성이 변경 사항이 없는 경우 다음 폴링은 이전 폴링과 동일한 값을 반환합니다.
사전 요구 사항
- 속성을 가져올 수 있는 보컬릿에 액세스할 수 있는 권한이 부여된 Google connection을 생성하셨습니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 통합을 시작하는 데 사용할 Google 연결을 클릭합니다.
- 작업 선택 페이지에서 개체 가져오기 속성 작업을 선택합니다.On the Choose an action page, select the Get font properties action.
Getontap 속성 작업을 구성하려면 다음을 수행합니다.
SpreadsheetId 필드에 이 Google account가 액세스할 수 있는 Google 계정의 ID를 입력합니다.
MeteringConfig ID를 얻으려면 브라우저에 이미지 정보를 표시합니다. ID는
d/과/edit사이의 URL의 일부입니다.- Delay 필드에서 기본값을 30초로 수락하거나 속성을 가져올 빈도를 지정합니다.
- 다음을 클릭하여 이 Google의 연결을 통합 시작으로 추가합니다.
결과
이제 통합이 시작 연결되고 Fuse Online에서 통합의 연결 완료를 선택하라는 메시지가 표시됩니다.
11.4.4. 기술 자료 만들기
흐름 중간에 새 페더레이션을 만들려면 시작과 종료 연결 사이에 Google#159 연결을 추가합니다. 또한 축소판을 만드는 Google의 연결로 간단한 통합을 완료할 수 있지만 동일한 연결에서 새 인시던트에 데이터를 추가할 수 없습니다. 따라서, 스프레드 시트를 만들고 동일한 흐름에 데이터를 추가하려는 경우 흐름에는 두 개의 Google connection이 필요합니다. 한 번의 연결로 인포그래프를 만든 다음 후속 연결에서 데이터 축소에 데이터를 추가합니다.
사전 요구 사항
- Its connection that is authorized to access the Google account in which you want to create the phone.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 개체를 만드는 데 사용할 Google 계정에 액세스할 수 있는 권한이 부여된 Google 연결을 클릭합니다.
- 작업 선택 페이지에서 프로젝트 만들기를 선택합니다.
이미지 생성 작업을 구성하려면 다음을 수행합니다.
- 제목 필드에 새 개체의 제목 을 입력합니다.In the title field, enter the title of the new font.
-
표준 시간대 필드에 새 표준 시간대(예:
인도 표준 시간또는 Cryostat)를 사용해야 하는 시간대를입력합니다. -
로케일 필드에 새 키워드의 로케일을 입력합니다(예:
캐나다또는홍콩).
- 다음을 클릭하여 흐름에 연결을 추가합니다. 연결은 통합 시각화에서 추가한 위치에서 나타납니다.
결과
조각 모음을 만드는 연결은 새 개체의 ID를 반환합니다.A connection that creates a font returns the identification ID for the new report. 후속 단계에서, 예를 들어, 새로운 It can update it to update it, for example, to update it in a connection에서, 예를 들면, 이 document ID를 chart ID에 매핑할 수 있습니다.
11.4.5. 시트에서 데이터 업데이트
통합에서는 흐름 중간의 조각에서 데이터를 업데이트하거나 간단한 통합을 완료할 수 있습니다. 이렇게 하려면 흐름 중간 또는 간단한 통합의 완료 연결로 Google의 연결을 추가합니다.
사전 요구 사항
- 업데이트하려는 Google document에 액세스할 수 있는 권한이 있는 Google connection을 생성하셨습니다.
- 업데이트하려는 시뮬레이터의 ID에 액세스할 수 있습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 업데이트할 구독에 액세스할 수 있는 권한이 있는 Google의 연결을 클릭합니다.
- 작업 선택 페이지에서 시트 업데이트 값을 선택합니다.
업데이트 시트 값 작업을 구성하려면 다음을 수행합니다.
SpreadsheetId 필드에서 다음 중 하나를 수행합니다.
- 업데이트할 구독의 ID를 입력합니다.Enter the ID of the report that you want to update.
- 필드를 비워 둡니다. 이 경우 흐름에 이 연결을 추가한 후 이 연결 전에 데이터 매퍼 단계를 추가해야 합니다. 데이터 매퍼 단계에서 이 연결에 대한 이전 연결의 details ID를 매핑합니다. 이전 연결은 이 연결에서 업데이트하려는 feature에 액세스해야 합니다.
범위 필드에서 Google A1 표기법을 사용하여 업데이트하려는 정보 표시 셀을 지정합니다. 시작 및 종료 좌표를 지정합니다(예
: A1:D4)는 스케줄의 첫 번째 시트의 처음 4개 행에 있는 처음 4개의 열을 업데이트합니다.기본값은
A:A입니다. 이 에서는 개체의 첫 번째 시트의 첫 번째 열을 업데이트합니다.- 주요 차원 필드에서 기본값인 행을 수락하거나 열을 선택합니다.In the major dimension field, accept Rows, which is the default, or select Columns. 행 은 행 개체를 사용하여 시트를 업데이트하도록 작업을 구성합니다. 각 row 오브젝트에는 업데이트할 각 열의 값이 포함되어 있습니다. 열은 열 개체를 사용하여 시트를 업데이트하도록 작업을 구성합니다. 각 열 오브젝트에는 업데이트할 각 행에 대한 값이 포함되어 있습니다.
값 입력 옵션 필드에서 Google 시트가 시트 업데이트를 위해 수신되는 데이터를 해석하는 방법을 나타냅니다. 기본값 인 지정되지 않은 경우 Google이 인식할 수 있는 데이터를 자동으로 변환할 수 있습니다. 예를 들어 입력 데이터가 날짜인 경우 Google은 이를 날짜로 포맷합니다. 입력 데이터가 10진수인 경우 Google은 10진수로 형식을 지정합니다.
- 지정되지 않은 기본값은 Google의 API 설정이며 기본값은 User입니다.
- Raw 는 Google이 입력 데이터를 그대로 삽입하도록 합니다.
- 사용자가 입력한 사용자는 인식할 수 있는 데이터를 자동으로 변환할 수 있습니다.
- 다음을 클릭하여 흐름에 연결을 추가합니다. 연결은 사용자가 추가한 위치의 통합 시각화에 나타납니다.
- 흐름에 다른 연결을 추가하려면 지금 추가한 다음 이러한 지침으로 돌아갑니다.
- 흐름에 필요한 모든 연결이 있는 후 통합 시각화에서 시트 값을 업데이트하는 Google이 연결되기 직전에 있는 더하기 기호를 클릭합니다.
- 데이터 매퍼 카드를 클릭하여 흐름에 데이터 매핑 단계를 추가합니다.
데이터 매퍼에서 다음을 수행합니다.
-
업데이트 시트 값 작업을 구성할 때 Itstic ID를 지정하지 않은 경우 소스 detailsId를 대상 details
Id에 매핑합니다. 소스 단계에서 대상 개체로 매핑 필드를 사용하여 시트를 업데이트할 때 사용할 데이터를 지정합니다. 예를 들어 다른 내용이나 데이터베이스의 필드를 매핑할 수 있습니다.
필요한 경우 시트 값을 업데이트하고 Range 또는 Major 차원의 설정을 변경하는 Google의 연결을 편집할 수 있습니다. 이러한 설정을 변경하면 데이터 매퍼가 변경 사항에 따라 다른 대상 필드를 표시합니다.
- 오른쪽 상단에서 Done 을 클릭하여 데이터 매퍼 단계를 추가합니다.
-
업데이트 시트 값 작업을 구성할 때 Itstic ID를 지정하지 않은 경우 소스 detailsId를 대상 details
11.4.6. 시트에 데이터 추가
흐름 중간에 시트에 데이터를 추가하거나 간단한 통합을 완료할 수 있습니다. 이렇게 하려면 흐름 중간 또는 간단한 통합의 완료 연결로 Google의 연결을 추가합니다.
사전 요구 사항
- 데이터를 추가하려는 Google document에 액세스할 수 있는 권한이 부여된 Google connection을 생성하셨습니다.
- 데이터를 추가하려는 구독의 ID에 액세스할 수 있습니다.You have access to the ID for the report in which you want to append data.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 데이터를 추가하려는 시뮬레이터에 액세스할 수 있는 권한이 부여된 Google recording 연결을 클릭합니다.
- 작업 선택 페이지에서 시트에 대한 앱 값을 선택합니다.
시트 작업으로 Append 값을 구성하려면 다음을 수행합니다.
SpreadsheetId 필드에서 다음 중 하나를 수행합니다.
- 값을 추가할 구독의 ID를 입력합니다.Enter the ID of the report that you want to add values to.
- 필드를 비워 둡니다. 이 경우 흐름에 이 연결을 추가한 후 이 연결 전에 데이터 매퍼 단계를 추가해야 합니다. 데이터 매퍼 단계에서 이 연결에 대한 이전 연결의 details ID를 매핑합니다. 이전 연결은 이 연결에서 데이터를 추가하려는 details에 액세스해야 합니다.
범위 필드에서 Google A1 표기법을 사용하여 데이터를 추가할 축소 범위를 지정합니다. 시작 및 종료 좌표를 지정합니다. 예를 들어
A3:D3은 4 열의 세 번째 줄 뒤에 첫 번째 시트에 데이터를 추가합니다. 기본값은A:A입니다. 이 에서는 개체의 첫 번째 시트의 첫 번째 열에 데이터를 추가합니다.연결은 데이터를 덮어쓰지 않습니다. 연결은 지정한 범위 뒤에 데이터 첨부를 시작한 다음 항상 해당 콘텐츠에 데이터를 추가합니다.
- 주요 차원 필드에서 기본값인 행을 수락하거나 열을 선택합니다.In the major dimension field, accept Rows, which is the default, or select Columns. 행 은 행 개체를 사용하여 데이터를 추가하는 작업을 구성합니다. 각 행 오브젝트에는 데이터를 추가할 각 열의 값이 포함되어 있습니다. 열 에서는 열 개체를 사용하여 데이터를 추가하는 작업을 구성합니다. 각 열 오브젝트에는 추가할 각 행의 값이 포함되어 있습니다.
값 입력 옵션 필드에서 Google 시트가 시트에 추가할 데이터를 해석하는 방법을 나타냅니다. 기본값 인 지정되지 않은 경우 Google이 인식할 수 있는 데이터를 자동으로 변환할 수 있습니다. 예를 들어 입력 데이터가 날짜인 경우 Google은 이를 날짜로 포맷합니다. 입력 데이터가 10진수인 경우 Google은 10진수로 형식을 지정합니다.
- 지정되지 않은 기본값은 Google의 API 설정이며 기본값은 User입니다.
- raw 는 아무것도 하지 않습니다. Google Cryostat는 입력 데이터를 그대로 삽입합니다.
- 사용자가 입력한 사용자는 인식할 수 있는 데이터를 자동으로 변환할 수 있습니다.
다음을 클릭하여 흐름에 연결을 추가합니다. 연결은 통합 시각화에서 추가한 위치에서 나타납니다.
시트 작업에 Append 값을 구성하도록 지정하는 값에 따라 데이터 매퍼가 이 연결에 또는 이 연결에서 매핑하기 위해 표시되는 필드가 결정됩니다.
- 흐름에 다른 연결을 추가하려면 지금 추가한 다음 이러한 지침으로 돌아갑니다.
- 흐름에 필요한 모든 연결이 있는 후 통합 시각화에서 데이터를 시트에 추가하는 Google connection 직전에 있는 더하기 기호를 클릭합니다.
- 데이터 맵퍼 를 클릭하여 흐름에 데이터 매핑 단계를 추가합니다.
데이터 매퍼에서 다음을 수행합니다.
-
Append 값을 details로 구성할 때 details ID를 지정하지 않은 경우 소스 detailsId를 대상
reportId에 매핑합니다. 소스 단계의 필드를 대상 표시로 매핑하여 시트에 추가할 데이터를 지정합니다. 예를 들어 다른 내용이나 데이터베이스의 필드를 매핑할 수 있습니다.
필요한 경우 시트 값을 추가하고 범위 또는 주요 차원의 설정을 변경하는 Google의 연결을 편집할 수 있습니다. 이러한 설정을 변경하면 데이터 매퍼가 변경 사항에 따라 다른 대상 필드를 표시합니다.
- 오른쪽 상단에서 Done 을 클릭하여 데이터 매퍼 단계를 추가합니다.
-
Append 값을 details로 구성할 때 details ID를 지정하지 않은 경우 소스 detailsId를 대상
11.4.7. 조각화 속성 업데이트
통합에서는 흐름 중간에서 또는 간단한 통합을 완료할 수 있습니다.In an integration, you can update the properties of a flow in the middle of a flow or to finish a simple integration. 이렇게 하려면 흐름 중간 또는 간단한 통합의 완료 연결로 Google의 연결을 추가합니다.
속성에는 프로젝트 제목, 로케일 및 시간대가 포함됩니다.Properties include the title, locale, and time zone.
Fuse Online에서 Update font 속성 작업을 구성하라는 메시지를 표시하면 일부 또는 모든 필드를 비워 둘 수 있습니다. 필드를 비워 두는 경우 이 연결 전에 흐름에 있는 데이터 매퍼 단계에서 필드를 이전 단계의 필드를 빈 업데이트 속성 작업 구성 필드에 매핑합니다.
사전 요구 사항
- 업데이트하려는 속성이 있는 Google document document에 액세스할 수 있는 권한이 부여된 Google connection을 생성하셨습니다.
- 사용자가 업데이트하려는 해당 속성이 있는 font ID에 액세스할 수 있습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 업데이트할 속성이 있는 브레인더에 액세스할 수 있는 권한이 부여된 Google connection을 클릭합니다.
- 작업 선택 페이지에서 프로젝트 속성 업데이트를 선택합니다.
이미지 업데이트 속성 작업을 구성하려면 다음을 수행합니다.
SpreadsheetId 필드에서 다음 중 하나를 수행합니다.
- 업데이트할 속성의 ID를 입력합니다.Enter the ID of the document whose properties you want to update.
- 필드를 비워 둡니다. 이 경우 흐름에 이 연결을 추가한 후 이 연결 전에 데이터 매퍼 단계를 추가해야 합니다.In this case, after you add this connection to the flow, you must add a data mapper step that is before this connection. 데이터 매퍼 단계에서 이 연결에 대한 이전 연결의 details ID를 매핑합니다. 이전 연결은 이 연결에서 업데이트하려는 feature에 액세스해야 합니다.
- 다른 필드에 속성을 변경하려는 경우에만 값을 입력합니다. 또는 필드를 비워 둘 수 있습니다. 이 연결 바로 전에 나중에 추가하는 데이터 매퍼 단계에서 변경할 필드를 매핑할 수 있습니다.
- 다음을 클릭하여 흐름에 연결을 추가합니다. 연결은 통합 시각화에서 추가한 위치에서 나타납니다.
- 흐름에 다른 연결을 추가하려면 지금 추가한 다음 이러한 지침으로 돌아갑니다.
흐름에 모든 원하는 연결이 있는 후에는 데이터 매퍼 단계를 사용하여 192.0.2. 속성을 업데이트할 수 있습니다.After the flow has all desired connections, you might want to use a data mapper step to update font properties:
- 통합 시각화에서 속성을 업데이트하는 Google의 연결 직전에 있는 더하기 기호를 클릭합니다.
- 데이터 맵퍼 를 클릭하여 흐름에 데이터 매핑 단계를 추가합니다.
-
데이터 매퍼에서 Update font 속성 작업을 구성할 때 details ID를 지정하지 않은 경우 소스 MeteringConfigId를 대상의 document
Id에 매핑합니다. - 변경하려는 각 recording 속성 및 업데이트 값을 지정하지 않은 경우, 업데이트 정보 표시 속성 작업을 구성할 때 소스 단계의 필드를 변경하려는 대상 논리적인 속성에 매핑합니다.
- 오른쪽 상단에서 Done 을 클릭하여 데이터 매퍼 단계를 추가합니다.
11.4.8. 시트에 차트 추가
흐름 중이나 간단한 통합을 완료하기 위해 Google에 기본 차트 또는 원형 차트를 Google에 추가할 수 있습니다. 이렇게 하려면 흐름 중간 또는 간단한 통합의 완료 연결로 Google의 연결을 추가합니다. 그런 다음 연결 바로 앞에 데이터 매퍼 단계를 추가합니다. 데이터 매퍼 단계에서 차트의 위치, 속성 및 내용을 결정하는 옵션을 설정합니다.
Fuse Online에서 차트 추가 작업을 구성하라는 메시지가 표시되면 일부 또는 모든 필드를 비워 둘 수 있습니다. 필드를 비워 두면 이 연결 직전에 추가할 데이터 매퍼 단계의 해당 필드에 값을 매핑할 수 있습니다.
사전 요구 사항
- 차트를 추가하려는 Google 보컬에 액세스할 수 있는 권한이 있는 Google connection을 생성하셨습니다.
- 차트를 추가할 텍스트의 ID에 액세스할 수 있습니다.You have access to the ID for the report that you want to add a chart to.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 간단한 통합을 위한 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 차트를 추가할 디바이스에 액세스할 수 있는 권한이 있는 Google 연결을 클릭합니다.Click a Google connection that is authorized to access the font that you want to add a chart to.
- 작업 선택 페이지에서 차트 추가 를 선택합니다.
차트 추가 작업을 구성하려면 다음을 수행합니다.
SpreadsheetId 필드에서 다음 중 하나를 수행합니다.
- 차트를 추가할 구독의 ID를 입력합니다.Enter the ID of the report that you want to add a chart to.
- 필드를 비워 둡니다. 이 연결 직전에 있을 데이터 매퍼 단계에서 이 연결에 대한 이전 연결에서 details ID를 매핑합니다. 이전 연결은 이 연결에서 차트를 추가하려는 details에 액세스해야 합니다.
차트 제목 필드에 제목 을 입력합니다.
또는 필드를 비워 둡니다. 이 연결 직전에 있는 데이터 매퍼 단계에서 소스 필드 또는 속성의 차트 제목을
제목대상 필드에 매핑합니다.Subtitle 필드에 subtitle을 입력합니다.
또는 필드를 비워 둡니다. 이 연결 직전에 있는 데이터 매퍼 단계에서 소스 필드 또는 속성의 차트 하위 제목을 하위 대상 필드에 매핑합니다.
- 다음을 클릭하여 흐름에 연결을 추가합니다. 연결은 통합 시각화에서 추가한 위치에서 나타납니다.
- 다른 연결을 흐름에 추가하려면 지금 추가합니다. 그런 다음 해당 지침으로 돌아갑니다.
- 통합 시각화에서 차트를 추가하는 연결 직전에 있는 더하기 기호를 클릭합니다.
데이터 매퍼 를 클릭합니다.
데이터 매퍼에서 차트를 추가하는 대상 Google의 연결에 소스 속성, 소스 필드 또는 소스 상수를 매핑합니다. 다음 명령은 각 대상 필드에 매핑하려는 값이 포함된 소스 필드, 소스 속성 또는 소스 상수가 있다고 가정합니다.
필요한 값에 대한 소스가 없는 경우 Properties 폴더 오른쪽에 있는 + 기호를 클릭하여 데이터 매퍼에 소스 속성을 생성합니다. 속성 만들기 대화 상자에서 올바른 대상 필드에 쉽게 매핑할 수 있는 이름을 지정합니다. 예를 들어 Overlay 192.0.2.
을속성 이름으로 지정합니다. 속성 값의 경우 차트를 만드는 데 사용할 연결을 지정할 값을 지정합니다.For the property value, specify the value that you want the connection to use to create the chart. 차트의 오버레이 위치 필드에는 셀을 식별하는 A1 표기법이 필요합니다. 즉, 시작 위치를 지정하지만 최종 위치 사양은 필요하지 않으며 있는 경우 무시됩니다. 예를 들어D4와 같은 항목을 overlay>-< 소스 속성의 값으로 지정합니다. 새 속성을 저장합니다.차트 추가 작업을 구성했을 때 이미지 표시 ID, 차트 제목 및/또는 차트 하위 제목의 값을 지정할 수 있습니다. 설정한 경우 해당 필드에 값을 매핑하지 마십시오.
차트를 시트에 추가하려면 다음과 같이 소스 속성, 소스 필드 또는 소스 상수를 대상 필드에 매핑합니다.
셀을 식별하는 A1 표기법 값을 overlay >-< 대상 필드에 매핑하여 차트 위치를 설정합니다. 최종 위치는 필요하지 않으며 있는 경우 무시됩니다. 매핑된 값은 Google이 차트를 배치하는 셀을 식별합니다. 이 셀은 차트 표시의 왼쪽 상단 코너입니다.
값을 overlay >-< 필드에 매핑하지 않고 차트를 추가할 시트를 식별하는 sheetId 필드에 값을 매핑하지 않는 경우 기본 동작은 Google이 새 시트를 만들고 A1에 차트를 배치한다는 것입니다.
value를 sheetId 필드에 매핑하려는 경우 overlay >-< 필드에 값을 매핑해야 합니다.
- 소스 details Id 필드를 대상 details Id 필드에 매핑합니다. 연결은 이 details의 소스 데이터를 사용하여 이 동일한 브레인스의 시트에 차트를 추가합니다. 원본 데이터와 차트는 동일한 비지엄에 있는 두 개의 서로 다른 시트에 있을 수 있지만 두 개의 서로 다른 엄선에 있을 수 없습니다.
- 대상 제목 필드에 매핑하여 차트 제목 을 설정합니다. 이 문자열을 차트 제목으로 삽입합니다.Inserts this string as the title of the chart.
- 대상 하위 인타이틀먼트 필드에 매핑하여 차트 하위 제목을 설정합니다. 연결은 이 문자열을 차트 하위 제목으로 삽입합니다.
정수를 sheetId 필드에 매핑하여 차트를 추가할 시트를 식별합니다.
값을 sheetId 필드에 매핑하는 경우 값을 overlay 2307 필드에 매핑해야 합니다.
value를 sheetId 필드에 매핑하지 않고 값을 overlay >-< 필드에 매핑하지 않으면 연결에서 새 시트를 생성하고 차트를 새 시트에 추가합니다.
값을 sheetId 필드에 매핑하지 않고 값을 overlay >-< 필드에 매핑하지 않으면 연결에서 sourceSheetId 필드에 의해 식별된 시트에 차트를 배치합니다. 차트의 데이터를 제공하는 시트입니다.
0은 스포드 시트의 첫 번째 시트를 식별합니다. 후속 시트의 경우 시트가 브라우저에 표시될 때 시트 ID는 URL 끝에 있습니다. 예를 들어 다음 URL 끝에gid=206589330을 볼 수 있습니다.https://docs.google.com/spreadsheets/d/1pa…ngQbKkM/edit#gid=206589330이는 시트 ID가
206589330이고 이는 sheetId 에 매핑되는 값입니다.정수 시트 ID를 대상 sourceSheetId 필드에 매핑하여 차트의 데이터를 제공하는 시트를 식별합니다. 기본값은
0이며, 이는 Microsoft의 첫 번째 시트를 식별합니다.기본 차트 또는 원형 차트를 추가할 수 있습니다. 추가할 차트의 종류에 따라 다음 명령 세트 중 하나를 따르십시오.
기본 차트를 추가하려면 대상 패널에서 basicChart 폴더를 확장하고 소스 필드를 basicChart 폴더에 있는 대상 필드에 매핑합니다.
-
대상 유형 필드에 매핑하여 차트 유형(
BAR,LINE,AREA또는COLUMN)을 설정합니다. 기본값은COLUMN입니다. - 대상 axisTitleBottom 필드에 매핑하여 차트의 하단 축을 설정합니다.
- 대상 axisTitleLeft 필드에 매핑하여 차트 왼쪽 축약을 설정합니다.
-
대상 domainRange 필드에 매핑하여 차트에서 표시하는 정보의 상위 수준을 설정합니다. 이 필드는 Google의 A1 표기법을 사용합니다. 예를 들어 소스 시트의 첫 번째 열은
A2에서A6까지의 5개의 제품 목록을 제공하고, 차트에서 각 제품에 대한 일부 데이터를 제공하도록 한다고 가정해 보겠습니다. 이 열에서 첫 번째 셀(A1)에는 제품과 같은 레이블이 포함되어야합니다. domainRange 의 설정은A1:A6입니다. 차트에는A2에서A6까지의 데이터가 포함됩니다. 차트에 레이블이 표시되지 않습니다. -
대상 dataRange 필드에 매핑하여 차트에서 표시하는 소스 데이터의 위치를 식별합니다. 이 필드는 Google의 A1 표기법을 사용합니다. 차트는 일련의 데이터만 제공할 수 있습니다. domainRange 예제를 계속 진행하면 소스 시트의 두 번째 열에 첫 번째 열에 나열된 각 5개 제품에 대해 판매된 수가 표시되어 차트가 표시할 데이터라고 가정합니다. 이 열에서 첫 번째 셀(
B1)에는Number Sold와 같은 레이블이 포함되어야 합니다. dataRange 의 설정은B1:B6입니다. 차트에는B2에서B6까지의 데이터가 포함됩니다. 차트에 레이블이 표시되지 않습니다.
-
대상 유형 필드에 매핑하여 차트 유형(
원형 차트를 추가하려면 대상 패널에서 pieChart 폴더를 확장하고 소스 필드를 pieChart 폴더에 있는 대상 필드에 매핑합니다.
-
대상 범례에 매핑하여 원형 차트 범례의 위치를 설정합니다. 기본값은
LEFT_LEGEND입니다. 값은BOTTOM_LEGEND,LEFT_LEGEND,RIGHT_LEGEND,parent_LEGEND또는NO_LEGEND여야 합니다. -
원형 차트에서 대상 domainRange 필드에 매핑하여 표시되는 높은 수준의 정보 범주를 설정합니다. 이 필드는 Google의 A1 표기법을 사용합니다. 예를 들어 소스 시트의 첫 번째 열은
A2에서A6까지의 5개의 제품 목록을 제공하고, 차트에서 각 제품에 대한 일부 데이터를 제공하도록 한다고 가정해 보겠습니다. 이 열에서 첫 번째 셀(A1)에는 제품과 같은 레이블이 포함되어야합니다. domainRange 의 설정은A1:A6입니다. 차트에는A2에서A6까지의 데이터가 포함됩니다. 차트에 레이블이 표시되지 않습니다. -
대상 dataRange 필드에 매핑하여 차트에서 표시하는 소스 데이터의 위치를 식별합니다. 이 필드는 Google의 A1 표기법을 사용합니다. 차트는 일련의 데이터만 제공할 수 있습니다. domainRange 예제를 계속 진행하면 소스 시트의 두 번째 열에 첫 번째 열에 나열된 각 5개 제품에 대해 판매된 수가 표시되어 차트가 표시할 데이터라고 가정합니다. 이 열에서 첫 번째 셀(
B1)에는Number Sold와 같은 레이블이 포함되어야 합니다. dataRange 의 설정은 B1:B6입니다. 차트에는B2에서B6까지의 데이터가 포함됩니다. 차트에 레이블이 표시되지 않습니다.
-
대상 범례에 매핑하여 원형 차트 범례의 위치를 설정합니다. 기본값은
- 오른쪽 상단에서 Done 을 클릭하여 데이터 매퍼 단계를 추가합니다.
11.4.9. 시트에 피벗 테이블 추가
흐름 중이거나 간단한 통합을 완료하기 위해 Google에 피벗 테이블을 추가할 수 있습니다. 피벗 테이블을 사용하면 작업을 집계, 정렬 또는 적용할 수 있습니다.Graphics 데이터에 함수를 집계, 정렬 또는 적용할 수 있으며 해당 결과를 동일한 스케일러에 표시할 수 있습니다. 피벗 테이블을 추가하려면 흐름 중간 또는 간단한 통합의 완료 연결로 Google Cryostat 연결을 추가합니다. 그런 다음 연결 전에 데이터 매핑 단계를 추가합니다. 데이터 매핑 단계에서는 피벗 테이블의 위치, 속성 및 내용을 결정하는 옵션을 설정합니다.
이번 릴리스에서는 피벗 테이블 추가 작업은 하나의 값 그룹, 행 피벗 그룹 및 하나의 열 피벗 그룹을 정의하는 데 제한됩니다. 단일 작업에서 여러 그룹에 대한 지원은 향후 릴리스에서 추가될 예정입니다. 이 문제를 해결하려면 동일한 소스 details에 따라 피벗 테이블을 추가하는 여러 Google#159 연결을 추가할 수 있습니다.
사전 요구 사항
- 피벗 테이블을 추가하려는 Google graphic에 액세스할 수 있는 권한이 있는 Google connection을 생성하셨습니다.
- 피벗 테이블의 소스 데이터가 포함된 MeteringConfig의 ID에 액세스할 수 있습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 간단한 통합을 위한 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 피벗 테이블을 추가할 수 있는 시뮬레이터에 액세스할 수 있는 권한이 있는 Google의 연결을 클릭합니다.
- 작업 선택 페이지에서 피벗 테이블 추가 를 선택합니다.
피벗 테이블 추가 작업을 구성하려면 SpreadsheetId 필드에서 다음 중 하나를 수행합니다.
- 피벗 테이블을 추가할 구독의 ID를 입력합니다.Enter the ID of the report that you want to add a pivot table.
- 필드를 비워 둡니다. 이 연결 바로 직전에 추가할 데이터 매퍼 단계에서는 이 연결에 대한 이전 연결에서 MeteringConfig ID를 매핑합니다. 이전 연결은 이 연결에서 피벗 테이블을 추가하려는 details에 액세스해야 합니다.
- 다음을 클릭하여 흐름에 연결을 추가합니다. 연결은 통합 시각화에서 추가한 위치에서 나타납니다.
- 이 흐름에 다른 연결을 추가하려면 지금 추가합니다. 그런 다음 해당 지침으로 돌아갑니다.
- 통합 시각화에서 피벗 테이블을 시트에 추가하는 연결 직전에 있는 더하기 기호를 클릭합니다.
데이터 매퍼 를 클릭합니다.
데이터 매퍼에서 피벗 테이블을 추가하는 대상 Google의 연결에 소스 속성, 소스 필드 또는 소스 상수를 매핑합니다. 다음 명령은 각 대상 필드에 매핑하려는 값이 포함된 소스 필드, 소스 속성 또는 소스 상수가 있다고 가정합니다.
필요한 값에 대한 소스가 없는 경우 Properties 폴더 오른쪽에 있는 + 기호를 클릭하여 데이터 매퍼에 소스 속성을 생성합니다. 속성 만들기 대화 상자에서 속성에 정확한 대상 필드에 쉽게 매핑할 수 있는 이름을 지정합니다. 예를 들어 속성 이름으로
valueLayout을 지정합니다. 피벗 테이블을 만드는 데 사용할 값을 지정합니다. 피벗 테이블의 값 레이아웃 필드에는HORIZONTAL또는VERTICAL값이 필요하므로VERTICAL을 valueLayout 속성 값으로 지정할 수 있습니다. 새 속성을 저장합니다.데이터 매퍼에서 다음과 같이 새 피벗 테이블을 구성합니다.
- 소스 details Id 필드를 대상 details Id 필드에 매핑합니다. 이 연결에서는 이 details의 소스 데이터를 사용하여 동일한 document에 있는 시트에 피벗 테이블을 추가합니다. 소스 데이터와 피벗 테이블은 동일한 브레드 박스에 있는 두 개의 서로 다른 시트에 있을 수 있지만 두 개의 서로 다른 엄선에 있을 수 없습니다.
피벗 테이블을 에 추가하여 정수를 sheetId 필드에 매핑하여 시트를 식별합니다. 기본값은
0이며, 이는 Microsoft의 첫 번째 시트를 식별합니다. 후속 시트의 경우 시트가 브라우저에 표시될 때 시트 ID는 URL 끝에 있습니다. 예를 들어 다음 URL 끝에gid=206589330:https://docs.google.com/spreadsheets/d/1pa…ngQbKkM/edit#gid=206589330.이는 시트 ID가
206589330이고 이는 sheetId 에 매핑되는 값입니다.-
정수 시트 ID를 대상 sourceSheetId 필드에 매핑하여 피벗 테이블을 생성하는 데이터를 제공하는 시트를 식별합니다. 값을 sourceSheetId 에 매핑하지 않으면 연결에서 sheetId 값을 사용하거나 value가 sheetId 에 매핑되지 않은 경우
0을 사용합니다.0은 스포드 시트의 첫 번째 시트를 식별합니다. - A1 표기법 값을 대상 sourceRange 필드에 매핑하여 피벗 테이블을 생성하기 위한 소스 데이터 범위를 설정합니다. 예를 들면 A2:D5 입니다.
-
대상 valueLayout 필드에 매핑하여 피벗 테이블에 사용할 값 레이아웃을 설정합니다. 값은 기본값인
VERTICAL또는HORIZONTAL이어야 합니다.HORIZONTAL은 값이 열로 설정되도록 지정합니다. - A1 표기법 셀 조정을 대상 시작 필드에 매핑하여 피벗 테이블의 맨 왼쪽 셀을 설정합니다. 연결에서 소스 데이터가 포함된 시트에 피벗 테이블을 추가할 때, 값을 시작 필드에 매핑하지 않으면 기본값은 피벗 테이블의 왼쪽 상단 셀이 소스 데이터 범위의 첫 번째 행에 있고 소스 데이터 범위 뒤의 첫 번째 비어 있는 셀이라는 것입니다. 소스 데이터가 한 시트에 있고 피벗 테이블이 다른 시트에 있을 때 기본값은 A1 입니다.
값 그룹을 추가하려면 대상 패널에서 valueGroups 를 확장하고 valueGroups 아래의 필드에 값을 매핑합니다.
- 대상 이름 필드에 값 그룹 이름을 매핑합니다.
-
값 그룹에 적용할 함수를 대상 함수 필드에 매핑합니다. 값은 ,
COUNT,AVERAGE,MAX,MIN또는CUSTOM이어야 합니다. 기본값은입니다. 공식을 정의할 때CUSTOM을 함수에 매핑합니다. -
CUSTOM값을 함수 필드에 매핑한 경우 값 그룹에 적용할 사용자 정의 공식을 대상 공식 필드에 매핑합니다. - 값 그룹을 빌드하는 좌표인 열 이름을 대상 소스 Cryostat 필드에 매핑합니다.
행 피벗 그룹을 추가하려면 대상 패널에서 columnGroups 를 확장하고 columnGroups 아래의 필드에 값을 매핑합니다.
- 행 피벗 그룹 이름을 대상 레이블 필드에 매핑합니다.
-
행 피벗 그룹에 적용할 정렬 순서를 대상 sortOrder 필드에 매핑합니다. 값은
ASCENDING또는DESCENDING이어야 합니다. 기본값은ASCENDING입니다. -
true또는false를 대상 showTotals 필드에 매핑합니다. 기본값은true이며 행 피벗 그룹의 합계를 표시할 수 있습니다. - 행 피벗 그룹을 빌드하는 좌표인 열 이름을 대상 소스 Cryostat 필드에 매핑합니다.
피벗 그룹을 추가하려면 대상 패널에서 rowGroups 를 확장하고 rowGroups 아래의 필드에 값을 매핑합니다.
- 피벗 그룹 이름을 대상 레이블 필드에 매핑합니다.
-
피벗 그룹에 적용할 정렬 순서를 대상 sortOrder 필드에 매핑합니다. 값은
ASCENDING또는DESCENDING이어야 합니다. 기본값은ASCENDING입니다. -
true또는false를 대상 showTotals 필드에 매핑합니다. 기본값은true이며, 이 경우 열 피벗 그룹의 합계를 표시할 수 있습니다. - 열 피벗 그룹을 빌드하는 좌표인 열 이름을 대상 소스 Cryostat 필드에 매핑합니다.
- 오른쪽 상단에서 Done 을 클릭하여 데이터 매퍼 단계를 추가합니다.
추가 리소스
12장. HTTP 및 HTTPS 끝점에 연결
통합에서는 HTTP 및 HTTPS 엔드포인트에 연결하여 GET,PUT,POST,DELETE,HEAD,OPTIONS,TRACE 또는 PATCH 메서드를 실행할 수 있습니다. 이렇게 하려면 HTTP 또는 HTTPS 연결을 생성한 다음 통합 흐름에 추가합니다. 다음 주제에서는 세부 정보를 제공합니다.
12.1. HTTP 또는 HTTPS 끝점에 대한 연결 생성
통합을 통해 HTTP GET,PUT,POST,DELETE,HEAD,OPTIONS,TRACE, PATCH 메서드를 실행하려면 HTTP 또는 HTTPS 엔드포인트에 대한 연결을 생성합니다. 그런 다음 하나 이상의 통합에 연결을 추가할 수 있습니다.
사전 요구 사항
연결하려는 끝점의 URL을 알아야 합니다.
프로시저
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 생성 을 클릭하여 Fuse Online 커넥터를 표시합니다.
- 하이퍼텍스트 전송 프로토콜을 사용하여 엔드포인트에 연결하려면 HTTP 커넥터를 클릭합니다. Hypertext Transfer Protocol Secure를 사용하려면 HTTPS 커넥터를 클릭합니다.
-
기본 URL 필드에 끝점 경로를 입력합니다. 예:
www.mycompany.com/sales. - Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 기본 URL 사양을 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
HTTPS My Company Sales를 입력합니다. - 설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다.
- 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 HTTPS My Company Sales 가 통합에 추가하도록 선택할 수 있는 연결로 표시됩니다.
12.2. 통합에 HTTP 또는 HTTPS 연결 추가
통합 수에 HTTP 또는 HTTPS 연결을 추가할 수 있습니다.
사전 요구 사항
- HTTP 또는 HTTPS 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 시작 연결을 선택하거나 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 흐름에 추가할 HTTP 또는 HTTPS 연결을 클릭합니다.
연결을 수행할 작업을 선택합니다.
- 시작 연결을 추가하는 경우 Periodic 호출 URL 은 사용 가능한 유일한 작업입니다. 이 작업은 끝점이 데이터를 반환하는 경우 통합을 지정하고 트리거하는 간격으로 끝점을 호출합니다.
- 중간 또는 완료 연결을 추가하는 경우 Invoke URL 이 사용 가능한 유일한 작업입니다. 이 작업은 엔드포인트를 한 번 호출합니다.
- URL 경로 필드에서 호출할 끝점의 위치를 지정합니다.
HTTP Method 필드에서 연결을 수행할 메서드를 선택합니다. 기본 메서드는
GET입니다.-
GET은 URL 경로에서 콘텐츠를 가져옵니다. -
PUT은 URL 경로의 콘텐츠를 통합 데이터로 교체합니다. -
POST는 새 콘텐츠를 생성하기 위해 URL 경로에 통합 데이터를 저장합니다. -
DELETE는 URL 경로의 콘텐츠를 제거합니다. -
HEAD는 URL 경로에서 콘텐츠에 대한 메타데이터를 가져옵니다. -
OPTIONS는 URL 경로에서 통신 옵션 설정을 가져옵니다. -
TRACE는 테스트 및 진단 목적으로 정보를 가져옵니다. -
PATCH는 통합 데이터에 따라 URL 경로에서 콘텐츠를 부분적으로 업데이트합니다.
-
- URL을 주기적으로 호출하는 시작 연결을 추가하는 경우 period 필드에서 기본 간격을 1 초로 수락하거나 번호와 단위(밀리초, 초, 분 또는 시간)를 지정하여 호출 사이에 대기하는 시간을 나타냅니다.
- 다음을 클릭하여 작업의 입력 또는 출력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 입력/출력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
13장. IRC에 연결
IRC(Internet Relay talk)는 IRC 클라이언트가 있는 모든 사용자가 텍스트 메시지를 실시간으로 전송하고 수신할 수 있는 프로토콜입니다. 통합에서 IRC에 대한 연결은 다음 중 하나를 수행할 수 있습니다.
- 지정한 IRC 닉네임이 개인 메시지를 수신할 때 간단한 통합을 트리거합니다. 통합은 메시지를 흐름의 다음 단계로 전달합니다. 예를 들어 가능한 고객의 이름을 수신하기 위해 IRC 닉네임을 지정할 수 있습니다. 메시지를 수신하면 통합이 Cryostat에 연결하여 주도자를 생성할 수 있었습니다.
- 특정 채널에 메시지를 전달합니다. 메시지는 사용자가 지정하는 닉네임의 것입니다. 예를 들어 통합에서 FTP 서버에서 파일을 다운로드하고 어떤 방식으로든 처리할 때 유용합니다. 통합 흐름은 프로세스가 성공했음을 나타내는 메시지를 특정 채널로 보낼 수 있습니다.
통합에서 IRC에 연결하려면 IRC 연결을 생성한 다음 통합 흐름에 연결을 추가합니다. 자세한 내용은 다음 항목에 있습니다.
13.1. IRC 연결 생성
통합에서 IRC 연결은 사용자가 지정하는 IRC 닉네임으로 전송되거나 채널의 닉네임으로 전송되는 메시지를 검색할 수 있습니다. 통합에 동일한 IRC 연결을 사용할 수 있습니다.
사전 요구 사항
- 연결하려는 IRC 서버의 호스트 이름과 포트를 알고 있습니다.
- IRC 서버에 암호가 필요한 경우 암호를 알고 있습니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 생성 을 클릭하여 Fuse Online 커넥터를 표시합니다.
- IRC 커넥터를 클릭합니다.
-
Hostname 필드에 IRC 호스트 이름을 입력합니다. IP 주소 또는 이름을 지정할 수 있습니다(예:
chat.freenode.net). -
Port 필드에 IRC 서버가 수신 대기 중인 포트(예: 6665)
를 입력합니다. - 암호 필드에 IRC 서버에 암호가 필요한 경우 여기에 입력합니다.
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 연결 구성 값을 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
IRC Freenode를 입력합니다. - 설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다.
- 저장 을 클릭하여 방금 만든 연결을 포함하여 사용 가능한 연결의 업데이트된 목록을 확인합니다. 예제 이름을 입력하면 IRC Freenode 가 통합에 추가하도록 선택할 수 있는 연결로 표시됩니다. 이 연결을 여러 통합에 추가할 수 있습니다.
13.2. 메시지 수신 시 통합 실행을 트리거하기 위해 IRC 연결 추가
통합을 시작하는 IRC 연결은 사용자가 지정하는 IRC 닉네임으로 전송되는 개인 메시지를 찾을 때 통합 실행을 트리거합니다.
사전 요구 사항
- IRC 연결을 생성했습니다.
- 메시지를 수신하고 전송하기 위한 IRC 닉네임이 있습니다.
- 간단한 통합을 만들고 Fuse Online에서는 통합을 시작하려는 방법을 선택하라는 메시지가 표시됩니다.
절차
- 통합을 시작하는 데 사용할 IRC 연결을 클릭합니다.
- IRC 수신 개인 메시지 작업을 선택합니다.
- 채널 필드에서 선택 옵션으로 쉼표로 구분된 하나 이상의 IRC 채널을 지정합니다.
- 닉네임 필드에서 통합에서 사용하는 IRC 닉네임을 지정합니다. 지정한 모든 채널의 경우 이 닉네임이 채널을 결합합니다. 실행 중에 통합은 이 닉네임으로 전송되는 메시지를 검색하고 통합의 다음 단계로 전달합니다.
- NickServ Password 필드에 지정된 닉네임에 암호가 있는 경우 입력합니다.
- 다음을 클릭하여 작업의 출력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 출력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭하여 흐름에 연결을 추가합니다.
결과
연결은 간단한 통합의 시작 연결이며 Fuse Online에서 통합의 완료 연결을 선택하라는 메시지를 표시합니다.
13.3. 메시지를 전송하기 위해 IRC 연결 추가
통합에서는 흐름 중 하나 이상의 IRC 채널에 메시지를 보내거나 간단한 통합을 완료할 수 있습니다. 이렇게 하려면 흐름 중 또는 간단한 통합의 완료 연결로 IRC 연결을 추가합니다.
사전 요구 사항
- IRC 연결을 생성했습니다.
- 메시지를 수신하고 전송하기 위한 IRC 닉네임이 있습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 흐름에 추가할 IRC 연결을 클릭합니다.
하나 이상의 채널에 메시지를 전송하기 위해 IRC Send Message 를 선택합니다.
- 채널 필드에 하나 이상의 IRC 채널을 쉼표로 구분합니다. 이 연결은 실행 중에 지정하는 IRC 닉네임에서 이러한 채널로 메시지를 보냅니다.
- 닉네임 필드에서 지정된 채널에 메시지를 보내는 IRC 닉네임을 지정합니다.
- NickServ 암호 필드에서 지정한 닉네임에 암호가 있는 경우 여기에 지정합니다.
- 다음을 클릭하여 작업의 입력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 입력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭하여 흐름에 연결을 추가합니다.
결과
연결은 추가한 흐름 시각화에 표시됩니다.
14장. JIRA에 연결
통합에서는 Jira 서버에 연결하여 문제를 해결, 생성 또는 업데이트할 수 있습니다. Jira는 소프트웨어 개발 프로젝트를 계획, 추적 및 관리하는 툴입니다. 각 Jira 환경에서는 워크플로우를 사용자 지정할 수 있으므로 통합에서 Jira에 연결하기 위한 세부 정보에 영향을 미칩니다. Jira 관리자와의 컨설팅은 세부 사항을 명확히 설명해야합니다.
다음 주제에서는 Jira 서버에 연결하는 통합을 생성하기 위한 정보 및 절차를 제공합니다.
14.1. OAuth를 사용하는 Jira 서버에 Fuse Online 등록
통합은 OAuth 프로토콜을 사용하여 액세스를 인증하는 Jira 서버에 연결할 수 있습니다. 이를 활성화하려면 Fuse Online 환경을 Jira 클라이언트 애플리케이션으로 등록합니다. Jira 클라이언트 애플리케이션은 Jira 소비자라고도 합니다. 즉, Fuse Online 환경은 Jira 소비자입니다.
Jira 서버에서 기본 인증만 사용하는 경우에는 등록이 필요하지 않습니다.
다음 절차에 따라 Jira에 대한 Fuse Online 연결을 생성하는 데 필요한 Jira OAuth 인증 정보를 가져옵니다. 샘플 서버의 단계를 수행하는 튜토리얼을 포함하여 Jira 소비자 등록에 대한 자세한 내용은 Jira 문서를 참조하십시오.
Jira 서버에 Fuse Online을 등록한 후 Fuse Online을 사용하여 해당 Jira 서버에 대한 연결을 생성합니다. 모든 통합에서 동일한 Jira 연결을 사용할 수 있습니다. 그러나 다른 Jira 연결을 생성하려면 여기에 제공된 등록 절차를 반복하여 다른 OAuth 인증 정보 세트를 가져와야 합니다.
기본 단계 개요
등록 절차의 주요 단계는 다음과 같습니다.
- OAuth 인증 정보를 가져올 수 있는 Atlassian 명령줄 애플리케이션을 가져옵니다.
-
다운로드한 애플리케이션을 실행하여
config.properties파일을 생성합니다. - Fuse Online에서 Jira 서버에 액세스하는 데 사용하는 공개/개인 키 쌍을 생성합니다.
-
config.properties파일을 편집하여 일부 값을 업데이트합니다. - Fuse Online 환경을 소비자 애플리케이션으로 인식하도록 Jira 서버를 구성합니다.
- Fuse Online에서 Jira 서버의 데이터에 액세스해야 하는 Jira 액세스 토큰을 받으십시오.
이러한 각 단계에는 몇 가지 하위 단계가 있으며 아래 절차에서는 세부 정보를 제공합니다.
사전 요구 사항
- JIRA 서버 관리 권한.
- 명령줄 인터페이스에 대해 숙지합니다.
절차
OAuth 인증 정보를 가져올 수 있는 Atlassian 명령줄 애플리케이션을 가져옵니다.
-
atlassian-oauth-examples페이지로 이동합니다. - 왼쪽 패널에서 아래쪽에서 다운로드를 클릭합니다.
- 다운로드 페이지에서 리포지토리 다운로드를 클릭합니다.
- 파일을 선택한 디렉터리로 추출합니다.
-
다운로드한 애플리케이션을 실행하여 OAuth 인증 정보에 대한
config.properties파일을 생성합니다.- 터미널에서 추출된 콘텐츠가 포함된 디렉터리로 이동합니다.
java디렉터리로 변경하고 클라이언트를 빌드합니다.cd atlassianlabs-atlassian-oauth-examples-dd0264cad043/java mvn clean compile assembly:single
대상디렉터리로 변경하고config.properties파일을 생성합니다.cd target java -jar OAuthTutorialClient-1.0.jar requestToken
연결 예외를 무시할 수 있습니다.
대상디렉터리에는 이제 일부 임시 키가 포함된config.properties파일이 있습니다.Fuse Online에서 Jira 서버에 액세스해야 하는 공개/개인 키 쌍을 생성합니다. 이러한 명령을 어디에서나 실행할 수 있지만 첫 번째 명령은 편의를 위해 특정 디렉터리로 안내합니다.
- 다운로드한 애플리케이션이 포함된 디렉터리로 이동합니다.
개인 키를 생성합니다.
openssl genrsa -out jira_privatekey.pem 1024
공개 키를 가져옵니다.
openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365
이 명령은 Fuse Online 환경에 대한 정보를 입력하라는 메시지를 표시합니다. 또는 프롬프트에 응답하지 않도록 하려면 명령에
-subj옵션을 추가합니다. 예를 들어 위의 명령행 끝에 다음과 같이 추가합니다.-subj "/C=US/ST=New York/L=New York/O=MyCompany Ltd./OU=IT/CN=mysubdomain.mydomain.com"
키를 내보냅니다.
openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8 openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pem
이제 4개의 파일이 있습니다.
jira_privatekey.pcks8jira_privatekey.pemjira_publickey.cerjira_publickey.pem헤더, 줄 바꿈 및 발퍼 없이 개인 키를 가져옵니다.
cat jira_privatekey.pcks8 | grep -v 'PRIVATE'|awk '{print}' ORS=''- 개인 키를 클립보드에 복사합니다.
config.properties파일을 편집합니다.-
config.properties파일이 포함된java/target디렉터리로 이동하여 편집을 위해 파일을 엽니다. -
config.properties파일에서 프라이빗 키를 클립보드에 복사한 개인 키로 교체합니다. jira_home설정을 Jira 서버의 URL로 변경합니다. Jira 서버가https를 사용하는 경우https를 지정해야 합니다. 또한 콜론을 이스케이프해야 합니다. 예를 들면 다음과 같습니다.jira_home=https\://issues.mycompany.org
consumer_key설정을Fuse Online App으로 변경합니다. 예를 들면 다음과 같습니다.consumer_key=Fuse Online App
-
config.properties파일을 저장하고 닫습니다.
-
Fuse Online 환경을 소비자 애플리케이션으로 인식하도록 Jira 서버를 구성합니다. 관리 사용자로 Jira 서버에 로그인해야 합니다.
-
설정 (
) > 제품 > 애플리케이션 링크를 선택합니다.
새 링크 입력 생성 필드에 URL을 입력합니다(예:
https://example.com).여기에는 응답이 수신되지 않았음을 나타내는 대화 상자가 표시됩니다. 단방향 통신만 필요하기 때문입니다.
계속 을 클릭하여 링크 애플리케이션 대화 상자를 표시합니다. 이 대화 상자에서 다음을 수행합니다.
-
소비자 키 필드에
Fuse Online App을 입력합니다. - 맨 아래에서 들어오는 링크 만들기 를 선택합니다.
- 다른 각 필드에 값을 입력합니다. 각 필드에는 값이 필요합니다. 응답이 필요하지 않기 때문에 입력하는 값은 중요하지 않습니다.
- Continue 를 클릭하여 다른 대화 상자를 표시합니다.
-
소비자 키 필드에
Fuse Online App을 입력합니다. -
소비자 이름 필드에
Fuse Online App을 입력합니다. -
공개 키 필드에
jira_publickey.pem파일에 있는 공개 키를 붙여넣습니다. 제목과 footer 없이 키만 붙여넣어야 합니다. 복사할 수 있도록 키를 표시하려면jira_publickey.pem파일이 포함된 디렉터리에cat jira_publickey.pem을 입력합니다. - Continue 를 클릭합니다.
-
소비자 키 필드에
-
설정 (
Fuse Online에서 Jira 서버의 데이터에 액세스해야 하는 Jira 액세스 토큰을 받으십시오. 이 절차의 시작 부분에 연결된 Jira OAuth 설명서에서 이 단계를 Fuse Online, Jira 서버 및 Jira 관리자 간에 교환하기 때문에 "Oauth dance"라고 합니다.
-
이 전체 절차의 첫 번째 단계에서 다운로드한 명령줄 애플리케이션이 포함된 디렉터리의
java/target디렉터리로 이동합니다. Jira 서버에서 요청 토큰을 가져옵니다.
java -jar OAuthTutorialClient-1.0.jar requestToken
다음과 같이 표시됩니다.
Token: ec3dj4byySM5ek3XW7gl7f4oc99obAlo Token Secret: OhONj0eF7zhXAMKZLbD2Rd3x7Dmxjy0d Retrieved request token. go to https://jira101.atlassian.net/plugins/servlet/oauth/authorize?oauth_token=ec3dj4byySM5ek3XW7gl7f4oc99obAlo to authorize it
- 다른 브라우저 탭에서 해당 출력에 제공된 URL로 이동합니다. 해당 페이지에서는 Jira를 시작하고 Fuse Online App에 대한 액세스를 허용하라는 메시지를 표시합니다.
- 확인 코드가 포함된 액세스 승인 페이지가 표시되는 허용 을 클릭합니다.
- 확인 코드를 클립보드에 복사하여 쉽게 검색할 수 있도록 에 붙여넣습니다.
다음과 같은 명령을 호출하여 액세스 토큰을 확보합니다. 다음 명령줄 예제에서 마지막 값은 확인 코드입니다. 실행하는 명령에서 예제 확인 코드를 이전 단계에서 복사한 확인 코드로 바꿉니다. 예를 들면 다음과 같습니다.
java -jar OAuthTutorialClient-1.0.jar accessToken qTJkPi
이 명령의 출력은 Fuse Online에서 Jira 서버에 액세스해야 하는 액세스 토큰입니다.
-
이 전체 절차의 첫 번째 단계에서 다운로드한 명령줄 애플리케이션이 포함된 디렉터리의
결과
Jira 명령줄 애플리케이션은 Fuse Online에 대한 Jira 연결을 구성하는 데 필요한 모든 값을 포함하도록 config.properties 파일을 업데이트합니다.
다음 단계
Jira 연결을 생성합니다.
14.2. Jira 연결 생성
통합에서 Jira 문제를 수집, 생성 또는 업데이트하려면 Jira 연결을 생성한 다음 통합에 추가합니다. 통합에 동일한 연결을 추가할 수 있습니다.
액세스 인증을 위해 OAuth 프로토콜을 사용하기 위해 연결하려는 Jira 서버가 Fuse Online 환경을 연결하려는 Jira 서버의 클라이언트로 등록해야 합니다. OAuth를 사용하는 Jira 서버가 있는 Fuse Online 등록을 참조하십시오.
사전 요구 사항
- 기본 인증을 사용하는 Jira 서버의 경우 Jira 사용자 이름과 암호가 있습니다.
-
OAuth를 사용하는 Jira 서버의 경우 Jira 액세스 토큰, 소비자 키, 개인 키 및 확인 코드에 대한 값이 포함된
config.properties파일에 액세스할 수 있습니다.
절차
- Fuse Online의 탐색 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 사용 가능한 커넥터를 표시합니다.
- Jira 커넥터를 클릭합니다.
Jira URL 필드에 통합이 연결하려는 Jira 서버의 URL을 입력합니다(예:
https://issues.mycompany.org).Jira 서버에 대한 연결의 경우 OAuth를 사용하여 Fuse Online 환경을 Jira 소비자 애플리케이션으로 등록하면
config.properties파일이 발생했습니다. 여기에서 지정하는 URL은config.preperties파일에 있는 URL과 같아야 합니다. 예를 들어config.properties파일에 다음과 같은 행이 표시됩니다.jira_home=https\:issues.mycompany.org
이 Jira 서버는 기본 인증을 사용하는 경우:
- 사용자 이름 필드에 Jira 사용자 이름을 입력합니다. 연결은 이 계정을 사용하여 지정된 Jira 서버에서 작동합니다.
- 암호 필드에 지정된 사용자의 암호를 입력합니다.
Jira 서버가 OAuth 인증을 사용하지 않는 경우 다음 단계를 건너뜁니다.
Jira 서버가 OAuth 인증을 사용하는 경우:
-
OAuth 액세스 토큰, 키 및 확인 코드가 포함된
config.properties파일을 엽니다. 이는 등록 절차의 결과인 파일입니다. 해당 파일에서 값을 복사하여 연결 구성 필드에 붙여넣습니다. -
access_token값을 Access Token 필드에 복사합니다. -
consumer_key값을 Consumer Key 필드에 복사합니다. -
private_key값을 개인 키 필드에 복사합니다. -
시크릿값을 확인 코드 필드에 복사합니다.
-
OAuth 액세스 토큰, 키 및 확인 코드가 포함된
- Validate 를 클릭합니다. Fuse Online에는 이 연결의 유효성을 검사할 수 있는지 여부를 나타내는 메시지가 표시됩니다. 유효성 검사가 실패하면 다시 시도한 후 올바른 값을 입력해야 합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
Jira Connect 1을 입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
jkim 계정을 사용하는 샘플 Jira 연결을 입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 Jira Connect 1 이 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
14.3. 통합 실행을 트리거하기 위해 Jira 문제 또는 주석 가져오기
Jira 서버에서 문제 또는 주석을 가져올 때 통합 실행을 트리거하려면 간단한 통합 시작 연결로 Jira 연결을 추가합니다.
사전 요구 사항
- Jira 연결을 생성하셨습니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 통합을 시작하는 데 사용할 Jira 연결을 클릭합니다.
작업 선택 페이지에서 작업을 선택합니다.
- 새 댓글 검색에서는 Jira 서버를 검색하는 데 지정하는 쿼리를 사용합니다. 쿼리가 반환하는 각 문제에 대해 연결에서 쿼리의 이전 호출 이후 주석이 추가되었는지 여부를 확인합니다. 연결에서 새 주석을 반환합니다.
- 새 문제 검색에서는 Jira 서버를 검색하기 위해 지정하는 쿼리를 사용합니다. 쿼리가 반환하는 각 문제에 대해 연결에서 생성 날짜를 확인합니다. 이전 쿼리를 호출한 후 문제가 생성된 경우 연결에서 통합에 문제가 반환됩니다. 연결이 이 쿼리를 처음 실행할 때 발견한 모든 문제를 반환합니다.
- Delay 필드에서 기본값 5000밀리초(5초)를 수락하거나 쿼리 호출 간에 경과할 시간(밀리초)을 입력합니다.
Jira Query Language 필드에 Jira 쿼리를 입력합니다. 예를 들면 다음과 같습니다.
project = GATE AND assignee = jkim AND (status = Open OR status = New OR status = Reopened)
이 쿼리는 게이트웨이 온라인 프로젝트에서 jkim 에 할당되고 해결되지 않은 문제를 찾습니다. 모든 Jira 프로젝트에는 짧은 이름과 긴 이름이 있습니다. 이 예제에서 게이트웨이 온라인 프로젝트의 짧은 이름은 GATE 입니다. 쿼리에서 프로젝트의 짧은 이름을 지정합니다.
쿼리가 더 구체적으로 표시될수록 Jira 서버를 검색하는 데 걸리는 시간이 줄어듭니다. 쿼리에 결과가 없는 경우 연결에서 통합 실행을 트리거하지 않습니다.
- 다음을 클릭합니다.
결과
연결은 간단한 통합을 시작하고 Fuse Online에서 통합의 완료 연결을 선택하라는 메시지를 표시합니다.
14.4. Jira 서버에 문제 추가
흐름 중에 또는 간단한 통합을 완료하기 위해 Jira 서버에 연결하여 문제를 추가할 수 있습니다.
사전 요구 사항
- Jira 연결을 생성하셨습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 간단한 통합 연결 완료를 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 Jira 연결을 추가할 더하기 기호를 클릭합니다. 간단한 통합의 완료 연결을 추가하는 경우 이 단계를 건너뜁니다.
- 통합에서 Jira 서버에 연결하는 데 사용할 Jira 연결을 클릭합니다.
- 작업 선택 페이지에서 문제 추가 를 선택합니다.
작업을 구성합니다. 필수 필드는 발급 유형 ID 또는 이름과 프로젝트 키 입니다. 선택적 필드의 경우 지금 값을 입력하거나 통합에 이 연결을 추가한 후 이 연결 전에 데이터 매퍼 단계를 추가할 수 있습니다. 데이터 매퍼 단계에서 이전 단계의 필드를 이 연결의 선택적 필드에 매핑합니다.
- 필요한 경우 Assignee 필드에 이 문제를 할당하려는 사용자의 Jira 사용자 이름을 입력합니다.
- 선택적으로 Components 필드에 하나 이상의 구성 요소의 이름을 입력합니다. 여러 이름을 쉼표로 구분합니다. Jira 관리자는 지정할 수 있는 구성 요소를 정의합니다.
- 필요한 경우 우선 순위 ID 또는 이름 필드에 새 문제의 우선 순위를 입력합니다. Jira 관리자는 입력할 수 있는 우선 순위 값을 정의합니다.
- 필요한 경우 Summary 필드에 문제에 대한 간략한 설명을 입력합니다.
Issue type ID 또는 name 필드에 문제 유형을 설명하는 값을 입력합니다. 예를 들어, 이것은 종종 history , Cryo
stat,Chore또는Bug와 같은 것입니다.JIRA에서 관리자 권한이 있는 사용자는 프로젝트 설정 > 문제 유형 을 선택하여 유효한 문제 유형 목록을 볼 수 있습니다. 이러한 권한이 없는 사용자는 문제의 유형 필드를 클릭하면 허용 가능한 값 목록이 표시되어야 합니다.
- 선택적으로 Watchers 필드에 Jira 사용자 이름의 쉼표로 구분된 목록을 입력합니다. 이러한 사용자는 이 문제가 업데이트될 때 알림을 받습니다.
-
프로젝트 키 필드에 Jira 관리자가 정의한 Jira 프로젝트의 짧은 이름을 입력합니다. 이 연결은 이 프로젝트에서 새 문제를 생성합니다. 예를 들어 프로젝트 키는
GATE와 같습니다. - 선택적으로 Description 필드에 이 문제에 대한 정보를 캡처하는 데 유용한 정보를 입력합니다.
- 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
14.5. Jira 문제에 주석 추가
흐름 중간에 또는 간단한 통합을 완료하기 위해 Jira 서버에 연결하여 문제에 주석을 추가할 수 있습니다.
사전 요구 사항
- Jira 연결을 생성하셨습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 간단한 통합 연결 완료를 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 Jira 연결을 추가할 더하기 기호를 클릭합니다. 간단한 통합의 완료 연결을 추가하는 경우 이 단계를 건너뜁니다.
- 통합에서 Jira 서버에 연결하는 데 사용할 Jira 연결을 클릭합니다.
- 작업 선택 페이지에서 주석 추가 를 선택합니다.
- 주석 필드에 문제에 추가할 주석을 입력하거나 이 연결 전에 데이터 매퍼 단계를 추가할 계획입니다. 해당 데이터 매퍼 단계에서 이전 통합 단계의 주석을 이 연결의 주석 필드에 매핑합니다.
-
Issue Key 필드에 문제에 대한 Jira 식별자를 입력합니다. 문제 키의 예:
GATE-1234,Ent-239. - 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
다음 단계
이전 통합 단계의 주석을 이 연결에 매핑하려면 주석 콘텐츠를 제공하는 연결을 추가한 다음 이 Jira 연결 앞에 데이터 매퍼 단계를 추가합니다. 예를 들어 데이터베이스 연결이 고객 레코드를 가져오는 경우를 가정해 보겠습니다. 데이터 매퍼 단계에서 고객 레코드 컬렉션을 Jira 연결의 주석 필드에 매핑합니다.
14.6. Jira 문제에 파일 연결
흐름 중에 또는 간단한 통합을 완료하기 위해 Jira 서버에 연결하여 하나 이상의 파일을 문제에 연결할 수 있습니다. 통합에는 연결할 파일을 가져오는 이전 단계가 있어야 합니다.
사전 요구 사항
- Jira 연결을 생성하셨습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 간단한 통합 연결 완료를 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 Jira 연결을 추가할 더하기 기호를 클릭합니다. 간단한 통합의 완료 연결을 추가하는 경우 이 단계를 건너뜁니다.
- 통합에서 Jira 서버에 연결하는 데 사용할 Jira 연결을 클릭합니다.
- 작업 선택 페이지에서 파일 연결을 선택합니다.
-
Issue Key 필드에 파일을 첨부할 문제의 Jira 식별자를 입력합니다. 문제 키의 예:
GATE-1234,Ent-239. - 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
다음 단계
통합에 Jira 문제에 연결할 파일을 가져오는 이전 연결이 아직 없는 경우 통합에 해당 연결을 추가합니다. 파일을 연결하는 Jira 연결 전에 있는지 확인합니다. 예를 들어 FTP 연결을 추가하고 FTP 서버에서 하나 이상의 파일을 다운로드한다고 가정합니다. 통합이 실행되면 후속 Jira 연결에서 연결 파일 작업을 구성할 때 지정한 Jira 문제에 해당 파일을 연결합니다.
14.7. Jira 문제 감시자 추가 및 제거
흐름 중간에 또는 간단한 통합을 완료하기 위해 Jira 서버에 연결하여 문제에 감시자를 추가하고 문제에서 감시자를 제거할 수 있습니다.
사전 요구 사항
- Jira 연결을 생성하셨습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 간단한 통합 연결 완료를 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 Jira 연결을 추가할 더하기 기호를 클릭합니다. 간단한 통합의 완료 연결을 추가하는 경우 이 단계를 건너뜁니다.
- 통합을 사용할 Jira 연결을 클릭합니다.
- 작업 선택 페이지에서 문제 추가 를 선택합니다.
-
Issue Key 필드에 감시자를 추가하거나 감시자를 제거하려는 문제의 Jira 식별자를 입력합니다. 문제 키의 예:
GATE-1234,Ent-239. - 선택적으로 Add Watchers 필드에 Jira 사용자 이름의 쉼표로 구분된 목록을 입력합니다. 이러한 사용자는 이 문제가 업데이트될 때 알림을 받습니다.
- 선택적으로 Remove Watchers 필드에 이 문제를 감시하고 있는 Jira 사용자 이름 목록을 쉼표로 구분하여 입력합니다. 이 연결은 감시자 목록에서 이러한 사용자를 제거합니다.
- 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
14.8. Jira 서버에서 문제 업데이트
흐름 중에 또는 간단한 통합을 완료하기 위해 Jira 서버에 연결하여 문제를 업데이트할 수 있습니다. 연결은 하나 이상의 문제 필드를 업데이트할 수 있습니다. 업데이트 중인 문제에 이미 필드에 대한 값이 있는 경우 연결에서 해당 값을 연결에 지정한 값 또는 연결 필드에 매핑하는 값으로 교체합니다. 예를 들어 문제에 설명이 이미 있고 Update Issue 작업을 구성할 때 Description 필드에 텍스트를 지정하면 이 새 설명과 함께 제공된 설명이 교체됩니다.
사전 요구 사항
- Jira 연결을 생성하셨습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 간단한 통합 연결 완료를 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 Jira 연결을 추가할 더하기 기호를 클릭합니다. 간단한 통합의 완료 연결을 추가하는 경우 이 단계를 건너뜁니다.
- 통합에서 Jira 서버에 연결하는 데 사용할 Jira 연결을 클릭합니다.
- 작업 선택 페이지에서 문제 업데이트를 선택합니다.
작업을 구성합니다. 유일한 필수 필드는 문제 키 입니다. 선택적 필드의 경우 지금 값을 입력하거나 통합에 이 연결을 추가한 후 이 연결 전에 데이터 매퍼 단계를 추가할 수 있습니다. 데이터 매퍼 단계에서 이전 단계의 필드를 이 연결의 선택적 필드에 매핑합니다.
- 필요한 경우 Assignee 필드에 이 문제를 할당하려는 사용자의 Jira 사용자 이름을 입력합니다.
- 선택적으로 Components 필드에 하나 이상의 구성 요소의 이름을 입력합니다. 여러 이름을 쉼표로 구분합니다. Jira 관리자는 지정할 수 있는 구성 요소를 정의합니다.
-
Issue Key 필드에 연결을 업데이트할 문제의 Jira 식별자를 입력합니다. 문제 키의 예:
GATE-1234,Ent-239. - 필요한 경우 우선 순위 ID 또는 이름 필드에 새 문제의 우선 순위를 입력합니다. Jira 관리자는 입력할 수 있는 우선 순위 값을 정의합니다.
- 필요한 경우 Summary 필드에 문제에 대한 간략한 설명을 입력합니다.
-
Issue type ID 또는 name 필드에 문제 유형을 설명하는 값을 입력합니다. 예를 들어, 이것은 종종 history , Cryo
stat,Chore또는Bug와 같은 것입니다. - 선택적으로 Description 필드에 이 문제에 대한 정보를 캡처하는 데 유용한 정보를 입력합니다.
- 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
14.9. Jira 새 상태로 전환
흐름 중에 또는 간단한 통합을 완료하기 위해 Jira 서버에 연결하여 문제를 새 상태로 전환하거나 새 워크플로우 단계로 전환할 수 있습니다. Jira 관리자는 전환 문제에 대한 의미와 전환 ID 값을 정의합니다.
사전 요구 사항
- Jira 연결을 생성하셨습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 간단한 통합 연결 완료를 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 Jira 연결을 추가할 더하기 기호를 클릭합니다. 간단한 통합의 완료 연결을 추가하는 경우 이 단계를 건너뜁니다.
- 통합에서 Jira 서버에 연결하는 데 사용할 Jira 연결을 클릭합니다.
작업 선택 페이지에서 전환 문제를 선택합니다.
전환 문제 작업을 구성하기 위해 값을 지정할 필요가 없습니다. 대신 이전 통합 단계의 값을 이 연결의 필드에 매핑할 수 있습니다.
- 필요한 경우 주석 필드에 문제에 추가할 주석을 입력합니다.
-
선택적으로 Issue Key 필드에 전환 중인 문제에 대한 Jira 식별자를 입력합니다. 문제 키의 예:
GATE-1234,Ent-239. 선택적으로 전환 필드의 ID 에 Jira 관리자가 특정 전환과 관련된 정수를 입력합니다 (예: Jira가 새로운 작업에서 작업 중으로 이동하거나 테스트 중인 상태로 이동하는 경우 등).
Jira 관리자는 프로젝트의 워크플로우 디스플레이에서 전환 ID를 볼 수 있습니다. 관리 권한이 없는 경우 Jira 관리자에서 허용되는 전환 ID를 가져옵니다.
- 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
다음 단계
각 Transition Issue 필드에 값을 지정하지 않은 경우 통합에 각 필드의 값을 가져오는 단계가 있는지 확인합니다. 통합에 필요한 모든 연결이 포함된 후 문제를 전환하는 Jira 연결 앞에 데이터 매퍼 단계를 추가합니다. 데이터 매퍼 단계에서 이전 단계의 필드를 문제를 전환하는 Jira 연결의 필드에 매핑합니다.
15장. Kafka에 연결
Apache Kafka는 데이터를 가져오고 게시하는 데 사용할 수 있는 분산 스트리밍 플랫폼입니다. 통합에서는 사용자가 지정하는 Kafka 주제의 데이터를 구독하거나 지정하는 Kafka 항목에 게시할 수 있습니다. 이렇게 하려면 Kafka에 대한 연결을 생성하고 통합 흐름에 해당 연결을 추가합니다. 자세한 내용은 다음 항목에 있습니다.
15.1. Kafka 브로커에 대한 연결 생성
통합에서 Kafka 주제의 데이터를 구독하거나 Kafka 항목에 데이터를 게시하려면 Kafka에 대한 연결을 생성한 다음 통합에 해당 연결을 추가합니다.
사전 요구 사항
- Kafka 인스턴스를 생성하고, 서비스 계정을 생성하고, Apache Kafka용 Red Hat OpenShift Streams 시작하기에 설명된 Kafka 주제를 설정했습니다. 서비스 계정의 클라이언트 ID 및 클라이언트 시크릿을 알고 있습니다.
Kafka 인스턴스의 부트스트랩 서버 URI를 알고 있습니다. 부트스트랩 서버 URI를 가져오려면 다음을 수행합니다.
- Red Hat Managed Services 웹 콘솔에 로그인합니다.
- 웹 콘솔 의 Kafka 인스턴스 페이지에서 연결하려는 관련 Kafka 인스턴스의 경우 옵션 아이콘(세로 점)을 선택한 다음 연결을 클릭하여 부트스트랩 서버 URI를 확인합니다.
- PLAIN SSL 메커니즘의 경우 사용자 이름과 암호를 알고 있습니다.
- TLS(Transport Layer Security)를 사용하여 데이터를 암호화하려면 Kafka 브로커의 PEM 인증서 텍스트가 있습니다. 일반적으로 Kafka 서버 관리자에서 브로커 인증서 텍스트를 가져옵니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 커넥터를 표시합니다.
- Kafka Message Broker 커넥터를 클릭합니다.
Kafka 브로커 URI 필드에 이 연결에 액세스할 브로커를 입력하거나 선택하거나 Kafka 브로커 URI의 쉼표로 구분된 목록을 입력합니다. 각 URI는
host:port형식이어야 합니다.Red Hat Managed Kafka는 관리형 Kafka 인스턴스의 부트스트랩 서버 URI를 입력합니다. OpenShift 클러스터에 Strimzi Operator 또는 AMQ Streams Operator를 설치한 경우 URI가 자동으로 검색되고 이를 선택할 수 있습니다.
보안 프로토콜 필드의 경우 다음 옵션 중 하나를 선택합니다.
- 데이터를 암호화하여 전송 중에 보호하려면 TLS (Transport Layer Security)를 선택합니다. 단계 7로 건너뜁니다.
- SASL으로 인증하고 SSL을 사용하여 데이터를 암호화하려면(예: Red Hat Managed Kafka 사용) SASL_SSL 을 선택합니다.
- 데이터를 암호화하지 않으려면 Plain 을 선택한 다음 8 단계로 건너뜁니다.
SASL_SSL 을 보안 프로토콜 로 선택한 경우 인증 정보를 설정하려면 두 가지 옵션 중에서 선택해야 합니다.
- PLAIN 을 SASL Mechanism 으로 사용하려면 Username 및 Password 필드를 설정해야 합니다.
OAUTHBEARER 를 SASL 메커니즘으로 사용하려면 다음 필드를 설정해야 합니다.
- OAuth 클라이언트 ID가 있는 사용자 이름입니다.
- OAUth 클라이언트 시크릿을 사용한 암호 입니다.
SASL 로그인 콜백 핸들러 클래스는 kafka-clients 2.5 버전 또는 Strimzi 프로젝트의 kafka-oauth-client의 콜백 처리기 클래스 를 사용할 수 있습니다. Red Hat Managed Kafka에 연결하려면 다음을 사용합니다.
io.strimzi.kafka.oauth.client.JaasClientOauthLoginCallbackHandler-
공급자가 제공하는
/oauth/token엔드포인트 URI를 사용한 OAuth 토큰 끝점 URI입니다.
- 5단계에서 TLS 를 선택한 경우 Broker 인증서 필드에서 Kafka 브로커의 PEM 인증서 텍스트를 붙여넣습니다.
선택 사항: Add a custom property 를 클릭하여
key:value쌍을 지정하여 Kafka 생산자 및 소비자 옵션을 구성합니다.예를 들어 새 통합에서 주제의 이전 메시지를 소비하려면 키 필드에
auto.offset.reset값을 입력하고 Value 필드의 경우가장 빠른속도로 auto.offset.reset 값을 입력하여 기본 (최신)에서 가장 빨리 auto.offset.reset 값을 변경합니다.Kafka 생산자 구성 옵션에 대한 자세한 내용은 https://kafka.apache.org/documentation/#producerconfigs로 이동하십시오.
Kafka 소비자 구성 옵션에 대한 자세한 내용은 https://kafka.apache.org/documentation/#consumerconfigs로 이동하십시오.
참고: 구성 속성을 추가하는 경우 Fuse Online에서는 다음 단계에서 유효성 검사 프로세스의 일부로 포함되지 않습니다.
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 입력 매개변수를 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
- 이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어 Kafka 테스트를 입력할 수 있습니다.
- 설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다.
- 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력한 경우 Kafka Test 가 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
15.2. 통합 실행을 트리거하기 위해 Kafka 브로커에서 데이터 가져오기
Kafka 브로커에서 데이터를 수신할 때 통합 실행을 트리거하려면 Kafka 연결을 시작 연결로 추가합니다. 통합이 실행되면 Kafka 연결은 사용자가 지정하는 Kafka 주제의 데이터를 지속적으로 감시합니다. 연결에서 새 데이터를 찾으면 통합의 다음 단계로 해당 데이터를 전달합니다.
사전 요구 사항
Kafka 브로커에 대한 연결을 생성했습니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 통합을 시작하는 데 사용할 Kafka 연결을 클릭합니다.
- 작업 선택 페이지의 서브스크립션 작업을 선택하여 지정한 주제에서 데이터를 수신합니다.
- Topic Name 필드에서 아래 캐at을 클릭하여 주제 목록을 표시하고 구독할 주제를 클릭합니다. 또는 해당 주제를 생성할 주제 이름을 입력합니다.
- 다음을 클릭하여 작업의 출력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 Kafka 연결 출력을 후속 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터를 인식하지 못합니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
이제 통합에 연결 및 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
15.3. Kafka 브로커에 데이터 게시
통합에서는 흐름 중 Kafka 브로커에 데이터를 게시하거나 간단한 통합을 완료할 수 있습니다. 이렇게 하려면 흐름 중간에 Kafka 연결을 추가하거나 간단한 통합의 완료 연결로 추가합니다.
사전 요구 사항
- Kafka 브로커에 대한 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 Kafka 연결을 추가할 더하기 기호를 클릭합니다. 간단한 통합의 완료 연결을 추가하는 경우 이 단계를 건너뜁니다.
- 메시지를 게시하는 데 사용할 Kafka 연결을 클릭합니다.
- 작업 선택 페이지에서 게시 를 선택합니다.
- Topic Name 필드에서 아래 캐at을 클릭하여 주제 목록을 표시하고 게시할 주제를 클릭합니다.
- 다음을 클릭하여 작업의 입력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 입력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
16장. Apache Kudu에 연결
Apache Kudu는 Apache Cryostat 플랫폼을 위해 개발된 고리 스토리지 관리자입니다. Fuse Online 통합은 Kudu 데이터 저장소에 연결하여 테이블을 스캔하여 테이블의 모든 레코드를 통합으로 반환하거나 테이블에 레코드를 삽입할 수 있습니다. 자세한 내용은 다음 항목에 있습니다.
16.1. Apache Kudu 데이터 저장소에 대한 연결 생성
통합을 통해 레코드에서 레코드를 가져오거나 Kudu 테이블에 삽입하려면 Kudu 마스터 호스트에 연결을 생성한 다음 통합에 해당 연결을 추가합니다.
사전 요구 사항
- 연결하려는 Kudu 마스터 호스트의 IP 주소 또는 호스트 이름을 알아야 합니다.
- Kudu가 수신 대기 중인 포트를 알아야 합니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 커넥터를 표시합니다.
- Apache Kudu 커넥터를 클릭합니다.
연결을 구성하려면 다음을 수행합니다.
- Kudu 마스터 호스트 주소 필드에 Kudu 마스터 호스트의 호스트 이름 또는 IP 주소를 입력합니다.
-
Port to establish connection to 필드에 Kudu가 수신 대기 중인 포트를 입력합니다. 기본값은
7051입니다.
- 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
Kudu North를 입력할 수 있습니다. - 설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다.
- 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 Kudu North 가 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
16.2. 스캔할 때 통합 트리거에서 Kudu 테이블의 레코드 반환
Kudu 테이블에서 데이터를 가져올 때 통합 실행을 트리거하려면 시작 연결로 Kudu 연결을 간단한 통합에 추가합니다. 통합이 실행되면 Kudu 연결은 사용자가 지정한 간격으로 지정한 테이블을 검색하고, 표의 모든 레코드를 가져오고, 레코드 컬렉션을 통합에서 다음 단계로 전달합니다.
Kudu 연결은 하나의 테이블에서만 데이터를 가져올 수 있습니다. 검사 사이에 연결 검색에 대한 데이터가 변경 사항이 없는 경우 다음 검사에서는 이전 스캔과 동일한 데이터를 반환합니다.
사전 요구 사항
- Kudu 연결을 생성하셨습니다.
- 레코드를 가져오려는 테이블이 존재합니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 통합을 시작하는 데 사용할 Kudu 연결을 클릭합니다.
- 작업 선택 페이지에서 Kudu 테이블 검사 작업을 선택합니다.
- 테이블 필드에 레코드를 가져올 테이블의 이름을 입력합니다.
- Period 필드에 기본값을 1분 동안 사용하거나 연결에서 테이블을 스캔하고 테이블에 있는 레코드를 반환할 간격을 입력합니다.
- 다음을 클릭합니다.
결과
연결은 간단한 통합의 시작 연결입니다.
다음 단계
통합의 완료 연결 및 통합에 포함할 기타 연결을 추가합니다. 통합에 필요한 모든 연결이 포함된 경우 Kudu 연결에서 반환하는 레코드 컬렉션을 분할해야 하는지 여부를 고려하십시오. Kudu 테이블에서 얻은 각 레코드에 대한 통합 단계를 실행하려면 Kudu 연결 후 분할 단계를 추가합니다. 또한 Kudu에서 가져온 데이터를 통합의 후속 연결에서 필드로 매핑하는 데이터 매핑 단계와 함께 Kudu 연결을 수행해야 할 수도 있습니다.
16.3. Kudu 테이블에 레코드 삽입
통합에서는 흐름 중 Kudu 테이블에 레코드를 추가하거나 간단한 통합을 완료할 수 있습니다. 이렇게 하려면 흐름 중간 또는 간단한 통합의 완료 연결로 Kudu 연결을 추가합니다.
사전 요구 사항
- Kudu 연결을 생성하셨습니다.
- 통합을 만들거나 편집하고 Fuse Online에서 통합에 추가할 것을 요청하고 있습니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
- 레코드를 추가할 테이블입니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 사용하려는 Kudu 연결을 클릭합니다. Kudu 연결이 데이터를 삽입하면 연결은 아무것도 반환하지 않습니다.
- 작업 선택 페이지에서 Kudu 테이블에 데이터 삽입을 선택합니다.
작업을 구성하려면 표 필드에서 레코드를 추가할 테이블 이름을 지정합니다.
레코드를 추가하는 Kudu 테이블이 설정된 방법을 이해하는 것이 중요합니다. 예를 들어 레코드를 추가하는 Kudu 테이블에는 고유 키가 있을 수 있습니다. 테이블에 이미 있는 키 값이 포함된 레코드를 추가하려고 하면 Kudu 연결에서 해당 레코드를 추가하지 않습니다.
- 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
다음 단계
Kudu 연결이 테이블에 추가할 수 있는 개별 레코드로 레코드 컬렉션을 분할해야 하는지 여부를 고려하십시오. 이렇게 하려면 통합에 분할 단계를 추가합니다. 분할 단계는 통합의 후속 단계를 각 레코드에 대해 한 번 실행합니다. 또한 테이블에 레코드를 추가하는 Kudu 연결 전에 데이터 매퍼 단계가 필요할 수 있습니다.
17장. MongoDB에 연결
MongoDB는 분산 NoSQL 데이터베이스입니다. Fuse Online 통합은 MongoDB 데이터베이스에서 콘텐츠를 가져오거나 MongoDB 데이터베이스의 콘텐츠를 업데이트할 수 있습니다. 이렇게 하려면 MongoDB 연결을 생성하여 통합에 추가합니다.
MongoDB 데이터베이스에 연결하기 위한 세부 사항은 다음과 같습니다.
17.1. MongoDB 데이터베이스에 대한 연결 생성
통합에서 MongoDB 데이터베이스에 연결할 수 있도록 MongoDB 연결을 생성합니다.
사전 요구 사항
- 연결하려는 MongoDB 데이터베이스의 호스트 이름을 알아야 합니다.
- MongoDB 데이터베이스에 대한 액세스 권한을 부여하는 사용자 이름과 암호가 있어야 합니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 커넥터를 표시합니다.
- MongoDB 커넥터를 클릭합니다.
연결을 구성합니다.
-
데이터베이스 호스트 필드에서 이 연결에 액세스할 수 있는 하나 이상의 MongoDB 데이터베이스 호스트를 지정합니다.
host:port의 여러 사양을 쉼표로 구분합니다.host를 호스트 이름, 가상 호스트 이름 또는 IP 주소로 교체합니다. 예:mongodb0.example.com:1234,mongodb1.example.com:1234. - Username 필드에 데이터베이스에 액세스할 수 있는 사용자 이름을 입력합니다.
- 암호 필드에 지정한 사용자 이름의 암호를 입력합니다.
- 선택 사항: 관리 데이터베이스 필드에 관리 데이터베이스가 있는 경우 액세스 권한을 부여하는 데 사용되는 MongoDB 관리 데이터베이스의 이름을 입력합니다. MongoDB 관리자는 액세스하려는 데이터베이스에 관리 데이터베이스가 있는지 여부를 알아야 합니다.
- 선택 사항: Replica set name 필드에서 연결에 액세스할 수 있는 MongoDB 복제본 세트(클러스터)의 이름을 지정합니다.
- 데이터베이스 필드에 연결을 읽을 컬렉션이 포함된 MongoDB 데이터베이스의 이름을 입력합니다.
-
데이터베이스 호스트 필드에서 이 연결에 액세스할 수 있는 하나 이상의 MongoDB 데이터베이스 호스트를 지정합니다.
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 입력 매개 변수를 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
MongoDB North를 입력할 수 있습니다. - 설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다.
- 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력한 경우 MongoDB North 가 통합에 추가하도록 선택할 수 있는 연결로 표시됩니다.
다음 단계
MongoDB 연결을 통합에 추가합니다.
17.2. MongoDB 컬렉션이 업데이트될 때 통합 트리거
문서가 MongoDB 컬렉션에 추가될 때 통합 실행을 트리거하려면 시작 연결로 간단한 통합에 MongoDB 연결을 추가합니다. 통합이 실행되면 MongoDB 연결은 통합을 만들 때 지정한 데이터베이스 컬렉션을 모니터링합니다. 연결이 구성된 컬렉션에 새 문서를 삽입하면 통합 실행이 트리거됩니다. MongoDB 연결은 새 문서를 통합으로 반환하고 이 데이터는 통합의 다음 단계에서 사용할 수 있습니다.
사전 요구 사항
- MongoDB 연결을 생성했습니다.
- 연결을 읽을 MongoDB 컬렉션의 이름을 알고 있습니다.
모니터링할 연결이 제한된 컬렉션인 경우 다음을 알아야 합니다.
- 들어오는 문서를 추적하는 MongoDB 컬렉션 필드의 이름입니다.
- 컬렉션이 포함된 데이터베이스에 대해 영구 추적이 활성화되어 있는지 여부입니다.
- 연결을 읽을 데이터와 관련된 tail 추적 정보를 지정하는 방법 MongoDB 연결은 tail 추적 정보를 사용하여 예기치 않은 연결 종료 후 작업을 재개할 수 있습니다. tail 추적을 사용하면 연결이 작업을 재개할 때 중복 데이터를 통합에 반환하지 않고 통합으로 반환해야 하는 데이터가 삭제되지 않습니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 통합에서 업데이트를 가져올 데이터베이스에 액세스하도록 구성된 MongoDB 연결을 클릭합니다.
작업 선택 페이지에서 다음 작업 중 하나를 선택합니다.
- 문서 검색(스트림) 은 일반적으로 선택할 작업입니다. 이스케이프되지 않은 컬렉션에서 데이터를 검색합니다.
- 문서 검색(세부 정보) 은 제한된 컬렉션에서 데이터를 검색하는 작업입니다.
작업을 구성합니다.
컬렉션 이름 필드에 연결을 읽을 MongoDB 컬렉션의 이름을 입력합니다.
Retrieve documents (stream) 작업을 구성하는 경우 이는 유일한 필수 매개변수입니다. 6단계로 이동합니다. Retrieve documents (tail) 작업을 구성하는 경우 나머지 하위 단계를 따르십시오.
- 들어오는 문서 필드를 추적하는 데 사용되는 컬렉션 필드에 관련 MongoDB 컬렉션 필드의 이름을 입력합니다. 이 필드에는 날짜 또는 ID와 같이 정렬할 수 있는 데이터가 포함되어 있습니다.
- 연결을 읽을 데이터베이스에 영구 추적이 활성화된 경우 영구 추적이 활성화된 경우 확인란을 선택합니다.
- 선택 사항: 이 추적 프로세스 필드를 식별하는 고유 ID에서 동일한 컬렉션을 모니터링하는 소비자가 여러 개인 경우 고유한 ID를 지정합니다. 자세한 내용은 Tailable Cursor Consumer 에 대한 Camel 설명서를 참조하십시오.
- 선택 사항: tail 추적 정보를 저장하는 데 사용된 DB에서 tail 추적 정보가 포함된 MongoDB 데이터베이스의 이름을 입력합니다.
- 선택 사항: tail 추적 필드를 저장하는 데 사용되는 컬렉션에서 tail 추적 정보가 포함된 컬렉션의 이름을 입력합니다.
- 선택 사항: tail 추적 필드를 저장하는 데 사용되는 필드에 이 연결이 읽는 컬렉션에 대한 tail 추적 정보를 저장하는 필드의 이름을 입력합니다.
tail 추적 필드를 식별하려면 tail 추적 데이터베이스 또는 tail 추적 컬렉션을 지정할 수 있습니다. 이러한 정보 중 하나를 사용하면 연결에서 tail tracking 필드를 찾을 수 있습니다.
- 다음을 클릭하여 작업의 출력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 출력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
이제 통합이 시작 연결되고 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
실행하는 동안 연결은 삽입된 문서를 JSON 형식으로 반환합니다.
17.3. MongoDB 컬렉션의 문서 작업
통합에서는 MongoDB 컬렉션에 문서를 검색, 업데이트, 삭제, 개수 또는 추가할 수 있습니다. 이렇게 하려면 흐름 중 또는 간단한 통합의 완료 연결로 MongoDB 연결을 추가합니다.
사전 요구 사항
- MongoDB 연결을 생성했습니다.
- 연결을 작동할 MongoDB 컬렉션의 이름을 알고 있습니다.
- 통합을 만들거나 편집하고 Fuse Online에서 통합에 추가할 것을 요청하고 있습니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 MongoDB 연결을 추가할 더하기 기호를 클릭합니다. 간단한 통합의 완료 연결을 추가하는 경우 이 단계를 건너뜁니다.
- 사용하려는 MongoDB 연결을 클릭합니다.
- 작업 선택 페이지에서 연결을 수행할 작업을 선택합니다.
작업을 구성하려면 컬렉션 이름 필드에 연결을 작동할 컬렉션의 이름을 입력합니다.
삽입 작업을 선택한 경우:
- 연결 구성을 완료했습니다.
- 통합이 이 MongoDB 연결에 전달되는 데이터에 컬렉션에 추가할 문서를 지정하는 JSON 표기법이 포함되어 있는지 확인합니다.
- 다음을 클릭하여 이 연결을 통합에 추가합니다.
다른 모든 동작의 경우 다음 표는 작업을 구성하기 위해 두 번째 필드에 지정할 항목에 대한 정보를 제공합니다.
두 번째 필드는 작업할 문서 및 작업에 대한 세부 정보를 식별하는 JSON 표기법 표현식입니다. 들어오는 소스 필드를 표현식의 식별자에 매핑하려면 표현식에서
:#variable-name을 지정합니다.완전성을 위해 삽입 작업도 이 표에 설명되어 있습니다.
동작 수행하는 작업 매개변수 필드 반환 수량
지정한 개수 표현식을 충족하는 문서 수를 계산합니다.
Count 표현식 필드에서
{"test":"unit"}형식으로 JSON 필터 표현식을 지정합니다. 이 작업은단위의테스트특성 값이 있는 문서 수를 계산합니다.발견된 문서 수를 지정하는
java.lang.Long의 인스턴스입니다.delete
컬렉션에서 하나 이상의 문서를 제거합니다.
Delete 표현식 필드에서
{"test":"unit"}형식으로 JSON 표현식을 지정합니다. 이 작업은테스트특성에단위값이 있는 각 문서를 제거합니다.삭제된 문서 수를 지정하는
java.lang.Long의 인스턴스입니다.검색
지정한 필터 표현식과 일치하는 모든 문서를 찾습니다.
Filter 표현식 필드에서 하나 이상의 문서를 식별하는 JSON 표기법 문자열을 지정합니다.
목록( array)을 지정하는 JSON 표기법입니다. 각 목록 요소는 필터 표현식과 일치하는 문서를 식별하고 문서 콘텐츠를 제공합니다. 문서를 찾을 수 없는 경우 작업은 빈 목록을 반환합니다.
컬렉션의 데이터 모델에 대해 잘 알고 있어야 합니다. 컬렉션이 JSON 스키마를 준수하는 경우 반환된 목록 요소가 이 스키마를 준수하므로 이 스키마에 익숙해야 합니다. 자세한 내용은 MongoDB 데이터 모델을 참조하십시오.
후속 데이터 매퍼 단계에서 찾기 작업의 출력 데이터를 사용하려면 컬렉션은 JSON 스키마를 준수해야 합니다. 이를 통해 데이터 매퍼에서 데이터 필드를 표시할 수 있습니다. 자세한 내용은 JSON 스키마 검증을 위한 MongoDB 설명서를 참조하십시오.삽입
컬렉션에 하나 이상의 문서를 추가합니다.
문서를 삽입하기 위한 작업 구성 매개 변수는 없습니다. MongoDB 연결에 들어오는 데이터에는 컬렉션에 추가할 하나 이상의 문서를 지정하는 JSON 표기법이 포함되어야 합니다.
목록( array)을 지정하는 JSON 표기법입니다. 각 목록 요소는 이 동작이 삽입된 문서입니다.
업데이트
컬렉션에서 하나 이상의 문서를 업데이트합니다.
Filter criteria 필드에서 2개의 인수 배열을 지정합니다. 첫 번째 인수는 업데이트할 문서를 식별하는 필터 표현식입니다. 두 번째 인수는 문서를 업데이트하는 방법을 지정하는 MongoDB 업데이트 명령입니다. 업데이트 명령 형식은 https://docs.mongodb.com/manual/reference/method/db.collection.update/ 에 설명되어 있습니다. 예:
[{"_id":11},{$set: {"test":"updated!"}}].업데이트된 문서 수를 지정하는
java.lang.Long의 인스턴스입니다.Upsert
컬렉션에서 하나 이상의 문서를 업데이트하거나 Upsert 표현식 과 일치하는 문서가 없는 경우 문서를 만듭니다.
Upsert 표현식 필드에서 하나 이상의 문서를 식별하는 JSON 표기법을 지정합니다. 이 표현식은 일치하는 문서를 감지하기 위해 이 표현식을 사용합니다. 작업에서 컬렉션에서 일치하는 문서를 찾으면 해당 문서가 업데이트됩니다. 작업이 일치하는 문서를 찾지 못하면 새 문서가 생성됩니다. MongoDB 연결에 들어오는 데이터에는 다음을 지정하는 JSON 표기법이 포함되어야 합니다.
* 삽입 작업인지 또는 업데이트 작업인지를 식별하는
_id필드입니다.추가 또는 업데이트할 콘텐츠입니다.
업데이트된 문서 수 또는 삽입된 새 문서의 ID를 지정하는
com.mongodb.client.result.UpdateResult의 인스턴스입니다.각 작업은 응답을 반환합니다. 이 연결이 완료되면 응답이 손실되지만 로그 를 추가하여 응답을 캡처할 수 있습니다.
- 다음을 클릭합니다.
- 선택 사항: 이 연결이 완료되면 로그 단계를 추가하여 대신 통합을 완료합니다. 응답을 캡처하도록 로그 단계를 구성합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
다음 단계
다른 필요한 연결을 흐름에 추가합니다. 데이터를 처리하는 다른 단계를 추가합니다. 필요한 데이터 매핑 단계를 추가하여 통합을 완료합니다. MongoDB 연결 작업을 구성할 때 작업 표현식에 :#변수 이름 식별자를 지정한 경우 소스 필드를 MongoDB 연결 변수 필드에 매핑해야 합니다.
18장. MQTT에 연결
MQTT(MQ Telemetry Transport)는 경량의 머신 간, 인터넷, 연결 프로토콜입니다. 통합을 통해 MQTT 브로커에 메시지를 얻거나 메시지를 게시할 수 있습니다. 이렇게 하려면 MQTT 브로커에 대한 연결을 생성한 다음 통합 흐름에 해당 연결을 추가합니다. 자세한 내용은 다음 항목에 있습니다.
18.1. MQTT 브로커에 연결 생성
통합을 통해 MQTT 브로커에서 메시지를 얻거나 MQTT 브로커에 게시하려면 MQTT 브로커에 연결하여 해당 연결을 통합에 추가합니다.
사전 요구 사항
연결하려는 MQTT 브로커의 URL을 알아야 합니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 커넥터를 표시합니다.
- MQTT 메시지 브로커 커넥터를 클릭합니다.
연결을 구성하려면 다음을 수행합니다.
- MQTT 브로커 URL 필드에 데이터를 보내거나 데이터를 가져올 MQTT 브로커의 위치를 입력합니다. 이 필드는 유일한 필수 필드입니다.
- 사용자 이름 필드에 브로커에 액세스하는 데 사용할 자격 증명이 있는 MQTT 계정의 사용자 이름을 선택적으로 입력합니다.
- 암호 필드에서 사용자 이름을 지정한 경우 해당 계정과 연결된 암호를 지정합니다.
- 클라이언트 ID 필드에 필요한 경우 메시지가 누락된 메시지 없이 연결을 닫고 다시 열 수 있는 ID를 입력합니다. 연결은 주제를 구독하거나 게시해야 합니다.
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 입력 매개 변수를 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
MQTT West를 입력할 수 있습니다. - 설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다.
- 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 MQTT West 가 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
18.2. MQTT 브로커에서 통합 실행을 트리거하는 메시지 가져오기
MQTT 브로커에서 메시지 수신을 기반으로 통합 실행을 트리거하려면 MQTT 연결을 시작 연결로 추가합니다. 통합이 실행되면 MQTT 연결은 사용자가 지정한 MQTT 대기열 또는 주제에서 지속적으로 메시지를 감시합니다. 연결에서 메시지를 찾으면 통합의 다음 단계로 전달합니다. MQTT 연결은 한 번에 하나의 메시지를 처리합니다.
사전 요구 사항
MQTT 연결을 생성했습니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 통합을 시작하는 데 사용할 MQTT 연결을 클릭합니다.
- 작업 선택 페이지에서 지정한 큐 또는 항목에서 메시지를 받을 구독 작업을 선택합니다.On the Choose an action page, select the Subscribe action to receive messages from the queue or topic that you specify.
- MQTT 큐/주제 이름 필드에 데이터를 수신하기 위해 구독할 큐 또는 항목의 이름을 입력합니다.
- 다음을 클릭하여 작업의 출력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 출력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
이제 통합이 시작 연결되고 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
18.3. MQTT 브로커에 메시지 게시
통합에서는 흐름 중 MQTT 브로커에 메시지를 게시하거나 간단한 통합을 완료할 수 있습니다. 이렇게 하려면 흐름 중 또는 통합의 완료 연결로 MQTT 연결을 추가합니다.
사전 요구 사항
- MQTT 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 MQTT 연결을 추가할 더하기 기호를 클릭합니다. 간단한 통합의 완료 연결을 추가하는 경우 이 단계를 건너뜁니다.
- 메시지를 게시하는 데 사용할 MQTT 연결을 클릭합니다.
- 작업 선택 페이지에서 게시 를 선택합니다.
- MQTT 큐/주제 이름 필드에서 메시지를 게시할 큐 또는 주제의 이름을 지정합니다.
- 다음을 클릭하여 작업의 입력 유형을 지정합니다.
유형 선택 필드에서 데이터 유형을 알 필요가 없는 경우 Type 사양 을 수락하고 Next 를 클릭합니다. 이 지침의 나머지 부분을 따를 필요가 없습니다.
그러나 구조화된 데이터 유형을 사용하는 것이 좋습니다. 예를 들어 연결 입력을 데이터 매퍼 단계에 매핑하려면 데이터 유형을 지정해야 합니다. 데이터 매퍼는 구조화되지 않은 데이터의 필드를 표시할 수 없습니다.
데이터 유형을 지정하려면 유형 선택 필드를 클릭하고 스키마 유형으로 다음 중 하나를 선택합니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
application/schema+json입니다. -
JSON 인스턴스는 JSON 데이터가 포함된 문서입니다. 문서의 미디어 유형은
application/json입니다. -
XML 스키마 는 XML 데이터의 구조를 설명하는 문서입니다. 문서의 파일 확장자는
.xsd입니다. -
XML 인스턴스는 XML 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.xml입니다. CSV 인스턴스는 쉼표로 구분된 값(CSV) 데이터가 포함된 문서입니다. 문서의 파일 확장자는
.csv입니다.참고 CSV 데이터에 대한 데이터 매퍼 지원은 기술 프리뷰 기능 전용입니다.
-
JSON 스키마 는 JSON 데이터의 구조를 설명하는 문서입니다. 문서의 미디어 유형은
-
정의 입력 상자에 선택한 스키마 유형을 준수하는 정의를 붙여넣습니다. 예를 들어 JSON 스키마를 선택하면
애플리케이션/schema+json의 미디어 유형이 있는 JSON 스키마 파일의 내용을 붙여넣습니다. 데이터 유형 이름 필드에 데이터 유형에 대해 선택한 이름을 입력합니다. 예를 들어 공급업체에 대한 JSON 스키마를 지정하는 경우 벤더를 데이터 유형 이름으로 지정할 수 있습니다.
이 유형을 지정하는 연결을 사용하는 통합을 생성하거나 편집할 때 이 데이터 유형 이름이 표시됩니다. Fuse Online은 통합 시각화 및 데이터 매퍼에 유형 이름을 표시합니다.
- 데이터 유형 설명 필드에 이 유형을 구분하는 데 도움이 되는 정보를 제공합니다. 이 설명은 이 유형을 처리하는 단계를 마우스로 가리킬 때 데이터 매퍼에 표시됩니다.
- 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
19장. OData에 연결
OData(Open Data Protocol)는 REST API를 빌드하고 사용하는 표준입니다. OData 서비스는 OData 호환 HTTP 요청을 통해 Fuse Online과 같은 클라이언트에 서비스를 제공합니다. Fuse Online 통합은 OData 서비스에서 엔터티를 가져올 수 있으며 OData 서비스에서 관리하는 엔터티를 업데이트, 생성 또는 삭제할 수 있습니다. 이렇게 하려면 OData 연결을 만들고 통합에 추가합니다.
OData 사양 버전 4 또는 버전 2 에 익숙한 것으로 가정합니다.
OData 서비스에 연결하기 위한 세부 사항은 다음과 같습니다.
19.1. OData 서비스에 대한 연결 생성
통합에서 OData 서비스에서 관리하는 엔터티를 수집, 업데이트, 생성 또는 삭제하려면 먼저 해당 OData 서비스에 대한 연결을 생성해야 합니다. 버전 2 또는 버전 4 OData에 대한 연결을 만들 수 있습니다.
사전 요구 사항
- 연결하려는 OData 서비스의 기본 URL을 알아야 합니다.
- 해당 서비스에서 인증을 사용하는 경우 필요한 인증 정보가 있어야 하며 필요한 경우 SSL 인증서가 있어야 합니다. 그러나 대부분의 OData 서비스는 공용이며 인증이 필요하지 않습니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 커넥터를 표시합니다.
- OData v2 또는 OData v4 커넥터를 클릭합니다.
연결을 구성하려면 다음을 수행합니다.
- Service Root URL 필드에 액세스하려는 OData 서비스의 기본 URL을 입력합니다.
- 사용자 이름 필드에 서비스에서 기본 인증을 사용하는 경우 사용자 이름을 입력합니다.
- 암호 필드에 서비스에서 기본 인증을 사용하는 경우 암호를 입력합니다.
서버 인증서 필드에 서비스에 필요한 경우 SSL 인증서의 콘텐츠를 붙여넣습니다.
일반적으로 공용 OData 서비스에는 브라우저에서 제공하는 인증서 외에 인증서가 필요하지 않습니다. 그러나 내부 OData 서비스의 경우 자체 SSL 인증서를 생성하고 자체 서명했을 수 있습니다. 이 인증서는 인증 기관에서 신뢰하지 않으므로 OData 서비스에 대한 연결이 실패합니다. 연결을 활성화하려면 자체 서명된 인증서를 여기에 붙여넣습니다.
인증서를 가져오는 한 가지 방법은 브라우저에서 서비스를 로드하는 것입니다. 사용 중인 브라우저에 종속되는 단계는 다음과 같습니다. 주소 표시줄 옆에 있는 비보안 잠금 기호를 클릭한 다음 인증서 보기를 클릭하고 표시된 인증서를 파일로 내보내고 인증서를 복사 하여 이 필드에 붙여넣습니다.
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 입력 매개 변수를 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
OData North를 입력할 수 있습니다. - 설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다.
- 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 OData North 가 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
다음 단계
OData 연결을 통합에 추가합니다.
19.2. OData 서비스에서 데이터를 폴링할 때 통합을 트리거
OData 서비스에서 데이터를 가져올 때 통합 실행을 트리거하려면 시작 연결로 간단한 통합에 OData 연결을 추가합니다. 통합이 실행되면 OData 연결은 사용자가 지정하는 간격으로 서비스를 폴링합니다. 연결에서 연결 구성을 충족하는 데이터를 찾으면 연결은 통합의 다음 단계로 데이터를 전달합니다.
사전 요구 사항
OData 연결을 생성했습니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 통합을 시작하는 데 사용할 OData 연결을 클릭합니다.
- 작업 선택 페이지에서 읽기 작업을 선택합니다.
읽기 작업을 구성합니다.
- 리소스 컬렉션 필드에서 쿼리할 OData 리소스의 이름을 선택합니다. Fuse Online에서 OData 서비스에서 데이터를 가져와 사용 가능한 리소스 컬렉션 목록을 제공합니다.
-
Entity Key Predicate 필드에서 특정 엔터티를 가져오기 위해 키 서술자를 지정하여 원하는 엔터티를 식별합니다. 예를 들어
UserName='Bob'또는Categories(1)와 같은 항목을 지정합니다. 여러 엔터티를 가져오려면 이 필드를 비워 둡니다. 쿼리 옵션 필드에 리소스에 적용할 쿼리를 입력합니다. OData 구문을 사용합니다. 예를 들어
$filter=startswith(name, 'N')는N으로 시작하는name필드가 있는 리소스의 각 엔터티에 대한 메시지를 반환합니다.Entity Key Predicate 및 쿼리 옵션을 모두 지정할 수 있습니다. 이 경우 OData 서비스는 지정된 엔터티를 가져와서 해당 엔터티에 쿼리를 적용합니다. 예를 들어 Entity Key Predicate 를
UserName='russellwhyte'/Emails로 설정하고 쿼리 옵션을$filter=contains($it,'example')로 설정했다고 가정합니다. 연결에서 다음과 같은 요청을 생성합니다.https://services.odata.org/TripPinRESTierService/People(UserName='russellwhyte')/Emails?$filter=contains($it, 'example')
서비스는 도메인
예제가 포함된 Russell whyte의 모든 이메일 주소를 반환합니다.- 이전 결과 필터링 확인란을 선택하여 특정 메시지를 한 번만 가져옵니다.
연결에서 메시지 컬렉션이 아닌 개별 메시지를 반환하려면 분할 결과 확인란을 선택합니다.
Fuse Online에서는 흐름에 추가할 수 있는 별도의 분할 및 집계 단계도 제공합니다. 하나 이상의 단계에서 개별 메시지를 처리한 다음 메시지를 컬렉션에 집계하려면 분할 결과 확인란을 선택하지 마십시오. 대신 확인란을 비워 두고 이 연결 후 흐름에 분할 단계를 추가합니다. 흐름의 집계 단계를 원하는 경우 분할 단계가 필요합니다.
- Interval Before Polling Starts 필드에서 기본값을 1초 동안 수락하거나 OData 서비스를 폴링하기 전에 만료하려는 시간을 입력합니다.
- Delay 필드에서 기본값을 30초로 수락하거나 OData 서비스를 폴링할 간격을 입력합니다.
Backoff Idle Threshold 필드에서 기본값을 수락하거나 데이터를 반환하지 않는 연속 폴링 수를 나타내는 정수를 입력합니다. 이 폴링 수가 지나면 연결은 후속 폴링 간의 간격을 늘립니다. 연결은 Delay 값을 Backoff Multiplier 값으로 곱하여 폴링 간격의 새 길이를 결정합니다.
예를 들어 폴링 간격( Delay 값)이 기본값인 30초, Backoff Idle Threshold 가 5로 설정되고 Backoff Multiplier 가 12로 설정되어 있다고 가정합니다. 데이터를 반환하지 않는 5회 연속 폴링 후 연결은 다시 폴링하기 전에 360초(30 x 12)를 대기합니다. 연결은 폴링에서 데이터를 반환할 때까지 360초마다 폴링합니다. 폴링이 데이터를 반환하면 연결이 30초마다 폴링을 재개합니다.
Backoff Multiplier 필드에서 기본값을 수락하거나 Backoff Idle Threshold 에 설정된 값이 도달한 경우 폴링 간격을 늘리기 위해 곱셈을 나타내는 정수를 입력합니다.
Backoff Multiplier 에 대해 기본값 1을 수락하면 연속 폴링 수에 관계없이 결과가 반환되더라도 연결이 지정된 간격으로 계속 폴링됩니다.
Backoff Idle Threshold 및 Backoff Multiplier 에 대해 지정하는 값은 유휴 기간 동안 연결이 자동으로 폴링할 수 있으므로 CPU 오버헤드를 줄이는 데 유용합니다.
- 다음을 클릭합니다.
결과
이제 통합이 시작 연결되고 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
실행되는 동안 연결이 반환하는 것은 Entity Key Predicate 및 Query Options 필드에 지정된 내용에 따라 다릅니다. OData 연결은 다음을 반환할 수 있습니다.
엔터티 컬렉션 또는 엔터티 속성 컬렉션입니다.A collection of entities or a collection of entity properties
예를 들어 리소스의 모든 Person 엔터티 또는 모든 Person 엔터티에 대한 모든 Age 속성일 수 있습니다.For example, this might be all Person entities in the resource, or perhaps all Age properties for all Person entities. 연결은 하나의 메시지로 컬렉션을 반환합니다. Fuse Online은 컬렉션에 대해 흐름의 각 후속 단계를 한 번 실행합니다. 그러나 Read 작업을 구성할 때 분할 결과 를 선택하면 연결에서 각 엔터티 또는 자체 메시지에서 각 속성을 반환합니다.However, when you configure the Read action, if you select Split Results, then the connection returns each entity or each property in its own message. Fuse Online은 각 메시지에 대해 흐름의 각 후속 단계를 한 번 실행합니다.
엔터티 또는 엔터티 속성
예를 들어 UserName 속성이 Cryostat인 Person 엔터티 또는 UserName 이 Cryostat인 Person 엔터티의 Age 속성일 수 있습니다.For example, this might be the Person entity whose UserName property is Cryostat , or perhaps the Age property for the Person entity whose UserName is Cryo stat. 연결은 흐름의 다음 단계로 전달되는 메시지의 엔터티 또는 엔터티 속성을 반환합니다.
다음 단계
통합의 완료 연결 및 통합에 포함할 기타 연결을 추가합니다. 통합에 필요한 모든 연결이 포함된 경우 OData 연결이 컬렉션을 반환하는 경우 OData 연결 후 분할 단계를 추가해야 하는지 여부를 고려하십시오. 통합은 일반적으로 OData 연결에서 반환된 데이터를 흐름의 후속 연결이 사용할 수 있는 필드에 매핑해야 합니다. 경우에 따라 컬렉션을 매핑할 수 있지만 대상 필드에 매핑하려면 컬렉션을 분할해야 하는 경우가 많습니다.
OData 연결 후 흐름에 데이터 매퍼 단계를 추가합니다. 흐름의 위치는 흐름이 무엇을 원하는지에 따라 달라집니다. 예를 들어 OData 연결 후 기본 필터 단계를 추가한 다음 데이터 매퍼 단계를 추가할 수 있습니다.
19.3. OData 서비스에서 관리하는 데이터 업데이트, 생성 및 삭제
통합에서는 흐름 중 OData 서비스에서 관리하는 리소스를 업데이트하거나 간단한 통합을 완료할 수 있습니다.In an integration, you can update a resource that is managed by an OData service in the middle of a flow or to finish a simple integration. 이렇게 하려면 흐름 중간 또는 간단한 통합의 완료 연결로 OData 연결을 추가합니다.
사전 요구 사항
- OData 연결을 생성했습니다.
- 통합을 만들거나 편집하고 Fuse Online에서 통합에 추가할 것을 요청하고 있습니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 OData 연결을 추가할 더하기 기호를 클릭합니다. 간단한 통합의 완료 연결을 추가하는 경우 이 단계를 건너뜁니다.
- 사용할 OData 연결을 클릭합니다. OData 연결이 엔터티를 업데이트하거나 삭제하면 연결은 아무것도 반환하지 않습니다. OData 연결이 엔터티를 만들 때 연결에서 새 엔터티를 반환합니다.
작업 선택 페이지에서 연결을 수행할 작업을 선택합니다.
- create 는 OData 리소스에 엔터티를 추가합니다.
- Delete 는 OData 리소스에서 엔터티를 제거합니다.
Update 는 OData 리소스에 있는 엔터티를 변경합니다.
OData 버전 2 연결의 경우 엔터티를 만들거나 업데이트할 때만 설정할 수 있는 세 가지 옵션이 있습니다. 다음 세 가지 옵션은 요청에서 데이터를 직렬화하는 방법을 지정합니다.
- 콘텐츠만 - 기본적으로 OData 버전 2는 요청의 일부로 메타데이터를 추가합니다. 이 기본 동작을 비활성화하려면 콘텐츠 전용 옵션을 선택합니다.
- ETag - 기본적으로 OData 버전 2에서는 업데이트를 요청에 보낼 때 업데이트 요청의 모든 필수 속성 값을 지정해야 합니다. 변경할 속성 값만 지정할 수 있도록 이 기본 동작을 비활성화하려면 Omit ETag 옵션을 선택합니다.
- Json 래퍼 생략 - 기본적으로 OData 버전 2는 요청을 JSON 형식으로 래핑합니다. 이 기본 동작을 비활성화하려면 Omit Json 래퍼 옵션을 선택합니다.
업데이트할 OData 리소스를 선택하여 작업을 구성합니다.
업데이트할 OData 리소스가 설정된 방법을 이해하는 것이 중요합니다. OData 서비스의 백업 데이터 소스는 업데이트 및 충돌 해결을 위한 규칙을 결정합니다. 예를 들어 OData 연결이 새 엔터티를 생성하려고 하지만 해당 조건자 키가 있는 엔터티가 이미 있다고 가정합니다. OData 서비스는 기존 엔터티를 덮어쓰거나 기존 엔티티의 일부 필드를 업데이트하거나 작업을 무시할 수 있습니다. 이러한 상황에서 OData 서비스가 어떻게 작동하는지 아는 것은 귀하에게 달려 있습니다.
- 다음을 클릭합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
다음 단계
OData 연결 앞에 데이터 매퍼 단계를 추가합니다. 새 엔터티를 생성하거나 엔터티를 업데이트하거나 엔터티를 삭제하는 데 필요한 데이터를 제공하는 소스 필드를 매핑해야 합니다. 다음 연결에 대한 통합 데이터 매핑을 참조하십시오.
20장. Cryostat에 연결
통합을 통해 Cryostat에 연결하려면 Fuse Online 환경을 Cryostat 클라이언트 애플리케이션으로 등록해야 합니다. 이렇게 하면 Fuse Online에서 Cryostat에 액세스할 수 있는 권한이 부여됩니다. 등록하면 Cryostat 연결을 만들 수 있으며, 이 연결은 여러 통합에 추가할 수 있습니다. 자세한 내용은 다음 항목을 참조하십시오.
20.1. Fuse Online을 Cryostat 클라이언트 애플리케이션으로 등록
통합에서 Cryostat에 연결하기 위해 가장 먼저 해야 할 일은 Cryostat에 액세스할 수 있는 클라이언트 애플리케이션으로 Fuse Online 환경을 등록하는 것입니다. 이를 통해 Cryostat에 연결된 여러 통합을 생성할 수 있습니다. 즉, RHHI에 특정 Fuse Online 환경을 한 번만 등록해야 합니다.
각 Fuse Online 환경에는 macvlan 클라이언트 애플리케이션으로 Fuse Online 등록은 하나만 있을 수 있습니다. 그러나 각 Cryostat 연결은 동일한 등록을 사용하지만 다른 사용자 자격 증명을 사용할 수 있습니다.
사전 요구 사항
Fuse Online에 로그인되어 있습니다.
절차
Fuse Online에서:
- 왼쪽 패널에서 설정을 클릭합니다.
-
설정 페이지에서 콜백 URL 오른쪽에 있는 상단에서
를 클릭하여 Fuse Online 환경의 콜백 URL을 클립보드에 복사합니다. 이 URL은 이 절차의 끝에 필요합니다.
- Cryostat 항목을 클릭하여 클라이언트 ID 및 클라이언트 시크릿 필드를 표시합니다.
다른 브라우저 탭에서 Cryostat 계정에 로그인하고 아래 단계에 따라 연결된 앱을 생성합니다. 이 지침에서는 사용자가 macvlan Classic 사용자 인터페이스를 사용한다고 가정합니다. Cryostat Lightning Experience 인터페이스에서 전환하려면 프로필 아이콘을 클릭하고 Switch Classic으로 전환을 선택합니다. 자세한 내용은 연결된 앱 만들기에 대한 Cryostat 설명서를 참조하십시오.
- RHHI에서 오른쪽 상단에 있는 설정을 클릭합니다.
- 왼쪽 패널에서 빌드 > 생성 > 앱 을 선택합니다.
- 연결된 앱 까지 아래로 스크롤하고 새로 만들기를 클릭합니다.
- 필요한 정보를 입력한 다음 OAuth 설정 사용을 선택합니다.
-
콜백 URL 필드에 이 절차의 시작 부분에 복사한 Fuse Online URL을 붙여넣습니다. 예:
https://app-proj912876.7b63.fuse-ignite.openshiftapps.com/api/v1/credentials/callback. OAuth 범위의 경우 다음을 추가합니다.
- API를 통해 사용자 데이터 관리(api)
- 고유 사용자 식별자 액세스(openid)
- 언제든지 요청 수행 (refresh_token, offline_accesss)
- Configure ID token 을 선택한 다음 Standard Claims를 포함합니다.
- 아래로 스크롤하여 저장을 클릭합니다.
-
scroll up to see that Cryostat indicates a short wait:
- Continue 를 클릭합니다.
- Cryostat가 제공하는 소비자 키를 복사합니다.
- Fuse Online Settings 페이지로 돌아가서 Cryostat 제공 소비자 키를 Fuse Online Cryostat Client ID 필드에 붙여넣습니다.
- Cryostat로 돌아가서 macvlan가 제공하는 소비자 시크릿을 복사합니다.
- Fuse Online Settings 페이지로 돌아가서 Cryostat가 제공한 소비자 시크릿을 Fuse Online Cryostat Client 시크릿 필드에 붙여넣습니다.
- 저장을 클릭합니다.
- Cryostat 항목을 클릭하여 축소합니다.
20.2. Cryostat 연결 생성
Cryostat에서 데이터에 액세스하는 통합을 생성하려면 먼저 Cryostat 연결을 생성해야 합니다. Cryostat 연결을 만든 후 여러 통합에서 사용할 수 있습니다.
사전 요구 사항
- Fuse Online에 로그인되어 있습니다.
- Fuse Online은 웹 브라우저에서 열려 있습니다.
- Fuse Online 환경이 이미 Cryostat에 액세스할 수 있는 애플리케이션으로 등록되어 있어야 합니다.
Fuse Online Settings 페이지에 등록 후 받은 Cryostat 클라이언트 ID 및 클라이언트 시크릿을 추가했습니다.
Cryostat 연결을 생성하기 전에 Fuse Online 설치를 Cryostat 클라이언트로 등록한 후 2~10분 정도 기다려야 합니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 사용 가능한 커넥터를 표시합니다. 커넥터는 하나 이상의 연결을 생성하기 위한 템플릿입니다.
- Cryostat 커넥터 를 클릭합니다.
Connect Cryostat를 클릭하여 Cryostat 권한 부여 페이지를 표시합니다. 권한 부여 페이지를 보기 전에 Cryostat에 로그인해야 할 수 있습니다.
Connect Cryo stat가 나타나지 않으면 Fuse Online 환경이 Cryostat 클라이언트 애플리케이션으로 등록되지 않습니다. COPY 클라이언트 애플리케이션으로 Fuse Online 등록을 참조하십시오. Cryostat 연결을 생성하려고 하면 Fuse Online 환경이 Cryostat 클라이언트 애플리케이션으로 등록되지 않은 경우 Fuse Online에서 권한 부여 정보를 요청하는 여러 필드를 표시합니다. 이러한 필드에 값을 입력하여 Cryostat 연결을 만들 수는 있지만 권장되지는 않습니다.
참고다음 오류는 Cryostat에 올바른 Fuse 온라인 콜백 URL이 없음을 나타냅니다.
error=redirect_uri_mismatch&error_description=redirect_uri%20must%20match%20configuration이 오류 메시지가 표시되면 Cryostat에서 Fuse Online 콜백 URL이 Cryostat 클라이언트 애플리케이션으로 등록된 Fuse Online의 지침에 따라 지정되어야 합니다.
- 허용 을 클릭하여 Fuse Online으로 돌아갑니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
SF Connect 1을 입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
my Cryostat 로그인 자격 증명을 사용하는 Sample Cryostat 연결을 입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 SF Connect 1 이 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
20.3. 통합에 Cryostat 연결 추가
통합에서는 흐름 중으로 Cryostat에 연결하거나 간단한 통합을 시작하거나 완료할 수 있습니다. 이렇게 하려면 integration에 Cryostat 연결을 추가합니다.
사전 요구 사항
- RHHI 연결을 생성했습니다.
- 통합을 생성하거나 업데이트하고 있습니다.
- Fuse Online에서는 시작 연결을 선택하거나 완료 연결을 선택하거나 통합에 추가할 것을 요청하고 있습니다.
절차
- flow 중앙에 Cryostat 연결을 추가하는 경우 연결을 추가할 때 더하기 기호를 클릭합니다. Fuse Online에서 시작 또는 연결을 완료하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 흐름에 추가할 Cryostat 연결을 클릭합니다. 통합에서 RHHI에 연결하기 위해 선택한 연결을 사용하는 경우 Fuse Online에서는 해당 연결에 정의된 자격 증명을 사용합니다.
- 선택한 연결을 수행할 작업을 선택합니다. 흐름에 추가하는 각 Cryostat 연결은 선택한 작업만 수행합니다.
- 작업이 작동하는 Cryostat 개체를 지정합니다. 예를 들어 연락처, 리드 또는 가격북 항목일 수 있습니다. Object 필드를 클릭하여 Cryostat 오브젝트 목록에서 선택하거나 오브젝트 이름을 입력합니다.
- 다음을 클릭하여 흐름에 연결을 추가합니다.
21장. SAP Concur에 연결
SAP Concur는 비즈니스 비용, 여행 및 송장을 관리합니다. 통합을 통해 SAP Concur에 연결하고 다양한 SAP Concur 작업 중 하나를 수행할 수 있습니다. 예를 들어 프로젝트 코드를 SQL 데이터베이스에 저장하고 SAP Concur에 동일한 프로젝트 코드가 필요하므로 비용을 프로젝트와 연결할 수 있습니다. SQL 데이터베이스에 연결하고 새 프로젝트 코드를 가져오는 저장 프로시저를 실행하는 통합을 만들 수 있습니다. 그런 다음 통합을 통해 SAP Concur에 연결하여 새 프로젝트 코드를 적절한 목록에 업로드할 수 있습니다.
다음 항목을 참조하십시오.
21.1. SAP Concur에 연결하기 위한 사용자 역할
SAP Concur에는 개발 작업을 위한 구현 사이트와 실시간 사용을 위한 프로덕션 현장이 있습니다. 구현 사이트에서는 프로덕션 사이트를 시뮬레이션합니다. 이를 통해 라이브 SAP Concur 사이트에서 프로덕션에서 사용하기 전에 통합을 생성하고 구체화할 수 있습니다.
언제든지 Fuse Online 환경은 SAP Concur 구현 사이트 또는 SAP Concur 프로덕션 사이트에 연결할 수 있습니다. 즉, 특정 Fuse Online 환경은 두 SAP Concur 사이트에 대한 연결을 동시에 지원하지 않습니다. 각 Fuse Online 환경에는 각 SAP Concur 사이트에 액세스하기 위한 고유한 인증 정보가 필요하며 구현 사이트의 인증 정보는 프로덕션 사이트의 인증 정보와 다릅니다.
결과적으로 시스템 관리자와 유사한 역할의 사용자가 다음을 수행할 것으로 예상합니다.
SAP Concur에서 두 개의 OAuth 인증 정보를 가져옵니다.
- SAP Concur 구현 사이트에 액세스하기 위한 하나의 세트
- SAP Concur 프로덕션 사이트에 액세스하기 위한 또 다른 세트
- 적절한 SAP Concur 사이트에 액세스할 수 있도록 SAP Concur 커넥터를 구성합니다.
- SAP Concur 연결을 만듭니다.
그러면 비즈니스 사용자가 SAP Concur 연결을 사용하는 통합을 생성할 수 있습니다.
21.2. SAP Concur 구현 사이트 OAuth 인증 정보를 얻는 방법
SAP Concur 구현 사이트에 액세스하기 위한 인증 정보를 얻으려면 SAP Concur에 직접 연락하여 알려주십시오.
- SAP Concur 구현 사이트에 액세스할 수 있는 새 앱으로 Fuse Online을 등록하려고 합니다.
- 해당 구현 사이트에 대한 새 OAuth 인증 정보 세트가 필요합니다.
-
자격 증명에는
LIST범위가 포함되어야 합니다. - 선택적으로 목록 작업 이외의 작업을 수행할 수 있는 권한을 얻으려면 다른 범위를 요청하십시오.
이러한 인증 정보의 OAuth 권한 부여 유형은
Authorization Grant Flow여야 합니다.SAP Concur 구현 사이트에 요청을 보내려면 Postman과 같은 REST 클라이언트를 사용하려면 OAuth 권한 부여 유형이 있는 인증 정보가
필요합니다.자격 증명을 원하는 환경의 Fuse 온라인 콜백 URL은 다음과 같습니다.
https://syndesis.my-minishift.syndesis.io/api/v1/credentials/callback이 URL에서
syndesis.my-minishift.syndesis.io는 Fuse Online 환경에 대한 OpenShift 경로와 일치합니다.
SAP Concur의 응답은 다음과 같습니다.
- SAP Concur 구현 사이트에 로그인하기 위한 사용자 이름 및 암호입니다.
- Fuse Online 개발 환경 설정 페이지에서 Fuse Online SAP Concur 커넥터를 구성할 클라이언트 ID 및 클라이언트 시크릿 값입니다.
21.3. SAP Concur 프로덕션 사이트 OAuth 인증 정보를 가져오는 방법
Fuse Online에서 SAP Concur 프로덕션 사이트에 액세스할 수 있도록 권한을 부여하는 OAuth 자격 증명을 얻으려면 SAP Concur Developer Center 시작하기 페이지로 이동하여 해당 지침을 따르십시오.
21.4. SAP Concur 커넥터 구성
통합을 통해 SAP Concur에 연결하려면 Fuse Online SAP Concur 커넥터를 구성해야 합니다. 그런 다음 커넥터를 사용하여 SAP Concur에 대한 연결을 만들 수 있습니다.
사전 요구 사항
- SAP Concur 구현 사이트 또는 SAP Concur 프로덕션 사이트에 액세스하도록 SAP Concur 커넥터를 구성할지 여부를 알고 있습니다.
- Fuse Online 환경에서 적절한 SAP Concur 사이트에 액세스할 수 있도록 권한을 부여하는 OAuth 자격 증명을 받았습니다.
절차
- Fuse Online의 왼쪽 패널에서 설정을 클릭합니다.
- 설정 페이지에서 SAP Concur 항목을 확장합니다.
- 클라이언트 ID 필드에 SAP Concur에서 수신한 클라이언트 ID를 입력합니다.
클라이언트 시크릿 필드에 SAP Concur에서 수신한 클라이언트 시크릿을 입력합니다.
Fuse Online에서 기타 필드를 채웁니다.
저장을 클릭합니다.
Fuse Online은 즉시 구성의 유효성을 검사하려고 합니다. 유효성 검사가 실패하면 입력 값을 수정하고 다시 시도합니다. 유효성 검사가 성공하면 통합에 추가할 수 있는 SAP Concur 연결을 만들 수 있습니다.
- SAP Concur 항목을 클릭하여 축소합니다.
다음 단계
SAP Concur 연결을 만듭니다.
21.5. SAP Concur 연결 생성
통합을 통해 SAP Concur에 연결하려면 먼저 SAP Concur 연결을 생성해야 합니다. 이 연결을 여러 통합에 추가할 수 있습니다. SAP Concur 연결을 생성할 때 연결을 인증하면 연결을 만들 때 입력하는 로그인 자격 증명으로 SAP Concur에 액세스할 수 있습니다.
사전 요구 사항
- 연결을 생성하는 Fuse Online 환경에서는 SAP Concur 커넥터를 구성해야 합니다.
- 커넥터가 SAP Concur 구현 사이트 또는 SAP Concur 프로덕션 사이트에 액세스하도록 구성되어 있는지 여부를 알아야 합니다.
- SAP Concur 커넥터가 구성된 SAP Concur 사이트에 로그인하려면 사용자 이름과 암호가 있어야 합니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 사용 가능한 커넥터를 표시합니다. 커넥터는 하나 이상의 연결을 생성하는 데 사용하는 템플릿입니다.
- SAP Concur 커넥터를 클릭합니다.
연결 구성 페이지에서 커넥터가 구성된 SAP Concur 사이트로 이동하는 Connect SAP Concur 를 클릭합니다.
Connect SAP Concur 가 나타나지 않으면 Fuse Online 환경의 SAP Concur 커넥터가 구성되지 않습니다. SAP Concur 커넥터 구성을 참조하십시오.
redirect_uri가 부적절하거나 이전에 등록되지 않은경우 SAP Concur 커넥터 구성이 올바르지 않습니다. Fuse Online Settings 페이지로 돌아가 커넥터 구성을 업데이트하고 검증합니다.SAP Concur OAuth 사이트에서 다음을 수행합니다.
- SAP Concur에 액세스하는 데 이 연결을 사용할 SAP Concur 계정의 이메일 주소를 입력합니다.
- 사용자 이름이 선택되어 있는지 확인합니다.
- Continue 를 클릭합니다.
- 이메일 주소와 관련된 SAP Concur 암호를 입력합니다.
- Fuse Online으로 돌아가려면 Sign In 을 클릭합니다.
-
Fuse Online Name 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
SAP Concur Test1을 입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
구현 사이트에 샘플 SAP Concur 연결을 입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 SAP Concur Test1 이 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
21.6. 통합에 SAP Concur 연결 추가
흐름 중 또는 간단한 통합에서 완료 연결로 SAP Concur 연결을 추가할 수 있습니다. SAP Concur에 대한 연결은 85 작업 중 하나를 수행할 수 있습니다.
사전 요구 사항
- SAP Concur 연결을 생성했습니다.
- 흐름을 만들거나 편집하고 있습니다.
- Fuse Online에서는 통합에 추가하거나 간단한 통합으로 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 흐름에 추가할 SAP Concur 연결을 클릭합니다. 통합에서 선택한 연결을 사용하는 경우 Fuse Online에서는 해당 연결에 정의된 자격 증명을 사용하여 SAP Concur에 연결합니다.
연결을 수행할 작업을 선택합니다. 흐름에 추가하는 각 SAP Concur 연결은 선택한 동작만 수행합니다.
SAP Concur 작업에 대한 자세한 내용은 SAP Concur 개발자 센터를 방문하여 v3.0 을 확장합니다.
- 다음을 클릭하여 흐름에 연결을 추가합니다.
결과
연결은 통합 시각화에서 추가한 위치에서 나타납니다.
21.7. 통합 데이터 필드를 SAP Concur 필드에 매핑하는 예
대부분의 통합에서는 SAP Concur에 연결하기 전에 데이터 매핑 단계를 추가해야 합니다. 데이터 매핑 단계에서는 이전 통합 단계에서 사용할 수 있는 데이터 필드를 SAP Concur 작업 매개변수에 매핑합니다. 데이터 매퍼에서 대상 패널에는 SAP Concur 연결을 통합에 추가할 때 선택한 작업에 대한 SAP Concur 매개변수가 표시됩니다.
통합이 새 프로젝트 코드를 가져오는 SQL 저장 프로시저를 실행하여 시작한다고 가정합니다. SAP Concur에 새 프로젝트 코드를 추가하여 통합이 완료됩니다. 다음 절차에서는 SAP Concur 연결 전에 데이터 매퍼 단계의 예를 제공합니다. 통합 시각화 디스플레이와 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다.
- 통합 시각화에서 SAP Concur 연결이 완료되기 전에 더하기 기호를 클릭합니다.
-
데이터 매퍼 를 클릭합니다. 데이터 필드가 표시되면 왼쪽의 Sources (소스) 패널에 데이터베이스 연결에서 사용 가능한 필드가 표시됩니다. 이 예에서 소스 필드에는
concur-list-id및프로젝트 코드가포함됩니다. 오른쪽에 있는 대상 패널에는 연결이 수행하는 업데이트 목록 작업에 대한 SAP Concur ID 및콘텐츠매개변수가 표시됩니다. -
concur-list-id소스 필드를id대상 필드에 매핑합니다. -
프로젝트 코드소스 필드를콘텐츠대상 필드에 매핑합니다. - 오른쪽 상단에서 Done 을 클릭하여 데이터 매퍼 단계를 통합에 추가합니다.
22장. ServiceNow에 연결
통합을 통해 ServiceNow 테이블의 레코드를 검색하거나 ServiceNow가 테이블을 업데이트하는 데 사용하는 ServiceNow 가져오기 세트에 레코드를 추가할 수 있습니다. 통합에서 ServiceNow에 연결하려면 ServiceNow 연결을 만든 다음 통합에 해당 연결을 추가합니다. 자세한 내용은 다음을 참조하십시오.
22.1. ServiceNow 연결 생성
통합에서 회사의 ServiceNow 인스턴스에 연결하려면 ServiceNow 연결을 생성해야 합니다.
사전 요구 사항
- 사이트의 ServiceNow 관리자가 ServiceNow 계정을 생성해야 합니다.
- ServiceNow 인스턴스의 URL과 ServiceNow 사용자 이름과 암호를 알아야 합니다.
- ServiceNow 관리자가 ServiceNow 클라이언트 ID 및 클라이언트 시크릿도 생성한 경우 다음 값을 알고 있어야 합니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 생성 을 클릭하여 Fuse Online 커넥터를 표시합니다.
- ServiceNow 커넥터를 클릭합니다.
이 ServiceNow 연결을 구성합니다.
-
인스턴스 이름 필드에 ServiceNow 인스턴스의 이름을 입력하거나 레코드에서 레코드를 복사합니다. 예를 들어 ServiceNow 인스턴스의 URL이
https://abc12345.service-now.com인 경우 인스턴스 이름은abc12345입니다. - 사용자 이름 필드에 ServiceNow 사용자 이름을 입력합니다.
- 사용자 암호 필드에 ServiceNow 암호를 입력합니다.
- 선택적으로 클라이언트 ID 필드에 ServiceNow 관리자에서 수신한 경우 클라이언트 ID를 입력합니다.
- 필요한 경우 클라이언트 시크릿 필드에 ServiceNow 관리자에서 수신한 경우 클라이언트 시크릿을 입력합니다.
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 검증에 실패하면 필요에 따라 구성 세부 정보를 업데이트하고 다시 시도하십시오.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
인스턴스 이름 필드에 ServiceNow 인스턴스의 이름을 입력하거나 레코드에서 레코드를 복사합니다. 예를 들어 ServiceNow 인스턴스의 URL이
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름을 입력합니다. 예를 들어
ServiceNow Con 1을 입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
관리 자격 증명을 사용하는 ServiceNow 연결을 입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 ServiceNow Con 1 이 통합에 추가하도록 선택할 수 있는 연결로 표시됩니다.
22.2. ServiceNow에서 통합 실행을 트리거하기 위해 레코드 가져오기
ServiceNow에서 레코드를 수신할 때 통합 실행을 트리거하려면 시작 연결로 간단한 통합에 ServiceNow 연결을 추가합니다.
사전 요구 사항
- ServiceNow 연결을 생성했습니다.
- 레코드를 검색할 테이블의 이름을 알고 있습니다.
- 원하는 레코드만 가져오는 ServiceNow 쿼리를 이미 정의해야 합니다. ServiceNow 쿼리 정보는 여기에서 찾을 수 있습니다: ServiceNow 인코딩 쿼리.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 통합을 시작하는 데 사용할 ServiceNow 연결을 클릭합니다.
- 작업 선택 페이지에서 레코드 검색을 선택하여 선택한 ServiceNow 테이블에서 레코드를 가져옵니다.
Retrieve Record 작업을 구성합니다.
- 테이블 이름 필드를 클릭하고 레코드를 가져올 테이블을 선택합니다.
-
쿼리에서 결과 집합 필드를 필터링하려면 ServiceNow 쿼리를 입력합니다. 예를 들어 사고에 대한 레코드를 유지하는 테이블에서
state=1^impact=2쿼리를 고려하십시오. 이 쿼리는 중간 영향을 미치는 새 사고(state=1)에 대한 레코드를 반환합니다(impact=2). 쿼리를 입력하지 않고 테이블의 레코드가 변경되지 않으면 연결에서 매번 동일한 레코드를 가져옵니다. -
페이지당 요소 제한 필드에 연결을 가져올 최대 레코드 수를 입력합니다. 이번 릴리스에서는 값을 입력해야 하며,
1000개 이하를 입력하는 것이 권장 사항이며, 페이지 번호 매김은 지원되지 않습니다. - Period 필드에서 레코드를 가져올 빈도를 나타냅니다. 기본값은 1분마다입니다. 즉, 기본적으로 Fuse Online은 60초마다 이러한 통합을 실행합니다.
- 다음을 클릭합니다.
결과
Fuse Online에서는 가져온 레코드의 구조를 정의하는 JSON 스키마를 생성합니다. 이를 통해 데이터 매핑이 필요한 경우 통합에서 다음 연결 전에 데이터 매핑 단계를 추가할 수 있습니다.
Fuse Online에서 완료 연결을 선택하라는 메시지를 표시합니다.
22.3. ServiceNow에서 가져오기 세트 생성
Fuse Online 통합에서는 ServiceNow 연결을 직접 업데이트할 수 없습니다. 통합에서 ServiceNow 데이터를 업데이트하기 위해 사전 요구 사항은 ServiceNow 테이블에 대한 업데이트를 수행하는 가져오기 세트입니다.
종종 가져오기 세트를 생성하는 가장 쉬운 방법은 ServiceNow 관리자가 ServiceNow 인바운드 웹 서비스를 생성하는 것입니다. 이는 ServiceNow 가져오기 세트를 암시적으로 생성합니다. 가져오기 세트는 관리자가 웹 서비스를 생성할 때 선택하는 ServiceNow 대상 테이블을 기반으로 합니다. ServiceNow 연결은 이 가져오기 세트를 업데이트하고 ServiceNow는 가져오기 세트를 사용하여 해당 ServiceNow 테이블을 업데이트합니다.
사전 요구 사항
ServiceNow 관리 권한이 있어야 합니다.
ServiceNow의 절차
-
ServiceNow에서
웹 서비스를 검색합니다. - 결과에서 System Web Services > Inbound 에서 새 만들기 를 클릭합니다.
웹 서비스 생성 페이지에서 다음을 수행합니다.
- 라벨 필드에서 웹 서비스의 표시 이름을 지정합니다. 웹 서비스의 가져오기 세트도 이 이름을 갖습니다.
- 대상 테이블 필드에서 이 서비스가 업데이트되는 ServiceNow 테이블을 선택합니다.
- 대상 테이블에서 필드 복사를 선택합니다. 이렇게 하면 대상 테이블과 동일한 스키마가 있는 가져오기 세트가 생성됩니다. 가져오기 세트는 대상 테이블을 업데이트하기 위한 스테이징 영역입니다.
- 변환 맵 생성을 선택합니다. 이 맵을 사용하면 ServiceNow가 가져오기 세트에서 대상 테이블로 데이터를 복사하고 변환할 수 있습니다.
- 생성을 클릭합니다.
- 다음 디스플레이에서 관련 링크에서 자동 맵 일치 를 클릭하여 선택한 대상 테이블에 필드 목록을 표시합니다.
상관 관계(또는 병합) 필드가 되도록 하나의 대상 테이블 필드를 선택합니다.
가져오기 세트의 레코드에서 correlation 필드의 값이 대상 테이블의 상관 관계 필드 값과 일치하는 경우 ServiceNow는 새 레코드를 생성하는 대신 대상 테이블에 해당 레코드를 업데이트합니다.
- Coalesce 를 선택하여 상관 관계 필드로 선택한 필드를 식별합니다. 상관 관계 필드가 없으면 ServiceNow는 가져오기 세트의 각 레코드를 대상 테이블에 추가합니다.
- 업데이트를 클릭합니다.
변환 맵이 생성되었는지 확인합니다.
-
ServiceNow에서
변환 맵을 검색합니다. - 시스템 가져오기 세트에서 변환 맵 을 클릭하여 변환 맵 목록을 표시합니다.
- 이 목록에서 사용자가 생성한 웹 서비스의 레이블에 대해 지정한 값이 이름인 변환 맵이 있는지 확인합니다.
-
ServiceNow에서
추가 리소스
22.4. 통합 중 또는 통합을 완료하기 위해 ServiceNow에 레코드 복사
흐름 중 ServiceNow에 레코드를 복사하거나 간단한 통합을 완료할 수 있습니다. 이렇게 하려면 흐름 중 또는 간단한 통합의 완료 연결로 ServiceNow 연결을 추가합니다.
사전 요구 사항
- ServiceNow 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
- 레코드를 추가할 ServiceNow 가져오기 세트의 이름을 알고 있습니다. ServiceNow 관리자는 적절한 가져오기 세트를 식별하는 데 도움이 될 수 있습니다. 가져오기 세트가 없는 경우 ServiceNow에서 가져오기 세트 생성을 참조하십시오.
- ServiceNow 가져오기 세트는 레코드 추가를 처리하도록 구성되어 있습니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 통합에 추가할 ServiceNow 연결을 클릭합니다.
- 레코드 추가 작업을 선택합니다.
- 집합 가져오기 필드를 클릭하고 레코드를 추가할 가져오기 세트를 선택합니다.
- 다음을 클릭합니다.
결과
Fuse Online에서는 흐름에 대한 연결을 추가합니다.
일반적으로 이 연결 전에 데이터 매퍼 단계가 필요합니다. 통합 시각화에서 Fuse Online은 연결에
를 표시합니다. 대부분의 통합에서는 ServiceNow 테이블의 correlation 필드로 사용되는 소스 필드를 대상 필드에 매핑해야 합니다.
22.5. ServiceNow와의 통합의 예
이 예제에서는 두 가지 간단한 통합을 설명합니다.
- 한 번의 통합으로 Cryostat에서 새 케이스를 가져와 ServiceNow에 인시던트로 추가합니다.
- 다른 통합에서는 Cryostat에서 업데이트된 케이스를 가져오고 ServiceNow의 해당 사고를 업데이트합니다.
사전 요구 사항(ServiceNow)
두 통합을 모두 위해 ServiceNow 관리자가 인바운드 웹 서비스를 생성하기 위한 사전 요구 사항입니다. 이는 ServiceNow에 데이터를 추가하기 위한 통합에 필요한 ServiceNow 가져오기 세트를 암시적으로 생성합니다. 예시의 경우:
- 웹 서비스의 이름은 Cryostat 의 케이스입니다.
- 서비스의 대상 테이블은 사고 입니다. 이 테이블에는 업데이트할 데이터가 포함되어 있습니다.
- 대상 테이블에서 복사 필드를 선택했기 때문에 가져오기 세트의 스키마는 Incidents 테이블 과 동일합니다. 가져오기 세트의 이름은 Cryostat 의 사례이기도 합니다.
- ServiceNow는 변환 맵 생성 선택으로 인해 Limit Range 가져오기의 케이스에서 데이터를 인젝트 대상 테이블로 복사하고 변환할 수 있습니다.
-
import 집합에서 correlation 필드는
correlation_Id필드를 선택한 다음 Coalesce 의 선택으로 인해correlation_Id입니다.
절차 개요(Fuse Online)
Fuse Online에서는 Cryostat 및 ServiceNow 연결을 만듭니다.
두 통합은 다음 단계에서 설명한 대로 macvlan 연결에서 수행하는 작업을 제외하고 동일합니다. 통합을 생성하려면 다음 단계를 두 번, 즉 한 번 수행하여 각 통합을 생성합니다.
Cryostat 연결을 시작 연결로 추가합니다.
- 새 케이스를 가져오는 통합을 만들려면 On create 작업을 선택합니다.
- 업데이트된 사례를 가져오는 통합을 만들려면 업데이트 시 작업을 선택합니다.
- 작업할 케이스 오브젝트를 선택합니다. 이 Cryostat 연결은 선택한 작업에 따라 새 Case 개체 또는 업데이트된 Case 개체를 반환합니다.
- ServiceNow 연결을 완료 연결로 추가합니다.
Create Record 작업을 선택한 다음 통합이 업데이트되는 가져오기 세트로 Cryostat 에서 케이스 를 선택합니다.
이 ServiceNow 연결은 Cryostat 가져오기 세트의 케이스에 신규 또는 업데이트된 Cryostat 케이스 를 추가합니다.
매핑되는 데이터 매퍼 단계를 추가합니다.
-
ServiceNow 가져오기
의correlation_Id에 대한 macvlan 케이스 ID -
Cryostat는 ServiceNow
short_description의적용을 받습니다. -
ServiceNow
설명에 대한hieradata설명
-
ServiceNow 가져오기
통합 이름을 지정한 다음 게시합니다.
- 새 케이스를 가져오는 통합의 경우 On SF Create Case 를 사용하십시오.
- 업데이트된 사례를 가져오는 통합의 경우 SF 업데이트 케이스에서 .
통합이 작동하는지 확인
두 통합 모두 실행 중인 경우 통합이 작동하는지 확인할 수 있습니다.
- Cryostat에서 케이스를 생성합니다.
- Fuse Online에서 On SF Create Case 통합 요약을 참조하십시오. 해당 활동 탭을 클릭하여 Fuse Online이 통합을 한 번 실행했는지 확인합니다.
- ServiceNow에서 사고 테이블을 봅니다. Cryostat에서 지정한 제목 및 설명이 포함된 새 인시던트가 표시되어야 합니다.
- Cryostat로 돌아가서 방금 만든 케이스를 업데이트하여 제목을 변경합니다.
- Fuse Online에서 On SF Update Case 통합 요약을 참조하십시오. 해당 활동 탭을 클릭하여 Fuse Online이 통합을 한 번 실행했는지 확인합니다.
-
ServiceNow에서 Incidents 테이블을 보고 이전에 새로 추가된 문제에 대한 항목을 확장합니다. 이 사고에 업데이트된
short_description값이 있는지 확인해야 합니다. ServiceNow는correlation_Id의 값에 대한 가져오기 세트 항목을 확인합니다. 이 값이 Incidents 테이블에 이미 존재하는 경우 ServiceNow는 해당 값이 있는 인시던트를 업데이트합니다.
23장. Slack에 연결
비즈니스 사용자는 Slack에 연결되는 통합을 생성할 수 있습니다. Slack에 대한 연결은 다음 중 하나를 수행할 수 있습니다.
- 지정한 Slack 채널이 메시지를 수신할 때 간단한 통합을 트리거합니다. 통합은 메시지를 흐름의 다음 단계로 전달합니다. 예를 들어 제품 이름과 같은 키워드 인스턴스에 대해 Slack 채널을 모니터링할 수 있습니다. 이러한 제품 이름이 포함된 메시지를 찾으면 통합을 통해 ESP 연결에서 적절한 연락처를 알릴 수 있습니다.
- 특정 사용자 또는 채널에 메시지를 전달합니다. 예를 들어 이 동작은 통합에서 FTP 서버에서 파일을 다운로드하고 어떤 방식으로든 처리할 때 유용합니다. 통합 흐름은 Slack 채널 또는 사용자에게 프로세스가 성공했음을 알릴 수 있습니다.
통합에서 Slack에 연결하려면 Slack 연결을 만든 다음 통합 흐름에 연결을 추가합니다. 자세한 내용은 다음 항목에 있습니다.
23.1. Slack 연결 생성
통합에서 Slack 연결은 사용자가 지정하는 채널에서 메시지를 검색하거나 채널 또는 사용자에게 보낼 수 있습니다. 통합에 동일한 Slack 연결을 사용할 수 있습니다.
사전 요구 사항
Fuse Online 을 Slack에 연결하기 위한 Slack 앱을 생성하고 설치합니다.
- 사용자 OAuth 액세스 토큰 을 소비자 엔드포인트의 토큰으로 사용합니다.
앱에 관련 사용자 토큰 범위를 추가하여 메시지를 볼 수 있는 권한을 부여합니다.
history (
channel:history,groups:history,mpim:history,im:history)읽기 (
채널:read,groups:read,mpim:read,im:read)
- Slack 앱의 Slack Webhook URL을 가져올 수 있습니다.
- Slack 앱에 대한 액세스 권한을 부여하는 사용자 OAuth 액세스 토큰 을 가져올 수 있습니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 생성 을 클릭하여 Fuse Online 커넥터를 표시합니다.
- Slack 커넥터를 클릭합니다.
- Slack Webhook URL 필드에 Slack 앱의 Webhook URL을 입력합니다.
- Slack API에 액세스하기 위한 토큰에 Slack 앱의 OAuth 및 권한 페이지에서 가져올 수 있는 사용자 OAuth 액세스 토큰 을 입력합니다.
선택적으로 추가 매개변수의 값을 입력합니다.
- Sending username for messages 필드에 Slack에 메시지를 보낼 때 봇에서 보유한 사용자 이름을 입력합니다.
Message avatar emoji 필드에서 메시지를 전송할 때 봇이 메시지 avatar로 사용하는 하나의 emoji를 지정합니다. 예:
:smile:,:Wave:,:question:.작은 정보이모티콘 시트 가 웹을 검색하여 일부 emoji 코드를 확인하십시오.
- Message avatar 아이콘 URL 필드에서 봇이 Slack에 메시지를 보낼 때 사용하는 avatar의 URL을 지정합니다.
emoji 및 아이콘 URL을 지정하면 통합에서 아이콘 URL을 사용합니다. emoji와 아이콘 URL을 지정하지 않으면 avatar 없이 메시지가 전송됩니다.
- Validate 를 클릭합니다. Fuse Online은 즉시 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 연결 구성 값을 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
Slack for Tracking Company Sales를 입력합니다. - 설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다.
- 저장 을 클릭하여 방금 만든 연결을 포함하여 사용 가능한 연결의 업데이트된 목록을 확인합니다. 예제 이름을 입력하면 추적 회사 영업에 대한 Slack 이 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다. 이 연결을 여러 통합에 추가할 수 있습니다.
23.2. 메시지를 수신할 때 통합 실행을 트리거하는 Slack 연결 추가
통합을 시작하는 Slack 연결은 사용자가 지정하는 Slack 채널에서 메시지를 찾을 때 통합 실행을 트리거합니다.
사전 요구 사항
- Slack 연결을 생성했습니다.
- 통합을 생성하고 Fuse Online에서 통합을 시작하려는 방법을 선택하라는 메시지를 표시합니다.
절차
- 통합을 시작하는 데 사용할 Slack 연결을 클릭합니다.
- Read Messages 작업을 선택합니다.
- 채널 필드에서 메시지를 가져올 Slack 채널을 지정합니다.
- Delay 필드에서 메시지를 폴링하는 시간으로 기본 500밀리초를 수락합니다. 또는 메시지를 확인하는 다른 간격을 지정하려면 번호를 입력하고 시간 단위를 선택합니다.
검색할 최대 메시지에서 기본값을 수락하거나 각 폴링에 대해 연결을 반환할 수 있는 최대 메시지 수를 나타냅니다. 연결이 이 읽지 않은 메시지 수보다 많은 것을 발견하면 가장 최근의 메시지를 반환합니다. 연결은 특정 메시지를 한 번만 반환합니다.
예를 들어 기본값 10을 수락하고 폴링 시 15개의 메시지가 있는 경우 연결은 가장 최근 10개의 메시지를 반환합니다. 다음 폴링에서 연결에서는 이전에 연결이 반환되었던 가장 최근 메시지 뒤에 타임스탬프가 있는 메시지를 확인합니다. 즉, 첫 번째 예제 폴링에서 반환되지 않은 5개의 메시지는 반환되지 않습니다.
Slack 연결이 두 개 이상의 메시지를 반환하면 통합에서 메시지를 배치로 처리합니다. 즉, Fuse Online은 일괄 처리에 대해 한 번 통합을 실행합니다.
- 다음을 클릭하여 통합에 연결을 추가합니다.
23.3. Slack 연결 추가: Slack 채널 또는 사용자에게 메시지를 보냅니다.
통합에서는 흐름 중 Slack 채널 또는 Slack 사용자에게 메시지를 보내거나 간단한 통합을 완료할 수 있습니다. 이렇게 하려면 흐름 중 또는 간단한 통합의 완료 연결로 Slack 연결을 추가합니다.
사전 요구 사항
- Slack 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 흐름에 추가할 Slack 연결을 클릭합니다.
연결을 수행할 작업을 선택합니다.
- Username 을 선택하여 한 사용자에게 메시지를 보냅니다. 이 작업을 구성하려면 사용자 이름 필드에서 메시지를 보낼 사용자의 Slack 이름을 지정합니다.
- 채널에 메시지를 게시하려면 채널을 선택합니다. 이 작업을 구성하려면 채널 필드에서 메시지를 게시할 채널을 지정합니다.
- 다음을 클릭하여 흐름에 연결을 추가합니다.
- 선택적으로 흐름에 대한 추가 연결을 추가합니다. 추가 연결이 필요한지 여부는 흐름을 원하는 작업에 따라 달라집니다. 중요한 것은 계속하기 전에 모든 연결을 추가하는 것입니다.
- 이 절차에서 추가한 Slack 연결 바로 앞에 데이터 매퍼 단계를 추가합니다. 매핑 단계에서 데이터 매핑 소스의 문자열을 Slack 메시지 필드에 매핑합니다. 이 문자열에는 Slack 사용자 또는 채널에 보낼 메시지가 포함되어야 합니다. 데이터 매퍼 단계 추가를 참조하십시오.
24장. SQL 데이터베이스에 연결
통합에서는 다음 유형의 SQL 데이터베이스에 연결할 수 있습니다.
- Apache Derby
- MySQL
- PostgreSQL
통합에서 액세스하려는 데이터베이스에 대한 연결을 만듭니다. 그런 다음 통합을 생성하고 통합에 해당 데이터베이스 연결을 추가합니다.
다른 유형의 데이터베이스에 연결하려면 해당 데이터베이스에 대한 JDBC 드라이버를 업로드해야 합니다.
자세한 내용은 다음 항목을 참조하십시오.
24.1. 데이터베이스 연결 생성
통합에서 연결할 각 데이터베이스에 대해 별도의 연결을 만듭니다. 여러 통합에서 동일한 연결을 사용할 수 있습니다.
데이터베이스 연결은 사용자가 지정하는 저장 프로시저를 지정하거나 호출하는 데이터베이스 테이블에서 작동합니다.A database connection operates on a database table that you specify or invokes a stored procedure that you specify.
사전 요구 사항
통합이 데이터베이스에 연결될 때 데이터베이스 테이블 또는 저장 프로시저가 있어야 합니다.
절차
- 연결하려는 데이터베이스의 JDBC 드라이버가 클래스 경로에 있는지 확인합니다. 전용 데이터베이스에 연결하기 위해 JDBC 드라이버 라이브러리 확장을 업로드한 경우 업로드 프로세스에서 클래스 경로에 드라이버를 배치합니다. JDBC 드라이버 라이브러리 확장 생성 을 참조하십시오.
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 생성 을 클릭하여 Fuse Online 커넥터를 표시합니다.
- 데이터베이스 커넥터를 클릭합니다.
다음을 입력하여 연결을 구성합니다.
-
연결 URL 필드에 연결하려는 데이터베이스의 JDBC URL을 입력합니다. 예를 들어
jdbc:postgresql://ignite-db1234/sampledb를 입력합니다. - 사용자 이름 필드에 데이터베이스에 액세스하는 데 사용할 계정 이름을 입력합니다. 지정된 암호 및 사용자 이름이 동일한 계정에 있는지 확인합니다.
- 암호 필드에 데이터베이스에 액세스하는 데 사용할 사용자 계정과 연결된 암호를 입력합니다.
- 스키마 필드에 데이터베이스의 스키마 이름을 입력합니다. 데이터베이스 스키마를 지정하는 방법은 각 데이터베이스 유형에 따라 다릅니다. 자세한 내용은 다음 섹션에 있습니다. 데이터베이스 연결에서 스키마를 지정하는 방법.
-
연결 URL 필드에 연결하려는 데이터베이스의 JDBC URL을 입력합니다. 예를 들어
- Validate 를 클릭합니다. Fuse Online은 연결의 유효성을 검사하려고 시도하며 유효성 검사에 성공했는지 여부를 나타내는 메시지를 표시합니다. 유효성 검사가 실패하면 필요에 따라 구성 세부 정보를 수정하고 다시 시도합니다.
- 유효성 검사가 성공하면 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어
PostgreSQL DB 1을 입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
내 로그인 자격 증명을 사용하는 샘플 PostgreSQL 연결을 입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 PostgreSQL DB 1 이 통합에 추가하도록 선택할 수 있는 연결로 표시됩니다.
24.2. 데이터베이스 연결에서 스키마를 지정하는 방법
Fuse Online에서 데이터베이스 연결을 만들 때 사용자 인터페이스에서 데이터베이스의 스키마를 지정하라는 메시지를 표시합니다. 스키마를 지정하는 방법은 각 데이터베이스에 따라 다릅니다. 아래 표는 각 데이터베이스에 필요한 사항을 보여줍니다.
| 데이터베이스 | 연결 구성 예 | 참고 |
|---|---|---|
| Apache Derby |
연결 URL (JDBC URL): |
테스트 목적으로만 사용됩니다. 기본 사용자 이름은 |
| MS SQLServer |
연결 URL (JDBC URL): | 확장 메커니즘 을 사용하여 드라이버를 업로드합니다. 그런 다음 연결을 만듭니다. 드라이버를 아직 업로드하지 않은 경우 연결 확인에 실패합니다. 연결 URL의 끝과 Schema 필드에 동일한 스키마를 지정해야 합니다. |
| MySQL |
연결 URL (JDBC URL): SQL | MySQL은 스키마를 지원하지 않습니다. MySQL 데이터베이스에 대한 연결을 만들 때 Schema 필드를 비워 둡니다. MySQL에서는 연결(JDBC) URL에서 모든 구성이 필요합니다. |
| Oracle DB |
연결 URL (JDBC URL): |
Fuse Online 확장 메커니즘 을 사용하여 Oracle 데이터베이스 드라이버를 업로드합니다. 그런 다음 연결을 만듭니다. 드라이버가 업로드되지 않은 경우 연결 확인에 실패합니다. |
| PostgreSQL |
연결 URL (JDBC URL): | 연결(JDBC) URL에 데이터베이스를 지정해야 합니다. 스키마를 사용하려면 스키마 필드에 지정해야 합니다. 쿼리는 database.schema.table 형식의 테이블을 참조할 수 있습니다. 참조에서 테이블 이름만 지정하면 연결은 먼저 연결을 구성할 때 지정한 스키마를 검색합니다. 테이블이 없으면 연결에서 지정된 테이블의 공용 리소스를 검색합니다. 자세한 내용은 PostgreSQL 스키마 설명서를 참조하십시오. |
24.3. 통합 실행을 트리거하기 위해 데이터베이스 레코드 가져오기
SQL 문 또는 SQL 저장 프로시저를 호출하는 결과에 따라 통합 실행을 트리거하려면 통합의 시작 연결로 데이터베이스 연결을 선택합니다.To trigger execution of an integration based on the result of invoking a SQL statement or a SQL stored procedure, choose a database connection as the integration's start connection.
사전 요구 사항
데이터베이스 연결을 생성했습니다.
절차
- 왼쪽의 Fuse Online 패널에서 통합을 클릭합니다.
- 통합 생성을 클릭합니다.
- 연결 선택 페이지에서 통합을 시작하는 데 사용할 데이터베이스 연결을 클릭합니다.
작업 선택 페이지에서 다음 중 하나를 선택합니다.
주기적 SQL 호출 은 사용자가 지정하는 SQL 문을 주기적으로 호출하여 데이터를 가져옵니다.
데이터베이스 커넥터는 대부분의 기본 SQL 구문을 허용합니다. 복잡한 SQL 문을 사용하려면 데이터베이스 커넥터가 저장 프로시저에서 SQL 구문의 유효성을 검사하지 않으므로 대신 저장 프로시저를 사용해야 합니다.If you want to use a complex SQL statement, you should use a stored procedure instead because the Database Connector does not validate the SQL syntax in a stored procedure.
- 주기적 저장 프로시저 호출 은 사용자가 지정하거나 선택하는 저장 프로시저를 주기적으로 호출하여 데이터를 가져옵니다.
Periodic SQL 호출 을 선택한 경우 쿼리 필드에 하나 이상의 레코드를 가져오는 SQL
SELECT문 또는 다른 표준 SQL 문을 입력합니다. 예:my_db_table에서 *를 선택합니다. 원하는 데이터가 포함된 데이터베이스 테이블이 이미 있어야 합니다.Periodic 저장 프로시저 호출 을 선택한 경우 프로시저 이름 필드에서 관심 있는 데이터를 가져오기 위해 호출할 저장 프로시저를 선택하거나 입력합니다. 지정한 저장 프로시저가 이미 있어야 합니다. 데이터베이스 관리자는 통합에 사용해야 하는 저장 프로시저를 생성한 것입니다.
-
Period 필드에 정수를 입력하고 단위가 밀리초, 초, 분, 시간 또는 일인지 여부를 나타냅니다. 예를 들어
5분을 지정하면 연결이 5분마다지정된 문 또는 저장 프로시저를 호출합니다. - 다음을 클릭합니다.
SQL 확장 사용에 대한 제한 사항
쿼리 필드에 입력하는 SQL 설명은 표준 SQL 구문이어야 합니다. Fuse Online에서는 Procedural Language/PostgreSQL(PL/pgSQL) 또는 Oracle Procedural Language Extensions to SQL(PL/SQL)과 같은 SQL 확장을 인식하거나 구문 분석하지 않습니다. 그러나 저장 프로시저 내에서 SQL 확장을 사용할 수 있습니다.However, you can use SQL extensions within stored procedures.
결과
Fuse Online에서는 지정된 SQL 문이 구문적으로 올바르게 올바른지 확인하고 문 또는 저장 프로시저 대상 데이터가 존재하는지 확인하는 등 연결의 유효성을 검사하려고 합니다. 확인에 성공하면 Fuse Online에서 통합 시작 연결을 추가합니다. 확인에 실패하면 Fuse Online에서 문제에 대한 메시지를 표시합니다. 필요에 따라 입력을 업데이트하고 다시 시도합니다.
24.4. 데이터를 업데이트하는 SQL 문의 매개 변수 자리 표시자 및 값 정보
흐름 중간에 있거나 간단한 통합을 완료하는 데이터베이스 연결은 데이터를 업데이트하는 SQL 문을 실행할 수 있습니다. 통합에 데이터베이스 연결을 추가하면 실행할 SQL 문에서 자리 표시자 매개 변수를 지정할 수 있습니다. 실행되는 동안 입력 매개 변수 값이 컬렉션에 있을 때 연결은 배치 업데이트를 수행할 수 있습니다.
SQL 문에서 매개변수 지정
통합을 만들거나 편집하고 데이터베이스를 업데이트하는 연결을 추가하면 런타임 시 연결이 실행되는 SQL 문에서 자리 표시자 매개 변수를 지정하거나 런타임 시 실행할 저장 프로시저에 자리 표시자 매개 변수가 있을 수 있습니다. 예를 들면 다음과 같습니다.
INSERT INTO TODO(task, completed) VALUES(:#param_1, :#param_2) DELETE FROM TODO WHERE task LIKE :#param_3
이러한 자리 표시자의 값을 지정하려면 데이터베이스 연결 전에 흐름에 데이터 매핑 단계를 추가합니다. 데이터 매핑 단계에서 적절한 소스 데이터 필드를 대상 데이터 필드에 매핑합니다. 예를 들어 소스 데이터를 :#param_1,:#param_2 및 :#param_3 대상 필드에 매핑합니다. 데이터 매퍼 단계 추가를 참조하십시오.
매개변수 값 컬렉션을 사용한 배치 업데이트
런타임 시 데이터베이스 연결이 데이터를 삽입, 삭제 또는 업데이트하는 SQL 문을 실행하는 경우 실행 중인 SQL 문이 하나 이상의 자리 표시자 매개 변수를 지정하는 경우가 많습니다(예: :#task ). 이 경우 연결에 대한 입력은 단일 매개변수 세트 또는 매개 변수 세트 컬렉션일 수 있습니다. 여기서 세트의 각 요소는 해당 자리 표시자 매개 변수에 대한 값을 정의합니다.
데이터베이스 연결에 대한 입력은 흐름의 이전 연결(예: HTTP 요청) 또는 API 공급자 통합을 위해 REST API 서비스로 전송된 요청에서 가져옵니다. 입력이 컬렉션이면 연결은 일괄 모드를 사용하여 테이블을 업데이트합니다. 예를 들어 다음 SQL 문을 고려하십시오.
insert into todo (task) values (:#task)
입력 컬렉션에 3개의 값이 포함된 경우 연결에서 각 값에 대해 하나씩 세 개의 레코드를 삽입합니다. 이제 두 개의 자리 표시자 매개 변수가 있는 SQL 문을 고려하십시오.
insert into todo (task, completed) values (:#task, :#completed)
이 SQL 문을 실행하는 연결에 대한 입력에서 데이터 셰이프 사양은 단일 요소를 지정할 수 있습니다.In the input to the connection that executes this SQL statement, a data shape specification could specify a single element, for example:
{"task": "write some docs", "completed": 0}또는 컬렉션을 지정할 수 있습니다. 예를 들면 다음과 같습니다.
[{"task": "write doc", "completed": 1},
{"task": "publish doc", "completed": 0}]컬렉션을 입력으로 사용하면 연결은 각 매개 변수 값 집합에 대해 한 번 삽입 작업을 실행합니다. 이 예제에서 연결은 각 매개 변수 값 집합에 하나씩 두 개의 레코드를 테이블에 추가합니다.
24.5. 중간의 데이터베이스 액세스 또는 통합을 완료
통합에서는 흐름 중간에 데이터베이스에 액세스하거나 간단한 통합을 완료할 수 있습니다. 이렇게 하려면 흐름 중간 또는 통합의 완료 연결로 데이터베이스 연결을 추가합니다.
사전 요구 사항
- 데이터베이스 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 액세스하려는 데이터베이스에 대한 데이터베이스 연결을 클릭합니다.
작업 선택 페이지에서 다음 중 하나를 선택합니다.
지정한 SQL 문을 실행하여 데이터에서 SQL을 호출합니다.Explicit SQL operates on data by executing the SQL statement you specify.
데이터베이스 커넥터는 대부분의 기본 SQL 구문을 허용합니다. 복잡한 SQL 문을 사용하려면 데이터베이스 커넥터가 저장 프로시저에서 SQL 구문의 유효성을 검사하지 않으므로 대신 저장 프로시저를 사용해야 합니다.If you want to use a complex SQL statement, you should use a stored procedure instead because the Database Connector does not validate the SQL syntax in a stored procedure.
- 호출 저장 프로시저는 사용자가 지정하거나 선택하는 저장 프로시저를 호출하여 데이터에서 작동합니다.Calling stored procedure operates on data by invoking the stored procedure that you specify or select.
Invoke SQL 을 선택한 경우 SQL 문 필드에서 다음을 수행합니다.
-
중간 연결의 경우 하나 이상의 레코드를 가져오는 SQL
SELECT문을 입력하거나 하나 이상의 레코드에서 작동하는 SQL Cryostat , UPDATE 또는 DELETE 문을 입력합니다.For a middle connection, enter a SQL SELECT statement that obtains one or more records or enter a SQL Cryostat ,UPDATE, orDELETEstatement that operates on one or more records.데이터가 포함된 데이터베이스 테이블은 이미 있어야 합니다. -
완료 연결의 경우 하나 이상의 레코드에서 작동하도록 SQL Cryostat ,
UPDATE또는DELETE문을 입력합니다. Batch 업데이트 필드에서 기본값인 No 를 허용하거나 Yes 를 선택합니다.
Batch 업데이트 설정은 이 작업에 대한 입력이 컬렉션이고 SQL 문을 삽입, 삭제 또는 업데이트할 때 연결 동작에 영향을 미칩니다. 기본 동작(배치 업데이트는 No)은 연결이 개별 개체만 수락하고 각 개체에 대해 SQL 문을 한 번 실행한다는 것입니다. Batch 업데이트가 예 이면 연결에서 작업에 대한 입력으로 컬렉션을 허용합니다. 연결은 한 번 SQL 문을 실행하고 모든 컬렉션 항목을 일괄 업데이트 작업에 대한 입력으로 사용합니다.
Invoke 저장 프로시저를 선택한 경우 프로시저 이름 필드에서 관심 있는 데이터에서 작동하도록 호출할 저장 프로시저의 이름을 선택하거나 입력합니다.If you selected Invoke stored procedure, in the Procedure name field, select or enter the name of the stored procedure to operate on the data of interest. 지정한 저장 프로시저가 이미 있어야 합니다. 데이터베이스 관리자는 통합에 사용해야 하는 저장 프로시저를 생성한 것입니다.
-
중간 연결의 경우 하나 이상의 레코드를 가져오는 SQL
- 다음을 클릭합니다.
결과
Fuse Online은 지정된 SQL 쿼리가 구문적으로 올바르고 쿼리 또는 저장 프로시저 대상 데이터가 존재하는지 확인하는 등 연결의 유효성을 검사하려고 합니다. 확인에 성공하면 Fuse Online에서 흐름에 대한 연결을 추가합니다. 확인에 실패하면 Fuse Online에서 문제에 대한 메시지를 표시합니다. 필요에 따라 입력을 업데이트하고 다시 시도합니다.
24.6. 독점 데이터베이스에 연결
전용 SQL 데이터베이스에 연결하려면 다음과 같이 수행해야 합니다.To connect to a proprietary SQL database, the main tasks that must be accomplished are as follows:
- 개발자는 통합에서 액세스하려는 데이터베이스를 위한 JDBC 드라이버가 포함된 라이브러리 확장을 생성합니다. JDBC 드라이버 라이브러리 확장 생성 을 참조하십시오.
-
개발자는 라이브러리 확장자가 포함된
.jar파일을 제공합니다. -
해당
.jar파일을 Fuse Online에 업로드합니다. 확장 가능 항목을 참조하십시오. - Fuse Online Database 커넥터를 선택하고 데이터베이스의 연결 URL을 지정하여 데이터베이스에 대한 연결을 만듭니다. 데이터베이스 연결 생성을 참조하십시오.
- 통합에서 데이터베이스에 연결을 추가합니다. 데이터베이스에 액세스하거나 중간의 데이터베이스에 액세스하거나 통합을 완료하여 통합 시작을 참조하십시오.
25장. Telegram에 연결
비즈니스 사용자는 Telegram에 연결하는 통합을 만들 수 있습니다. Telegram에 대한 연결은 다음 중 하나를 수행할 수 있습니다.
- 지정한 Telegram 봇이 메시지를 수신할 때 간단한 통합을 트리거합니다. 통합은 메시지를 흐름의 다음 단계로 전달합니다. 예를 들어 간단한 통합에서 메시지를 수신한 후에는 제품 이름과 같은 키워드 인스턴스를 감시하는 필터 단계가 있을 수 있습니다. 이러한 제품 이름이 포함된 메시지를 검색하면 통합에서 Selectium 연결 또는 다른 Telegram 연결에서 적절한 연락처를 알릴 수 있습니다.
- 특정 Telegram 채팅에 메시지를 전달합니다. 예를 들어 이 동작은 통합에서 FTP 서버에서 파일을 다운로드하고 어떤 방식으로든 처리할 때 유용합니다. 프로세스가 성공했음을 전보 채팅에게 알리는 전보 연결을 추가할 수 있습니다.
통합에서 Telegram에 연결하려면 Telegram 연결을 만든 다음 통합 흐름에 연결을 추가합니다. 자세한 내용은 다음 항목에 있습니다.
25.1. Telegram 연결 생성
통합에서 Telegram 연결은 특정 채팅으로 전송된 메시지를 수신할 수 있습니다. 생성한 채팅 봇은 메시지를 Fuse Online으로 전달합니다. Telegram 연결은 연결에 액세스할 수 있는 채팅에 메시지를 보낼 수도 있습니다. 동일한 Telegram 연결을 사용할 수 있습니다.
- 연결을 사용하여 채팅에 메시지를 보내는 통합의 수입니다.
- 또한 연결을 사용하여 Telegram 채팅에서 메시지를 수신하는 하나의 통합에서 사용할 수 있습니다.
즉, 두 통합에서 Telegram 채팅 메시지를 수신하려는 경우 둘 이상의 통합에서 동일한 Telegram 연결을 사용할 수 없습니다. 이는 전보 제한 사항입니다.
사전 요구 사항
- Telegram에서는 메시지를 가져오고 메시지를 보낼 수 있는 채팅 봇을 생성했습니다. 이 문제에 대한 도움말 은 개발자를 위한 소개를 참조하십시오.
- Telegram CryostatFather에서 봇 인증 토큰을 가져왔습니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 생성 을 클릭하여 Fuse Online 커넥터를 표시합니다.
- Telegram 커넥터를 클릭합니다.
- 인증 토큰 필드에 메시지를 가져오고 메시지를 보낼 봇의 전보 권한 부여 토큰을 입력합니다.
- 다음을 클릭합니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어 Product people
tions 용으로 Telegram을입력합니다. - 설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다.
- 저장 을 클릭하여 방금 만든 연결을 포함하여 사용 가능한 연결의 업데이트된 목록을 확인합니다. 예제 이름을 입력하면 통합에 추가하도록 선택할 수 있는 연결로 Telegram for Product focustions가 표시됩니다. 이 연결을 여러 통합에 추가할 수 있습니다.
25.2. 메시지가 수신될 때 통합 실행을 트리거하기 위해 전보 연결 추가
통합을 시작하는 Telegram 연결은 사용자가 지정하는 Telegram 채팅 봇에서 메시지를 수신할 때마다 통합 실행을 트리거합니다.
사전 요구 사항
- Telegram 연결을 생성했습니다.
- 간단한 통합을 만들고 Fuse Online에서는 통합을 시작하려는 방법을 선택하라는 메시지가 표시됩니다.
절차
- 통합을 시작하는 데 사용할 Telegram 연결을 클릭합니다.
채팅 봇으로 전송되는 모든 메시지를 수신하려면 Read Messages 작업을 선택합니다.
연결 구성은 메시지를 수신하려는 채팅 봇을 식별합니다. 다른 구성이 필요하지 않습니다.
25.3. 전보 채팅에 메시지를 보내는 전보 연결 추가
통합에서는 흐름 중 Telegram 채팅에 메시지를 보내거나 간단한 통합을 완료할 수 있습니다. 이렇게 하려면 흐름 중 또는 간단한 통합의 완료 연결로 전보 연결을 추가합니다.
사전 요구 사항
- Telegram 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 연결을 추가할 더하기 기호를 클릭합니다. Fuse Online에서 완료 연결을 선택하라는 메시지가 표시되면 이 단계를 건너뜁니다.
- 흐름에 추가할 Telegram 연결을 클릭합니다.
- 텍스트 메시지 보내기 작업을 선택합니다.
chat Id 필드에 메시지를 보내는 Telegram 채팅의 ID를 입력합니다.
이 필드를 비워 두고 메시지를 수신하는 이전 Telegram 연결이 있는 경우 Fuse Online은 들어오는 메시지에 있는 채팅 ID를 사용합니다.
채팅 ID를 가져오려면 다음을 수행합니다.
- Telegram에서 메시지를 보낼 채팅에 봇을 추가합니다. CryostatFather 응답에는 봇 액세스 토큰이 포함됩니다.
- 액세스 토큰을 클립보드에 복사합니다.
- Telegram에서 해당 채팅에 직접 메시지를 보냅니다. 메시지를 보내는 데 봇을 사용하지 마십시오.
다음 형식으로
curl명령을 호출하여 해당 채팅으로 전송되는 메시지를 읽습니다.bot-access-token을 클립보드의 액세스 토큰으로 교체합니다.curl https://api.telegram.org/bot-access-token/getUpdates\?offset\=0응답은 JSON 형식으로 되어 있습니다. JSON
채팅오브젝트에는 채팅 ID가 포함되어 있습니다.
- 다음을 클릭하여 흐름에 연결을 추가합니다.
26장. Twitter에 연결
통합으로 Twitter에 연결하기 위한 주요 단계는 다음과 같습니다.
Fuse Online 환경에서 Twitter로 액세스 권한을 부여하려면 Twitter 개발자 계정이 필요합니다. 아직 Twitter 개발자 계정이 없는 경우 https://apps.twitter.com 로 이동하여 Twitter에 로그인 한 후 개발자 계정에 대한 적용을 클릭합니다. 개발자 계정을 얻는 것은 you@gmail.com와 같은 개인 주소가 아닌 와 같은 전문 이메일 주소를 제공하는 경우 매우 빠릅니다.
you@gmail.com
26.1. Fuse Online을 Twitter 클라이언트 애플리케이션으로 등록
통합을 통해 Twitter에 연결하기 위해 가장 먼저 해야 하는 작업은 Fuse Online 환경을 Twitter에 액세스할 수 있는 클라이언트 애플리케이션으로 등록하는 것입니다. 이를 통해 Twitter에 연결되는 여러 통합을 생성할 수 있습니다. 즉, Twitter에 특정 Fuse Online 환경을 한 번만 등록해야 합니다.
각 Fuse Online 환경에는 Twitter 클라이언트 애플리케이션으로 Fuse Online 등록은 하나만 있을 수 있습니다. 그러나 각 Twitter 연결은 동일한 등록을 사용하지만 다른 사용자 자격 증명을 사용할 수 있습니다.
사전 요구 사항
Fuse Online에 로그인되어 있습니다.
절차
Fuse Online에서:
- 왼쪽 패널에서 설정을 클릭합니다.
-
설정 페이지에서 콜백 URL 오른쪽에 있는 상단에서
를 클릭하여 Fuse Online을 설치할 콜백 URL을 클립보드에 복사합니다. 이 URL은 이 절차의 뒷부분에서 필요합니다.
- Twitter 항목을 클릭하여 Consumer API Key 및 Consumer API Secret Key 필드를 표시합니다.
다른 브라우저 탭에서 Twitter 개발자 계정으로 이동하여 필요한 경우 로그인 한 다음 다음을 수행하십시오.
- 프로젝트 및 앱을 클릭합니다.
- 개요 페이지에서 독립 실행형 앱까지 아래로 스크롤한 다음 앱 만들기를 클릭합니다.On the Overview page, scroll down to STandalone Apps and then click Create App.
- 앱 이름 필드에 My Fuse Online Client 와 같은 이름을 입력합니다.
- 아래로 스크롤하여 앱 설정 후 앱 설정을 클릭합니다.
- 사용자 인증 설정으로 아래로 스크롤 하고 설정을 클릭합니다.
- OAuth 1.0a 옵션을 전환합니다.
- 앱 권한 의 경우 읽기 및 쓰기 및 직접 메시지를 선택합니다.
-
콜백 URL 필드에 이 절차의 시작 부분에 복사한 URL을 붙여넣습니다.
https://app-proj912876.7b63.fuse-ignite.openshiftapps.com/api/v1/credentials/callback과 같이 표시되어야 합니다. 웹 사이트 URL 필드에 URL 을 다시 붙여넣고 URL 끝에
/api/v1/credentials/callback을 제거합니다.다음 몇 개의 필드를 건너뛸 수 있습니다.
- 저장을 클릭합니다.
- 방금 생성한 앱의 페이지 상단에서 키 및 토큰 탭을 클릭합니다.
- Consumer Keys 에서 Regenerate 를 클릭한 다음 다시 생성할지 확인합니다.
- API 키를 복사합니다.
- Fuse Online Settings 페이지로 돌아가서 Twitter 소비자 API 키를 Fuse Online Twitter Consumer API Key 필드에 붙여넣습니다.
- Twitter 키 및 토큰 탭으로 돌아가서 소비자 API 시크릿 키를 복사합니다.
- Fuse Online Settings 페이지로 돌아가서 Twitter 소비자 API 시크릿 키를 Fuse Online Twitter Consumer API Secret Key 필드에 붙여넣습니다.
- 저장을 클릭합니다.
- Twitter 항목을 클릭하여 축소합니다.
26.2. Twitter 연결 만들기
Twitter에서 데이터를 가져오는 통합을 만들려면 먼저 Twitter 연결을 생성해야 합니다. Twitter 연결을 만든 후에는 여러 통합에서 사용할 수 있습니다.
사전 요구 사항
- Fuse Online에 로그인되어 있습니다.
- Fuse Online은 웹 브라우저에서 열려 있습니다.
- Fuse Online 환경을 Twitter에 액세스할 수 있는 애플리케이션으로 등록했습니다.
- Fuse Online Settings 페이지에 등록 후 받은 Twitter 소비자 API 키 및 소비자 API 시크릿 키를 추가했습니다.
절차
- Fuse Online의 왼쪽 패널에서 연결을 클릭하여 사용 가능한 연결을 표시합니다.
- 연결 만들기를 클릭하여 사용 가능한 커넥터를 표시합니다. 커넥터는 하나 이상의 연결을 생성하는 데 사용하는 템플릿입니다.
- Twitter 커넥터를 클릭합니다.
Connect Twitter 를 클릭하여 Twitter 인증 페이지를 표시합니다. 권한 부여 페이지를 보기 전에 Twitter에 로그인해야 할 수도 있습니다.
Connect Twitter 가 나타나지 않으면 Fuse Online 환경이 Twitter 클라이언트 애플리케이션으로 등록되지 않습니다. Fuse Online 등록을 Twitter 클라이언트 애플리케이션으로 참조하십시오. Twitter 연결을 만들고 Fuse Online 환경이 Twitter 클라이언트 애플리케이션으로 등록되지 않은 경우 Fuse Online에서 권한 부여 정보를 요청하는 여러 필드를 표시합니다. 이러한 필드에 값을 입력하여 Twitter 연결을 만들 수는 있지만 권장되지는 않습니다.
- 앱 인증을 클릭하여 Fuse Online으로 돌아갑니다.
-
이름 필드에 이 연결을 다른 연결과 구별하는 데 도움이 되는 이름의 선택을 입력합니다. 예를 들어,
Twitter Connect 1을 입력합니다. -
설명 필드에 선택적으로 이 연결에 대해 알 수 있는 정보를 입력합니다. 예를 들어
내 Twitter 로그인 자격 증명을 사용하는 Sample Twitter connection을 입력합니다. - 저장을 클릭하여 생성한 연결을 지금 사용할 수 있는지 확인합니다. 예제 이름을 입력하면 Twitter Connect 1 이 통합에 추가하도록 선택할 수 있는 연결로 표시되는 것을 확인할 수 있습니다.
26.3. 통합 실행을 트리거하는 Twitter 연결 추가
간단한 통합에서 시작 연결은 특정 say 또는 direct messages를 찾을 때 통합 실행을 트리거하는 Twitter 연결일 수 있습니다.
사전 요구 사항
- Twitter 연결을 생성했습니다.
- 간단한 통합을 만들거나 편집하고 Fuse Online에서 시작 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합을 시작하는 Twitter 연결을 클릭합니다. 통합에서 선택한 연결을 사용하여 Twitter에 연결하면 Fuse Online에서는 해당 연결에 정의된 자격 증명을 사용합니다.
연결을 수행할 작업을 선택합니다. 통합에 추가하는 Twitter 연결은 사용자가 선택한 동작만 수행합니다.
- 모니터 Twitter에서 연결이 권한이 부여된 Twitter 계정에 대한 Twitter 처리 기능이 포함된 again에 대해 Twitter를 언급합니다. 이러한 튜토리얼을 찾으면 연결은 통합 실행을 트리거하는 Fuse Online으로 돌아갑니다.
- Twitter 연결에 액세스할 수 있는 권한이 있는 Twitter 계정으로 전송되는 직접 메시지를 주기적으로 폴링합니다. 이러한 메시지를 찾으면 연결에서 통합 실행을 트리거하는 Fuse Online으로 돌아갑니다.
- 귀하가 지정한 기준과 일치하는 트로이블루션에 대해 주기적으로 Twitter를 폴링합니다. 이러한 튜토리얼을 찾으면 연결은 통합 실행을 트리거하는 Fuse Online으로 돌아갑니다.
선택한 작업을 구성합니다.
- mention 에는 구성이 필요하지 않습니다.
검색
count 의 기본값은 100이며 내부 동작에 영향을 주는 이 값을 변경할 필요가 없습니다. 그러나 이렇게 하면 성능이 저하될 수 있으므로 이 값을 50 미만으로 설정하지 마십시오.
검색 작업은 항상 지난 30일 동안 수신된 이전에 처리되지 않은 직접 메시지를 모두 반환합니다. 이전에 Ignore direct messages 를 선택하지 않으면 Retrieve 작업은 지난 30일 동안 수신된 모든 메시지를 반환합니다.
- 지연은 폴링 사이의 시간입니다. Twitter는 속도 제한을 적용하므로 너무 자주 폴링해서는 안 됩니다. 기본 간격은 5초입니다.
- 이전에 찾은 직접 메시지를 무시하면 선택한 경우 새 메시지만 반환됩니다.
검색
- 지연은 폴링 사이의 시간입니다. Twitter는 속도 제한을 적용하므로 너무 자주 폴링해서는 안 됩니다. 기본 간격은 5초입니다.
- 이전에 발견 한 networks을 무시하면 선택한 경우 새 networks 만 반환됩니다.
query 는 연결을 반환할 Twitter 형식의 검색 표현식입니다. 다음 표에서는 입력할 수 있는 항목의 예를 제공합니다. 자세한 내용은 검색 운영자에 대한 이 Twitter 문서에 있습니다.
쿼리
결과
내 제품My및Product가 모두 포함되었지만 반드시 내 제품이 포함된poss를 가져옵니다."내 제품"My Product인스턴스가 포함된poss를 가져옵니다.내 또는 제품My또는Product인스턴스 또는 각 인스턴스가 포함된mistral을 가져옵니다.내 -제품My인스턴스가 포함되어 있고Product인스턴스가 포함되지 않은 곳에는 도달할 수 있습니다.#MyProductMyProducthashtag가 포함된pos를 가져옵니다.
- 다음을 클릭하여 통합에 연결을 추가합니다.
결과
이제 통합이 시작 연결되고 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
26.4. 직접 메시지를 보내는 Twitter 연결 추가
흐름 중에 또는 간단한 통합을 완료하기 위해 Twitter 사용자에게 직접 메시지를 보내는 Twitter 연결을 추가할 수 있습니다. 직접 메시지는 지정된 사용자에게만 전달되는 개인 메시지입니다.
사전 요구 사항
- Twitter 연결을 생성했습니다.
- 흐름을 만들거나 편집하는 동안 Fuse Online에서 통합에 추가하라는 메시지가 표시됩니다. 또는 간단한 통합을 위해 Fuse Online에서 완료 연결을 선택하라는 메시지가 표시됩니다.
절차
- 통합에 추가 페이지에서 Twitter 연결을 추가할 더하기 기호를 클릭합니다.
- 통합에 추가할 Twitter 연결을 클릭합니다. 통합에서 선택한 연결을 사용하여 Twitter에 연결하면 Fuse Online에서는 해당 연결에 정의된 자격 증명을 사용합니다.
- 전송 작업을 선택합니다.
- 기본 메시지 필드에 데이터 매퍼 단계가 이전 단계의 직접 메시지 콘텐츠를 이 Twitter 연결에 매핑하지 않을 때 연결할 메시지를 입력합니다. 이 Twitter 연결을 구성할 때 메시지를 입력해야 하지만 이전 단계의 매핑이 여기에서 지정하는 메시지보다 우선합니다.
- 사용자 필드에 직접 메시지를 보낼 사용자의 Twitter 처리를 입력합니다. 예를 들어 Aslan 과 @Aslan 둘 다 맞는 것입니다.
- 다음을 클릭하여 통합에 연결을 추가합니다.
결과
연결은 통합 시각화의 중간 또는 끝에 나타납니다.