Integrity Lifecycle Manager

ThingWorx Flow > 기본 제공 커넥터 및 작업 > 기본 제공 커넥터 서비스 > Integrity Lifecycle Manager

Integrity Lifecycle Manager(ILM) 커넥터를 사용하면 ThingWorx Flow 워크플로에서 Integrity Lifecycle Manager 작업을 액세스하고 실행할 수 있습니다.

사전 요구 사항

사용 중인 Integrity Lifecycle Manager 버전에 따라 올바른 전제 조건을 설정했는지 확인합니다.

Integrity Lifecycle Manager 12.1을 사용하는 경우

1. 다음을 설정하고 구성합니다.

▪ Integrity Lifecycle Manager 12.1 서버

▪ Integrity Lifecycle Manager REST 서비스 12.1

▪ Integrity Lifecycle Manager 요구사항 및 유효성 검사 솔루션

2. 다음 부트스트랩 API 끝점을 실행합니다.

https://<호스트 이름>:<포트>/rws/odata/ptc/ilm/resources/jsongenerators

REST 서비스 또는 Integrity Lifecycle Manager 서버가 재시작될 때마다 이 끝점을 실행해야 합니다.

Integrity Lifecycle Manager 12.2를 사용하는 경우

1. 다음을 설정하고 구성합니다.

▪ Integrity Lifecycle Manager 12.2 서버

▪ Integrity Lifecycle Manager 요구사항 및 유효성 검사 솔루션

2. <Integrity_Server_Directory>/data/rws에 있는 ResourcesNameMapping.xml 파일에서 아래와 같이 다음 target 필드에 대해 source 값을 수정합니다.

대상	소스
라이브 항목 ID	LiveItemID
주 버전 ID	MajorVersionID
부 버전 ID	MinorVersionID
유형	유형

Integrity Lifecycle Manager 커넥터의 다양한 작업에 대한 필드 이름은 ResourcesNameMapping.xml 파일에 있는 source 값과 동일합니다. 작업에 대한 해당 필드 이름을 보려면 다른 target 필드에 대한 source 값을 변경하면 됩니다. 그러나 source 값에는 공백이 없어야 합니다.

3. 다음 끝점을 실행합니다.

https://<호스트 이름>:<포트>/rws/odata/ptc/ilm/resources/jsongenerators?updateformapping=true

다음 사항에 유의하십시오.

• ResourcesNameMapping.xml 파일을 업데이트할 때마다 이 끝점을 실행해야 합니다.

• 서버가 재시작될 때마다 ResourcesNameMapping.xml 파일이 원래대로 재설정되고 수정된 파일은 백업(ResourcesNameMapping.xml.bak)으로 저장됩니다.

ResourcesNameMapping.xml 파일을 삭제하고 ResourcesNameMapping.xml.bak의 이름을 ResourcesNameMapping.xml로 바꾼 후 끝점을 다시 실행하십시오.

ThingWorx Flow에서 HTTP 유틸리티의 HTTP 요청 작업을 사용하여 끝점을 실행할 수 있습니다. HTTP 요청 작업을 사용하는 경우 URL 값을 부트스트랩 API 끝점 URL로 설정하고 기본 인증에 대한 추가 필드에서 관리자 사용자의 사용자 이름 및 암호를 설정합니다. Integrity Lifecycle Manager에서 SSL/TLS를 사용하도록 구성되지 않은 경우 SSL 인증서 확인을 false로 설정하고, 그렇지 않으면 true로 설정합니다. 자세한 내용은 HTTP 요청을 참조하십시오.

커넥터 릴리즈 버전

Integrity Lifecycle Manager 커넥터는 8.4.1 릴리즈에서 제공되었습니다.

지원되는 작업

• 항목 만들기

• 항목 편집

• 질의 실행

• 텍스트 검색

지원되는 트리거

없음

지원되는 승인

Integrity Lifecycle Manager 커넥터의 경우 다음 승인이 필요합니다.

• 기본

• OAuth

OAuth 연결을 추가하기 전에 클라이언트 ID 및 클라이언트 보안 키 가져오기에 나오는 단계를 따라야 합니다.

Integrity Lifecycle Manager 승인

각 Integrity Lifecycle Manager 커넥터 작업에 대해 Integrity Lifecycle Manager를 승인해야 합니다. Integrity Lifecycle Manager 커넥터를 승인하려면 다음 인증 체계 중 하나를 선택합니다.

