サプリメンタル・データのインポート
重要: このトピックは、Connectの最新バージョンのユーザーを対象としています。引き続きクラシックConnectを使用する場合は、Classic Connect User Guideをダウンロードしてください。
Connectを使用して、Oracle Responsysのサプリメンタル・データ表にレコードをインポートできます。
インポート・ジョブを実行した後、アップロード・ファイルはサーバーにアーカイブされます。ジョブが正常に終了すると、アップロード・ファイルは削除されます。ジョブが失敗すると、次の状況の場合のみアップロード・ファイルが削除されます。
- ファイルが空の場合
- 無効なデータ書式などのデータの問題がファイルにある場合
- アップロード・ファイルとカウント・ファイルのレコード数が異なる場合
サプリメンタル・データのインポート・ジョブを作成するには:
- サイド・ナビゲーション・バーの
「データ」をクリックし、「Connect」を選択します。
- Connectの管理ページで、「ジョブの作成」をクリックします。
- ドロップダウン・リストから「サプリメンタル・データのインポート」を選択して、インポート・ジョブの名前と摘要を指定します。
ジョブ名は100文字以下で、使用できる文字は、A-Z、a-z、0-9、空白、! - = @ _ [ ] { }のみです。
- 「完了」をクリックします。
Connectウィザードが開きます。任意の順序でステップを完了でき、変更内容を保存して後から続行できます。
- 次のステップを完了します。
- すべてのステップを構成した後、「保存」をクリックします。ジョブを保存およびアクティブ化するには、「アクティブ化」をクリックします。
重要: ジョブを保存したりアクティブにする前に、失効日を設定するか、ジョブが失効しないように設定する必要があります。「失効」の横にある「編集」をクリックします。ジョブが失効すると、ジョブは削除されて復元できなくなります。失効日の管理の詳細を参照してください。
終了後は、次のようになります。
- ジョブを保存した後、Connectの管理ページを使用してジョブを管理できます。ジョブの管理の詳細を参照してください。
- ジョブを保存すると、Connectによりエラーが返される場合があります。「エラーの表示」をクリックしてエラーを確認し、修正が必要なページに素早くジャンプします。ジョブをアクティブ化する前に、すべてのエラーを解決する必要があります。
ステップ1: ソース接続
このステップでは、ソース・ファイルを取得するためのファイル・サーバーの仕様を指定します。
次のオプションから1つ選択してください。
- Responsysファイル・サーバー: コネクト・ジョブにより、Responsys SCP (Secure Copy Protocol)アカウント・ファイル・サーバーを介してデータをインポートできます。このアカウントには、アップロード、ダウンロード、アーカイブの3つのディレクトリが含まれています。
重要: まだ確立されていない場合は、Oracle Responsysサポートとお客様のITチームが共同でSSH-2公開キー/秘密キーのペアを生成する必要があります。そうすればSSH/SCPクライアントを経由したSCPアカウントへのアクセスの安全を確保できます。SSH (Secure Shell)クライアントを使用した独自のディレクトリを作成することもできます。
- このオプションを選択する場合は、「変更」をクリックして、ファイルを配置するディレクトリを指定します。
- SFTPによる外部サーバー: このオプションを選択する場合は、次の情報を指定します。
- ホスト名: ドロップダウン・リストからホスト名を選択します。
- ディレクトリ・パス: 関連するディレクトリのパス名を入力します。
- ユーザー名: SFTP接続にアクセスするためのユーザー名を入力します。
- 認証: サーバーの設定方法に応じて、「パスワード」または「キー」のいずれかを選択します。
これがキー承認を使用する最初のジョブである場合は、「キー情報へアクセスまたはキー情報の生成」をクリックして、公開キーと公開キーをSFTPアカウントに追加するための指示を受信するEメール・アドレスを入力します。公開キーをインストールした後、「接続のテスト」をクリックして、SFTP接続構成が有効であることを確認します。
ヒント: キー認証の詳細は、公開キーの選択、インポートまたは生成を参照してください。
ステップ2: ソース仕様
このステップでは、インポートするファイルに関する情報を指定します。
- アップロードするファイル: インポートするファイルのフル・ネームとファイル拡張子。プリフィクスまたはサフィクスとして、ファイルの作成日を追加できます。
- キャラクタ・セット: ファイルのキャラクタ・セット。ファイルに絵文字が含まれている場合は、「Unicode (UTF-8)」のキャラクタ・セットを選択する必要があります。
- フィールド区切り文字: ファイル内のフィールド(列)を区切る区切り記号。
- フィールド囲み文字: テキスト列や値を一重引用符または二重引用符で囲むかを指定します。
- 日付書式: インポート・ファイルの日付形式を選択します。サポートされている日付形式の詳細は、Connectでサポートされる日付形式を参照してください。
- 最初の行は列名を含む: ファイル内の1行目にフィールド名を含める場合は、このチェック・ボックスを選択します。
- ファイルはPGP/GPGキーで暗号化されています: ファイルがキーを使用して暗号化され、アップロードの前に復号化する必要がある場合は、このチェック・ボックスを選択します。
- ファイルはPGP/GPGキーで署名されています: ファイルがキーで署名されている場合は、このチェック・ボックスを選択します。
- 概算レコード数確認用ファイル: オプションで、このチェック・ボックスを選択し、レコード数をインポートされたレコード数と比較するために使用するファイルを指定します。たとえば、このファイル内の概算レコード数が300であり、インポートされたファイルに100個のレコードのみが含まれる場合、転送エラーが示されて、アップロード処理は中止されます
ステップ3: ターゲット定義
このステップでは、データをインポートするサプリメンタル・データ表を選択します。
注意: また、ステップ4でフィールドをマップする際にターゲット表を選択する必要もあります。
ターゲット定義を追加するには:
- 「ターゲット定義」ステップで、「追加」+をクリックし、データをインポートするサプリメンタル・データ表を選択します。
- 「構成」セクションで、次のオプションを指定します。
- 既存のレコードすべてを削除してアップロード: 既存レコードを新しくアップロードしたレコードで置き換えるには、このチェック・ボックスを選択します。
- 次のフィールドを使用して表にマージ: 既存レコードをすべて削除しない場合は、新しいレコードを既存レコードにマージするためのフィールドを選択します。
- 一致する場合、既存レコードのマッピングされたフィールドをすべて上書き: レコードが一致する場合に既存レコードを新しいデータで置き換えるには、このチェック・ボックスを選択します。このチェック・ボックスを選択しない場合、受信レコードは無視されます。
- 一致しない場合は新しいレコードをインポート: 一致しない場合にレコードをインポートするには、このチェック・ボックスを選択します。このチェック・ボックスを選択しない場合、受信レコードは無視されます。
ステップ4: フィールドのマッピング
このステップでは、ソース・ファイルの列をターゲット表内のフィールドにマッピングします。マッピング・フィールドを使用して、どのソース・フィールドがどのターゲット・フィールドに対応するかを指定します。
フィールドを手動でマッピングしたり、マッピング用のアップロード・ファイルを使用したり、フィールドのマッピングを自動的に生成することもできます。
次のことに注意してください。
- 長いフィールド名は30文字で切り捨てられます。
- フィールド名は、文字または数字で始める必要があり、文字、数字およびアンダースコア(_)のみを使用できます。
- 作成されたフィールド名に大文字と小文字の区別はありませんが、後にすべて大文字に変換されます。
- 変更によってフィールド名が重複した場合は、手作業で名前を変更する必要があります。
- (Oracle Responsysにより定義および予約されている)すべてのシステム・フィールド名は、EMAIL_ADDRESS_のように、末尾にアンダースコア文字が付いています。ベスト・プラクティスとして、アップロード・フィールド名の末尾をアンダースコア文字にすることは避けてください。システム・フィールド用に予約されているためです。
- 可能な場合、入力フィールド名は既存のリスト・フィールドに似た名前と一致させます。たとえば、CUST_IDをCUSTOMER_ID_に一致させます。
データ・タイプとフィールド名要件の詳細は「データ・タイプとフィールド名」をご覧ください。
マッピング・ファイルをアップロードするには:
- 「フィールドのマッピング」ステップで、「ファイルのアップロード」をクリックします。
- マッピング・ファイルを選択して、詳細を完了します。
- フィールドの区切り文字: ファイル内の列を区切る区切り記号(一般にタブやカンマ)を選択します。
- フィールドの囲み文字: テキスト列や値を一重引用符または二重引用符で囲むかを指定します。
- 最初の行は列名を含む: 1行目にフィールド名を含める場合は、このチェック・ボックスを選択します。
フィールドをマッピングするには:
- 「フィールドのマッピング」ステップで、「追加」+をクリックします。
- そのフィールドのターゲット表も必ず選択してください。
- 入力フィールドおよびそのフィールドと一致させるフィールドを指定します。フィールドを一致させない場合は、「このフィールドは取り込まない」を選択します。
- 「更新」をクリックします。
ステップ5: 後処理
このステップでは、ジョブ実行が成功した後にキャンペーンを開始できます。最大40つのキャンペーンを選択できます。
キャンペーン開始に関する進捗通知を受信するには、各キャンペーンの設定で、進捗通知を受信する1つ以上のEメール・アドレスを指定していることを確認してください。
ステップ6: 通知
このステップでは、ジョブに関するEメール通知を設定します。ジョブが成功または失敗した後に通知を送信することを選択できます。
ステップ7: スケジュール
このステップでは、ジョブをスケジュールします。指定された日時に1回、または定期的にジョブを実行できます。オンデマンドでジョブを実行するには、「スケジュールしない」オプションを使用します。
重要: うるう年および31日ある月に問題が発生しないようにするため、毎月繰返しの実行は月の29日、30日または31日にスケジュールできません。月の最後の金曜日など、月の最後の曜日にジョブを実行するようにスケジュールできます。
ジョブの開始時間を設定する場合は、1時間内の0-14、15-29、30-44、45-59の4つの時間スロットのいずれかを選択します。スケジュールされた各ジョブについて、システムが無作為な分(0-14セグメントで12分以内など)を選びます。これにより、ジョブの開始時間がより均等に配分されます。
ジョブは選択された時間スロット内で無作為に開始されます。新しいジョブを現在時刻と重なるスロットに設定しようとすると、選択した時間は過去に起こったという旨のエラー・メッセージが発行される場合があります。したがって、現在の時間スロットよりも後の時間スロットを選択することがベスト・プラクティスとなります。