バッチファイルをアップロードする
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
このウォークスルーでは、バッチファイルをSitecore CDPにアップロードします。
このウォークスルーでは、以下の方法を説明します:
- JSONファイルをGzipで処理してください
- 必要な情報を集める
- gzip化されたファイルをアップロードしてください
- Sitecore CDPがアップロードされたデータを取り込んでいるか確認してください:::
!注始める前に
有効なJSON記録を含むJSONファイル (import.json)を用意してください。ご自身の記録JSONがない場合は、サンプルJSON記録をご利用ください。
ファイルアーカイブを使えるようにしましょう。
JSONファイルをGzipで処理してください
バッチファイルをアップロードする前に、JSONファイルをgzip化し、アップロードプロセスでgzip化されたファイルを使います。
JSONファイルをgzip化するには:
- ファイルアーカイブまたはプログラム方式のいずれかを使いましょう。
例えば、アップロードしたいデータがimport.jsonにある場合、gzip化されたファイルはimport.json.gzです。
!ヒントバッチファイルのアップロードには50MBのサイズ制限があります。
もしgzipファイルのサイズが50MBの制限を超えた場合は、元のJSONファイルを2つ以上のgzipファイルに再圧縮し、そのファイルは50MBサイズを超えません。その後、gzip化されたファイルを1つずつアップロードします。
必要な情報を集める
gzipファイルを作成した後、アップロードプロセスを開始するために必要な詳細情報を集めます。
詳細
種類
概要
例
バイト単位のファイルサイズ
整数
gzip化されたファイルのバイト単位でのサイズ(import.json.gz)。ファイルのプロパティで確認できます。
3456
MD5チェックサム
ストリング
gzip化されたファイルの16進エンコード MD5チェックサム です。これは、gzip化されたファイルの整合性が保たれていることを保証するためのものです。
"40d9a12f0a3c93c8ed66a3b6f3735790"
Base64弦
ストリング
同じ16進符号化されたMD5チェックサムを Base64に変換しました。
"hmhSUwGGLymfT1gmfmkCSA=="
バッチ参照用のUUID
ストリング
バッチアップロードのUUID。
これはあなたが生成するUUIDです。すべてのバッチで一意でなければなりません。 オンラインツールを使って UUIDを生成できます。
3ee694e5-0b77-2d1e-af19-1aa78f500785
gzip化されたファイルをアップロードしてください
必要な情報を集めたら、アップロードプロセスを開始できます。このプロセスでは、まずバッチアップロードの場所を割り当て、その後gzip化されたファイルのアップロードを開始し、アップロードのステータスを取得します。
バッチアップロード場所を割り当てた後は、開発者センター Sitecore CDP >バッチ アップロード>バッチファイルのアップロード状況を監視し始めることができます。
gzip化されたファイルをアップロードするには:
-
バッチアップロード場所を割り当てるためにPUTリクエストを出します。
curl -X PUT '
/v2/batches/<batchRef_UUID>' \ -u ' : ' \ --data-raw ' { "checksum": "<MD5_checksum>", "size": <file_size_in_bytes> }' 以下に注意してください:
レスポンス内のlocationオブジェクトのhrefキーにはバッチアップロードパスが含まれています。次のステップでバッチアップロードパスを使用します。バッチアップロードパスは1時間有効です。
バッチアップロードパスの例:
https://sitecore-batch-service-dev-eu-west-1.s3.amazonaws.com/...
!警告処理のために大量のバッチファイルをアップロードしようとすると、バッチアップロードの上限を超えたというエラーが表示されます。一度に1つのバッチファイルをアップロードする必要があります。
-
バッチアップロードパスにPUTリクエストを送ります。このリクエストがアップロードを開始します。
curl -X PUT 'https://sitecore-batch-service-dev-eu-west-1.s3.amazonaws.com/...' \ -H 'x-amz-server-side-encryption: AES256' \ -H 'Content-Md5: <Base64_string>' \ --data-binary '<path_to_gzipped_file>'
以下に注意してください:
-
前のステップとは逆に基本的な認証は使わないことです。
-
上記のコードサンプルで示されたようにヘッダーを指定します。
を前の手続きで収集した値に置き換えます。 -
--data-binaryで、gzip化されたファイルのパスを指定します。ファイルを本文にバイナリデータとしてアップロードしなければなりません。
例: @/C:/Users/user/Desktop/import.json.gz
!ヒントPostmanを使っている場合は、バイナリ>ボディをクリックし>ファイル選択。
このリクエストは空の200 OK応答を返します。
-
-
バッチファイルのアップロード状況は、開発者センター >バッチ アップロードSitecore CDP >を開くか、以下のGETリクエストを行って確認してください:
curl -X GET '
/v2/batches/<batchRef_UUID>' \ -u ' : ' \ -H 'Accept: application/json' 以下に注意してください:
- 基本的な認証を使いましょう。
を基本URLに置き換えてください。<batchRef_UUID>を、PUTのバッチアップロード場所割り当てリクエストをしたときに使ったのと同じバッチ参照に置き換えてください。
応答では、statusオブジェクトに アップロード状況に関する情報が含まれています。まず、ステータスはprocessingです。アップロードが成功すると、ステータスはsuccessとなります。
!ヒント次のファイルをアップロードする前に、各ファイルのアップロード状況が成功しているか確認することをお勧めします。これにより、フォーマットの問題やその他のエラーで失敗した際に、ステータスを確認しなかったファイルの再アップロードを省くことができます。
Sitecore CDPがアップロードされたデータを取り込んだか確認してください
アップロードが成功したら、アップロードされたデータを確認するためにSitecore CDPにログインします。この例では、サンプルJSONレコードに記載されているゲストを検索します。
Sitecore CDPがアップロードされたデータを取り込んだことを確認するために:
-
Sitecore CDPで「 ゲスト」をクリックし、検索ドロップダウンで 「メール 」を選択し、アップロードしたゲストレコードのメールアドレス(例えば[email protected])を入力してください。
ゲストの展示。
-
ゲストをクリックしてください。ゲストプロフィールが表示されます。
-
ゲストプロフィールページで「プロパティ」をクリックします。アップロードされたゲストの詳細が表示されます。サンプルJSONレコードに記載されているゲストの詳細には、Ext属性にFirst Seen、Last Seen、データ拡張(例えばLoyaltyNumber)が含まれています。
!ヒントアップロードが成功し、Sitecore CDPがデータを取り込んだら、残りのバッチファイルを一つずつアップロードし始められます。
これでバッチファイルをSitecore CDPに正常にアップロードしました。JSONファイルをgzip化し、アップロードを開始し、Sitecore CDPがアップロードしたデータを取り込んだことを確認しました。