在Visualforce頁面中使用Visual Flow

在本文中,我們將通過一個示例說明如何將“流”(Visual Flow)用于Visualforce頁面。

更全面的知識可以參考官方文檔

創建流

我們要創建一個流,它的作用是得到一個“客戶”(Account)變量,然后根據其中的自定義字段“是否破產”(Bankrupt__c)來決定是否在客戶名稱后面加上“已破產”的字樣。

步驟如下:

  1. 在新的流中創建一個“SObject對象變量”,這個變量會用于存儲“客戶”對象的信息
新建客戶變量
  1. 創建一個“決策”元素,在其中檢查剛才建立的客戶變量的“是否破產”字段值
檢查是否破產
  1. 創建一個“分配”元素,和上一步“決策”變量中“已破產”的結果相連接,在其中將客戶變量的名稱字段后面加上“已破產”字樣
更新客戶名稱
  1. 創建一個“快速更新”元素,更新客戶變量
更新客戶變量

完成后的流程圖如下:

流程圖

保存為“流”類型,設置名稱為“Check_and_update_bankrupt”,并啟用該流。

這時,我們還不能使用它,因為這個流在使用前需要先得到一個“客戶”對象。要實現這一點,就需要使用一個Visualforce頁面來加載“客戶”對象并調用流。

創建Visualforce頁面

要將創建的“流”使用于Visualforce頁面中,可以使用以下步驟:

  1. 在“設置”界面搜索“Visualforce 頁面”,點擊“Visualforce 頁面”鏈接,進入Visualforce頁面的一覽表

  2. 點擊“新建”按鈕,新建Visualforce頁面

  3. 設置“標簽”和“名稱”屬性。設置名稱為“Check_Bankrupt_And_Update_Name”

  4. 在“Visualforce Markup”部分刪除原有的代碼,改為:

<apex:page StandardController="Account">
  <flow:interview name="Check_and_update_bankrupt"></flow:interview>
</apex:page>
  1. 這里使用了“flow:interview”組件調用了剛才建立的“流”,并且將頁面的“StandardController”屬性設置為“Account”,標明該頁面和“客戶”對象相聯系

  2. 保存此Visualforce頁面

Visualforce頁面的建立

建立按鈕調用Visualforce頁面

在“客戶”的“按鈕、鏈接和操作”部分,新建一個按鈕,并將“內容源”設置為“Visualforce頁面”。

系統會自動檢測所有的Visualforce頁面,并在下拉列表中顯示“StandardController”屬性為“Account”的頁面。

在下拉列表中選擇剛才建立的頁面,保存。

連接Visualforce頁面到按鈕

然后將此按鈕添加到“客戶”的頁面布局。

將按鈕添加到頁面布局

這樣,用戶在客戶的詳細信息頁面點擊“檢查破產并更新名稱”按鈕,就可以使用流了。

將參數傳入流

現在還差最后一步工作,就是將按鈕所在的客戶頁面的客戶變量傳入流中,讓流知道哪個“客戶”對象需要被檢查和更新。

編輯剛才建立的Visualforce頁面,在“flow:interview”組件中進行如下修改:

<apex:page StandardController="Account">
  <flow:interview name="Check_and_update_bankrupt">
      <apex:param name="AccountVar" value="{!account}"/>
  </flow:interview>
</apex:page>

從上面的代碼中可以看到,我們使用了“apex:param”標簽來設置流中使用的變量“AccountVar”。

但是這時,如果在客戶頁面中點擊剛才建立的按鈕,會直接出現錯誤。當我們檢查調試日志時,會發現這樣的錯誤信息:“流無法訪問AccountVar.Bankrupt__c的值”。

這是因為我們在Visualforce頁面中通過標準的“Account”控制器傳入參數時,標準的控制器并不會調用“客戶”對象下面的字段,從而無法檢查“Bankrupt__c”的值。

這時,我們需要新建一個Apex類,作為標準“Account”控制器的擴展,在其中要求系統調用“Name”和“Bankrupt__c”字段的值。新建的Apex類如下:

public class AccountCheckBankruptExtension {
    private final Account acc;
    
    public AccountCheckBankruptExtension(ApexPages.StandardController stdController) {
        stdController.addFields(new List<String>{'Name', 'Bankrupt__c'});
        this.acc = (Account)stdController.getRecord();
    }
}

然后將剛才的Visualforce頁面修改為:

<apex:page StandardController="Account" Extensions="AccountCheckBankruptExtension">
  <flow:interview name="Check_and_update_bankrupt">
      <apex:param name="AccountVar" value="{!account}"/>
  </flow:interview>
