バーテンダーの統合

BartenderはTulipアプリから可能な印刷機能を拡張します。

:::(Info) () TulipライブラリからBartenderユニットテストをダウンロードしてください**：**

Seagull Scientific社のBartenderは、業界をリードする印刷クライアントで、ERP/MESソリューションと増え続けるプリンタ、ネットワーク構成などの間のインターフェース層として、製造業の世界で幅広く使用されています。

要するに、Bartenderはこの方程式のプリンタ側を処理し、Tulipコネクタ関数がドキュメントを印刷するためにヒットできるAPIエンドポイントを公開します。

ネットワークに関する考察

Bartenderクライアントは通常、施設のインターネットネットワーク上のサーバ（またはコンピュータ）でホストされます。これは通常、外部のシステムからはアクセスできません。Tulipはクラウドで動作しているため、バーテンダーのインスタンスをクラウドに公開する必要があります。

これにはいくつかの方法があります：

1. オンプレミ・コネクタ・ホストがネットワークへのトンネルの役割を果たします。これらのコネクタのセットアップ・プロセスは少し複雑で、おそらくITチームのサポートが必要になるでしょう。
2. ネットワークに接続されたTulip Edge Deviceが、ネットワーク内のコネクタホストとして機能します。これは、このトンネルを確立する最も簡単な方法であり、セットアップにITチームのサポートは必要ありません。Edge MCは150ドルで購入できる。
3. SSHトンネルを確立して、バーテンダーのインスタンスを公開することができます。これは最も技術的なオプションで、セットアップにはIT部門の助けが必要です。この種のトンネルには、Tulipが構築したソリューションのようなビルトインセキュリティはありません。

さらに、Bartenderが提供するPrint Portalを使用します。これは "Automation "プランと "Enterprise "プランでのみ利用可能です。

セットアップ

:::(Info) (注）この手順は、バーテンダーとの統合の最初の調査の一部として作成されたもので、ユニットテストアプリケーションで提供される機能は若干異なる場合があります：

バーテンダーラベルの設定

Bartenderの中で、私はLabel Example.btwというラベルのサンプルを作成しました。重要な設定は、ラベルの各ダイナミックフィールドがテンプレートフォームの入力に紐付いていることを確認することです。この場合、Tulipでラベルを使用する際のキーがより直感的になるように、入力フィールドの名前も変更しました。

最後に、BartenderサーバのIPアドレスをメモしました。

Bartenderが設定されると、同じネットワーク上のどのマシンからでも、次の場所でプリントポータルにアクセスできるようになります：

http://[サーバーIP]/bartender

Bartenderインスタンスが正しく設定されていることを確認するために、Print Portal内からフォームをテストすることを強くお勧めします。

チューリップの構成

注：この例では、コネクタホストとしてEdge MCを使用します。

1. Edge MCをネットワークに接続します。
2. コネクター構成をクリックします。

1. Running on」フィールドをEdge MCのコネクタ・ホストに設定します。

1. ホストをBartenderサーバのIPに設定します。

1. Bartender Serverによって示されるように、Portを "5160 "に設定します。

コネクタ機能

Bartender への印刷には、5 つのコネクタ関数が必要です：

1. Bartenderインスタンス内のフォルダのリストを取得します。印刷したいフォルダを選択します。
2. プリンタのリストを取得し、印刷先のプリンタを選択します。
3. 希望のフォルダ内のファイルのリストを取得します。印刷したいファイルを選択します。
4. 印刷エンドポイントにリクエストを行い、リクエストIDを返します。
5. プリンター、ラベルへのパス、リクエストIDを渡します。

:::(Info) (注）プリンタ、フォルダ、ドキュメント（上記1、2、3）は、Bartenderの設定が変更されなければ変更されません。これらはプロダクションアプリで静的に設定することができます：

フォルダの取得

入力Note

出力Bartender インスタンス内のフォルダのリスト。各フォルダには3つの属性があります：

• ユニークID
• 名前
• Path - このフォルダが他のフォルダ内にある場合、このフォルダへのパスになります。

プリンタの取得

入力メモ

**出力：**Bartender インスタンスで設定されているプリンタのリスト。

Get Folder Items（フォルダアイテムの取得

入力： Get Folders入力： Get Folders関数からの一意なフォルダID。

**出力：**出力：そのフォルダ内の各ファイル名のリストと、そのフォルダへの絶対パス。

Get RequestID

**入力：**入力： プリンタ名、ファイルへの絶対パス（フォルダパス＋ファイル名）、フォルダの一意ID（Get Folders関数から）。

**出力：**出力：テキスト値、このレスポンスIDは印刷時に使用されます。

:::(Info) (注）この関数は、印刷が行われるたびに呼び出される必要があります。印刷ジョブごとに一意の印刷IDが必要です：

プリント

**入力：**入力： プリンタ名、ファイルへの絶対パス（フォルダパス＋ファイル名）、フォルダの固有ID（Get Folders関数から）、responseID（Get RequestIDから）、ラベルの動的フィールドのいずれか。

**出力：**出力： 印刷が成功したかどうかを示すテキスト値。

:::(Info) (注）このラベルのダイナミックフィールドは、Bartender のラベル構成内のものと一致する必要があります。Print関数の例は、Library Unit Testで提供されるLabel Example.btwファイルで動作するように構成されています：