インターフェースサービスの作成

インターフェースサービスを使用すると、CSV または Excel ファイルから SCV テーブルにデータをインポートまたはエクスポートできます。このトピックでは、データエンティティ = SCV テーブル、かつインターフェースタイプ = CSV であるインターフェースサービスを作成するプロセスについて説明します。

インターフェースサービスを作成するには、次の手順を実行します。

  1. [設定] > [共通] > [インターフェースサービス] > [インターフェースサービス] の順に選択します。
  2. [新規] をクリックします。 [新しいインターフェースサービス] ウィンドウが表示されます。
  3. 次の情報を指定します。
    インターフェースタイプ
    インターフェースのタイプ。CSV を選択します。
    データエンティティ
    インターフェースにマッピングするデータエンティティ。SCV テーブルを選択します。
    注: [データエンティティ] フィールドがシナリオ値に設定されている場合、[メジャーごとの列] チェックボックスが表示されます。
    インターフェース方向
    データフローの方向。次のような値があります。
    • インポート
    • エクスポート
  4. [OK] をクリックします。新しいインターフェースサービスページが表示されます。
  5. [インターフェース詳細] タブで次の情報を指定します。
    名前
    一意のインターフェースサービスの名前。
    表示名
    インターフェースサービスに表示される名前。指定されていない場合は、[名前] フィールドで指定された値がデフォルト値になります。
    システム
    インターフェースサービスの状態を示します。次のような値があります。
    • オン (有効)
    • オフ (無効)
    注: このオプションは、システムで定義されているエンティティに対して有効です。
    インターフェースタイプ
    インターフェースのタイプ。この値は、 [新しいインターフェースサービス] ウィンドウからデフォルト設定されます。
    データエンティティ
    インターフェースにマッピングするデータエンティティ。この値は、 [新しいインターフェースサービス] ウィンドウからデフォルト設定されます。
    インターフェース方向
    データフローの方向。この値は、 [新しいインターフェースサービス] ウィンドウからデフォルト設定されます。
  6. [データソース] タブで次の情報を指定します。
    データソース
    SCP で定義されたデータソース (ファイル、FTP、または Amazon S3) の名前。データソースに定義された定義は、マクロを使用してインターフェースサービスを実行するときに使用されます。
    注: ファイルインターフェースサービスを使用してデータを手動でインポートまたはエクスポートする場合、ローカルコンピュータで使用するファイルを参照します。
    ファイル名パターンの使用
    ファイル名を定義するパターンまたは式。これは、複数のファイルのインポート、最新バージョンのインポート、およびファイルの順序やグループ化をサポートしています。一致するパターンのファイル名がインポートされます。
    注: このオプションは、[インターフェースタイプ] フィールドがインポートに設定されている場合のみ表示されます。
    ファイル
    インターフェースサービスに使用されるファイルの名前。表示されるファイルは、定義したデータソースに基づいています。ファイルが表示されない場合は、[プラス (+)] をクリックして、必要なファイルを追加します。
    注: [ファイル名パターンの使用] オプションがオンに設定されている場合、フィールドラベルは [ファイル名パターン] として表示され、正規表現をファイル名として使用できます。これらの変数は、変数間の区切りとしてアンダースコアを使用できます。
    • 任意のアルファベット (A-Z)
    • 任意の英数字 (A-Z、0-9)
    • 任意の数字
    ヘッダー行内のフィールド名
    インポートまたはエクスポートされるファイルの最初の行の内容を示します。オンに設定すると、次のシナリオが考えられます。
    • ファイルのインポート時に、インポートファイルの最初の行のフィールドラベルをスキップします。
    • ファイルのエクスポート時に、エクスポートファイルの最初の行のフィールドのヘッダーを使用します。
  7. [SCV テーブル] タブで、必要な SCV テーブル名を選択します。[マッピング] タブのデータは、選択する SCV テーブルに基づいて表示されます。
    注: 
    • ファイルのインポート時に、SZ_REG_TABLE に登録されているフィールド table_area = inbox または %_Import のすべてのテーブルが表示されます。
    • ファイルがエクスポートされると、すべての SCV テーブルとビューが表示されます。
  8. [ファイル詳細] タブで次の情報を指定します。
    ファイルの区切り文字
    ファイル区切り文字タイプ。次のオプションがあります。
    • コンマ
    • タブ
    • パイプ
    注: デフォルトでは、この値はコンマに設定されています。
    番号形式
    SCV データベースの数値フィールドにデータをインポートするときに検証される値の数値形式。数値は、定義されたフォーマットに基づいてエクスポートされます。
    日付形式
    SCV データベースの日付フィールドにデータをインポートするときに検証される値の日付形式。日付値は、この定義済フォーマットに基づいてエクスポートされます。
    注: 月インジケータと時間インジケータは大文字で指定する必要があります。
  9. [ファイル処理] タブをクリックします。
    注: このタブは、[インターフェース方向] フィールドがインポートに設定されている場合にのみ表示されます。
  10. 次の情報を指定します。
    ファイル順序
    指定した値に基づいてディレクトリ内のファイルを整理する順序 (昇順)。次の変数を使用できます。
    • %file_1 = ファイル名の最初の変数
    • %file_2 = ファイル名の 2 番目の変数
    注: このオプションは、[データソース] タブで、[ファイル名パターンの使用] オプションがオンに設定されている場合のみ有効になります。
    最新ファイルのインポート
    インターフェースサービスのインポートパターンを示します。次のようなシナリオがあります。
    • オン: ファイルのタイムスタンプまたは [ファイル順序] オプションに指定された値に基づいて、最新のファイルをインポートします。
    • オフ: タイムスタンプ (ファイルの保存時のシステム時間) または [ファイル順序] オプションに指定された値に基づいて、すべてのファイルを順番にインポートします。
    注: 
    • このフィールドは、[ファイル名パターンの使用] オプションがオンに設定されている場合のみ有効になります。
    • タイムスタンプはソースの OS に基づきます。
    グループファイル区分
    グループ内のファイルの順序の基準。ファイルは、[ファイル順序] オプションで指定された値に基づいて、各グループで順に並べられます。それ以外の場合は、ファイルが最新の日時順に並べられます。各グループの最新のファイルがインポートされます。
    注: このフィールドは、[ファイル名パターンの使用] オプションがオンに設定されている場合のみ有効になります。
    インポート後にファイル名を変更
    正常にインポートされたファイルの名前変更の基準となる変数。次の変数が名前変更に使用されます。
    • %file = 完全ファイル名
    • %file_0 = 拡張子なしのファイル名

    例:

    • %file_save: TAR_MD_BOM_20170705060012.csv isの名前を TAR_MD_BOM_20170705060012_save.csv に変更します。
    • %file_0_complete: ファイル TAR_MD_BOM_20170705060012.csv の名前を TAR_MD_BOM_20170705060012_complete に変更します。
  11. [インポート動作] タブで次の情報を指定します。
    インポート前に出力先テーブルをクリアする
    インターフェースを実行して行をインポートする前に、ターゲットテーブルからすべての行またはデータを削除する、またはデータを既存のレコードに追加する必要があるかどうかを示します。次のようなシナリオがあります。
    • オン: 削除して挿入
    • オフ: 追加
    ソース列/値に基づいてクリア
    ターゲットテーブルからレコードを削除する場合の基準となる条件。次のようなシナリオがあります。
    • これらのフィールドに値が指定されていない場合、すべてのレコードがターゲットテーブルから削除されます。
    • 指定した場合、[ソース列] と [] フィールドで指定された値が同じレコードのみが削除されます。
    注: これらのオプションは、[インポート前にターゲットテーブルをクリアする] オプションがオンに設定されている場合のみ有効になります。
  12. [エクスポートフィルター] タブをクリックします。このタブでは、エクスポート時にデータをフィルタリングする条件を定義できます。
  13. 次の情報を指定します。
    SCV テーブルの列名。
    演算子
    フィルター条件の設定に使用される演算子。次のような値があります。
    • 等しい
    • 等しくない
    • 類似する
    • 類似しない
    • Null である
    • Null でない
    フィルター条件が適用される値。
  14. [エクスポート動作] タブをクリックします。
    注: このタブは、インターフェース方向が「インポート」に設定されている場合のみ表示されます。
  15. 次の情報を指定します。
    ファイル名にタイムスタンプを追加
    タイムスタンプをエクスポートファイル名に追加する必要があるかどうかを示します。
    注: 
    • タイムスタンプは UTC 形式で指定し、前にアンダースコアを付けて、ファイル名の拡張子の前に追加する必要があります。たとえば、FileName_20171030135355.csv です。
    • デフォルトでは、この値はオフに設定されています。
    エクスポート値に引用符を含める
    エクスポートされた値を引用符で囲むかどうかを示します。
    注: デフォルトでは、この値はオンに設定されています。
  16. [マッピング] タブをクリックします。[マッピングタブ] には、属性のリストが表示されます。属性リストのデフォルトは、選択した SCV テーブルに基づいてデフォルト設定されます。
  17. 必要に応じて新しい属性を追加します。「新しい属性の追加」を参照してください。
  18. [インポート定数タブ] をクリックします。このタブには、データのインポート時に定数値がマップされなければならない SCV テーブルの属性のリストが表示されます。
    注: 
    • このタブは、[インターフェース方向] フィールドがインポートに設定されている場合にのみ表示されます。
    • このタブで指定した値は、[マッピング] タブでマップされたデータを上書きします。
  19. 必要に応じて、新しいインポート定数を追加します。「新しいインポート定数の追加」を参照してください。
  20. [エクスポート定数] タブをクリックします。このタブには SCV テーブルからの属性のリストが含まれ、エクスポート中に定数値がマップされます。
    注: このタブは、[インターフェース方向] フィールドがエクスポートに設定されている場合のみ表示されます。
  21. 必要に応じて、新しいエクスポート定数を追加します。「新しいエクスポート定数の追加」を参照してください。
  22. [保存] をクリックします。