</apex:page>

這時,在“是否破產”值為“真”的客戶頁面點擊“檢查破產并更新名稱”按鈕,就可以運行流了。

設置返回跳轉鏈接

雖然流可以順利運行了,但是流的執行是在新的窗口中執行,結束后會給出“流執行完畢”的字樣。為了提高用戶體驗,我們需要讓流在運行結束后返回處理的“客戶”頁面,從而直接將結果展示為用戶。

將剛才的Visualforce頁面修改為:

<apex:page StandardController="Account" Extensions="AccountCheckBankruptExtension">
  <flow:interview name="Check_and_update_bankrupt" finishLocation="{!URLFOR('/' + account.Id)}">
      <apex:param name="AccountVar" value="{!account}"/>
  </flow:interview>
</apex:page>

在這里,我們使用了“finishLocation”屬性來設置流完成后跳轉的頁面,即跳轉到“客戶”變量詳細信息頁面。

執行結果

現在我們就可以檢查整個過程了。

首先,進入一個客戶的詳細信息頁面,將“是否破產”改為“真”。

將“是否破產”改為“真”

然后點擊“檢查破產并更新名稱”按鈕,會彈出一個新的頁面。這就是剛才建立的Visualforce頁面。在其中,流將會被執行。結束后,跳轉到剛才的客戶頁面。

流的執行結果

可以看到,“客戶”的“名稱”部分已經被加入了“(已破產)”的字樣。流執行成功了。

擴展知識

流的變量設定

在流中新建“SObject變量”時,需要將變量的“輸入/輸出類型”設置為“輸入和輸出”。否則,此變量有可能無法被Visualforce頁面和相應的控制器調用。

在Apex代碼中使用Flow.Interview類

在Apex代碼中使用Flow.Interview類可以直接引用執行的流的實例,并且可以使用getVariableValue()函數來得到流中的變量的值。

比如上述的示例中,將Apex代碼改為:

public class AccountCheckBankruptExtension {
    public Flow.Interview.Check_and_update_bankrupt flowInstance {get; set;}
    
    private final Account acc;
    
    public AccountCheckBankruptExtension(ApexPages.StandardController stdController) {
        stdController.addFields(new List<String>{'Name', 'Bankrupt__c'});
        this.acc = (Account)stdController.getRecord();
    }

    public String getAccName() {
        Account accInFlow = (Account) flowInstance.getVariableValue('AccountVar');
        return accInFlow.Name;
    }
}

在代碼中增加了一個變量“flowInstance”,類型是“Flow.Interview.流的名字”。同時也增加了一個函數getAccName(),使用了getVariableValue()函數得到流中的“客戶”變量的名稱。

將Visualforce頁面的代碼改為:

<apex:page StandardController="Account" Extensions="AccountCheckBankruptExtension">
  <flow:interview name="Check_and_update_bankrupt" interview="{!flowInstance}">
      <apex:param name="AccountVar" value="{!account}"/>
  </flow:interview>
  
  <apex:outputtext>客戶名稱:{!accName}</apex:outputtext>
</apex:page>

這樣,我們成功的得到了客戶的名稱,顯示在頁面底部。

流的執行結果,顯示了客戶名稱
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 227,967評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,273評論 3 415
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 175,870評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,742評論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,527評論 6 407
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,010評論 1 322
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,108評論 3 440
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,250評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,769評論 1 333
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,656評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,853評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,371評論 5 358
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,103評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,472評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,717評論 1 281
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,487評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,815評論 2 372

推薦閱讀更多精彩內容

  • Visual Flow(流) Salesforce提供了幾種自動化流程工具,其中的Visual Flow(流)可以...
    程程哥閱讀 955評論 0 1
  • 1. Java基礎部分 基礎部分的順序:基本語法,類相關的語法,內部類的語法,繼承相關的語法,異常的語法,線程的語...
    子非魚_t_閱讀 31,710評論 18 399
  • Swift版本點擊這里歡迎加入QQ群交流: 594119878最新更新日期:18-09-17 About A cu...
    ylgwhyh閱讀 25,471評論 7 249
  • 就像掘墓一樣,身體被挖空,詩消失了 靈感與火熊熊的燃著,我無法靠近 待火熄滅以后,一片廢墟里 走出一個狼藉的詩人,...
    鹿原先生和蓬蒿閱讀 317評論 0 6
  • 崔健、周國平,兩個深邃的男人同框,連書封都深沉起來。 搖滾與哲學,精神世界對飚的兩極。前者是火山、海嘯、龍卷風,后...
    郭爾同學閱讀 154評論 0 0