コール
6. 発送済み注文の取引先をタップし、フィードまでスワイプします。注文が発送 されたことをユーザに知らせるフィード項目が表示されます。
成功です。これで、作成したアクションを
REST API
コールで呼び出すようにShipify Web
アプリケーションを更新できました。もうひとこと : クイックアクションと REST API
REST API
には、アクションの操作時に使用できるリソースとコールがいくつか含まれています。
Quick Actions
Quick Actions
リソースは、アクションと、フィードに表示されるカスタム項目およびオブジェクトのリストを返すために使用します。リソースでは、
services/data/v37.0/quickActions/形式の URI が使用されます。
SalesforceAPI
の操作に特定のツールを使用しているユーザもいます。好みのツールがない場合、ワークベンチを使用すれば簡単に始めることができます。ワークベンチにつ
いての詳細は、https://developer.salesforce.com/page/Workbenchを参照してください。
REST API
についての詳細は、『Force.com REST API開発者ガイド』を参照してください。グローバルアクション
グローバルアクションを返すには、services/data/v37.0/quickActions/を 使用します。
このリソースへのコールでは、次の応答のスニペットに示すように、
Shipify
キャン バスカスタムアクションを含む、グローバルアクションに関する情報が返されま す。...
{
"urls" : {
"quickAction" : "/services/data/v37.0/
quickActions/LogACall",
"defaultValues" : "/services/data/v37.0/
quickActions/LogACall/defaultValues",
"describe" : "/services/data/v37.0/
quickActions/LogACall/describe"
},
"name" : "LogACall",
"type" : "LogACall",
"label" : "Log a Call"
}, {
"urls" : {
"quickAction" : "/services/data/v37.0/
quickActions/Shipify",
"describe" : "/services/data/v37.0/
quickActions/Shipify/describe"
},
"name" : "Shipify",
"type" : "Canvas",
"label" : "Shipify"
}, ...
オブジェクトアクション
グローバルアクションだけでなく特定のオブジェクトのアクションを返すには、
services/data/v37.0/sobjects/object/quickActions/を使用します。
/services/data/v37.0/sobjects/Invoice__c/quickActionsコールでは、
次の応答のスニペットに示すように、グローバルアクションおよび請求書の Create_Deliveryアクションに関する情報が返されます。
...
{ "urls" : {
"quickAction" : "/services/data/v37.0/
quickActions/Shipify",
"describe" : "/services/data/v37.0/
quickActions/Shipify/describe"
},
"name" : "Shipify",
"type" : "Canvas",
"label" : "Shipify"
}, {
"urls" : {
"defaultValuesTemplate" : "/services/data/v37.0/
sobjects/Invoice__c/quickActions/Create_Delivery/
defaultValues/{ID}",
"quickAction" : "/services/data/v37.0/
sobjects/Invoice__c/quickActions/Create_Delivery",
"defaultValues" : "/services/data/v37.0/
sobjects/Invoice__c/quickActions/Create_Delivery/
defaultValues",
"describe" : "/services/data/v37.0/
sobjects/Invoice__c/quickActions/Create_Delivery/
describe"
},
"name" : "Invoice__c.Create_Delivery",
"type" : "Create",
"label" : "Create Delivery"
}, ...
特定のアクション
特定のアクションを返すには、
services/data/v37.0/sobjects/object/quickActions/Action_Nameを使 用します。
/services/data/v37.0/sobjects/Invoice__c/
quickActions/Create_Deliveryコールでは、次の応答に示すように、
Create_Deliveryアクションに関する情報のみが返されます。
{
"colors": [ {
"theme": "theme4",
"color": "AA8E0A",
"context": "primary"
}, {
"theme": "theme3",
"color": "AA8E0A",
"context": "primary"
} ],
"miniIconUrl": "https://instance.salesforce.com/img/
icon/custom51_100/truck16.png",
"sourceSobjectType": "Invoice__c",
"targetParentField": "Invoice__c",
"targetRecordTypeId": null,
"targetSobjectType": "Delivery__c",
"visualforcePageName": null,
"iconUrl": "https://instance.salesforce.com/img/
icon/custom51_100/truck32.png",
"iconName": null,
"canvasApplicationName": null,
"height": null,
"icons" : [ ], ...
"layout": {
"layoutRows": [{
"layoutItems": [ {
"layoutComponents": [{
"details": {
"namePointing": false,
"custom": true,
"htmlFormatted": false,
"dependentPicklist": false,
"calculatedFormula": null,
"defaultValueFormula": null,
"defaultedOnCreate": false,
"digits": 0,
"groupable": true,
"permissionable": false,
"referenceTo": ["Invoice__c"],
"relationshipOrder": 0,
"soapType": "tns:ID",
"nameField": false,
"sortable": true,
"filterable": true,
"restrictedPicklist": false,
"caseSensitive": false,
"calculated": false,
"scale": 0,
"nillable": false,
"externalId": false,
"idLookup": false,
"controllerName": null,
"deprecatedAndHidden": false,
"inlineHelpText": null,
"writeRequiresMasterRead": false,
"createable": true,
"updateable": false,
"relationshipName": "Invoice__r",
"autoNumber": false,
"unique": false,
"picklistValues": [],
"displayLocationInDecimal": false,
"cascadeDelete": true,
"restrictedDelete": false,
"length": 18,
"name": "Invoice__c",
"type": "reference",
"defaultValue": null,
"byteLength": 18,
"label": "Invoice",
"precision": 0 },
"displayLines": 1,
"tabOrder": 1,
"value": "Invoice__c",
"type": "Field"
}],
"placeholder": false,
"editable": true,
"required": true,
"label": "Invoice"
}, {
"layoutComponents": [],
"placeholder": true,
"editable": false,
"required": false,
"label": ""
} ],
"numItems": 2 }],
"useCollapsibleSection": false,
"useHeading": false,
"columns": 2,
"heading": null,
"rows": 1 },
"defaultValues": [],
"width": null,
"urls": {
"defaultValuesTemplate": "/services/data/v37.0/
sobjects/Invoice__c/quickActions/
Create_Delivery/defaultValues/{ID}",
"quickAction": "/services/data/v37.0/
sobjects/Invoice__c/quickActions/Create_Delivery",
"defaultValues": "/services/data/v37.0/
sobjects/Invoice__c/quickActions/
Create_Delivery/defaultValues",
"describe": "/services/data/v37.0/
sobjects/Invoice__c/quickActions/
Create_Delivery/describe"
},
"name": "Invoice__c.Create_Delivery",
"type": "Create",
"label": "Create Delivery"
}
アクションの詳細
特定のアクションの説明の詳細を返すには、
services/data/v37.0/sobjects/object/quickActions/Action_Name/describe/
を使用します。
アクションのデフォルト値と項目値
デフォルトの項目値を含む、特定のアクションのデフォルト値を返すには、
services/data/v37.0/sobjects/object/quickActions/Action_Name/defaultValues/
を使用します。
/services/data/v37.0/sobjects/Invoice__c/
quickActions/Create_Data/defaultValuesコールでは、次の応答のスニペッ トに示すように、請求書のCreate_Deliveryアクションのデフォルトに関する 情報が返されます。
...
{
"attributes":{
"type":"Delivery__c"
} } ...
アクションのデフォルト値
アクションのデフォルト値を返すには、/services/data/v37.0/subjects/
object/quickActions/Action_Name/defaultValues/Parent_IDを使用しま す。
Describe Layouts
Global Describe Layouts
リソースは、アクションオブジェクトを含む、オブジェクトのグローバルレイアウト情報を取得するために使用します。このリソースでは、
services/data/v37.0/ sobjects/Global/describe/layouts/形式の
URI
が使 用されます。このリソースへのコールでは、次の応答に示すように、グローバルアクション
(Shipify
キャンバスカスタムアクションを含む) のレイアウト情報が返されます。{
"recordTypeSelectorRequired":[
false ],
"recordTypeMappings":[
],
"layouts":[
{
"relatedLists":[
],
"relatedContent":null,
"detailLayoutSections":[
],
"editLayoutSections":[
],
"multirowEditLayoutSections":[
],
"offlineLinks":[
],
"buttonLayoutSection":null,
"highlightsPanelLayoutSection":null,
"quickActionList":{
"quickActionListItems":[
{
"quickActionName":"Shipify",
"colors":[
],
"miniIconUrl":null,
"targetSobjectType":null,
"iconUrl":null,
"urls":{
"quickAction":"/services/data/v37.0/
quickActions/Shipify",
"describe":"/services/data/v37.0/
quickActions/Shipify/describe"
},
"icons":[
],
"type":"Canvas",
"label":"Shipify"
}, {
"quickActionName":"FeedItem.TextPost",
"colors":[
],
"miniIconUrl":null,
"targetSobjectType":null,
"iconUrl":null,
"urls":{
},
"icons":[
],
"type":"Post",
"label":"Post"
}, {
"quickActionName":"FeedItem.ContentPost",
"colors":[
],
"miniIconUrl":null,
"targetSobjectType":null,
"iconUrl":null,
"urls":{
},
"icons":[
],
"type":"Post",
"label":"File"
}, {
"quickActionName":"NewTask",
"colors":[
{
"color":"44A12C",
"theme":"theme4",
"context":"primary"
}, {
"color":"1797C0",
"theme":"theme3",
"context":"primary"
} ],
"miniIconUrl":"https://instance.
salesforce.com/img/icon/tasks16.png",
"targetSobjectType":"Task",
"iconUrl":"https://instance.
salesforce.com/img/icon/home32.png",
"urls":{
"quickAction":"/services/data/v37.0/
quickActions/NewTask",
"defaultValues":"/services/data/v37.0/
quickActions/NewTask/defaultValues",
"describe":"/services/data/v37.0/
quickActions/NewTask/describe"
},
"icons":[
{
"url":"https://instance.
salesforce.com/img/icon/home32.png",
"height":32,
"theme":"theme3",
"width":32,
"contentType":"image/png"
}, {
"url":"https://instance.
salesforce.com/img/icon/tasks16.png",
"height":16,
"theme":"theme3",
"width":16,
"contentType":"image/png"
}, ...
],
"type":"Create",
"label":"New Task"
}, {
"quickActionName":"NewContact", ...
],
"type":"Create",
"label":"New Contact"
}, ...
"type":"Create",
"label":"New Lead"
}, {
"quickActionName":"FeedItem.LinkPost",
"colors":[
],
"miniIconUrl":null,
"targetSobjectType":null,
"iconUrl":null,
"urls":{
},
"icons":[
],
"type":"Post",
"label":"Link"
}, {
"quickActionName":"FeedItem.PollPost",
"colors":[
],
"miniIconUrl":null,
"targetSobjectType":null,
"iconUrl":null,
"urls":{
},
"icons":[
],
"type":"Post",
"label":"Poll"
} ] },
"id":"00hR0000000MpLAIA0"
} ] }
Describe Layouts
リソースは、アクションオブジェクトを含む、特定のオブジェクトのレイアウトの説明を取得するために使用します。このリソースでは、services/data/
v37.0/sobjects/object/describe/layouts/形式の
URI
が使用されます。インターフェースの拡張
この章では、各種モバイルユーザ向けに
Acme Wireless
組織を 拡張します。このシナリオの場合、Acme Wireless
には、修理 トピック:
• Lightning ページと は?
部品や付属品をすべてまとめて保管する倉庫があります。
各店舗は倉庫に部品を注文し、店内に一定数の商品を用意
• Lightning ページ: 全 体像
しています。在庫のない特殊な部品が必要なときは、店舗 が倉庫に特別注文します。
• Lightning ページの
リリース このガイドの大部分ではモバイル技術者に焦点を当ててき ましたが、今回は倉庫から店舗に在庫を輸送する配送運転
• Lightning ページの
タブ 手に焦点を当てます。現在、運転手はカスタムアプリケー ションを使用して、配送の作成、更新、および追跡を行っ
• Salesforce1 で
Lightning ページを ています。
Salesforce1
に組み込むことができるように、Lightning
ページを使用して、そのアプリケーションのホーム使用できるように
する方法 ページを作成します。こうすることで、運転手は単一のソー スで配送の管理に必要な情報を得られるようになります。
• もうひとこと: Lightning ページ
Lightning ページとは ?
Lightning
ページは、Salesforce1
モバイルアプリケーションまたはLightning Experience
で使用するページを設計できるカスタムレイアウトです。
Lightning
ページは、ページレイアウトとVisualforce
ページの中間に位置します。ページレイアウトと同様、
Lightning
ページではページにカスタム項目を追加できます。ただ し、これらのカスタム項目は、項目やVisualforce
コンポーネントではなくLightning
コン ポーネントであるため、高い柔軟性があります。Lightning
ページを使用して、アプリケーションホームページを作成し、そのページをSalesforce1
ナビゲーションメニューに追加できます。アプリケーションホームページは、モバイルホームページになり、ユーザはこのページを使用して、そのアプリケー ションで最も重要なオブジェクトと項目にすばやくアクセスできます。
さらに、
Lightning
ページXML
でグローバルクイックアクションを指定することで、Lightning
ページにそれらのアクションを割り当てることもできます。ユーザがLightning
ページにアクセスすると、割り当てたすべてのグローバルアクションがページ下部の アクションバーに表示されます。
Lightning ページ
Lightning
ページは、ComponentInstanceを含む範囲のリストで構成されます。ComponentInstance
には、特定のコンポーネントのインスタンスのプロパティ(
インスタンスがどの
Lightning
コンポーネントを参照するかなど)
、およびLightning
コンポーネン トの属性のサブセットを表す名前/
値のペアのセットが含まれます。使用可能な標準 Lightning コンポーネント
一部の
Lightning
コンポーネントはComponentInstance
で指定できません。コンポーネントが許可されている場合でも、そのすべての属性を指定できるとは限りません。現
在、次の
Lightning
コンポーネントがすべての種類のLightning
ページで使用できます。flexipage:filterListCard
リストビューを参照し、そのビューから最初の数レコードを表示します。
flexipage:filterListCardコンポーネントでは、次を除く標準オブジェクト およびカスタムオブジェクトに関連付けられた、すべてのリストビューがサポー トされます。
•
Activity
•
ContentVersion (Files)
•
Task
•
User
•
UserProfile
flexipage:recentItems
指定されたプロパティに基づく、次のオブジェクトをサポートする最近使用した 項目のリストです。
• すべてのカスタムオブジェクト
• 次の両方の条件を満たすすべての標準オブジェクト
– オブジェクトにコンパクトレイアウトが定義されている。
– 最近使用したオブジェクトのリストでオブジェクトが追跡されている。
最近使用したオブジェクトのリストでオブジェクトが追跡されている場合、
LastViewedDateとLastReferencedDateのいずれかまたは両方の項目が表 示されます。
最近使ったデータコンポーネントでは、次のオブジェクトはサポートされていま せん。
•
ContentVersion (Files)
•
User
•
UserProfile
flexipage:reportChart
レポートグラフコンポーネントを使用して、
Lightning
ページにレポートのグラフを 表示します。プロパティ:
•
label:
このプロパティを空白のままにすると、コンポーネントの表示ラベルは、代わりにレポートの表示ラベルから取得されます。
•
reportName:
レポートのAPI
名このコンポーネントは、
API
バージョン32.0
以降でサポートされています。このコ ンポーネントは、[
私の非公開カスタムレポート]
フォルダにあるレポートでは機能 しません。レポートをパッケージに含めると、[
未整理公開レポート]
フォルダ内の レポートを参照するレポートグラフコンポーネントはリリースできません。flexipage:richText
リッチテキストコンポーネントを使用して、テキストやシンプルな
HTML
マークアップを
Lightning
ページに追加します。プロパティ
:
•
richTextValue:
表示するHTML
またはテキストメモ: JavaScript、
CSS
、iframe
、およびその他の高度なマークアップは、サポートされていません。高度な
HTML
要素をコンポーネントで使用する場合は、
Visualforce
ページコンポーネントまたはカスタムLightning
コンポーネントを使用することをお勧めします。
リッチテキストコンポーネントは
4,000
文字までに制限されます。このコンポーネ ントは、API
バージョン32.0
以降でサポートされています。flexipage:tab
タブコンポーネントを使用して
Lightning
ページの範囲にタブセットを追加します。標準タブセットから選択するか、カスタムタブを作成して、