使用 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 文件。 将它替换为您的应用中屏幕的名称。

    向按钮的 OnSelect 属性添加 PDF 函数的屏幕截图。

  3. 选择保存并发布

播放应用并选择您添加的按钮。 将生成 PDF 文件并将其存储在内存中供将来使用。 后面一节中建议了一些在应用中使用 PDF 文件的方法。

PDF 函数只能将当前可见的屏幕作为目标。 您可以传递整个屏幕,如我们的示例所示,或者输入更多参数指定容器或库来限制要传递的内容。

使用生成的 PDF 文件

您可以通过多种方式使用生成的 PDF 文件。 以下是一些方式,使用的是上一节中的示例。

使用 PDF 查看器 控件查看文件

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

  2. 在按钮的 OnSelect 属性中,输入以下公式,将 SubmitInspectionScreen 替换为您应用中的屏幕的名称:Set(myPDF, PDF(SubmitInspectionScreen));

    在画布应用中设置按钮的 OnSelect 属性的屏幕截图。

  3. 选择插入 > PDF 查看器(试验)

  4. 属性列表中,选择 Document 属性,然后在公式栏中输入 myPDF

    在画布应用中设置按钮的 Document 属性的屏幕截图。

  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 函数(试验)