Praca z funkcją PDF (funkcja eksperymentalna)

Funkcja PDF w Power Apps umożliwia wygenerowanie dokumentu PDF na podstawie zawartości ekranu lub określonych typów kontrolek. Wygenerowany plik można przekazać do łącznika akcji — na przykład w celu wysłania go w wiadomości e-mail Office 365 przy użyciu łącznika programu Outlook — lub przepływu Power Automate w ramach scenariusza automatyzacji.

Ważne

• To jest funkcja objęta programem eksperymentalnym. Funkcje w wersji eksperymentalnej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu klienci mogą szybciej uzyskać do nich dostęp i przekazać opinie na ich temat. Zrozumienie eksperymentalnych, podglądowych i wycofanych funkcji w aplikacjach kanwy.
• Funkcję PDF należy włączyć w  Ustawienia > Przyszłe funkcje > Eksperymentalne. Ponieważ jest to funkcja eksperymentalna, jest ona domyślnie wyłączona.
• Wyślij swoją opinię na forum społeczności eksperymentalnych funkcji usługi Power Apps.

Włącz funkcję PDF

Ponieważ funkcja PDF to funkcja eksperymentalna, jest ona domyślnie wyłączona. Aby używać jej w aplikacjach, należy ją włączyć ręcznie.

1. Zaloguj się do Power Apps i utwórz aplikację kanwy lub otwórz istniejącą aplikację.

2. W Power Apps Studio na pasku poleceń wybierz Ustawienia.

3. Wybierz pozycję Nadchodzące funkcje.

4. Na karcie Konwersja włącz funkcję PDF.

Generowanie pliku PDF za pomocą pliku PDF

W poniższym przykładzie do wygenerowania pliku PDF użyjemy we właściwości OnSelect. Zamiast tego można również funkcji PDF w OnVisible, OnHidden lub innej właściwości zachowania.

1. Wybierz istniejący przycisk lub dodaj nowy przycisk do aplikacji kanwy.

2. We właściwości OnSelect przycisku dodaj funkcję PDF i wprowadź wartość docelową funkcji jako parametr. Wprowadzanie formuły: PDF(SubmitInspectionScreen);

   W tym przykładzie na ekranie SubmitInspectionScreen naszym głównym celem jest wygenerowanie pliku PDF z zawartości ekranu inspekcji przykładowej aplikacji. Zastąp go nazwą ekranu w aplikacji.

   

3. Wybierz Zapisz i opublikuj.

Odtwórz aplikację i wybierz dodany przycisk. Plik PDF zostanie wygenerowany i zapisany w pamięci, aby można go było użyć w przyszłości. W poniższej sekcji przedstawiono kilka sposobów pracy z plikiem PDF w aplikacji.

Funkcja PDF może dotyczyć tylko widocznej zawartości ekranu. Możesz przekazać cały ekran, tak jak w naszym przykładzie, lub wprowadzić więcej parametrów w celu określenia kontenera lub galerii, aby ograniczyć zawartość do przekazania.

Praca z wygenerowanym plikiem PDF

Wygenerowany plik PDF może być użyty na wiele sposobów. Oto kilka z nich, korzystając z przykładu z poprzedniej sekcji.

Wyświetlanie pliku za pomocą formantu przeglądarki plików PDF

1. W aplikacji kanwy wybierz przycisk utworzony w poprzednim przykładzie lub dodaj nowy przycisk.

2. W właściwości przycisku OnSelect wprowadź następujący formułę, zastępując SubmitInspectionScreen nazwą ekranu w aplikacji: Set(myPDF, PDF(SubmitInspectionScreen));

   

3. Wybierz opcję Wstaw > Przeglądarkę plików PDF (eksperymentalna).

4. Z listy właściwości właściwość Document i wprowadź myPDF na pasku formuł.

   

5. Wybierz Zapisz i opublikuj.

Odtwórz aplikację i wybierz dodany przycisk. Plik PDF jest generowany, zapisywany w zmiennej myPDF i widoczny w kontrolce przeglądarki plików PDF.

