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 ファイルを生成する

次の例では、PDF 関数をボタンの OnSelect プロパティで使用して、PDF ファイルを生成します。 PDF 関数は、OnVisible、OnHidden、またはその他の動作プロパティでも使用可能です。

既存のボタンを選択するか、キャンバスアプリに新しいボタンを追加します。
ボタンの OnSelect プロパティに PDF 関数を追加し、パラメータとして PDF 関数のターゲットを入力します。次の式を入力します: PDF(SubmitInspectionScreen);

この例では、画面 SubmitInspectionScreen をターゲットにして、サンプルアプリの検査画面の内容から PDF ファイルを生成します。それをアプリの画面の名前に置き換えます。
保存して公開 を選択します。

アプリを再生し、追加するボタンを選択します。 PDF ファイルが生成され、今後使用するためにメモリに保存されます。次のセクションでは、アプリで PDF ファイルを扱うための方法をいくつか提案します。

PDF 関数は、現在表示されている画面のみを対象にすることができます。この例のように画面全体を渡すことも、さらにパラメータを入力してコンテナーまたはギャラリーを指定し、渡すコンテンツを制限することもできます。

生成された PDF ファイルで作業する

生成された PDF ファイルは、さまざまな方法で使用できます。前のセクションの例を使用して、いくつかを次に示します。

PDF ビューア― コントロールを使用してファイルを表示する

キャンバスアプリで、前の例で作成したボタンを選択するか、新しいボタンを追加します。
ボタンの OnSelect プロパティに次の式を入力し、SubmitInspectionScreen をアプリの画面の名前に置き換えます: Set(myPDF, PDF(SubmitInspectionScreen));
挿入 > PDF viewer (試験段階) を選択します。
プロパティリストから、ドキュメント プロパティを選択して、数式バーから 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 機能 (実験的)