Lightning コンポーネント開発者ガイド
jLightning for Outlook および Lightning for Gmail のカスタムコンポーネントのサンプル
Lightning for Outlook および Lightning for Gmail のメールアプリケーションペインに実装できるカスタムの Lightning コンポーネントのサンプルを見ていきます。
以下に、Lightning for Outlook および Lightning for Gmail のメールアプリケーションペインに搭載できるカスタム Lightning コンポーネントの例を示します。このコンポーネントは、選択したメールまたは予約のコンテキストを利用します。
1<aura:component implements="clients:availableForMailAppAppPage,clients:hasItemContext">
2
3<!--
4 Add these handlers to customize what happens when the attributes change
5 <aura:handler name="change" value="{!v.subject}" action="{!c.handleSubjectChange}" />
6 <aura:handler name="change" value="{!v.people}" action="{!c.handlePeopleChange}" />
7-->
8
9 <div id="content">
10 <aura:if isTrue="{!v.mode == 'edit'}">
11 You are composing the following Item: <br/>
12 <aura:set attribute="else">
13 You are reading the following Item: <br/>
14 </aura:set>
15 </aura:if>
16
17 <h1><b>Email subject</b></h1>
18 <span id="subject">{!v.subject}</span>
19
20 <h1>To:</h1>
21 <aura:iteration items="{!v.people.to}" var="to">
22 {!to.name} - {!to.email} <br/>
23 </aura:iteration>
24
25 <h1>From:</h1>
26 {!v.people.from.name} - {!v.people.from.email}
27
28 <h1>CC:</h1>
29 <aura:iteration items="{!v.people.cc}" var="cc">
30 {!cc.name} - {!cc.email} <br/>
31 </aura:iteration>
32
33 <span class="greeting">New Email Arrived</span>, {!v.subject}!
34 </div>
35</aura:component>この例では、カスタムコンポーネントに、メール受信者のメールアドレスに基づく取引先および商談情報が表示され��す。このコンポーネントは、初期化時に JavaScript コントローラ関数の handlePeopleChange() をコールします。JavaScript コントローラは、Apex サーバ側コントローラのメソッドをコールして、情報を照会し、取引先の対応期間および商談が完了するまでの日数を計算します。以下に、Apex コントローラ、JavaScript コントローラ、ヘルバーを示します。
1<!--
2This component handles the email context on initialization.
3It retrieves accounts and opportunities based on the email addresses included
4in the email recipients list.
5It then calculates the account and opportunity ages based on when the accounts
6were created and when the opportunities will close.
7-->
8
9<aura:component
10 implements="clients:availableForMailAppAppPage,clients:hasItemContext"
11 controller="ComponentController">
12
13 <aura:handler name="init" value="{!this}" action="{!c.handlePeopleChange}" />
14 <aura:attribute name="accounts" type="List" />
15 <aura:attribute name="opportunities" type="List" />
16 <aura:iteration items="{!v.accounts}" var="acc">
17 {!acc.name} => {!acc.age}
18 </aura:iteration>
19 <aura:iteration items="{!v.opportunities}" var="opp">
20 {!opp.name} => {!opp.closesIn} Days till closing
21 </aura:iteration>
22
23</aura:component>1/*
2On the server side, the Apex controller includes
3Aura-enabled methods that accept a list of emails as parameters.
4*/
5
6public class ComponentController {
7 /*
8 This method searches for Contacts with matching emails in the email list,
9 and includes Account information in the fields. Then, it filters the
10 information to return a list of objects to use on the client side.
11 */
12 @AuraEnabled
13 public static List<Map<String, Object>> findAccountAges(List<String> emails) {
14 List<Map<String, Object>> ret = new List<Map<String, Object>>();
15 List<Contact> contacts = [SELECT Name, Account.Name, Account.CreatedDate
16 FROM Contact
17 WHERE Contact.Email IN :emails];
18 for (Contact c: contacts) {
19 Map<String, Object> item = new Map<String, Object>();
20 item.put('name', c.Account.Name);
21 item.put('age',
22 Date.valueOf(c.Account.CreatedDate).daysBetween(
23 System.Date.today()));
24 ret.add(item);
25 }
26 return ret;
27}
28
29 /*
30 This method searches for OpportunityContactRoles with matching emails
31 in the email list.
32 Then, it calculates the number of days until closing to return a list
33 of objects to use on the client side.
34 */
35 @AuraEnabled
36 public static List<Map<String, Object>> findOpportunityCloseDateTime(List<String> emails) {
37 List<Map<String, Object>> ret = new List<Map<String, Object>>();
38 List<OpportunityContactRole> contacts =
39 [SELECT Opportunity.Name, Opportunity.CloseDate
40 FROM OpportunityContactRole
41 WHERE isPrimary=true AND Contact.Email IN :emails];
42 for (OpportunityContactRole c: contacts) {
43 Map<String, Object> item = new Map<String, Object>();
44 item.put('name', c.Opportunity.Name);
45 item.put('closesIn',
46 System.Date.today().daysBetween(
47 Date.valueOf(c.Opportunity.CloseDate)));
48 ret.add(item);
49 }
50 return ret;
51 }
52}1({
2/*
3This JavaScript controller is called on component initialization and relies
4on the helper functionality to build a list of email addresses from the
5available people. It then makes a caller to the server to run the actions to
6display information.
7Once the server returns the values, it sets the appropriate values to display
8on the client side.
9*/
10 handlePeopleChange: function(component, event, helper){
11 var people = component.get("v.people");
12 var peopleEmails = helper.filterEmails(people);
13 var action = component.get("c.findOpportunityCloseDateTime");
14 action.setParam("emails", peopleEmails);
15
16 action.setCallback(this, function(response){
17 var state = response.getState();
18 if(state === "SUCCESS"){
19 component.set("v.opportunities", response.getReturnValue());
20 } else{
21 component.set("v.opportunities",[]);
22 }
23});
24 $A.enqueueAction(action);
25 var action = component.get("c.findAccountAges");
26 action.setParam("emails", peopleEmails);
27
28 action.setCallback(this, function(response){
29 var state = response.getState();
30 if(state === "SUCCESS"){
31 component.set("v.accounts", response.getReturnValue());
32 } else{
33 component.set("v.accounts",[]);
34 }
35});
36$A.enqueueAction(action);
37}
38})1({
2 /*
3 This helper function filters emails from objects.
4 */
5 filterEmails : function(people){
6 return this.getEmailsFromList(people.to).concat(
7 this.getEmailsFromList(people.cc));
8 },
9
10 getEmailsFromList : function(list){
11 var ret = [];
12 for (var i in list) {
13 ret.push(list[i].email);
14 }
15 return ret;
16 }
17})