例: ユーザー・プロフィール属性変更ファイル

統合サーバーを使用できるようになり、ファイルの命名と属性の指定の要件についてよく理解したら、組織内のユーザーのプロフィール情報を更新するために、ユーザー・プロフィール属性変更ファイルを作成できます。

ファイル・ヘッダーは、ユーザー・プロフィール属性変更ファイルの作成の表 2 の最初の列で定義したとおりに操作フィールド名を指定します (大/小文字は区別されません)。残りの行により、対応する各フィールドの値が定義されます。各行は、適切な復帰または改行文字で終了する必要があります。 Windows では ¥r¥n (0x0D 0x0A) を使用し、UNIX または Linux では ¥n (0xA) を使用します。統合サーバーはどの行終了形式が指定されたファイルでも処理できますが、正しい行の終了が中間 FTP サーバーに送受信されるようにするため、TEXT 転送形式を使用します。

プロフィール属性変更ファイルで操作をエンコードする場合は、以下の規則に準拠してください。

注: 統合サーバーのユーザー・プロフィール属性変更ファイルでは、コンマ区切り値 (CSV) 形式が使用されます。詳しくは、RFC 4180 を参照してください。この形式の詳細については、Wikipedia などの Web サイトに記載されています。

以下の例に示されているように、正しい CSV フィールドの順序で、関連するフィールド・データを追加します。追加情報については、ユーザー・プロフィール属性変更ファイルの作成の表 2 を参照してください。
UTF-8 文字セットを使用します。
連続したコンマを使用して、オプションのフィールドまたは適用不可のフィールドに空の値を追加します。
フィールドに対して長さゼロのストリングを “” としてエンコードします。
フィールド値にコンマや二重引用符が含まれている場合、またはフィールド値の最初や最後にスペースが含まれている場合は、その値を二重引用符で囲みます。その他のフィールド値は、必要に応じて二重引用符 ("") で囲むことができます。
- フィールド値は、フィールド内にどのような文字があるかに関係なく、二重引用符 ("") で囲むことができます。
- 二重引用符 ("") は、コンマを含むフィールド値に対しては使用する必要があります。
- 二重引用符 ("") は、値の最初または最後に 1 つ以上のスペースを持つフィールド値に対して使用する必要があります。
- 1 組の二重引用符 ("") 文字を使用して、二重引用符 ("") 文字をエンコードします。例: ...,"John ""that guy"" Doe", ...
空のフィールド値 (,, など) を含む更新操作では、フィールド設定は既存の値のままになります。
長さがゼロのストリングを指定する更新は、長さがゼロのストリングにフィールド値を置き換えます。
操作名は大/小文字の区別はありません。
ステートメントの末尾にある連続するコンマは省略できます。例えば、以下の 2 つのステートメントは同じ結果になります。
```
joseph_lu@bluebox.lotus.com,update, N,"some description",

joseph_lu@bluebox.lotus.com,update, N,"some description",,,,,,,,,,,,,
```
操作に必要ではない場合は、ステートメントの末尾にあるフィールド名、コンマを省略できます。例えば、description より後のフィールドが必要ない場合は、以下のフィールドに値を指定するだけで問題ありません。
```
emailAddress,action, isManager, description
```

IBM Verse チーム分析機能にレポート先情報を提供するためのユーザープロフィール属性変更ファイルの例。jobResp 属性はオプションで、Connections Cloud プロフィールを介して更新することができます。

emailAddress,action,isManager,managerEmail,jobResp
branney@renovations.com,update,Y,marmond@renovations.com,Lead System Administrator
sdaryn@renovations.com,update,N,bgossens@renovations.com,Promotions Coordinator

ユーザー・プロフィール属性の更新のためのユーザー・プロフィール属性変更ファイルの例:

emailAddress,action, isManager, description, experience, telephoneNumber, mobileNumber, faxNumber, phone1, phone2, phone3, address1, address2, address3, address4, item1, item2, item3, item4, item5, item6, item7, item8, item9, item10

joseph_lu@bluebox.lotus.com,update, N,"some description","user experience rich text",123-456-7890,345-678-9012,789-012-345,"","","","550 King Street, Littleton, MA","","","","item1 value","","","","","","","","","item10 values"