データカタログを更新する

Vantage UI から新しい CSV ファイルをアップロードするか、SFTP で接続された共有フォルダーにファイルを配置して、既存のデータカタログを更新します。

CSV 形式

アップロードする CSV を準備する際は、次のルールに従ってください。

列はカンマで区切る必要があります。
列名と区切りのカンマの間にスペースを入れてはいけません。
リテラルとして扱う必要があるカンマを含む値は、二重引用符で囲む必要があります。
文字列値内の引用符は 2 つ重ねて記述する必要があり、文字列値全体も二重引用符で囲む必要があります。

CSV ファイルの編集には Microsoft Excel を使用できます。

CSV ファイルのサイズは 100 MB を超えてはいけません。

Document Issuer Companies または Document Receiver Companies データカタログを更新する場合は、Company ID 列と Country 列に必ず値を入力してください。これらの列の値が空だと、更新は失敗します。

サンプル: カンマを含む値

Id,VATID,BusinessUnitId,IBAN,BankAccount,BankCode,Name,ZIP,Street,City,State,CountryCode
"999,9",GB_fake01,01,123456678,PPPCCC,CB3 AAA,CAMBRIDGESHIRE COUNTY COUNCIL,PO Box 123456,str1,Cambridge,East,GB
"0,1",GB_fake02,01,123487654,CCCPPP,AAA BB3,Random Company Inc.,PO Box 45678,str2,Oxford,South East England,GB

サンプル: 引用符付きの値

Id,VATID,Name,ZIP,Street,City,State,CountryCode
1,GB_fake01,"CAMBRIDGESHIRE ""COUNTY COUNCIL""",22313,str1,Cambridge,East,GB
2,GB_fake02,Random Company Inc.,22314,str2,Oxford,South East England,GB

UI から更新する

CSV を選択してアップロードする

データカタログ タブで一覧からカタログを選択し、一覧の上にあるペインで Update をクリックします。CSV ファイルをページ上にドラッグするか、画面上部の Browse をクリックします。

CSV ファイル名はデータカタログ名と一致している必要があります。一致しない場合、Vantage は代わりに新しいカタログを作成します。

新しい列を処理する（存在する場合）

Vantage が CSV 内に新しい列を検出した場合は、次のいずれかを選択します。

Add — 新しい列を追加して、データカタログを更新します。
Skip — 新しい列は無視して、データカタログを更新します。

列のプロパティを編集できるのは、新しい列だけです。

更新が正常に完了すると、更新されたレコード数と、追加または削除された列を示すダイアログが表示されます。

共有フォルダー経由で更新する

まず、SFTP を使用して共有フォルダーに接続します。

SFTP クライアントをインストールする

任意の SFTP クライアント (FileZilla や WinSCP など) をインストールして起動します。

共有フォルダーのパスをコピーする

データカタログ タブでカタログを選択し、設定ダイアログを開きます。CSV をアップロードするフォルダー field からパスをコピーします。

Folder to upload CSV のパスが強調表示されたデータカタログの設定ダイアログ — データカタログの設定から共有フォルダーのパスをコピーする

SFTP クライアントから接続する

コピーしたパスを SFTP クライアントの Host field に貼り付け、Connect をクリックします。

データカタログ設定の値が Host field に入力された FileZilla SFTP クライアント — 共有フォルダーのホストが設定された FileZilla クライアント

ホストを信頼する

確認ダイアログで OK をクリックしてホストを信頼します。SFTP クライアントのリモートフォルダーペインに Catalogs フォルダーが表示されます。

データカタログを更新するには、CSV ファイルにデータカタログと同じ名前を付けて、Catalogs フォルダーに配置します。

Vantage は 20 秒ごとに Catalogs フォルダーを確認し、フォルダー内の CSV ファイルと名前が一致するデータカタログを更新します。

共有フォルダー経由でデータカタログを更新すると、既存のレコードは新しいレコードに置き換えられます。

更新結果

ファイルの状態	結果
すべてのレコードが有効	カタログが更新され、ファイルは Catalogs から削除されます。
一部のレコードが空	空のレコードは無視され、有効なレコードがインポートされ、ファイルは Catalogs から削除されます。
一部の列が欠落している	欠落している列は無視され、既存の列がインポートされ、ファイルは Catalogs から削除されます。
ファイルに新しい列が含まれている	新しい列がカタログに追加され、ファイルは Catalogs から削除されます。
レコードの形式が正しくない	カタログは更新されず、ファイルは Catalogs-exception に移動されます。
ファイルを開けない、または名前がカタログと一致しない	カタログは更新されず、ファイルは Catalogs-exception に移動されます。

​CSV 形式

​サンプル: カンマを含む値

​サンプル: 引用符付きの値

​UI から更新する

​共有フォルダー経由で更新する

​更新結果

​関連トピック

CSV 形式

サンプル: カンマを含む値

サンプル: 引用符付きの値

UI から更新する

共有フォルダー経由で更新する

更新結果

関連トピック