ThingWorx Composer의 WorkflowSubsystem에서 서비스 실행
사전 요구 사항
ThingWorx Composer에서 서비스를 실행하기 전에 다음 사전 요구 사항을 충족하는지 확인합니다.
• ThingWorx Flow 서버가 실행 중이어야 합니다.
• 관리자로 ThingWorx에 로그인합니다.
단계
1. ThingWorx Flow 대시보드에서 Composer를 클릭하여 ThingWorx Composer로 이동합니다.
2. ThingWorx Composer의 시스템에서 하위 시스템을 선택합니다.
3. WorkflowSubsystem을 선택하고 서비스 탭을 클릭합니다. ThingWorx Flow에 사용할 수 있는 노드는 다음과 같습니다.
4. 서비스를 검색하고 다음 작업 중 하나를 수행합니다.
◦ 입력 및 출력 정보를 보려는 서비스를 선택합니다.
◦ 
을 클릭합니다. 적절한 입력 값을 입력하고 실행을 클릭합니다.
을 클릭합니다. 적절한 입력 값을 입력하고 실행을 클릭합니다.서비스
LoadOAuthConfiguration
이 서비스를 사용하여 OAuth 구성 JSON 파일을 ThingWorx Flow 서버에 로드합니다. 이 서비스는 JSON 파일에 지정된 커넥터의 OAuth 공급자를 업데이트하거나 추가합니다. 기존 OAuth는 삭제되지 않습니다.
입력 | 출력 | ||
|---|---|---|---|
매개 변수 이름 | 기본 유형 | 설명 | |
oauthConfigurations | JSON | 커넥터에 대한 올바른 OAuth 구성 설정이 포함된 유효한 JSON 파일을 제공합니다. | 성공적으로 완료되었거나 서비스 실행 중에 오류가 발생했다는 메시지를 반환합니다. |
예: JIRA에 대한 OAuth 구성을 로드하려면 oauthConfigurations 값을
"jira": {
"JIRA": {
"CLIENT_ID": "<Client ID>"
"CLIENT_SECRET": "<Secret>"
}
},
"JIRA": {
"CLIENT_ID": "<Client ID>"
"CLIENT_SECRET": "<Secret>"
}
},
으로 입력합니다.
ThingWorx Composer에서 사용할 수 있는 OAuth 구성 JSON 파일 템플릿은 OAuths 구성 및 로드를 참조하십시오.
DeleteOAuthConfiguration
OAuth 공급자를 어느 커넥터에서도 사용하고 있지 않은 경우 이 서비스를 사용하여 ThingWorx Flow 서버에서 OAuth 구성을 삭제합니다.
입력 | 출력 | ||
|---|---|---|---|
매개 변수 이름 | 기본 유형 | 설명 | |
Connector config name | 문자열 | 해당 OAuth 구성 설정을 삭제할 유효한 커넥터 구성 값을 제공합니다. | 성공적으로 완료되었거나 서비스 실행 중에 오류가 발생했다는 메시지를 반환합니다. |
OAuth provider | 문자열 | 지정된 커넥터에 유효한 OAuth 공급자를 제공합니다. | |
JIRA에 대한 동일한 OAuth 구성을 삭제하려면 Connector config name 필드의 값을 jira로 제공하고 OAuth provider 필드 값을 JIRA로 제공합니다.
GetOAuthConfiguration
이 서비스를 사용하여 OAuth가 ThingWorx Flow 서버에 로드되는 커넥터 목록을 검색합니다. 클라이언트 ID, 클라이언트 보안 및 URL과 같은 중요한 정보는 표시되지 않습니다.
입력 | 출력 | ||
|---|---|---|---|
매개 변수 이름 | 기본 유형 | 설명 | |
- | - | - | ThingWorx Flow 서버에 로드된 모든 OAuth의 커넥터 이름과 OAuth 공급자 이름을 제공하는 JSON을 반환합니다. |
DeleteOAuthAccessToken
이 서비스를 사용하여 지정된 OAuth 공급자의 OAuth 액세스 토큰을 삭제합니다.
입력 | 출력 | ||
|---|---|---|---|
매개 변수 이름 | 기본 유형 | 설명 | |
OAuth provider | 문자열 | 타사 서비스 또는 유틸리티에 대해 유효한 OAuth 공급자를 제공합니다. | 성공적으로 완료되었거나 서비스 실행 중에 오류가 발생했다는 메시지를 반환합니다. |
User Name | 문자열 | 지정된 OAuth 공급자에 대해 생성된 액세스 토큰을 삭제할 ThingWorx 사용자 이름을 제공합니다. 이 필드는 선택 사항입니다. 사용자 이름을 지정하지 않으면 서비스는 지정된 OAuth 공급자의 모든 사용자에 대한 모든 OAuth 액세스 토큰을 삭제합니다. | |
 | 서비스에서 OAuth 공급자에 대한 OAuth 액세스 토큰을 삭제한 후에는 OAuth(등록 사용자) 커넥터가 ThingWorx Flow 대시보드에  아이콘과 함께 나타납니다. |