Kontrolka przeglądarki plików PDF wyświetla się w wygenerowanym pliku PDF jako czarny kształt. Aby wykluczyć formant z wygenerowanego pliku, umieść treść, którą chcesz zamienić w plik PDF, w kontenerze lub galerii i w celu docelowym, a nie na ekranie. na przykład PDF(Container1) lub PDF(Gallery1).

Korzystanie z łącznika akcji

W tym przykładzie jest generowany plik PDF przesyłany przez nas jako załącznik do wiadomości e-mail przy użyciu łącznika programu Office 365 Outlook.

1. W aplikacji kanwy wybierz przycisk utworzony w poprzednim przykładzie lub dodaj nowy przycisk.

2. We właściwości OnSelect przycisku wprowadź następującą formułę:

   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) 
                } 
            ) 
       } 
    ); 
   

   

3. Wybierz Zapisz i opublikuj.

Odtwórz aplikację i wybierz dodany przycisk. Zostanie wygenerowany plik PDF, a wiadomość e-mail jest wysyłana na podany adres e-mail z dołączonym plikiem PDF.

Użyj w przepływie Power Automate

W tym przykładzie wygenerowano plik PDF i przekazano go do przepływu Power Automate, w którym jest przechowywany plik w bibliotece dokumentu z użyciem łącznika SharePoint. W tym przykładzie domyślny wyzwalacz PowerApps w Power Automate jest zastępowany przez wyzwalacz PowerApps (V2).

Tworzenie przepływu do użycia w aplikacji

1. W aplikacji kanwy wybierz przycisk utworzony w poprzednim przykładzie lub dodaj nowy przycisk.

2. W menu tworzenia aplikacji wybierz pozycję Power Automate > Utwórz nowy przepływ.

3. Wybierz pozycję Utwórz z pustego.

4. Aby usunąć domyślny wyzwolenie PowerApps, wybierz menu wyzwalacza (…), a następnie wybierz polecenie Usuń.

   

5. Wyszukaj i wybierz PowerApps (V2).

   

6. Wybierz wyzwalacz PowerApps V2, aby rozwinąć węzeł, a następnie wybierz opcję Dodaj dane wejściowe.

   

7. Wybierz opcję Plik dla typu danych wejściowych użytkownika.

8. Ponownie wybierz opcję Dodaj dane wejściowe, a następnie wybierz Tekst jako typ danych wejściowych użytkownika.

9. Zmień dane wejściowe na Nazwa pliku i zmień opis na Wprowadź nazwę pliku.

   

Dodawanie łącznika SharePoint do przepływu

1. Wybierz Nowy krok, aby dodać akcję. Wyszukaj ciąg SharePoint i wybierz akcję Utwórz plik.

   

2. W Adresie witryny wybierz witrynę SharePoint, w której masz uprawnienia do dodawania plików.

3. W Ścieżka folderu wybierz bibliotekę dokumentów, w której masz uprawnienia do dodawania plików.

4. Wybierz dane wejściowe Nazwa pliku. Z karty Zawartość dynamiczna wybierz nazwę pliku w obszarze PowerApps (V2).

5. Wybierz dane wejściowe Zawartość pliku, a następnie z listy wybierz pozycję Zawartość pliku.

   

6. Wybierz pozycję Zapisz w prawym górnym rogu wybierz x, by zamknąć okno Power Automate.

7. Okienko Power Automate zostanie odświeżone, a nowy przepływ PowerApps (V2) pojawi się Utwórz plik, zostanie wyświetlony na liście.

   

Dodawanie przepływu do przycisku w aplikacji

1. Wybierz przycisk na kanwie aplikacji. We właściwości przycisku OnSelect wprowadź następujący formułę, zastępując nazwę przepływu i wygenerowaną nazwę pliku PDF własnymi nazwami:

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

   

2. Wybierz Zapisz i opublikuj.

Odtwórz aplikację i wybierz dodany przycisk. Power Automate jest uruchamiany i dodaje wygenerowany plik PDF do biblioteki dokumentów.

Zobacz także

Funkcja PDF w Power Apps (wersja eksperymentalna)