使用 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 查看器（试验）。
从属性列表中，选择 Document 属性，然后在公式栏中输入 myPDF。
选择保存并发布。

播放应用并选择您添加的按钮。将生成 PDF 文件，存储在变量 myPDF 中，在 PDF 查看器控件中可见。

PDF 查看器控件在生成的 PDF 文件中显示为黑色形状。要从生成的文件中排除此控件，将要转换为 PDF 文件的内容放在容器或库中，并将其作为目标，而不是以屏幕为目标；例如，PDF(Container1) 或 PDF(Gallery1).

使用操作连接器

在此示例中，我们生成了一个 PDF 文件，并使用 Office 365 Outlook 连接器将其作为电子邮件附件发送。

在您的画布应用中，选择在前面示例中创建的按钮或添加新按钮。

在按钮的 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 文件，并将其传递到 Power Automate 流，该流使用 SharePoint 连接器将文件存储在文档库中。此示例将 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 函数（试验）

通过