연결 만들기
일부 시스템에서는 OAuth 메커니즘을 지원하지 않을 수 있습니다. 이러한 시스템은 사용자 이름과 암호를 사용하는 기본 인증과 같은 다른 인증 메커니즘을 사용하거나 키 기반 메커니즘을 지원할 수 있습니다. OAuth를 지원하지 않는 모든 시스템에 대해 연결을 정의해야 합니다.
새 연결을 만들려면 다음을 수행합니다.
1. 명령 프롬프트에서 다음 명령을 실행합니다.
a. cd <user project root directory>
b. flow add connection <name>
사용자의 연결이 <service-name>-<connection-name> 형식으로 지정됩니다.
서비스 이름은 CLI에서 자동으로 추가됩니다. connection.json 파일 및 index.js 파일로 구성된 로컬 디렉터리에 새 폴더(connector name-connection name)가 작성됩니다.
다음 옵션을 명령에 사용할 수 있습니다.
|
옵션
|
설명
|
데이터 유형
|
|---|---|---|
|
--version
|
버전 번호를 표시합니다.
|
[부울]
|
|
--help
|
도움말을 표시합니다.
|
[부울]
|
|
--parentDir,-d
|
프로젝트에 대한 상위 디렉터리입니다.
|
[기본값: "."]
|
|
--logLevel,-1
|
로그 수준을 설정합니다.
|
[기본값: "info"]
|
|
--artifactVersion,-v
|
작성할 아티팩트의 버전입니다.
|
[기본값: "v1"]
|
2. 시스템 연결을 위해 수집해야 할 정보를 확인합니다.
 |
정보는 URL, 사용자 이름, 암호, 앱 키 또는 시스템 연결에 필요한 기타 정보 양식일 수 있습니다.
|
위 정보는 connection.json 파일에 JSON 스키마로 표현되어야 합니다. ThingWorx Flow는 이 정보를 사용하여 해당 양식을 ThingWorx Flow 워크플로 편집기에 표시합니다.
index.js 파일은 양식에 저장된 정보를 변환하며 작업 및 트리거에 사용될 수 있습니다. 양식에서 반환된 이 정보는 암호화되어 ThingWorx Flow 데이터베이스에 저장됩니다.
형식 적용된 스키마 connection.json 파일 및 입력 양식이 다음과 같이 표시됩니다.
아래 표에는 JSON 스키마에 사용된 속성에 대한 설명이 나와 있습니다.
속성 | JSON 파일에 속성 입력 |
|---|---|
type | 최상위 유형은 항상 object 유형이어야 합니다. |
title | ThingWorx Flow 홈 페이지에서 인증 창의 제목으로 사용됩니다. |
format | ThingWorx Flow 캔버스에 양식을 표시하는 데 사용되는 레이아웃입니다. |
properties | 대상 시스템 인증을 위해 사용자로부터 획득한 속성을 포함합니다. 이 속성은 하위 속성을 개수 제한 없이 포함할 수 있습니다. 모든 하위 속성에 제목, 유형 및 설명이 있어야 합니다. 유형은 JSON 스키마에서 지원하는 유형이면 됩니다. 예를 들어, 시스템에 연결하는 데 email, subscription_id, account_url, API 토큰이 필요함을 확인할 수 있습니다. |
계약
index.js와 같은 JavaScript 파일은 두 개의 메소드가 포함된 JavaScript 객체를 내보내야 합니다.
• connect - 입력을 작업, 트리거 및 조회에 사용하기에 적합한 형태로 변환합니다.
• validate - 연결의 유효성을 검사하는 데 사용됩니다. 일반적으로 npm request 라이브러리와 같은 몇 가지 API를 사용하여 대상 시스템에 연결할 수 있습니다.
연결에 사용할 수 있는 API용 SDK에 대한 자세한 내용은
ThingWorx Flow 커넥터 SDK 단원을 참조하십시오.
다음 비디오에서는 ThingWorx Flow CLI를 사용하여 연결을 만드는 과정을 보여줍니다.