第7章 デザインシートを利用した設計
7.6 処理データの構造・フォーマットの設計
・ 「ファイル転送」
・ 「Salesforce.com」
・ 「Interstage List Creator」
・ 「Interstage Information Storage」
・ 「Azure Storage(BLOB)」
・ 「Interstage Service Integrator」
注意
Excelファイルを配付する場合
Excelファイルを配付する場合、Excelファイルは、上記の手順でデータボックスへの配付を行います。Excelファイルを配付するには、
上記の手順での配付処理の前に、プラグインによるCSVデータからExcelデータへの変換処理が必要です。
Excelファイルで利用するプラグインについての詳細は、“付録K プラグイン機能を利用したExcel連携”を参照してください。
図7.5 1つだけのデータ変換処理を含む場合の設計イメージ
複数のデータ変換処理(およびデータ振分処理)を含む処理プロセスの場合
収集データと配付データの他に、データ変換処理の中間結果データに対しても設計を行います。
図7.6 複数のデータ変換処理(およびデータ振分処理)を含む場合の設計イメージ
7.6.2 操作手順
以下にデザインシート設計の操作手順を説明します。
7.6.3 データ構造の設計
データ構造の設計では、データ構造定義シートを利用し、Information Integratorのデータ変換処理で扱うデータに対して項目の並び 順やデータ属性を設計していきます。
1. データ構造定義シートの作成
Excelアドインメニュー「Integratorデザインシート」の[定義の新規作成]-[データ構造定義]を選択し、データ構造定義シートを作 成します。
2. データ構造の設計
データの項目名、データ属性、桁数などの情報を入力します。1つのデータ構造定義シートで、1つのデータ構造が設計できま す。
メタ収集機能を利用して相手側システムの情報を取り込むときの手順については、後述の“メタ収集機能を利用した設計手順”
を参照してください。
オブジェクト格納時の留意点
オブジェクト格納時の留意点は、それぞれ以下のとおりです。
・ データ追加を行うとき
レコード管理IDは、データ追加時にSalesforceで自動採番されます。
そのため、データ構造定義の項目名およびデータに、Salesforceのレコード管理IDを付与する必要はありません。データ構造定義 の項目名にレコード管理IDを含めて定義した場合、データ構造定義に定義したレコード管理IDは無効となります。
・ データ更新を行うとき
データ構造定義の項目名およびデータに、Salesforceのレコード管理IDを付与してください。
付与したレコード管理IDとSalesforce側のレコード管理IDが一致するレコードのデータが更新されます。レコード管理IDが一致し ない場合は、データは更新されません。異常メッセージ出力後、処理は異常終了します。
・ データ追加/更新を行うとき
データ構造定義の項目名およびデータに、Salesforceの外部IDを付与してください。
付与した外部IDとSalesforce側の外部IDが一致するレコードのデータが更新されます。外部IDが一致しないレコードは、データが 追加されます。
注意
レコード管理IDの付与について
データ追加/更新を行うときは、レコード管理IDの定義は不要です。データ構造定義の項目名にレコード管理IDを含めて定義した 場合、データ構造定義に定義したレコード管理IDは無効となります。
7.6.4 メタ収集機能を利用した設計手順
メタ収集機能を利用して相手側システムの情報を取り込むときの手順について説明します。
収集するメタに応じて、それぞれ説明します。
CSVファイル
1. [Integratorツール]-[外部メタ読み込み]-[CSVファイル]を選択します。
→メタ収集に必要な詳細項目を入力する[外部メタ読み込み(CSV)]画面が表示されます。
2. 選択項目に従って、入力します。各項目の入力内容については、デザインシートの各項目に設定されたコメント、および“デザイ ンシート操作ヘルプ”を参照してください。
→収集したメタ情報(項目名や属性情報)がデータ構造定義シートに表示されます。表示内容を確認してください。
COPY LIBファイル
COBOLのデータ項目に関する定義(COBOL COPY句)が記述されたファイルのメタ収集定義の手順は、以下のとおりです。
1. [Integratorツール]-[外部メタ読み込み]-[COBOL COPY句ファイル]を選択します。
→メタ収集に必要な詳細項目を入力する[外部メタ読み込み(COBOL COPY句)]画面が表示されます。
2. 選択項目に従って、入力します。各項目の入力内容については、デザインシートの各項目に設定されたコメント、および“デザイ ンシート操作ヘルプ”を参照してください。
→収集したメタ情報(項目名や属性情報)がデータ構造定義シートに表示されます。表示内容を確認してください。
データベース
1. [Integratorツール]-[外部メタ読み込み]-[データベース]を選択します。
→メタ収集に必要な詳細項目を入力する[外部メタ読み込み(データベース)]画面が表示されます。
2. 選択項目に従って、入力します。各項目の入力内容については、デザインシートの各項目に設定されたコメント、および“デザイ ンシート操作ヘルプ”を参照してください。
→収集したメタ情報(項目名や属性情報)がデータ構造定義シートに表示されます。
表示された内容は、Information Integratorサーバで利用可能な属性になっているかなどを確認してください。Information Integrator サーバで利用可能な属性については、“B.1.4 Information Integratorで収集できるデータベース形式”または“B.2.4 Information
Integratorで配付できるデータベース形式”を参照してください。
オブジェクト
1. [Integratorツール]-[外部メタ読み込み]-[salesforce.com]を選択します。
→メタ収集に必要な詳細項目を入力する[外部メタ読み込み(salesforce.com)]画面が表示されます。
2. 選択項目に従って、入力します。各項目の入力内容については、デザインシートの各項目に設定されたコメント、および“デザイ ンシート操作ヘルプ”を参照してください。
→収集したメタ情報(項目名や属性情報)がデータ構造定義シートに表示されます。表示内容を確認してください。
3. オブジェクト格納で利用するメタの収集では、オブジェクト格納のアクセス権の有無に関わらずデータ構造定義シートに情報を 表示します。アクセス権がない項目は、オブジェクト格納を行うことができないため、アクセス権のない項目をデザインシートから 削除してください。デザインシートにアクセス権のない項目が記載された状態でオブジェクト格納を行うとエラーとなります。
アクセス権についての設定は、“9.4 オブジェクト抽出・格納利用時のセキュリティ設定情報”を参照してください。
なお、以下の項目は、オブジェクト格納のアクセス権はありません。必ず削除してください。
－ IsDeleted
－ CreatedDate
－ LastModifiedDate
－ SystemModstamp
帳票データ
1. [Integratorツール]-[外部メタ読み込み]-[List Creator帳票定義体]を選択します。
→[ファイルを開く]画面が表示されます。
2. メタの収集元(Interstage List Creatorの帳票定義体)を選択します。
ポイント
帳票定義体について
－ 帳票定義体(拡張子.pmd)は、一般的に以下に格納されています。
Interstage List Creator インストール ディレクトリ\Asset
－ 帳票定義体で「集団項目を使用」が指定されている場合、デザインシートの項目には、集団項目を表示します。帳票定義体 で「構成項目を使用」が指定されている場合、デザインシートの項目には、構成項目を表示します。
→収集したメタ情報(項目名や属性情報)がデータ構造定義シートに表示されます。表示内容を確認してください。
ポイント
・ 演算結果や定数を変換処理後のデータの項目として出力する場合には、変換後のデータに対してデータ構造を設計する際に、
出力項目を含めたデータ構造として設計します。
・ 同じようなデータ構造定義を作成する場合には、作成したデータ構造定義シートをExcelの機能で複写し、「データ構造定義ID」を 変更して流用することにより、簡単に作成することができます。
7.6.5 データフォーマットの設計
データフォーマットの設計では、フォーマット定義シートを利用し、データの形式や文字コードなどの属性を定義します。
1. フォーマット定義シートの作成
Excelアドインメニュー「Integratorデザインシート」の[定義の新規作成]-[フォーマット定義]を選択し、フォーマット定義シートを作 成します。
2. データフォーマットの設計
1つのデータフォーマット定義シートで複数のフォーマット定義を作成することができます。
見出し行の存在するデータを扱う場合の留意事項
データ変換処理またはデータ振分処理で見出し行の存在するデータを扱う場合は、留意事項があります。留意事項については、“7.3.3 見出し行の存在するデータを扱う場合の留意事項”を参照してください。