使用 PDF 功能 (實驗性)

Power Apps 中的 PDF 函數會從畫面或特定類型的控制項的內容產生 PDF 文件。 您可以將產生的檔案傳遞至動作連接器 (例如,使用 Office 365 Outlook 連接器在電子郵件中傳送),或作為自動化案例的一部分傳遞至 Power Automate 流程。

這很重要

開啟PDF功能

由於 PDF 功能是一項實驗性功能,因此預設情況下會關閉。 要在您的應用程序中使用它,您需要手動打開它。

  1. 登入 Power Apps建立畫布應用程式 或開啟現有應用程式。

  2. 在 Power Apps Studio 的命令列上,選取設定。

  3. 選取 [即將推出的功能]。

  4. [實驗] 索引標籤上,開啟 PDF 功能

使用 PDF 函數產生 PDF 檔案

在下列範例中,我們會在按鈕的屬性中使用 OnSelect PDF 函數來產生 PDF 檔案。 您也可以在OnVisibleOnHidden或任何其他行為屬性中使用PDF函數。

  1. 選取現有的按鈕,或將新按鈕新增至畫布應用程式。

  2. 在按鈕的 OnSelect 屬性中,新增PDF函數,並輸入函數的目標作為參數。 輸入公式: PDF(SubmitInspectionScreen);

    在此範例中,我們以螢幕 SubmitInspectionScreen 為目標,以從範例應用程式的檢查畫面內容產生 PDF 檔案。 將其替換為應用程式中的螢幕名稱。

    將 PDF 函式新增至按鈕的 OnSelect 屬性的螢幕擷取畫面。

  3. 選取儲存並發佈。

播放應用程式並選擇您新增的按鈕。 PDF 檔案會產生並儲存在記憶體中以供將來使用。 下一節建議在應用程式中使用 PDF 檔案的幾種方法。

PDF 功能只能以目前可見的螢幕為目標。 您可以傳遞整個畫面,如我們的範例所示,或輸入 更多參數 來指定容器或資源庫,以限制要傳遞的內容。

與生成的 PDF 文件合作

您可以透過多種方式使用產生的 PDF 檔案。 以下是一些,使用上一節中的範例。

使用 PDF 檢視器控制項檢視檔案

  1. 在您的畫布應用程式中,選取您在上一個範例中建立的按鈕,或新增按鈕。

  2. 在按鈕的 OnSelect 屬性中,輸入下列公式,並取代 SubmitInspectionScreen 為應用程式中的畫面名稱: Set(myPDF, PDF(SubmitInspectionScreen));

    在畫布應用程式中設定按鈕的 OnSelect 屬性的螢幕擷取畫面。

  3. 選取 插入>PDF檢視器 (實驗性)。

  4. 屬性清單中,選取 [文件] 屬性,然後在編輯列中輸入 myPDF

    在畫布應用程式中設定按鈕的 [文件] 屬性的螢幕擷取畫面。

  5. 選取儲存並發佈。

播放應用程式並選擇您新增的按鈕。 PDF 檔案會產生、儲存在變數 myPDF中,並在 PDF 檢視器控制項中可見。

PDF 檢視器控制項會在產生的 PDF 檔案內顯示為黑色形狀。 若要從產生的檔案中排除控制項,請將您要轉換為 PDF 檔案的內容放在容器或圖庫內,並以該檔案為目標,而不是螢幕;例如,PDF(Container1)PDF(Gallery1).

使用動作連接器

在此範例中,我們會產生 PDF 檔案,並使用 Office 365 Outlook 連接器以電子郵件附件的形式傳送。

  1. 在您的畫布應用程式中,選取您在上一個範例中建立的按鈕,或新增按鈕。

  2. 在按鈕的 OnSelect 屬性中,輸入下列公式:

    Office365Outlook.SendEmailV2( 
       "sample@email.com", 
        "New Safety Inspection" 
        "A new safety inspection has been submitted for your review. Please see attached.", 
        { 
            Attachments: Table( 
                 { 
                     Name: "submittedInspection.pdf", 
                     ContentBytes: PDF(SubmitInspectionScreen) 
                 } 
             ) 
        } 
     ); 
    

    新增至按鈕 OnSelect 屬性的電子郵件螢幕擷取畫面。

  3. 選取儲存並發佈。

