データベースの上書きを使用した基本的なCSVインテグレーションの作成方法
概要
CSV連携は、最もシンプルで便利な連携方法のひとつです。始めるための設定も少なくて済みます。このタイプの連携は、トリガーファイルの情報を使って、ラベルに紐づくデータベースを上書きします。BarTenderのバージョンによってUIが異なる場合があるので、画面上部のバージョン選択ドロップダウンを利用してください。
同様の連携方法をお探しの場合は、以下のチュートリアルもご参照ください:
- 印刷コマンドスクリプトを使ったドキュメント印刷(動画 - 9:40) - スクリプトヘッダーでプリンターやラベル情報を設定し、CSVデータベースを含む連携例です。
- 名前付きデータソースを使ったCSV連携の作成方法 - CSVを分解してラベル上の名前付きデータソースに振り分ける連携例です。プリンターやラベル情報の設定にも利用できます。
対象バージョン
BarTender 2022以降
情報
ラベルの設定
まず、ラベルファイルを作成し、データベースに接続します。ご自身のCSVを使うか、以下のような簡単なサンプルデータベースをテキストまたはCSVファイルとして保存しても構いません:
Name,Food,ID
Seagull Kitty Snax,cat treats,12334668
BarTender Dog Bones,dog food,25346489
- 新しいラベルを作成し、テキストデータベースに接続します。手順が分からない場合は、データベース接続のはじめかた(動画 - 5:20)をご覧ください。
- ツールボックス(デフォルトでは画面左側)で「データソース」タブをクリックします。
- ツールボックスからデータベースフィールドをドラッグし、ラベルデザインエリアにドロップします。追加したいフィールドごとに繰り返してください。
- ラベルを保存します。
連携の作成
連携にはトリガーファイルが必要です。このファイルは、ラベルで使用したデータベースの形式と一致している必要があります。たとえば、CSVデータベースならCSVトリガー、タブ区切りならタブ区切りのトリガーが必要です。上記の例を使う場合、以下のようなトリガーファイルを用意します:
Name,Food,ID
Seagull Seed Rings,bird food,1236468
- Integration Builderを開き、「新しい連携の作成」を選択します。
- 新規連携ダイアログで「ファイル連携」を選び、OKをクリックします。
- まず、スキャンフォルダーを設定して、連携がファイルを検出する方法を決めます。ここにトリガーファイルを置くと、連携が自動で検出します。例としてCドライブ上のフォルダーを使っています。マイドキュメントやデスクトップなど、アクセス権が必要な場所は避けてください。
- 「場所」ドロップダウンから「コンピューター/ネットワーク」を選択します。
- 「参照」ボタンでフォルダーを指定するか、フォルダー名を直接入力します。
- ファイルパターンを、使用するファイルに合わせて変更します。デフォルトは.datですが、.txtや.csvなど任意の拡張子を使えます。
- このセクションの一番下までスクロールします。*.txtファイルパターンを使う場合は、「検出後」のオプションで別の拡張子に変更してください。同じファイルが何度も検出されるのを防げます。
- 左側のメニューで「ドキュメント印刷」アクションをクリックします。
- 「ドキュメント」セクションで、連携がトリガーされたときに印刷するドキュメントを選択します。
- 「印刷オプション」タブをクリックします。「データベースの上書き」セクションで「データベースの上書きを追加」ボタンをクリックします。データソースを「変数」に変更し、変数ドロップダウンリストから「EventData」を選択します。
-
(デフォルトのデータベース)(デフォルトのデータベース)オプションは、ドキュメント設定をインポートしていない場合に自動で選択されます。これは、ドキュメント内で最初に設定されたドキュメントレベルのデータベース接続を上書きすることを意味します。テーブルオブジェクトやデータ入力コントロールのデータベース接続には適用されません。もしテーブルオブジェクトやデータ入力コントロールの接続を上書きしたい場合、または接続名が分かっている場合は、上書きするデータベースリストから既存の名前を選ぶか、
追加をクリックして、上書きするデータベース欄に名前を入力して新しい接続を追加できます。 - 連携を保存します。
- ツールバー上部の「連携のテスト」ボタンをクリックします。
- 右上の緑色の「開始」ボタンをクリックします。
- エクスプローラーでCSVトリガーファイルをスキャンフォルダーにドラッグします。連携がトリガーされ、ラベルが印刷されます。
連携のデプロイ
連携のテストが終わったら、本番環境にデプロイします。
- 「デプロイ」タブをクリックし、上部ツールバーの「デプロイ」ボタンを押します。変更がある場合は、続行前に連携ファイルの保存を求められます。
- ドロップダウンリストから「このコンピューター」を選択し、「次へ」をクリックします。
- 「今すぐデプロイ」を選択したまま「完了」をクリックします。
- しばらくすると管理コンソールが開き、連携がデプロイされて稼働中であることが表示されます。
対象バージョン
BarTender 2021
情報
ラベルの設定
まず、ラベルファイルを作成し、データベースに接続します。ご自身のCSVを使うか、以下のような簡単なサンプルデータベースをテキストまたはCSVファイルとして保存しても構いません:
Name,Food,ID
Seagull Kitty Snax,cat treats,12334668
BarTender Dog Bones,dog food,25346489
- 新しいラベルを作成し、テキストデータベースに接続します。手順が分からない場合は、データベース接続のはじめかた(動画 - 5:20)をご覧ください。
- ツールボックス(デフォルトでは画面左側)で「データソース」タブをクリックします。
- ツールボックスからデータベースフィールドをドラッグし、ラベルデザインエリアにドロップします。追加したいフィールドごとに繰り返してください。
- ラベルを保存します。
連携の作成
連携にはトリガーファイルが必要です。このファイルは、ラベルで使用したデータベースの形式と一致している必要があります。たとえば、CSVデータベースならCSVトリガー、タブ区切りならタブ区切りのトリガーが必要です。上記の例を使う場合、以下のようなトリガーファイルを用意します:
Name,Food,ID
Seagull Seed Rings,bird food,1236468
- Integration Builderを開き、「新しい連携の作成」を選択します。
- 新規連携ダイアログで「ファイル連携」を選び、OKをクリックします。
- まず、スキャンフォルダーを設定して、連携がファイルを検出する方法を決めます。ここにトリガーファイルを置くと、連携が自動で検出します。例としてCドライブ上のフォルダーを使っています。フォルダー名を入力するか、「参照」ボタンで指定してください。マイドキュメントやデスクトップなど、アクセス権が必要な場所は避けてください。
- ファイルパターンを、使用するファイルに合わせて変更します。デフォルトは.datですが、.txtや.csvなど任意の拡張子を使えます。
- このセクションの一番下までスクロールします。*.txtファイルパターンを使う場合は、「検出後」のオプションで別の拡張子に変更してください。同じファイルが何度も検出されるのを防げます。
- 左側のメニューで「ドキュメント印刷」アクションをクリックします。
- 「ドキュメント」セクションで、連携がトリガーされたときに印刷するドキュメントを選択します。
- 「印刷オプション」タブをクリックします。「データベースの上書き」セクションで「データベースの上書きを追加」ボタンをクリックします。データソースを「変数」に変更し、変数ドロップダウンリストから「EventData」を選択します。
-
(デフォルトのデータベース)(デフォルトのデータベース)オプションは、ドキュメント設定をインポートしていない場合に自動で選択されます。これは、ドキュメント内で最初に設定されたドキュメントレベルのデータベース接続を上書きすることを意味します。テーブルオブジェクトやデータ入力コントロールのデータベース接続には適用されません。もしテーブルオブジェクトやデータ入力コントロールの接続を上書きしたい場合、または接続名が分かっている場合は、上書きするデータベースリストから既存の名前を選ぶか、
追加をクリックして、上書きするデータベース欄に名前を入力して新しい接続を追加できます。 - 連携を保存します。
- ツールバー上部の「連携のテスト」ボタンをクリックします。
- 右上の緑色の「開始」ボタンをクリックします。
- エクスプローラーでCSVトリガーファイルをスキャンフォルダーにドラッグします。連携がトリガーされ、ラベルが印刷されます。
連携のデプロイ
連携のテストが終わったら、本番環境にデプロイします。
- 「デプロイ」タブをクリックし、上部ツールバーの「デプロイ」ボタンを押します。変更がある場合は、続行前に連携ファイルの保存を求められます。
- ドロップダウンリストから「このコンピューター」を選択し、「次へ」をクリックします。
- 「今すぐデプロイ」を選択したまま「完了」をクリックします。
- しばらくすると管理コンソールが開き、連携がデプロイされて稼働中であることが表示されます。
対象バージョン
BarTender 2019
情報
ラベルの設定
まず、ラベルファイルを作成し、データベースに接続します。ご自身のCSVを使うか、以下のような簡単なサンプルデータベースをテキストまたはCSVファイルとして保存しても構いません:
Name,Food,ID
Seagull Kitty Snax,cat treats,12334668
BarTender Dog Bones,dog food,25346489
- 新しいラベルを作成し、テキストデータベースに接続します。手順が分からない場合は、データベース接続のはじめかた(動画 - 5:20)をご覧ください。
- ツールボックス(デフォルトでは画面左側)で「データソース」タブをクリックします。
- ツールボックスからデータベースフィールドをドラッグし、ラベルデザインエリアにドロップします。追加したいフィールドごとに繰り返してください。
- ラベルを保存します。
連携の作成
連携にはトリガーファイルが必要です。このファイルは、ラベルで使用したデータベースの形式と一致している必要があります。たとえば、CSVデータベースならCSVトリガー、タブ区切りならタブ区切りのトリガーが必要です。上記の例を使う場合、以下のようなトリガーファイルを用意します:
Name,Food,ID
Seagull Seed Rings,bird food,1236468
- Integration Builderを開き、「新しい連携の作成」を選択します。
- 新規連携ダイアログで「ファイル連携」を選び、OKをクリックします。
- まず、スキャンフォルダーを設定して、連携がファイルを検出する方法を決めます。ここにトリガーファイルを置くと、連携が自動で検出します。例としてCドライブ上のフォルダーを使っています。フォルダー名を入力するか、「参照」ボタンで指定してください。マイドキュメントやデスクトップなど、アクセス権が必要な場所は避けてください。
- ファイルパターンを、使用するファイルに合わせて変更します。デフォルトは.datですが、.txtや.csvなど任意の拡張子を使えます。
- このセクションの一番下までスクロールします。*.txtファイルパターンを使う場合は、「検出後」のオプションで別の拡張子に変更してください。同じファイルが何度も検出されるのを防げます。
- 左側のメニューで「ドキュメント印刷」アクションをクリックします。
- 「ドキュメント」セクションで、連携がトリガーされたときに印刷するドキュメントを選択します。
- 「印刷オプション」タブをクリックします。「データベースの上書き」セクションでチェックボックスをオンにし、「Integration Input Data」(デフォルト)をそのまま使います。
- 連携を保存します。
- ツールバー上部の「連携のテスト」ボタンをクリックします。
- 右上の緑色の「開始」ボタンをクリックします。
- エクスプローラーでCSVトリガーファイルをスキャンフォルダーにドラッグします。連携がトリガーされ、ラベルが印刷されます。
連携のデプロイ
連携のテストが終わったら、本番環境にデプロイします。
- 「デプロイ」タブをクリックし、上部ツールバーの「デプロイ」ボタンを押します。変更がある場合は、続行前に連携ファイルの保存を求められます。
- ドロップダウンリストから「このコンピューター」を選択し、「次へ」をクリックします。
- 「今すぐデプロイ」を選択したまま「完了」をクリックします。
- しばらくすると管理コンソールが開き、連携がデプロイされて稼働中であることが表示されます。
追加リソース