この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

QuickAction

Chatter パブリッシャーで使用可能となるオブジェクトに対して指定された作成または更新クイックアクションを表します。たとえば、取引先の詳細ページで、ユーザがそのページの Chatter フィードからその取引先に関連する取引先責任者を作成するアクションを作成できます。QuickAction は、カスタム項目が許可されたオブジェクトで作成できます。サポートされる親オブジェクトは、次のとおりです。
  • Account
  • Campaign
  • Case
  • Contact
  • Custom objects
  • Group
  • Lead
  • Opportunity

ファイルのサフィックスおよびディレクトリの場所

QuickAction コンポーネントのサフィックスは quickAction で、quickActions フォルダに保存されます。

バージョン

QuickAction コンポーネントは、API バージョン 28.0 以降で使用できます。

項目

項目名 データ型 説明
canvas string キャンバスアプリケーションを使用してカスタムアクションを作成する場合に、アプリケーションを特定します。クイックアクション種別が Canvas の場合はキャンバスアプリケーションの完全修飾名を <namespace>__<dev_name> 形式で返し、そうでない場合は null を返します。この項目は API バージョン 29.0 以降で使用できます。
description string アクションの説明。
fieldOverrides FieldOverride QuickAction 内で上書きできる特定の項目。
height int カスタムアクションを作成する場合、この値がアクションペインの高さ (ピクセル単位) になります。
icon string アクションの識別に使用するアイコン。

API バージョン 32.0 以降は、以前の API バージョンと異なるアイコンを返します。

isProtected boolean このコンポーネントが保護されるか (true)、否か (false) を示します。保護コンポーネントは、インストールする組織で作成されたコンポーネントによってリンク設定したり参照したりすることはできません。
label string アクションを特定し、ユーザに表示します。これは、API および管理パッケージに使用するデフォルトの識別子でもあります。
page string Visualforce ページを使用してカスタムアクションを作成する場合に、ページを特定します。
quickActionLayout QuickActionLayout アクション中の項目のレイアウト。
standardLabel QuickActionLabel (string 型の列挙) アクションに使用する標準表示ラベルを指定します。有効な値は、次のとおりです。
  • LogACall
  • LogANote
  • New (新しいレコード)
  • NewRecordType (表示ラベルが「新しいアイデア」などのような場合)
  • Update
  • UpdateRecordType
  • NewChild (新しい子レコード)
  • NewChildRecordType
  • CreateNew
  • CreateNewRecordType (表示ラベルが「新しいアイデアを作成」などのような場合)
  • SendEmail (この値は API バージョン 31.0 以降で使用できます)。
  • QuickRecordType
  • Quick (クイックレコード)
targetObject string アクションを作成および実行する対象となるオブジェクト。

たとえば、取引先の詳細ページで、ユーザがそのページの Chatter フィードからその取引先に関連する取引先責任者を作成するアクションを作成できます。この場合、取引先責任者が targetObject になります。

targetParentField string アクションの親オブジェクト種別。ターゲットオブジェクトを親オブジェクトにリンクします。たとえば、ターゲットオブジェクトが取引先責任者であり、親オブジェクトが取引先である場合、取引先を使用します。
targetRecordType string 作成するレコードタイプを指定します。有効な値は、次のとおりです。
  • 法人取引先
  • 個人取引先
  • 主取引先
type QuickActionType (string 型の列挙) クイックアクションの種別。有効な値は、次のとおりです。
  • Create
  • VisualforcePage
  • Post
  • SendEmail (この値は API バージョン 31.0 以降で使用できます)。
  • LogACall
  • SocialPost
  • Canvas
  • Update
width int カスタムアクションを作成する場合、この値がアクションペインの幅 (ピクセル単位) になります。

FieldOverride

QuickAction での上書きを構成する項目名、各項目の数式およびリテラル値を表します。

項目名 データ型 説明
field string 上書きを許可する特定の項目の名前。
formula string 項目を上書きするときに使用する数式を指定します。
literalValue string 上書きなしの項目の値。

QuickActionLayout

アクション中の項目のレイアウト。アクションレイアウトに追加できる項目数にハードリミットはありません。ただし、使いやすさを最適化するため、最大 8 項目をお勧めします。20 項目以上を追加すると、ユーザの効率が大幅に低下します。

項目名 データ型 説明
layoutSectionStyle LayoutSectionStyle (string 型の列挙) 使用するレイアウト構造の種別。有効な値は、次のとおりです。
  • TwoColumnsTopToBottom
  • TwoColumnsLeftToRight
  • OneColumn
  • CustomLinks
quickActionLayoutColumns QuickActionLayoutColumn[] QuickActionLayout の列を指定します。

QuickActionLayoutColumn

QuickActionLayout に定義される列です。

項目名 データ型 説明
quickActionLayoutItems QuickActionLayoutItem[] QuickActionLayoutColumn の行アイテムを指定します。

QuickActionLayoutItem

項目で構成され QuickActionLayoutColumn 用に定義される行アイテムです。

項目名 データ型 説明
emptySpace boolean このレイアウト項目が空白スペースであるか (true)、否か (false) を制御します。
field string QuickActionLayoutItem の特定の項目を表します。アクションレイアウトに追加できる項目数にハードリミットはありません。ただし、使いやすさを最適化するため、最大 8 項目をお勧めします。20 項目以上を追加すると、ユーザの効率が大幅に低下します。
uiBehavior UiBehavior (string 型の列挙) QuickActionLayoutItem の特定の項目に関するユーザ入力動作を指定します。有効な値は、次のとおりです。
  • Edit
  • Required
  • Readonly

宣言的なメタデータの定義のサンプル

次に、QuickAction コンポーネントの例を示します。

1<?xml version="1.0" encoding="UTF-8"?>
2<QuickAction xmlns="http://soap.sforce.com/2006/04/metadata">
3    <description>testActionDefinitionTypesCreate</description>
4    <fieldOverrides>
5        <field>DoNotCall</field>
6        <formula>TRUE</formula>
7    </fieldOverrides>
8    <fieldOverrides>
9        <field>LeadSource</field>
10        <literalValue>Partner</literalValue>
11    </fieldOverrides>
12    <label>testActionDefinitionTypesCreate</label>
13    <quickActionLayout>
14        <layoutSectionStyle>TwoColumnsLeftToRight</layoutSectionStyle>
15        <quickActionLayoutColumns>
16            <quickActionLayoutItems>
17                <emptySpace>false</emptySpace>
18                <field>HomePhone</field>
19                <uiBehavior>Required</uiBehavior>
20            </quickActionLayoutItems>
21            <quickActionLayoutItems>
22                <emptySpace>true</emptySpace>
23                <uiBehavior>Edit</uiBehavior>
24            </quickActionLayoutItems>
25            <quickActionLayoutItems>
26                <emptySpace>false</emptySpace>
27                <field>Name</field>
28                <uiBehavior>Required</uiBehavior>
29            </quickActionLayoutItems>
30            <quickActionLayoutItems>
31                <emptySpace>false</emptySpace>
32                <field>AccountId</field>
33                <uiBehavior>Edit</uiBehavior>
34            </quickActionLayoutItems>
35        </quickActionLayoutColumns>
36        <quickActionLayoutColumns>
37            <quickActionLayoutItems>
38                <emptySpace>false</emptySpace>
39                <field>Description</field>
40                <uiBehavior>Edit</uiBehavior>
41            </quickActionLayoutItems>
42        </quickActionLayoutColumns>
43    </quickActionLayout>
44    <targetObject>Contact</targetObject>
45    <targetParentField>Account</targetParentField>
46    <type>Create</type>
47</QuickAction>