使用 PDF 功能 (實驗性)

2023-04-18

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

重要

這是實驗性功能。實驗性功能不供生產時使用，而且可能功能受限。這些功能是在正式發行前先行推出，讓客戶能夠搶先體驗並提供意見反應。了解畫布應用程式中的實驗性、預覽及已取代功能。
您必須在設定 > 即將推出的功能 > 實驗性中開啟 PDF 函數。做為實驗性功能，預設會停用。
在 Power Apps 實驗性功能社群論壇中發送您的意見反饋。

開啟 PDF 函數

由於 PDF 函數是實驗性功能，預設會關閉此功能。若要在應用程式中使用該功能，您必須手動將其開啟。

登入 Power Apps，並建立畫布應用程式或開啟現有的應用程式。
在 Power Apps Studio 中，選取命令列上的設定。
選擇 即將推出的功能。
在 實驗性 索引標籤上，開啟 PDF 函數。

使用 PDF 函數來產生 PDF 檔案

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

選擇現有按鈕或將新按鈕新增到您的畫布應用程式。
在按鈕的 OnSelect 屬性中，新增 PDF 函數，並輸入函數的目標做為參數。輸入公式：PDF(SubmitInspectionScreen);

在此範例中，我們以畫面 SubmitInspectionScreen 為目標，從範例應用程式的 [檢驗] 畫面的內容產生 PDF 檔案。將其取代為應用程式中畫面的名稱。
選取儲存並發佈。

播放應用程式，並選取您新增的按鈕。 PDF 檔案已產生，並儲存在記憶體中供日後使用。下列各節建議幾個在應用程式中使用 PDF 檔案的方式。

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

使用產生的 PDF 檔案

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

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

在畫布應用程式中，選取您在上一個範例中建立的按鈕，或新增新的按鈕。
在按鈕的 OnSelect 屬性中，輸入下列公式，並將 SubmitInspectionScreen 取代為應用程式中畫面的名稱：Set(myPDF, PDF(SubmitInspectionScreen));
選取插入 > PDF 檢視器 (實驗性)。
從屬性列表中，選擇文件屬性，然後在公式欄中輸入 myPDF。
選取儲存並發佈。

播放應用程式，並選取您新增的按鈕。 PDF 檔案已產生、儲存在變數 myPDF 中，並顯示在 PDF 閱讀器控制項中。

PDF 閱讀器控制項會在產生的 PDF 檔案中顯示為黑色圖形。若要從產生的檔案中排除控制項，請將您要轉換成 PDF 檔案的內容置入容器或資源庫中，並以之替代畫面為目標；例如，PDF(Container1) 或 PDF(Gallery1).

使用動作連接器

在此範例中，我們使用 Office 365 Outlook 連接器產生一個當做電子郵件附件傳送的 PDF 檔案。

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

在按鈕的 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) 
             } 
         ) 
    } 
 );

選取儲存並發佈。

播放應用程式，並選取您新增的按鈕。 PDF 檔案已產生，且附加所產生 PDF 檔案的電子郵件已傳送至指定的電子郵件地址。

在 Power Automate 流程中使用

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

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

在畫布應用程式中，選取您在上一個範例中建立的按鈕，或新增新的按鈕。
在應用程式製作功能表中，選取 Power Automate > 建立新流程。
選取從空白建立。
若要刪除預設 PowerApps 觸發程序，請選取觸發程序功能表 (…)，然後選取刪除。
搜尋並選取 PowerApps (V2)。
選取 PowerApps V2 觸發程序以展開節點，然後選取新增輸入。
選取檔案做為使用者輸入的類型。
再次選取新增輸入，然後選取文字做為使用者輸入的類型。
將輸入重新命名為檔案名稱，並將描述變更為請輸入檔案的名稱。

將 SharePoint 連接器新增至流程

選取新增步驟以新增動作。搜尋 SharePoint，並選取建立檔案。
在網站位址中，選取您有權限將檔案新增到的 SharePoint 網站。
在資料夾路徑中，選取您有權限將檔案新增到的文件庫。
選取檔案名稱輸入。在動態內容索引標籤中，選取 PowerApps (V2) 下的檔案名稱。
選取檔案內容輸入，然後從清單選取檔案內容。
選取儲存，然後選取右上角的 x 以關閉 Power Automate 視窗。
Power Automate 窗格會重新整理，而新的 PowerApps (V2) 流程建立檔案會出現在清單中。

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

選取畫布應用程式中的按鈕。在按鈕的 OnSelect 屬性中，輸入下列公式，並將流程名稱以及產生的 PDF 檔案名稱取代為您自己的：

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

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

選取儲存並發佈。

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

另請參閱

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

共用方式為