바텐더 통합

바텐더는 Tulip 앱에서 가능한 인쇄 기능을 확장합니다.

:::(Info) ( Tulip 라이브러리에서 바텐더 유닛 테스트를 다운로드하세요.:::

Seagull Scientific의 Bartender는 제조 업계에서 ERP/MES 솔루션과 계속 확장되는 프린터 목록, 네트워크 구성 등의 인터페이스 계층으로 광범위하게 사용되는 업계 최고의 인쇄 클라이언트입니다.

간단히 말해, 바텐더는 이 방정식의 프린터 측면을 처리하고 문서를 인쇄하기 위해 Tulip 커넥터 기능이 호출할 수 있는 API 엔드포인트를 노출하며, 이 문서에서는 해당 통합을 안내합니다.

네트워크 고려 사항

바텐더 클라이언트는 일반적으로 시설의 인터넷 네트워크에 있는 서버(또는 컴퓨터)에서 호스팅됩니다. 이 서버는 일반적으로 외부 시스템에서 액세스할 수 없습니다. Tulip은 클라우드에서 실행되므로 바텐더 인스턴스를 클라우드에 노출해야 합니다.

이를 위한 몇 가지 방법이 있습니다:

1. 온프레미스 커넥터 호스트가 네트워크에 대한 터널 역할을 할 수 있습니다. 이러한 커넥터의 설정 프로세스는 다소 복잡할 수 있으며 IT 팀의 지원이 필요할 수 있습니다.
2. 네트워크에 연결된 Tulip 에지 디바이스가 네트워크에서 이 커넥터 호스트 역할을 할 수 있습니다. 이 방법은 이 터널을 설정하는 가장 쉬운 방법이며, 설정하는 데 IT 팀의 도움이 필요하지 않습니다. Edge MC는 $150에 구입할 수 있습니다.
3. 바텐더 인스턴스를 노출하기 위해 SSH 터널을 설정할 수 있습니다. 이는 가장 기술적인 옵션이며, 설정하는 데 거의 확실하게 IT 부서의 도움이 필요합니다. 이러한 종류의 터널에는 Tulip이 구축한 솔루션의 기본 제공 보안 기능이 제공되지 않습니다.

또한 Bartender의 인쇄 포털 서비스를 사용할 것입니다. 이는 '자동화' 및 '엔터프라이즈' 요금제에서만 액세스할 수 있습니다.

설정

:::(Info) (참고)이 절차는 바텐더와의 통합에 대한 원래 조사의 일환으로 작성되었으며, 단위 테스트 애플리케이션에서 제공되는 기능은 약간 다를 수 있습니다:::

바텐더 라벨 구성

바텐더 내에서 라벨 예제라는 라벨 예제를 만들었으며 이 문서는 다운로드할 수 있습니다(이 문서 하단에 첨부되어 있음). 중요한 구성은 라벨의 각 동적 필드가 템플릿 양식의 입력에 연결되도록 하는 것입니다. 이 경우에는 Tulip에서 라벨을 사용할 때 키를 더 직관적으로 사용할 수 있도록 입력 필드의 이름도 변경했습니다.

마지막으로 바텐더 서버의 IP 주소를 기록해 두었습니다.

바텐더가 구성되면 동일한 네트워크에 있는 모든 컴퓨터에서 다음 주소로 인쇄 포털에 액세스할 수 있어야 합니다:

http://[서버 IP]/바텐더

인쇄 포털 내에서 양식을 테스트하여 바텐더 인스턴스가 올바르게 구성되었는지 확인하는 것이 좋습니다.

튤립 구성

참고: 이 예에서는 Edge MC를 커넥터 호스트로 사용합니다.

1. Edge MC를 네트워크에 연결하기
2. 커넥터 구성을 클릭합니다.

1. '실행 중' 필드를 Edge MC의 커넥터 호스트로 설정합니다.

1. 호스트를 바텐더 서버의 IP로 설정합니다.

1. 포트를 바텐더 서버에 표시된 대로 "5160"으로 설정합니다.

커넥터 기능

바텐더로 인쇄하려면 5가지 커넥터 기능이 필요합니다:

1. 바텐더 인스턴스의 폴더 목록을 가져옵니다. 인쇄할 폴더를 선택합니다.
2. 프린터 목록을 가져와서 인쇄할 프린터를 선택합니다.
3. 원하는 폴더 내의 파일 목록을 가져옵니다. 인쇄할 파일을 선택합니다.
4. 인쇄 엔드포인트에 요청을 하면 요청 ID가 반환됩니다.
5. 프린터, 라벨 경로, 요청 ID를 전달합니다.

:::(Info) (참고) 프린터, 폴더 및 문서(위 1, 2, 3)는 바텐더 구성이 변경되지 않으면 변경되지 않습니다. 이는 프로덕션 앱에서 정적으로 설정할 수 있습니다:::

폴더 가져오기

입력을 클릭합니다: 참고

출력: 바텐더 인스턴스에 있는 폴더 목록입니다. 각 폴더에는 3개의 속성이 있습니다:

• 고유 ID
• 이름
• 경로 - 이 폴더가 다른 폴더 안에 있는 경우 이 폴더의 경로가 됩니다.

프린터 가져오기

입력을 가져옵니다: 참고

출력: 바텐더 인스턴스에 구성된 프린터 목록입니다.

폴더 항목 가져오기

입력: 폴더 가져오기 기능에서 가져온 고유 폴더 ID입니다.

출력: 출력: 해당 폴더의 각 파일 이름 목록과 해당 폴더의 절대 경로입니다.

요청 ID 가져오기

입력: 프린터 이름, 파일의 절대 경로(폴더 경로 + 파일 이름) 및 폴더의 고유 ID(폴더 가져오기 함수에서 가져옴)

출력: 텍스트 값으로, 인쇄할 때 이 응답 ID가 사용됩니다.

:::(Info) (참고)이 함수는 인쇄가 완료될 때마다 호출해야 합니다. 각 인쇄 작업마다 고유한 인쇄 ID가 필요합니다:::

Print

입력값: 프린터 이름, 파일의 절대 경로(폴더 경로 + 파일 이름) 및 폴더의 고유 ID(폴더 가져오기 함수에서), 응답 ID(요청 ID 가져오기에서) 및 레이블의 동적 필드 중 하나

출력: 출력: 인쇄가 성공했는지 여부를 나타내는 텍스트 값입니다.

:::(Info) (참고)이 레이블의 동적 필드는 바텐더의 레이블 구성에 있는 필드와 일치해야 합니다. 예제 인쇄 기능은 라이브러리 단위 테스트::...와 함께 제공되는 레이블 예제.btw 파일에서 작동하도록 구성되었습니다: