リストビューまたは関連リストなどのリスト内で選択したレコードのレコード ID の形式で、配列された文字列を返します。
使用方法
{!GETRECORDIDS(object_type)}。object_type に、取り出したいレコードのカスタムオブジェクトまたは標準オブジェクトへの参照を指定します。
ヒント
Sコントロール、カスタム項目、およびリンクの特殊な差し込み項目にアクセスするには、グローバル変数を使用します。
活動は、特殊なオブジェクトです。ToDo リストボタンを作成する場合は、{!GETRECORDIDS($ObjectType.Task)} を使用します。行動リストボタンを作成する場合は、{!GETRECORDIDS($ObjectType.Event)} を使用します。
この関数はカスタムボタン、リンク、および Sコントロールでのみ使用できます。
カスタムボタンの例
{!REQUIRESCRIPT ("/soap/ajax/13.0/connection.js")} var records =
{!GETRECORDIDS($ObjectType.Sample)}; var newRecords = []; if (records[0] == null) { alert("Please select at least one row") } else {
for (var n=0; n<records.length; n++) { var c = new sforce.SObject("Case"); c.id = records[n]; c.Status = "New";
newRecords.push(c); } result = sforce.connection.update(newRecords); window.location.reload(); }
この例では、すべての選択されたケースのレコードの [状況] を「新規」として更新します。組織で設定するには、次の属性を持つケースのカスタムリストボタンを作成します。
- [表示の種類] は「リストボタン」です。
- [動作] は「JavaScript を実行」です。
- [コンテンツソース] は「OnClick JavaScript」です。
上記のサンプルコードをカスタムボタンのコンテンツに張り付けます。最後にリストボタンを、取引先や商談などの [ケース] 関連リストを含むページレイアウトに追加します。ユーザは、関連リストで任意の数のケースを選択し、リストボタンをクリックすることで選択した複数のケースの状態を一度に変更できます。ユーザがリストから何も選択しなかった場合にメッセージを表示する records[0] == null の設定を確認してください。
外部システムへのレコード ID の受け渡しの例
外部システムと統合するための固有 ID として Salesforce レコード ID を使用できます。次の例では、Visualforce ページをコールして、選択されたレコードのレコード ID を判別し、それらを URL クエリパラメータで「www.yourwebsitehere.com」という外部 Web ページに渡すボタンを作成します。
- GETRECORDIDS 関数を使用する Visualforce ページを作成して、選択されたレコードのリストを取得します。
<script type="text/javascript">
idArray = {!GETRECORDIDS($ObjectType.Account)};
window.location.href="http://www.yourwebsitehere.com?array="+idArray;
</script>
2. 次の属性を使用して、取引先のボタンを定義します。
表示の種類 : リストボタン
[チェックボックスの表示 (複数レコード選択用)] を選択すると、ユーザはボタンをクリックする前に、リストで複数のレコードを選択できます。
動作 : 現在のウィンドウにサイドバー付きで表示します。
内容のソース : Visualforce ページ。
3. 最初の手順で作成した Visualforce ページを選択します。
4. 該当するページレイアウトまたはリストビューレイアウトにボタンを追加します。