播放應用程式並選擇您新增的按鈕。 生成 PDF 文件,並將電子郵件發送到指定的電子郵件地址,並附加生成的 PDF 文件。

在 Power Automate 流程中使用

在此範例中,我們會產生 PDF 檔案,並將其傳遞至 Power Automate 流程,該流程使用 SharePoint 連接器將檔案儲存在文件庫中。 此範例會將 Power Automate 中的預設 PowerApps 觸發程序取代為 PowerApps (V2) 觸發程序。

建立要在應用程式中使用的流程

  1. 在您的畫布應用程式中,選取您在上一個範例中建立的按鈕,或新增按鈕。

  2. 應用程式撰寫功能表中,選取 Power Automate 建立>新流程

  3. 選擇 從空白建立

  4. 若要刪除預設的 PowerApps 觸發程序,請選取觸發程序功能表 (...),然後選取 [刪除]。

    刪除 Power Automate 流程中預設 PowerApps 觸發程序的螢幕擷取畫面。

  5. 搜尋並選取 PowerApps (V2)。

    選取 PowerApps (V2) 觸發程序的螢幕擷取畫面。

  6. 選取 PowerApps V2 觸發程序以展開節點,然後選取 [ 新增輸入]。

    PowerApps(V2)觸發節點新增輸入的截圖。

  7. 選取 [檔案 ] 作為使用者輸入的類型。

  8. 再次選取 新增輸入 ,然後選取 文字作為 使用者輸入的類型。

  9. 重新命名輸入的 檔案名稱 ,並將描述變更為請 輸入檔案名稱

    PowerApps (V2) 觸發節點中兩個使用者輸入的螢幕擷取畫面。

將 SharePoint 連接器新增至流程

  1. 選取 新增步驟 以新增動作。 搜尋 SharePoint 並選取 建立檔案

    將 SharePoint 建立檔案連接器新增至流程的螢幕擷取畫面。

  2. [網站位址] 中,選取您有權新增檔案的 SharePoint 網站。

  3. [資料夾路徑] 中,選取您有權新增檔案的文件庫。

  4. 選取 檔案名稱 輸入。 在 [動態內容] 索引標籤中,選取 PowerApps (V2) 底下的檔案名稱。

  5. 選取 [檔案內容 ] 輸入,然後選取清單中的 [ 檔案內容 ]。

    使用 SharePoint 建立檔案連接器選取要儲存的檔案的螢幕擷取畫面。

  6. 選取儲存,然後選取右上角的 x 以關閉 Power Automate 視窗。

  7. Power Automate 窗格會重新整理,新的 PowerApps (V2) 流程 [ 建立檔案] 會出現在清單中。

    Power Automate 清單中的流程螢幕擷取畫面。

將流程新增至應用程式中的按鈕

  1. 選取應用程式畫布中的按鈕。 在按鈕的 OnSelect 屬性中,輸入下列公式,將流程名稱及生成的 PDF 檔案名稱替換成您自己的名稱:

    'PowerAppV2->Createfile'.Run( 
       "NewInspectionReport.pdf", 
        {         
           file: { 
                name: "NewInspectionReport.pdf", 
                contentBytes: PDF(InspectionDetails) 
            }               
        } 
    );  
    

    已新增至按鈕 OnSelect 屬性之流程的螢幕擷取畫面。

  2. 選取儲存並發佈。

播放應用程式並選擇您新增的按鈕。 Power Automate 流程會執行,並將產生的 PDF 檔案新增至文件庫。

另請參閱

Power Apps 中的 PDF 函式 (實驗性)