• 기본 - 인증 체계 선택 목록에서 기본을 선택하고 다음 단계를 완료합니다.

1. 새로 추가를 클릭하고 다음 세부 정보를 입력합니다.

▪ 연결 레이블 - 자동으로 채워집니다. 원하는 연결 레이블을 제공할 수 있습니다.

▪ Integrity Lifecycle Manager REST URL - REST URL(예: https://<REST 서버 호스트 이름>:<REST 서버 포트 번호>)을 입력합니다.

▪ 사용자 이름 및 암호를 입력합니다.

2. 추가를 클릭합니다.

테스트를 클릭하여 연결의 유효성을 검사합니다.

• OAuth - 인증 체계 선택 목록에서 OAuth를 선택하고 다음 단계를 완료합니다.

1. 새로 추가를 클릭하고 다음 세부 정보를 입력합니다.

▪ 사용자 이름 - 사용자 이름을 입력합니다.

▪ 암호 - 암호를 입력합니다.

▪ 허용을 클릭한 다음 승인 프로세스를 완료합니다.

▪ 승인 추가 창에서 필요한 경우 승인 레이블의 이름을 바꾼 다음 리소스 URL(예: https://<REST 서버 호스트 이름>:<REST 서버 포트 번호>)을 추가합니다.

2. 추가를 클릭합니다.

테스트를 클릭하여 연결의 유효성을 검사합니다.

OData 커넥터 작업 사용

OData 커넥터에 대한 속성 가져오기 작업을 사용하면 하나 이상의 Integrity Lifecycle Manager 항목의 콘텐츠 또는 속성을 가져올 수 있습니다. 흐름에 속성 가져오기 작업을 사용하려면 기본 URL에 대해 https://<호스트 이름>:<포트>/rws/odata/ptc/ilm/items/$metadata 형식을 사용합니다.

자세한 내용은 OData 커넥터를 참조하십시오.

예

ThingWorx Flow을 사용하여 Excel Online 및 Integrity Lifecycle Manager 작업을 통합하는 방법을 알아보겠습니다.

Integrity Lifecycle Manager 질의 결과를 Excel 시트로 가져오기

필수조건:

1. 동일한 엔터프라이즈 계정을 사용하여 Excel Online과 Integrity Lifecycle Manager에 액세스할 수 있어야 합니다.

2. 일부 질의는 Integrity Lifecycle Manager에서 이미 작성되어 있습니다. 예를 들어, 문제점 질의는 모든 문제점을 반환합니다. 사용자 정의 질의를 만드는 방법을 알아보려면 PTC 지원 웹 사이트에서 Integrity Lifecycle Manager 설명서를 참조하십시오.

단계:

Integrity Lifecycle Manager의 질의 실행 작업 구성

1. Integrity Lifecycle Manager 커넥터에 있는 질의 실행 작업을 캔버스에 끌어 놓고 마우스 포인터로 작업을 가리킨 다음

을 클릭하거나 작업을 두 번 클릭합니다. 질의 실행 작업 창이 열립니다.

2. 질의 실행 작업에서 연결을 만듭니다. 연결을 만드는 방법에 대한 자세한 내용은 Integrity Lifecycle Manager 커넥터 항목을 참조하십시오.

3. 다음 정보를 입력합니다.

a. 질의 필드에서 문제점을 선택합니다.

b. 정렬 순서 섹션에서 결과를 정렬할 속성을 선택합니다.

c. 결과의 순서(오름차순 또는 내림차순)를 선택합니다.

d. 질의의 출력에 표시될 속성을 선택합니다. 이 예에서는 속성 선택 섹션에서 추가를 클릭하여 7개의 속성(ID, 요약, 프로젝트, 우선 순위, 심각도, 상태, 설명)이 추가되었습니다.

4. 질의 실행 작업을 캔버스의 시작 아이콘

에 연결합니다.

질의 출력 처리에 대한 루프 구성

이 예에서는 루프를 사용하여 데이터를 한 번에 한 행씩 Excel 테이블에 작성합니다. 루프 유틸리티에 대한 자세한 내용은 루프 작업을 참조하십시오.

유틸리티 탭에서 또는 검색 상자에서 단순히 루프를 검색하여 루프 작업을 찾을 수 있습니다. 루프 작업에서 작업을 끌어야 합니다.

을 클릭하고 루프 유틸리티에 있는 루프 작업을 캔버스에 끌어 놓습니다.

2. 질의 실행 작업을 루프 도구에 연결합니다.

3. 루프를 캔버스의 중지 아이콘

에 연결합니다.

4. 루프 유형 선택 목록에서 각 항목을 선택합니다. 루프 작업은 질의 실행 작업 결과의 항목과 동일한 횟수만큼 실행됩니다.

5. 소스 배열 또는 객체 필드에서 결과 항목 옆에 있는

을 클릭하여 질의 실행 작업에 대한 트리거 데이터 결과 항목을 선택합니다.

이제 Excel Online 커넥터에서 테이블을 만들겠습니다.

1. 엔터프라이즈 계정 자격 증명을 사용하여 Microsoft Excel Online 웹 사이트 및 로그인으로 이동합니다. 통합 문서를 작성합니다. 이 예에서는 이름이 DemoTask인 통합 문서를 만듭니다.

이 통합 문서에는 기본 시트로 Sheet 1이 있습니다.

2. 왼쪽 아래의 시트 탭 옆에 있는 +를 클릭하여 다른 시트를 추가합니다.

3. 원하는 이름으로 테이블을 만듭니다. 여기서는 Table 1로 만들겠습니다. 이 테이블에는 Integrity Lifecycle Manager 질의에서 가져온 필드와 유사한 개수의 열이 있어야 합니다. 이 예에는 7개의 열(ID, 요약, 프로젝트, 우선 순위, 심각도, 상태, 설명)이 작성됩니다.

4. 루프의 왼쪽 및 오른쪽 모두에서 테이블에 행 추가 작업을 연결합니다.

ThingWorx Flow Excel Online 커넥터의 테이블에 행 추가 작업 구성

1. Excel Online 커넥터에 있는 테이블에 행 추가 작업을 캔버스에 끌어 놓고 마우스 포인터로 작업을 가리킨 다음

을 클릭하거나 작업을 두 번 클릭합니다. 테이블에 행 추가 작업 창이 열립니다.

2. 필요한 경우 레이블 이름을 편집합니다. 기본적으로 레이블 이름은 작업 이름과 동일합니다.

3. 승인을 추가하려면 Excel Online 커넥터 항목의 Excel Online 승인 단원을 참조하십시오.

이전에 Excel Online 승인을 추가한 경우 목록에서 승인을 선택합니다.

4. 다음 세부 내용을 입력합니다.

a. 폴더 이름 - 목록에서 문서를 선택합니다.

b. 통합 문서 ID - 작성된 통합 문서의 이름을 선택합니다. 이 경우 DemoTask입니다.

c. 시트 ID - 테이블이 있는 시트의 이름을 선택합니다. 이 경우 Sheet 1에 테이블이 있습니다.

d. 테이블 ID/이름 - 질의 결과를 작성할 테이블의 이름입니다. 목록에서 테이블 이름을 선택합니다.

e. 엔트리 유형 선택 - 단일 행 엔트리 및 여러 행 엔트리를 선택합니다. 이 자습서에서는 루프 도구와 함께 단일 행 엔트리를 사용하므로 루프가 Integrity Lifecycle Manager 질의에서 반환된 항목 수만큼 실행하고 테이블에 하나씩 추가됩니다.

행 값 - 테이블을 채울 행 값을 매핑합니다. 행 값 필드에서 7개의 필드를 채워야 하므로 7개의 열이 추가됩니다. 다음 그림과 같이 열 1, 2, 3, 4, 5, 6, 7에 각각 ID, 요약, 프로젝트, 우선 순위, 심각도, 상태, 설명이 추가됩니다. 열 순서는 1단계에서 Excel 시트에서 작성한 테이블과 동일합니다.

이러한 결과 항목이 하나의 배열에 있으며 루프가 실행될 때마다 루프 색인의 현재 값을 삽입해야 합니다. 따라서 다음 그림과 같이 색인에서 루프의 현재 색인이 추가됩니다.

오른쪽 위에 있는 실행 버튼을 클릭하여 흐름을 시작합니다.

결과

흐름이 완료되면 Excel 테이블이 질의 결과로 채워집니다. 제공된 이미지에서 필드가 모두 7개인 테이블에 두 개의 문제점이 추가된 것을 확인할 수 있습니다.

Excel 데이터를 사용하여 Integrity Lifecycle Manager 항목 편집

사전 요구 사항

1. 동일한 엔터프라이즈 계정을 사용하여 Excel Online과 Integrity Lifecycle Manager에 액세스할 수 있어야 합니다.

2. Integrity Lifecycle Manager 12.1 서버

a. REST 웹 서비스

b. Integrity Lifecycle Manager 요구사항 및 유효성 검사 솔루션

3. ThingWorx Flow

단계:

Excel 시트의 필드 값을 편집합니다.

"우선 순위" 및 "심각도"가 두 항목에 대해 각각 "낮음" 및 "경미"로 변경됩니다.

Excel Online 커넥터의 테이블 행 가져오기 작업 구성:

1. Excel Online 커넥터에 있는 테이블에 행 추가 작업을 캔버스에 끌어 놓고 마우스 포인터로 작업을 가리킨 다음

을 클릭하거나 작업을 두 번 클릭합니다. 테이블에 행 추가 작업 창이 열립니다.

2. 다음 필드에 정보를 입력합니다.

a. 폴더 이름 - 목록에서 문서를 선택합니다.

b. 통합 문서 ID - 목록에서 작성된 통합 문서의 이름을 선택합니다. 이 경우 DemoTask입니다.

c. 시트 ID - 목록에서 테이블이 있는 시트의 이름을 선택합니다. 이 테이블은 "시트2"에 있습니다.

d. 테이블 ID - 질의 결과를 작성할 테이블(이전에 작성해 놓은 테이블)의 이름입니다. 목록에서 테이블 이름을 선택합니다.

e. 가져올 행 - 사용자가 테이블에서 읽고 Integrity Lifecycle Manager에서 편집할 행 수를 입력합니다.

f. 건너뛸 행 - 사용자는 테이블 위에서 일부 행을 건너뛸 수 있습니다. 건너뛸 행에 대한 값을 입력합니다.

3. 테이블 행 가져오기 작업을 캔버스의 시작 아이콘

에 연결합니다.

구성이 완료되었습니다.

질의 출력 처리를 위해 루프 작업 구성

유틸리티 탭에서 또는 검색 내에서 단순히 루프를 검색하여 루프 작업을 찾을 수 있습니다. 커넥터는 함께 사용할 루프 내부로 끌어야 합니다. 이 자습서는 Integrity Lifecycle Manager에서 항목을 하나씩 편집하는 데 사용됩니다. 소스 배열 또는 객체 작업에서 테이블 행 가져오기의 출력인 결과 항목이 선택됩니다.

을 클릭하고 루프 유틸리티에 있는 루프 작업을 캔버스에 끌어 놓습니다.

2. 루프 유형 선택 필드의 목록에서 각 항목을 선택합니다. 테이블 행 가져오기 작업 결과의 항목 수와 동일한 횟수만큼 루프를 실행합니다.

3. 소스 배열 또는 객체 필드에서

을 클릭하여 트리거 데이터 섹션의 테이블 값을 매핑합니다.

4. 테이블 행 가져오기 작업을 루프 작업에 연결합니다.

5. 루프 작업을 캔버스의 출력

에 연결합니다.

루프 작업이 구성되었습니다.

Integrity Lifecycle Manager의 항목 편집 작업 구성

1. Integrity Lifecycle Manager 커넥터에 있는 항목 편집 작업을 캔버스에 끌어 놓고 마우스 포인터로 작업을 가리킨 다음

을 클릭하거나 작업을 두 번 클릭합니다. 항목 편집 작업 창이 열립니다.

2. 엔티티 유형 필드에 편집할 항목의 유형을 입력합니다. 이 경우에 문제점이 있습니다. 선택 후 선택한 항목 유형과 관련된 필드가 나타납니다.

3. 테이블 값의 값을 매핑하고 현재 색인에 따라 색인을 변경합니다.

4. 모든 다른 필드는 테이블 행 가져오기 작업 아래의 테이블 값에서 매핑됩니다.

5. 항목 편집 작업을 루프 작업의 오른쪽에 연결합니다.

6. 오른쪽 위에 있는 실행 버튼을 클릭하여 흐름을 실행합니다. 흐름이 완료된 후 사용자는 Integrity Lifecycle Manager에서 편집된 필드를 볼 수 있습니다. 다음 그림에 최종 흐름이 나와 있습니다.