OData 커넥터 구성
ThingWorx Navigate는 사용자 지정 작업에 대한 데이터에 액세스할 수 있도록 Windchill REST Services와 함께 OData 커넥터 사용을 지원합니다.
 |
WindchillConnector(ptc-windchill-demo-thing)는 더 이상 사용되지 않으며 ThingWorx Navigate 9.1 이후 릴리즈에서 제거됩니다. 다음 릴리즈로 원활하게 전환하려면 사용자 지정 작업을 업데이트하여 OData 커넥터를 사용하도록 합니다.
|
사전 요구 사항
OData 커넥터를 사용하기 전에 ThingWorx Integration Runtime을 구성해야 합니다. 일반적으로 ThingWorx Integration Runtime은 ThingWorx Navigate 설치 도구에 의해 설치 프로세스의 일부로 구성됩니다.
커넥터 작성
OData 커넥터를 설정하기 위해 사용할 수 있는 옵션은 두 가지로, 커넥터의 새 인스턴스를 작성하거나 기본 제공 커넥터 ptc-windchill-OData-connector를 사용할 수 있습니다. 사용 사례에 가장 적합한 옵션을 선택합니다.
Info*Engine 작업을 사용하는 사용자 지정 작업의 경우, 기본 제공 ptc-windchill-OData-connector를 사용하는 것이 좋습니다. 이는 기본 제공 커넥터에서 Info*Engine 서비스를 이미 사용할 수 있기 때문입니다.
OData 커넥터의 새 인스턴스를 작성하려면 다음 단계를 수행합니다.
1. ThingWorx Composer에서 모델링 > 통합 커넥터를 찾은 다음 새로 만들기를 클릭합니다.
2. 템플릿 선택 창에서 ODataConnector 사물 템플릿을 선택하고 확인을 클릭합니다.
3. 커넥터의 이름과 프로젝트를 입력합니다.
이제 커넥터를 구성할 준비가 완료되었습니다.
커넥터 구성
1. Composer에서 생성한 커넥터를 열거나 ptc-windchill-OData-connector를 검색하고 엽니다. 일반 정보 페이지가 열립니다.
2. 구성 탭을 클릭합니다. 구성 페이지가 열립니다.
사용자의 구성은 Single Sign-on, Windchill 인증 또는 고정 인증 등 인증 방식에 따라 다릅니다.
Single Sign-on
Single Sign-on이 구성되어 있는 경우 다음 단계를 따릅니다.
1. 일반 커넥터 연결 설정에서 인증 유형에 SSO을 선택합니다.
2. 승인 서버 ID에서 sso-settings.json에 제공한 AuthorizationServerSettingsID 값(예: PingFed1)을 입력합니다.
3. 승인 서버 범위 설정 아래에서 추가를 클릭합니다. AuthorizationServerScopesSettings 창이 열립니다.
4. PingFederate에서 등록한 Windchill 범위를 범위에 입력합니다(예: WINDCHILL).
5. 추가를 클릭합니다.
6. CSRF 설정에서 다음 정보를 입력합니다.
◦ CSRF Get 요청에 대한 상대 URL - /servlet/odata
◦ CSRF 토큰 이름 - CSRF_NONCE
7. HTTP 커넥터 연결 설정에서 다음 정보를 입력합니다.
◦ 기본 URL - Windchill URL. URL은 /oauth로 끝나야 합니다. 다음 형식을 사용합니다.
[https]://[Windchill Host]:[port]/[Windchill-web-app]/oauth
이 형식은 연결이 OAuth 표준을 사용하며 리소스 공급자에서 데이터 요청이 가능하도록 지정합니다.
◦ 상대 URL - /servlet/odata
사용자 이름과 암호를 입력할 필요가 없습니다.
8. 저장을 클릭합니다. OData 커넥터가 이제 사용자의 Single Sign-on 환경에서 작동되도록 구성되었습니다.
Windchill 인증
Windchill 인증이 구성되어 있는 경우 다음 단계를 따릅니다.
1. 일반 커넥터 연결 설정에서 인증 유형에 None을 선택합니다.
2. CSRF 설정에서 다음 정보를 입력합니다.
◦ CSRF Get 요청에 대한 상대 URL - /servlet/odata
◦ CSRF 토큰 이름 - CSRF_NONCE
3. HTTP 커넥터 연결 설정에서 다음 정보를 입력합니다.
◦ 기본 URL-ionecctor에서 Info * Engine 요청을 받는 Windchill 서버입니다. 다음 형식을 사용합니다.
[https]://[Windchill Host]:[port]/[Windchill-web-app]/sslClientAuth
◦ 상대 URL - /servlet/odata
◦ 연결 URL - /servlet/WindchillGW/wt.httpgw.HTTPServer/ping
사용자 이름과 암호를 입력할 필요가 없습니다.
4. 저장을 클릭합니다. OData 커넥터가 이제 사용자의 Windchill 인증 환경에서 작동되도록 구성되었습니다.
고정 인증
고정 인증이 구성되어 있는 경우 다음 단계를 따릅니다.
1. 일반 커넥터 연결 설정에서 인증 유형에 Fixed을 선택합니다.
2. CSRF 설정에서 다음 정보를 입력합니다.
◦ CSRF Get 요청에 대한 상대 URL - /servlet/odata
◦ CSRF 토큰 이름 - CSRF_NONCE
3. HTTP 커넥터 연결 설정에서 다음 정보를 입력합니다.
◦ 사용자 이름 - 사용자의 Windchill 관리자 사용자 이름
◦ 암호 - 사용자의 Windchill 관리자 암호
◦ 기본 URL-ionecctor에서 Info * Engine 요청을 받는 Windchill 서버입니다. 다음 형식을 사용합니다.
[https]://[Windchill Host]:[port]/[Windchill-web-app]
◦ 상대 URL - /servlet/odata
4. 저장을 클릭합니다. OData 커넥터가 이제 사용자의 고정 인증 환경에서 작동되도록 구성되었습니다.
커넥터의 서비스 노출
커넥터를 구성한 후 다음 단계는 사용자 지정 작업에 따라 달라집니다.
• Info*Engine 작업을 사용하지 않는 사용자 지정 작업의 경우, 커넥터에서 필요한 서비스를 노출합니다. 서비스 노출에 대한 자세한 내용은 통합 커넥터의 서비스 노출 및 도움말 센터의 서비스에 대한 새 API 맵 생성 항목을 참조하십시오.
• Info*Engine 작업을 사용하는 사용자 지정 작업의 경우, OData 커넥터를 사용하여 Info*Engine 서비스 실행 항목으로 계속 진행합니다.