インターフェースサービスの作成
インターフェースサービスを使用すると、CSV または Excel ファイルから SCV テーブルにデータをインポートまたはエクスポートできます。このトピックでは、データエンティティ = SCV テーブル、かつインターフェースタイプ = CSV であるインターフェースサービスを作成するプロセスについて説明します。
インターフェースサービスを作成するには、次の手順を実行します。
- [設定] > [共通] > [インターフェースサービス] > [インターフェースサービス] の順に選択します。
- [新規] をクリックします。 [新しいインターフェースサービス] ウィンドウが表示されます。
- 次の情報を指定します。
- インターフェースタイプ
- インターフェースのタイプ。CSV を選択します。
- データエンティティ
- インターフェースにマッピングするデータエンティティ。SCV テーブルを選択します。注: [データエンティティ] フィールドがシナリオ値に設定されている場合、[メジャーごとの列] チェックボックスが表示されます。
- インターフェース方向
- データフローの方向。次のような値があります。
- インポート
- エクスポート
- [OK] をクリックします。新しいインターフェースサービスページが表示されます。
-
[インターフェース詳細] タブで次の情報を指定します。
- 名前
- 一意のインターフェースサービスの名前。
- 表示名
- インターフェースサービスに表示される名前。指定されていない場合は、[名前] フィールドで指定された値がデフォルト値になります。
- システム
- インターフェースサービスの状態を示します。次のような値があります。
- オン (有効)
- オフ (無効)
注: このオプションは、システムで定義されているエンティティに対して有効です。 - インターフェースタイプ
- インターフェースのタイプ。この値は、 [新しいインターフェースサービス] ウィンドウからデフォルト設定されます。
- データエンティティ
- インターフェースにマッピングするデータエンティティ。この値は、 [新しいインターフェースサービス] ウィンドウからデフォルト設定されます。
- インターフェース方向
- データフローの方向。この値は、 [新しいインターフェースサービス] ウィンドウからデフォルト設定されます。
-
[データソース] タブで次の情報を指定します。
- データソース
- SCP で定義されたデータソース (ファイル、FTP、または Amazon S3) の名前。データソースに定義された定義は、マクロを使用してインターフェースサービスを実行するときに使用されます。注: ファイルインターフェースサービスを使用してデータを手動でインポートまたはエクスポートする場合、ローカルコンピュータで使用するファイルを参照します。
- ファイル名パターンの使用
- ファイル名を定義するパターンまたは式。これは、複数のファイルのインポート、最新バージョンのインポート、およびファイルの順序やグループ化をサポートしています。一致するパターンのファイル名がインポートされます。注: このオプションは、[インターフェースタイプ] フィールドがインポートに設定されている場合のみ表示されます。
- ファイル
- インターフェースサービスに使用されるファイルの名前。表示されるファイルは、定義したデータソースに基づいています。ファイルが表示されない場合は、[プラス (+)] をクリックして、必要なファイルを追加します。注: [ファイル名パターンの使用] オプションがオンに設定されている場合、フィールドラベルは [ファイル名パターン] として表示され、正規表現をファイル名として使用できます。これらの変数は、変数間の区切りとしてアンダースコアを使用できます。
- 任意のアルファベット (A-Z)
- 任意の英数字 (A-Z、0-9)
- 任意の数字
- ヘッダー行内のフィールド名
- インポートまたはエクスポートされるファイルの最初の行の内容を示します。オンに設定すると、次のシナリオが考えられます。
- ファイルのインポート時に、インポートファイルの最初の行のフィールドラベルをスキップします。
- ファイルのエクスポート時に、エクスポートファイルの最初の行のフィールドのヘッダーを使用します。
-
[SCV テーブル] タブで、必要な SCV テーブル名を選択します。[マッピング] タブのデータは、選択する SCV テーブルに基づいて表示されます。
注:
- ファイルのインポート時に、SZ_REG_TABLE に登録されているフィールド table_area = inbox または %_Import のすべてのテーブルが表示されます。
- ファイルがエクスポートされると、すべての SCV テーブルとビューが表示されます。
-
[ファイル詳細] タブで次の情報を指定します。
- ファイルの区切り文字
- ファイル区切り文字タイプ。次のオプションがあります。
- コンマ
- タブ
- パイプ
注: デフォルトでは、この値はコンマに設定されています。 - 番号形式
- SCV データベースの数値フィールドにデータをインポートするときに検証される値の数値形式。数値は、定義されたフォーマットに基づいてエクスポートされます。
- 日付形式
- SCV データベースの日付フィールドにデータをインポートするときに検証される値の日付形式。日付値は、この定義済フォーマットに基づいてエクスポートされます。注: 月インジケータと時間インジケータは大文字で指定する必要があります。
-
[ファイル処理] タブをクリックします。
注: このタブは、[インターフェース方向] フィールドがインポートに設定されている場合にのみ表示されます。
-
次の情報を指定します。
- ファイル順序
- 指定した値に基づいてディレクトリ内のファイルを整理する順序 (昇順)。次の変数を使用できます。
- %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 に変更します。
-
[インポート動作] タブで次の情報を指定します。
- インポート前に出力先テーブルをクリアする
- インターフェースを実行して行をインポートする前に、ターゲットテーブルからすべての行またはデータを削除する、またはデータを既存のレコードに追加する必要があるかどうかを示します。次のようなシナリオがあります。
- オン: 削除して挿入
- オフ: 追加
- ソース列/値に基づいてクリア
- ターゲットテーブルからレコードを削除する場合の基準となる条件。次のようなシナリオがあります。
- これらのフィールドに値が指定されていない場合、すべてのレコードがターゲットテーブルから削除されます。
- 指定した場合、[ソース列] と [値] フィールドで指定された値が同じレコードのみが削除されます。
注: これらのオプションは、[インポート前にターゲットテーブルをクリアする] オプションがオンに設定されている場合のみ有効になります。
- [エクスポートフィルター] タブをクリックします。このタブでは、エクスポート時にデータをフィルタリングする条件を定義できます。
-
次の情報を指定します。
- 列
- SCV テーブルの列名。
- 演算子
- フィルター条件の設定に使用される演算子。次のような値があります。
- 等しい
- 等しくない
- 類似する
- 類似しない
- Null である
- Null でない
- 値
- フィルター条件が適用される値。
-
[エクスポート動作] タブをクリックします。
注: このタブは、インターフェース方向が「インポート」に設定されている場合のみ表示されます。
-
次の情報を指定します。
- ファイル名にタイムスタンプを追加
- タイムスタンプをエクスポートファイル名に追加する必要があるかどうかを示します。注:
- タイムスタンプは UTC 形式で指定し、前にアンダースコアを付けて、ファイル名の拡張子の前に追加する必要があります。たとえば、FileName_20171030135355.csv です。
- デフォルトでは、この値はオフに設定されています。
- エクスポート値に引用符を含める
- エクスポートされた値を引用符で囲むかどうかを示します。注: デフォルトでは、この値はオンに設定されています。
- [マッピング] タブをクリックします。[マッピングタブ] には、属性のリストが表示されます。属性リストのデフォルトは、選択した SCV テーブルに基づいてデフォルト設定されます。
- 必要に応じて新しい属性を追加します。「新しい属性の追加」を参照してください。
-
[インポート定数タブ] をクリックします。このタブには、データのインポート時に定数値がマップされなければならない SCV テーブルの属性のリストが表示されます。
注:
- このタブは、[インターフェース方向] フィールドがインポートに設定されている場合にのみ表示されます。
- このタブで指定した値は、[マッピング] タブでマップされたデータを上書きします。
- 必要に応じて、新しいインポート定数を追加します。「新しいインポート定数の追加」を参照してください。
-
[エクスポート定数] タブをクリックします。このタブには SCV テーブルからの属性のリストが含まれ、エクスポート中に定数値がマップされます。
注: このタブは、[インターフェース方向] フィールドがエクスポートに設定されている場合のみ表示されます。
- 必要に応じて、新しいエクスポート定数を追加します。「新しいエクスポート定数の追加」を参照してください。
- [保存] をクリックします。