メインコンテンツへスキップ
Deutsch English (United States) Español Français 简体中文 繁體中文

検索

このセクションの記事

もっと見る

XML統合の作成

Samantha Petro

BarTender Content Team

  • 更新

概要

BarTender 2019 では、XML データベースを含む新しい種類のテキストデータベースが導入されました。Designer でこれらのデータベースをネイティブに読み込めるようになったため、XLST 変換を行わずにトリガーファイルとしても利用できるようになりました。

ヒント: テキストコネクタについて詳しくは、BarTender 2019 のテキストデータベース接続オプション（動画）をご覧ください。

このチュートリアルでは、以下の内容を順にご説明します。

  • XML ファイルをデータベースとして使用する方法
  • XML ファイルのインテグレーション設定方法
  • インテグレーションのテストと展開方法

チュートリアルで使用するサンプルデータもご用意しています。内容を理解したら、ご自身のデータやラベルでも同じ手順で XML インテグレーションを作成し、ニーズに合わせてご活用ください。

対象製品

BarTender 2019 以降

情報

XML データベースの作成

以下は、架空のペットフード会社「Seagull Pet Snacks」のサンプル XML データベースです。データベースには、シンプルなヘッダーセクション <HEADER> と、データ本体が含まれる <DETAILS> があります。

<?xml version="1.0"?>
<LABEL>
  <HEADER>
    <BRAND>Seagull Pet Snacks</BRAND>
    <PACKAGE>Bag</PACKAGE>
    <LOCATION>Seattle</LOCATION>
    <DETAILS>
        <NAME>Kitty Kibble</NAME>
        <TAGLINE>Delicious snacks for kitty</TAGLINE>
        <FLAVOR>Salmon</FLAVOR>
    </DETAILS>
  </HEADER>
</LABEL>

XML データベースを作成する手順

  1. メモ帳などのテキストエディタを開きます。
  2. 上記のテキストをエディタに貼り付けます。
  3. ファイル > 名前を付けて保存 を選択し、保存するファイルの種類をすべてのファイルに変更します。
  4. ファイル名を例として Database.xml などに設定し、保存をクリックします。

ラベルファイルの作成

  1. BarTender Designer を開き、新しいドキュメントを作成します。
  2. 新規ドキュメントウィザードが完了したら、ファイル > データベース接続の設定 に進みます。
  3. 新しいデータベース接続を作成 を選択し、次へをクリックします。
  4. リストから XML ファイル を選択し、次へをクリックします。
  5. 参照 ボタンを使って database.xml ファイルを探し、選択して 次へ をクリックします。
  6. このチュートリアルでは、XML ファイルからスキーマを自動検出する の最初のオプションを選択し、次へ をクリックします。
  7. 次の画面では、BarTender に XML ファイル内のどこにデータがあるかを指定できます。
    上記のデータベースでは、<HEADER> というヘッダーと、各レコードやラベルの詳細を示す <DETAILS> セクションがあります。データベースとして使用したいのは DETAILS セクションの情報のみなので、上部ペインのリストから DETAILS を選択します（下記のスクリーンショット参照）：
    XMLintegration.png
    選択するタグによってファイルのプレビューが変わることに注目してください。下部ペインには、データがテーブル形式で表示されます。もしプレビューがタグ表示の場合は、右側の フィールド タブをクリックしてテーブル形式に切り替えてください。
  8. 上部ペインで DETAILS タグを選択した状態で 次へ をクリックします。
  9. この画面では、無視したいフィールドのチェックを外すことができます。今回は 3 つのフィールドすべてにチェックを入れたままにします。ウィザードで 完了 をクリックし、ダイアログで OK をクリックします。
  10. データベースが接続されたので、ツールボックスの データソース タブをクリックします（まだ選択されていない場合）。
  11. 3 つのフィールドすべてをラベル上にドラッグ＆ドロップします。
    ヒント: TAGLINE がラベルに収まらない場合は、テキストプロパティの折り返し設定で折り返しを有効にできます。
  12. ラベルを保存します。これで準備完了です！

インテグレーションの作成

  1. Integration Builder を開きます。
  2. スタート画面から 新しいインテグレーションの作成 を選択します。
  3. ダイアログで ファイル を選択し、OK をクリックします。
  4. ファイル検出 で、スキャンフォルダの場所を選択します。ここがインテグレーションがファイルを取得する場所になります。
    注意: C ドライブなどの一般的な場所にフォルダを作成することをおすすめします。マイドキュメントやデスクトップのフォルダは、アクセスに特別な権限が必要な場合があります。
  5. ファイルパターンを *.xml に変更します。これで xml ファイルをスキャンするようになります。
  6. ドキュメントの印刷 アクションをクリックします。
  7. ドキュメント タブで 参照 ボタンを使い、前のセクションで作成したドキュメントを選択します。スキャンフォルダと同様、このドキュメントもマイドキュメント以外の共通フォルダに保存することをおすすめします。
  8. データベースの上書き オプションを設定します。

    BarTender 2019: 印刷オプション タブの データベースの上書き で、データソースを使用 のチェックボックスをオンにし、ドロップダウンは「インテグレーション入力データ」のままにします。
    2019_new.png

    BarTender 2021: 印刷オプション タブの データベースの上書き で、青いプラスボタンをクリックしてデータベース上書きオプションを追加します。データソース を「変数」に設定し、変数 フィールドに「%EventData%」と入力します。
    2021new.png

  9. ファイルを保存します。

インテグレーションのテストと展開

インテグレーションを展開する前に、テスト用のトリガーファイルを作成して動作確認を行います。トリガーファイルは、ラベルファイルにリンクしたデータベースと同じ構造である必要があります。以下はテスト用のサンプルデータです。ラベルのデータベースとは内容が異なりますが、構造は同じです。

<?xml version="1.0"?>
<LABEL>
  <HEADER>
    <BRAND>Seagull Pet Snacks</BRAND>
    <PACKAGE>Box</PACKAGE>
    <LOCATION>Seattle</LOCATION>
    <DETAILS>
        <NAME>Dog Crunchies</NAME>
        <TAGLINE>Crunchy snacks for your best friend!</TAGLINE>
        <FLAVOR>Duck</FLAVOR>
    </DETAILS>
  </HEADER>
</LABEL>
  1. 上記のデータを使ってテスト用のトリガーファイルを作成します。ファイルの拡張子は .XML にしてください（インテグレーションがこの拡張子を期待しています）。
  2. インテグレーションを開いた状態で、テスト タブをクリックします。
  3. 上部リボンの緑色の 開始 ボタンをクリックします。
  4. 前のセクションで設定したスキャンフォルダにファイルをドロップします。
  5. インテグレーションメッセージが表示され、ファイルが検出されたことが確認できます。
  6. 印刷が正常に完了したら、展開の準備ができています。
  7. 展開 タブをクリックし、緑色の 展開 ボタンをクリックします。
  8. ファイルを保存していない場合は、保存を促されます。
  9. ドロップダウンメニューから このコンピューター を選択し、次へ をクリックします。
  10. 今すぐ展開 を選択し、完了 をクリックします。
  11. これでインテグレーションの展開が完了しました。

追加リソース

印刷コマンドスクリプトを使ったドキュメント印刷（動画・9:40）

印刷コマンドスクリプトを使ったファイルインテグレーションの構築（27:58）

関連記事