머신 속성 API 사용

Machine Attributes API 사용 방법

Node-RED, Python 또는 기타 서비스의 데이터를 사용하여 Tulip 머신을 생성합니다.

요약

Machine Attributes API를 사용하면 /attributes/report 엔드포인트를 통해 RESTful API 방식으로 머신의 특정 속성에 데이터를 전송할 수 있습니다. 이를 통해 Node-RED, Python 또는 기타 언어 및 서비스에서 Tulip과 유연하게 통합할 수 있는 다양한 옵션이 제공됩니다.

Machine API 설정

참고: 이미 Tulip 테이블 API가 설정되어 있는 경우, 해당 API 키와 시크릿을 사용할 수 있습니다.

1. 설정 > Tulip API로 이동합니다.
2. 화면 우측 상단의 ‘서비스 계정 생성’을 클릭합니다.
3. 서비스 계정 이름을 지정하고, 범위(scope)로 attributes:report를 선택하세요:

1. API 키, 시크릿 및 인증 헤더가 포함된 모달 창이 나타납니다. 이 정보는 나중에 다시 확인할 수 없으므로 반드시 저장해 두십시오!

새 기계 설정

머신 API를 설정하면 인스턴스에 새로운 머신 데이터 소스가 나타납니다. 이 데이터 소스를 보려면 [Shop Floor ] > [ Machines]를 클릭한 후 [ **Machine Data Sources]**로 이동하십시오 :

이 데이터 소스에 연결된 새 머신을 생성해야 합니다. 새 머신을 생성하려면 ‘머신 라이브러리’로 이동하여 ‘머신 생성’을 클릭하십시오 .

다음과 같은 모달 창이 나타납니다:

1. 기계 이름 (필수): 기계 이름을 입력하세요
2. 머신 데이터 소스 (필수): Tulip API를 선택하세요
3. 스테이션 (선택 사항)
4. 유형 (필수): 사용할 유형이 없는 경우 먼저 유형을 생성하십시오. 이 예시에서는 'default'라는 이름의 유형이 생성되었습니다.

머신이 생성되었으므로 이제 속성을 추가해야 합니다. 화면 오른쪽 상단의 ‘편집’을 클릭하세요. 그런 다음 화면 오른쪽 상단의 ‘+’ 버튼을 클릭하세요:

아직 머신 속성이 생성되지 않았으므로 파란색으로 표시된 머신 유형(이 예에서는 'Default')을 클릭하십시오.

그러면 해당 머신과 연결된 머신 유형 페이지로 이동합니다. 화면 오른쪽 상단의 ‘편집’ 버튼을 누르세요.

그런 다음 화면 왼쪽 하단의 ‘머신 속성’ 옆에 있는 ‘+’ 버튼을 누르세요.

이제 화면 오른쪽 하단에 있는 ‘+ 기계 속성 생성’을 클릭하세요.

이 예시에서는 정수(Integer) 유형의 카운터 (Counter) 속성을 생성해 보겠습니다.

속성이 생성되면 ‘머신 속성’ 목록에서 ‘카운터 속성’을 클릭한 다음, 화면 오른쪽 상단의 ‘저장’을 누르십시오.

기계 페이지로 돌아가세요.

이제 머신 속성이 생성되었으므로, 이를 머신에 추가할 수 있습니다. 오른쪽 상단 모서리에 있는 ‘편집’ 버튼을 누르세요. 그런 다음 오른쪽 상단 모서리에 있는 ‘+’ 버튼을 클릭하고 방금 생성한 카운터 속성을 선택하세요:

오른쪽 상단의 ‘저장’을 클릭해 주세요.

이제 Tulip 인스턴스에 Machine API, 머신 및 머신 속성이 설정되었습니다. 이제 어디서든 Tulip 머신으로 데이터를 전송할 수 있습니다!

여기에서 카운터 속성의 attributeId와 machineID를 확인할 수 있습니다. 이 정보는 아이콘을 클릭하여 복사할 수 있으며, HTTP 요청 본문에 사용됩니다.

이를 수행하려면 REST API에 대해 잘 알고 있어야 합니다. 쿼리 매개변수 및 본문 형식을 포함하여 /attributes/report 엔드포인트 사용 방법에 대한 전체 문서는 your-company.tulip.co/apidocs에서 확인하거나 Tulip API 페이지의 링크를 따라가면 볼 수 있습니다...

... 또한 문서에는 ‘Machine Monitoring’ 섹션이 있습니다.

추가 자료

API를 더 깊이 활용하고 Edge MC 및 Node-RED와 함께 사용하는 방법을 알고 싶다면이 기사를 확인해 보세요!