コールセンター定義ファイルの形式

次に、各要素のプロパティと属性ついて詳しく説明します。

callCenter

この要素は、1 つのコールセンターの電話システムの定義を表します。すべてのコールセンター定義ファイルには、少なくとも 1 つの <callCenter> 要素を含める必要があります。<callCenter> 要素は、1 つ以上の <section> 要素で構成されます。

section

この要素は、サーバ情報や発信番号など、関連するデータ項目のグルーピングを表します。Salesforce でコールセンターを編集すると、割り当てられたセクションごとに項目が整理されます。<section> 要素は、1 つの <callCenter> 要素に属し、1 つ以上の <item> 要素で構成されます。

属性:

名前	型	必須かどうか	説明
sortOrder	正の整数	必須	Salesforce でコールセンターを編集するときにセクションが表示される順序。たとえば、sortOrder="1" と指定されたセクションは、sortOrder="2" と指定されたセクションの直前に表示されます。 sortOrder の値は、負でない整数である必要があり、1 つのコールセンター定義内で数値をスキップすることはできません。たとえば、1 つのコールセンター定義ファイルに 3 つの section 要素がある場合、1 つの <section> 要素は sortOrder="0"、1 つの <section> 要素は sortOrder="1"、1 つの <section> 要素は sortOrder="2" を持つ必要があります。
name	String	必須	Salesforce データベースで定義される、セクションの内部名。この値を使用して、カスタムアダプタまたはソフトフォンコードの作成時にセクションを参照できます。 名前には、空白や他の句読点を含まない英数字のみを使用する必要があります。それぞれの名前は 40 文字以内に制限されています。 req で始まる名前は、必須の Salesforce セクションのみのために予約されています (「コールセンターの必須要素と必須属性」を参照)。name 属性に使用できない他の予約語として、label、sortOrder、internalNameLabel、displayNameLabel があります。
label	String	省略可能	Salesforce で表示するときのセクション名。表示ラベルには、UTF-8 文字で構成された任意の文字列を使用できます。それぞれの名前は 1000 文字以内に制限されています。

item

この要素は、プライマリサーバの IP アドレスや国際電話の発信番号など、1 つのコールセンター定義の 1 つの項目を表します。Salesforce でコールセンターを編集すると、各 <item> 要素は、それが属するセクションの下に表示されます。1 つの <item> 要素に、複数の <section> 要素を指定できます。

属性:

名前	型	必須かどうか	説明
sortOrder	正の整数	必須	Salesforce でコールセンターを編集するときに項目が表示される順序。たとえば、sortOrder="1" と指定された項目は、sortOrder="2" と指定された項目の直前に表示されます。 sortOrder の値は、負でない整数である必要があり、1 つのコールセンター定義内で数値をスキップすることはできません。たとえば、1 つのコールセンター定義ファイルに 3 つの item 要素がある場合、1 つの <item> 要素は sortOrder="0"、1 つの <item> 要素は sortOrder="1"、1 つの要素は <item> 要素は sortOrder="2" を持つ必要があります。
name	String	必須	Salesforce データベースで定義される、項目の内部名。この値を使用して、カスタムアダプタまたはソフトフォンコードの作成時に項目を参照できます。 名前には、空白や他の句読点を含まない英数字のみを使用する必要があります。それぞれの名前は 40 文字以内に制限されています。 req で始まる名前は、必須の Salesforce セクションのみのために予約されています (「コールセンターの必須要素と必須属性」を参照)。name 属性に使用できない他の予約語として、label、sortOrder、internalNameLabel、displayNameLabel があります。
label	String	省略可能	Salesforce で表示するときの項目名。表示ラベルには、UTF-8 文字で構成された任意の文字列を使用できます。それぞれの名前は 1,000 文字以内に制限されています。