Sforce Call Options ヘッダー

ヘッダーの項目名と値

項目名

Sforce-Call-Options

項目値

• client — イベントログファイルなどで使用される、クライアントを識別する文字列。
• defaultNamespace — 開発者の名前空間プレフィックスを識別する文字列。名前空間をすべての場所で指定することなく、管理パッケージの項目名を解決します。

例

開発者名前空間プレフィックスが battle で、パッケージに botId というカスタム項目がある場合、デフォルトの名前空間に次のコールオプションヘッダーを設定します。

1Sforce-Call-Options: client=CaseSensitiveToken, defaultNamespace=battle

その後で次のようなクエリを実行します。

1/services/data/vXX.X/query/?q=SELECT+Id+botID__c+FROM+Account

この場合、実際に照会される項目は、battle__botId__c です。

このヘッダーを使用すると、名前空間プレフィックスを指定せずにクライアントコードを作成することができます。上の例でヘッダーを使用しない場合は、battle__botId__c を記述する必要があります。

この項目が設定され、クエリでも名前空間を指定している場合、応答にはプレフィックスは含まれません。たとえば、このヘッダーを battle に設定し、SELECT+Id+battle__botID__c+FROM+Account のようなクエリを発行すると、応答は battle_botId__c 要素ではなく、botId__c 要素を使用します。

describe 情報を取得するときに defaultNamespace 項目は無視されるため、名前空間プレフィックスと、同じ名前のカスタム項目との間で混乱が生じることはありません。