チュートリアル: バッチ ファイルのアップロード
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
このチュートリアルでは、バッチ ファイルをSitecore CDPにアップロードします。
このチュートリアルでは、次のことを前提としています。
-
有効なJSONレコードを含むJSONファイル (import.json) を用意します。独自のJSONレコードがない場合は、サンプルのJSONレコードを使用できます。
-
ファイルアーカイバにアクセスできる。
このチュートリアルでは、次の方法について説明します。
-
JSONファイルをGzip圧縮します。
-
必要な詳細を収集します。
-
gzip圧縮したファイルをアップロードします。
-
アップロードされたデータがSitecore CDP取り込まれたことを確認します。
JSONファイルをGzip圧縮します
バッチファイルをアップロードする前に、JSONファイルをgzip圧縮し、圧縮したファイルをアップロードプロセスで使用します。
JSONファイルをgzip圧縮するには:
-
ファイルアーカイバまたはプログラムによるアプローチを使用します。
たとえば、アップロードするデータがimport.jsonにある場合、gzip圧縮されたファイルはimport.json.gzです。
バッチファイルのアップロードには50 MBのサイズ制限があります。
gzip圧縮されたファイルのサイズが50MBの制限を超える場合は、元のJSONファイルを50MBのサイズ制限を超えない2つ以上の圧縮されたファイルに再圧縮します。次に、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圧縮されたファイルのアップロードを開始してから、アップロードのステータスを取得します。
gzip圧縮したファイルをアップロードするには:
-
PUT要求を行って、バッチ アップロードの場所を割り当てます。
次の操作を行う必要があることに注意してください。
レスポンスのlocationオブジェクトのhrefキーには、バッチアップロードパスが含まれています。次の手順では、バッチ アップロード パスを使用します。バッチアップロードパスは1時間有効です。
バッチアップロードパスの例:
https://sitecore-batch-service-dev-eu-west-1.s3.amazonaws.com/...
警告処理のためにアップロードするバッチ ファイルが多すぎると、バッチ アップロードの制限を超えたことを示すエラーが表示されます。一度に1つのバッチファイルをアップロードする必要があります。
-
バッチ アップロード パスに対してPUT要求を行います。このリクエストにより、アップロードが開始されます。
次の操作を行う必要があることに注意してください。
-
前の手順とは対照的に、基本認証は使用しません。
-
上記のコード サンプルに示されているようにヘッダーを指定します。 <Base64 string> を前の手順で収集した値に置き換えます。
-
--data-binaryで、gzip圧縮したファイルへのパスを指定します。本文内のファイルをバイナリデータとしてアップロードする必要があります。
例: @/C:/Users/user/Desktop/import.json.gz
先端Postmanを使用している場合は、Body > binary > Select Fileをクリックします。
このリクエストは、空の200 OKレスポンスを返します。
-
-
GETリクエストを送信して、バッチ ファイルのアップロード ステータスを取得します。
次の操作を行う必要があることに注意してください。
応答では、statusオブジェクトに アップロード ステータスに関する情報が含まれています。まず、ステータスはprocessingです。アップロードが成功すると、ステータスはsuccessになります。
先端次のファイルをアップロードする前に、各ファイルのアップロードステータスが成功したことを確認することをお勧めします。これにより、ファイルのステータスを確認せず、フォーマットの問題やその他のエラーが原因で失敗したことに気付いた場合に、ファイルを再度アップロードする必要がなくなります。
アップロードされたデータがSitecore CDP取り込まれたことを確認します
アップロードが成功したら、Sitecore CDPにログインしてアップロードされたデータを見つけます。この例では、サンプルJSONレコードにリストされているゲストを検索します。
アップロードされたデータがSitecore CDP取り込まれたことを確認するには:
-
Sitecore CDPでGuestsをクリックし、検索ドロップダウンでEmailを選択し、アップロードしたゲストレコードの1つの電子メールアドレス([email protected]など)を入力します。
ゲストが表示されます。
-
ゲストをクリックします。ゲスト プロファイルが表示されます。
-
ゲスト プロファイル ページで、Propertiesをクリックします。アップロードされたゲストの詳細が表示されます。サンプルJSONレコードにリストされているゲストの場合、詳細には、First Seen、Last Seen、およびExt属性のデータエクステンション ( LoyaltyNumberなど) が含まれます。
アップロードが成功し、データが取り込まれSitecore CDPことを確認したら、残りのバッチ ファイルのアップロードを一度に1つずつ開始できます。
これで、バッチファイルがSitecore CDPに正常にアップロードされました。JSONファイルを圧縮し、アップロードを開始し、アップロードしたデータをSitecore CDPが取り込んだことを確認しました。