사용자에 대한 OAuth 액세스 토큰이 삭제된 후 사용자가 워크플로를 실행하려면 OAuth 커넥터에 대한 해당 승인 정보를 제공해야 합니다.
◦ OAuth(등록 사용자) - 커넥터를 재구성하는 자격 증명을 제공하도록 Oauth(등록 사용자) 커넥터를 편집합니다.
◦ OAuth(세션 사용자) - 해당 워크플로에서 이 OAuth(세션 사용자) 커넥터를 사용하는 모든 사용자는 로그인하여 타사 서비스 또는 유틸리티에 다시 승인을 제공하고 권한을 부여해야 합니다.
RefreshMetadata
ThingWorx Flow는 Windchill OData 정보를 캐시하여 성능을 향상시킵니다. Windchill 메타데이터 사양을 수정했거나 Windchill 서버에서 소프트 속성을 업데이트한 경우 이 서비스를 사용하여 ThingWorx Flow 서버에서 해당 항목을 업데이트합니다.
입력 | 출력 | ||
|---|---|---|---|
매개 변수 이름 | 기본 유형 | 설명 | |
connectorName | 문자열 | 타사 서비스에 대한 커넥터 이름을 제공합니다. | 성공적으로 완료되었거나 서비스 실행 중에 오류가 발생했다는 메시지를 반환합니다. |
ValidateFlowSetup
이 서비스를 실행하여 ThingWorx Flow가 ThingWorx 서비스와 통신할 수 있는지 확인합니다.
입력 | 출력 | ||
|---|---|---|---|
매개 변수 이름 | 기본 유형 | 설명 | |
- | - | - | 성공적으로 완료되었거나 서비스 실행 중에 오류가 발생했다는 메시지를 반환합니다. |
ThingWorx와 ThingWorx Flow 서비스 사이에 연결 문제가 발생하는 경우 다음과 같은 오류 코드와 메시지가 표시됩니다.
오류 코드 | 오류 메시지 |
|---|---|
[FLOW-CONFIG-01] | ThingWorx Flow is not enabled. Add the OrchestrationSettings section to the platform-settings.json file to enable ThingWorx Flow. |
[FLOW-RABBIT-01] | Failed to connect to RabbitMQ. Check whether the RabbitMQ service is running and is accessible. |
[FLOW-API-01] | Failed to connect to ThingWorx Flow. Check ThingWorx logs for more detail. |
[FLOW-API-02] | Failed to connect to ThingWorx Flow. ThingWorx Flow 설치 후 ThingWorx Flow 호스트 이름과 포트를 통해 ThingWorx에 액세스하고 있는지 확인합니다. Otherwise, ThingWorx Flow and ThingWorx will not be able to communicate with each other. |
[FLOW-KEY-01] | OAuth admin key not found in the ThingWorx KeyStore. |
[FLOW-KEY-02] | Exchange admin key not found in the ThingWorx KeyStore. |
[FLOW-KEY-03] | Failed to get ThingWorx Flow keys from the ThingWorx KeyStore. |
[FLOW-KEY-04] | Failed to get ThingWorx Flow keys from the ThingWorx KeyStore. |
[FLOW-EXCHANGE-01] | Failed to connect to ThingWorx Flow exchange service. Check ThingWorx logs for more details. |
[FLOW-EXCHANGE-02] | Failed to connect to ThingWorx Flow exchange service. Check whether ThingWorx Flow exchange service is up and running. |
[FLOW-OAUTH-01] | Failed to connect to ThingWorx Flow OAuth service. Check ThingWorx logs for more details. |
[FLOW-OAUTH-02] | Failed to connect to ThingWorx Flow OAuth service. Check whether ThingWorx Flow OAuth service is up and running. |