連絡先インポート ファイルを作成する
CSV ファイルなどの区切られたファイル形式に含まれる連絡先を、アドレス帳にインポートできます。このセクションでは、連絡先のインポートに使用されるインポート ファイルの要件について説明します。
- ファイル内のデータは、サポートされている形式を使用して区切る必要があります (以下を参照してください)。
- ファイルに Unicode 文字が含まれる場合は、UTF-8 を使用してエンコードする必要があります。
- ファイルの最初のデータ行には、各種データ列の名前を指定する必要があります。
- 少なくとも 1 つの列に、連絡先を一意に指定する ID を指定する必要があります (以下の「連絡先 ID」を参照してください)。
- その他の列の値をインポートする場合は、使用する拡張詳細フィールドにマッピングする必要があります。
- 連絡先をシステム管理レベルの [(すべての連絡先)] ノードにインポートするには、ファイルに
GROUP_KEYVALUEフィールドにマッピングできる列がある必要があります (行の値で既存のアドレス帳のキー値を指定する必要があります)。
- OutboundEmail.xml 設定ファイルでインポートのロギングを設定します。
連絡先 ID
連絡先には既定の拡張詳細フィールドのセットがあり、IDENTIFICATION_KEY と IMPORT_SOURCE を組み合わせて使用して個人の連絡先を一意に指定します。連絡先 ID フィールドの変更と連絡先の拡張詳細の追加 (データベース管理者が実行) の手順は、実装マニュアルで説明されています。
既定のマッピングの指定
設定ファイル OutboundEmail.xml の <ContactDetails> セクションで、連絡先の拡張詳細フィールドを指定する必要があります。これらのフィールドは、Audience Manager データベースで定義された拡張詳細を反映しています。既定のマッピングを指定するには、拡張詳細フィールドで指定したものと同じ列名を指定します。設定の詳細については、SDL Tridion Sites の製品マニュアルでインストールに関するトピックを参照してください。
拡張詳細フィールドのほか、連絡先には各連絡先に固定された一連のフィールドがあり、マッピングされていない場合は既定値が割り当てられています。次の表の名前で列を作成して、マッピングが既定で動作することを確認できます。
| フィールド | 有効な値 | 既定値 |
|---|---|---|
| SUBSCRIBE_STATUS_ID |
| 2 |
| EMAIL_TYPE |
| 1 |
| BOUNCE_STATUS_ID |
| 1 |
| ENABLED | true または false | 正確 |
GROUP_KEYVALUE | 既存のアドレス帳のキー値 |
ファイルの書式設定
次の表は、連絡先インポート ファイルでのデータの書式設定を示しています。
| 書式設定オプション | 説明 | サポートする値 |
|---|---|---|
| フィールドの区切り文字 | フィールドおよび列を区切る方法を指定します。 |
|
| 文字列の区切り文字 | コンマ、二重引用符、改行を含むフィールドを区切る方法を指定します。 |
|
| 小数点記号 | 小数値の整数部と小数部との境界を示すために使用する記号を指定します。 |
|
| グループの区切り文字 | 3 桁の位取りに使用する記号を指定します (大きな数値を読みやすくするため)。 |
|
| 日付の形式 | 日付の形式を指定します。 | 日付は、Audience Manager データベースがサポートするデータ形式に従って設定する必要があります。
|
| 行の区切り文字 | 行を区切る方法を指定します。
|
|