Tworzenie formularzy niestandardowych
Uwaga
Akcja Wyświetlanie formularza niestandardowego jest oparta na technologii adaptacyjnych kart. Więcej informacji na temat adaptacyjnych kart można znaleźć na tej stronie.
Pola komunikatów umożliwiają użytkownikom wprowadzanie różnych danych wejściowych, takich jak tekst, daty, pliki lub wyświetlanie informacji i wyników na ekranie.
Mimo że większość akcji z tej grupy może obsługiwać scenariusze, w których wymagane jest wprowadzenie pojedynczych danych wejściowych, niektóre automatyzacji mogą wymagać kombinacji danych wejściowych lub/i wyjściowych. Najlepszym podejściem do rozwiązania tych scenariuszy jest wyświetlenie akcji Wyświetl formularz niestandardowy.
Aby utworzyć formularz niestandardowy, należy wdrożyć akcję Wyświetlania niestandardowego formularza i wybrać przycisk Niestandardowy projektant formularzy, aby otworzyć projektanta formularzy.
Po lewej stronie projektanta znajduje się lista z wszystkimi dostępnymi elementami wejściowymi, które można dodać do formularza, takimi jak tekst, data i dane wejściowe do pliku, a także niektóre elementy nieinteraktywne, takie jak reklamy i obrazy.
Aby dodać element do formularza niestandardowego, kliknij go dwukrotnie lub przeciągnij i upuść w obszarze roboczym projektanta. Użyj okienka podglądu w dolnej części okna projektanta formularzy, aby zobaczyć, jak będzie wyglądać skonfigurowany formularz w czasie wykonywania.
Po dodaniu elementu można obsługiwać wszystkie dostępne właściwości po prawej stronie projektanta formularzy. Dostępne właściwości mogą się różnić w zależności od charakteru wybranego elementu.
Uwaga
Poza elementami formularza projektant formularzy zawiera pewne właściwości konfiguracyjne wyglądu sesji dialogowej nadrzędnego formularza niestandardowego. Aby je skonfigurować, należy wybrać puste miejsce w obszarze roboczym i wyświetlić dostępne właściwości w odpowiednim okienku.
Gdy użytkownik wypełni formularz niestandardowy, podane dane są przechowywane w zmiennej niestandardowej CustomFormData. Aby uzyskać dostęp do wartości określonego elementu wejściowego przechowywanego w obiekcie niestandardowym, należy użyć następującego ustawienia: %CustomFormData['ElementID']%.
Ważne
Identyfikator każdego elementu musi być unikatowy i nie może być pusty. Nazwa musi zaczynać się od litery i może zawierać litery łacińskie, liczby i spacje. Nie można używać zmiennych w polach identyfikacyjnych. Jeśli jest podany nieprawidłowy identyfikator, ostatni używany prawidłowy identyfikator zostanie automatycznie przywrócony po zamknięciu i zapisaniu projektanta formularzy.
Uwaga
Więcej informacji dotyczących obiektów niestandardowych i jak się z nimi obchodzić można znaleźć w Zaawansowanych typach danych.
Poza elementami wejściowymi i nieinteraktywnymi projektant formularzy udostępnia pewne akcje służące do implementacji dodatkowych funkcji w formularzach.
Akcje należy rozważyć jako przyciski umożliwiające uruchamianie różnych funkcji w zależności od tego, który przycisk został naciśnięty. Na przykład użyj akcji Prześlij jako przycisku zapisywania do zbierania i przechowywania podanych danych użytkownika do późniejszego użycia w przepływie.
Uwaga
Akcje można dodać tylko na końcu struktury formularza po dowolnym innym typie elementu formularza.
Podobnie jak pozostałe elementy, każda akcja ma identyfikator, który opisuje ją w sposób unikatowy. Po wybraniu akcji jej identyfikator jest przechowywany w zmiennej ButtonPressed.
Gdy formularz zawiera wiele akcji, użyj tej zmiennej i warunków w celu sprawdzenia, która z nich jest naciśnięta i zaimplementuj inną funkcję dla każdego scenariusza. Aby uzyskać więcej informacji na temat implementowania tego zachowania, zobacz temat Obsługa niestandardowych formularzy.
Na poniższych zrzutach ekranu pokazano, jak wygląda wcześniej skonfigurowany formularz niestandardowy podczas działania przepływu.
Elementy formularza niestandardowego
| Nazwa elementu | Typ | Specyfikacje | Właściwości układu | Właściwości sprawdzania poprawności | Właściwości stylu | Obraz tła |
|---|---|---|---|---|---|---|
| Formularz niestandardowy | Nadrzędna sesja dialogowa | Tytuł | Minimalna wysokość w pikselach, wyrównanie zawartości pionowej | Adres URL, tryb wypełniania, wyrównanie poziome, wyrównanie pionowe | ||
| Dane wejściowe — tekst | Dane wejściowe | Identyfikator, Etykieta, Wartość domyślna, Wieloliniowy, Styl, Maksymalna długość | Odległość, Separator, Wysokość | Wymagane sprawdzanie poprawności, komunikat o błędzie, wzorzec | ||
| Dane wejściowe — liczby | Dane wejściowe | Identyfikator, Etykieta, Wartość domyślna, Wartość minimalna, Wartość maksymalna | Odległość, Separator, Wysokość | Wymagane sprawdzanie poprawności, komunikat o błędzie | ||
| Dane wejściowe — data | Dane wejściowe | Identyfikator, Etykieta, Wartość domyślna, Wartość minimalna, Wartość maksymalna | Odległość, Separator, Wysokość | Wymagane sprawdzanie poprawności, komunikat o błędzie | ||
| Dane wejściowe — godzina | Dane wejściowe | Identyfikator, Etykieta, Wartość domyślna, Wartość minimalna, Wartość maksymalna | Odległość, Separator, Wysokość | Wymagane sprawdzanie poprawności, komunikat o błędzie | ||
| Dane wejściowe — przełącznik | Dane wejściowe | Identyfikator, Etykieta, Tytuł, Wartość domyślna, Wartość po włączeniu, Wartość po wyłączeniu | Odległość, Separator, Zawinięcie wysokości | Wymagane sprawdzanie poprawności, komunikat o błędzie | ||
| Dane wejściowe — zestaw opcji wyboru | Dane wejściowe | Identyfikator, Etykieta, Wartość domyślna, Zezwalaj na wiele wyborów, Styl, Opcje | Odległość, Separator, Wysokość, Zawinięcie | Wymagane sprawdzanie poprawności, komunikat o błędzie | ||
| Dane wejściowe — plik | Dane wejściowe | Identyfikator, Etykieta, Wartość domyślna | Odległość, Separator, Wysokość | Wymagane sprawdzanie poprawności, komunikat o błędzie | ||
| Blok tekstu | Element | Identyfikator, Tekst | Odległość, separator, wyrównanie poziome, wysokość, zawinięcie, maksymalna liczba wierszy, maksymalna szerokość | Typ czcionki, rozmiar, waga, kolor, dyskretna, kursywa, przekreślenie | ||
| Obraz | Element | Identyfikator, adres URL, Tekst alternatywny | Odległość, separator, wyrównanie poziome, Wysokość, Wysokość w pikselach, Szerokość w pikselach, Rozmiar | Styl, Kolor tła | ||
| Prześlij | Akcja | Identyfikator, Tytuł, Ignoruj wprowadzone dane wejściowe | ||||
| Otwórz adres URL | Akcja | Identyfikator, Tytuł, adres URL |
Właściwości elementu formularza niestandardowego
| Nazwa właściwości | Opcjonalnie | Akceptuje | Wartość domyślna | Opis |
|---|---|---|---|---|
| Zezwalaj na wybór wielokrotny | Brak | Wartość logiczna | Fałsz | Umożliwia wybranie wielu opcji wyboru |
| Tekst alternatywny | Tak | Wartość tekstowa | Alternatywny tekst stanowiący opis obrazu | |
| Kolor tła | Tak | Wartość tekstowa | Stosuje tło do przejrzystego obrazu. Ta właściwość będzie dotyczyła stylu obrazu. W tej właściwości są możliwe do zaakceptowania tylko wartości szesnastkowe | |
| Opcje wyboru | Tak | Tytuł i wartość | Opisuje opcje do użycia w zestawie wyboru. Składa się z tytułu (tekst do wyświetlenia) i wartości (nieprzetworzona wartość opcji wyboru) | |
| Kolor | Brak | Domyślne, Ciemne, Jasne, akcent, dobre, ostrzeżenie, uwaga | Wartość domyślna | Określa kolor tekstu |
| Domyślna wartość | Tak | Wartość tekstowa, Wartość liczbowa | Domyślna wartość elementu danych wejściowych | |
| Komunikat o błędzie | Tak | Wartość tekstowa | Komunikat o błędzie, który ma być wyświetlany po wprowadzeniu nieprawidłowych danych wejściowych | |
| Tryb wypełniania | Brak | Okładka, Powtórz poziomo, Powtórz pionowo, Powtórz | Opisuje, w jaki sposób obraz ma wypełniać obszar | |
| Typ czcionki | Brak | Domyślnie, O stałej szerokości | Wartość domyślna | Typ czcionki, która ma być używana na potrzeby renderowania |
| Wysokość | Brak | Automatycznie, Rozciągnij, Piksele | Automatycznie | Określa wysokość elementu. Opcja „Piksele” jest dostępna tylko dla elementów obrazu |
| Wysokość w pikselach | Nie | Wartość liczbowa | 0 | Określa żądaną wysokość obrazu. Obraz będzie odkształcony, by pasować do tej wysokości. Zastępuje to właściwość „Rozmiar”. Domyślna wartość 0 określa, że nie jest podana żadna wysokość |
| Wyrównanie w poziomie | Brak | Lewo, Środek, Prawo | Blok tekstu: po lewej stronie Obraz: po lewej stronie |
Określa, w jaki sposób jest wybierane położenie tego elementu w poziomie. W przypadku formularzy niestandardowych opisuje sposób dopasowywania obrazu tła w sytuacji, gdy musi on zostać przycięty lub gdy jest używany tryb wypełniania Powtarzaj |
| Identyfikator | Nie | Wartość tekstowa | Zależy od elementu | Identyfikator unikatowy wartości. Używany do identyfikowania zebranych danych wejściowych podczas działania Prześlij. Jeśli tymczasowo będzie używany nieprawidłowy identyfikator, a projektant formularzy zostanie zamknięty, zostanie zastosowany ostatni prawidłowy identyfikator |
| Ignoruj wprowadzone dane wejściowe | Brak | Wartość logiczna | Fałsz | Jeśli ta właściwość zostanie włączona, wykonanie tej akcji spowoduje zamknięcie formularza bez zapisywania wybranych danych wejściowych (działanie odpowiadające działaniu przycisku Anuluj) |
| Kursywa | Brak | Wartość logiczna | Fałsz | Jeśli ta właściwość jest włączona, powoduje formatowanie tekstu kursywą |
| Etykieta | Tak | Wartość tekstowa | Etykieta tych danych wejściowych | |
| Długość maksymalna | Nie | Wartość liczbowa | 0 | Określa maksymalną liczbę znaków do zgromadzenia. Domyślna wartość 0 określa, że nie jest podana maksymalna długość |
| Maksymalna liczba wierszy | Nie | Wartość liczbowa | 0 | Określa maksymalną liczbę wierszy do wyświetlenia. Domyślna wartość 0 określa, że nie jest podana maksymalna liczba wierszy |
| Wartość maksymalna | Tak | Wartość tekstowa | Wskazówka dotycząca wartości maksymalnej. W przypadku wprowadzania dat i godzin wartość musi być wyrażana w formacie regionalnym komputera | |
| Maksymalna szerokość | Nie | Wartość liczbowa | 0 | Określa maksymalną szerokość bloku tekstu w pikselach. Domyślna wartość 0 określa, że nie jest podana maksymalna szerokość |
| Wysokość minimalna w pikselach | Nie | Wartość liczbowa | 0 | Określa minimalną wysokość formularza. Domyślna wartość 0 określa, że nie jest podana minimalna wysokość |
| Wartość minimalna | Tak | Wartość tekstowa | Wskazówka dotycząca wartości minimalnej. W przypadku wprowadzania dat i godzin wartość musi być wyrażana w formacie regionalnym komputera | |
| Wiele wierszy | Brak | Wartość logiczna | Fałsz | Jeśli ta właściwość jest włączona, umożliwia wprowadzenie wielu wierszy danych wejściowych |
| Wzorzec | Tak | Wartość tekstowa | Wyrażenie regularne wskazujące wymagany format tych tekstowych danych wejściowych | |
| Separator | Brak | Wartość logiczna | Fałsz | Gdy ta właściwość jest włączona, powoduje narysowanie linii rozdzielającej u góry elementu |
| Rozmiar | Brak | Blok tekstu: Domyślny, Mały, Średni, Duży, Bardzo duży Obraz: automatycznie, rozciągnij, mały, średni, duży |
Blok tekstu: domyślny Obraz: Automatycznie |
Kontroluje rozmiar tekstu lub obrazu |
| Odstęp | Brak | Domyślny, Brak, Mały, Średni, Duży, Bardzo duży, Dopełnienie | Wartość domyślna | Określa wielkość odstępu między tym elementem a poprzedzającym go elementem |
| Przekreślenie | Brak | Wartość logiczna | Fałsz | Jeśli ta właściwość jest włączona, powoduje formatowanie tekstu przekreśleniem |
| Styl | Brak | Wprowadzanie tekstu: tekst, tel, adres URL, adres e-mail Zestaw opcji do wprowadzenia: kompaktowe, rozszerzone Obraz: Domyślny, osoba |
Dane wejściowe — tekst: tekst Dane wejściowe — zestaw opcji wyboru: kompaktowe Obraz: domyślny |
Styl podpowiedzi tekstu, zestawu wyboru lub obrazu |
| Subtelny | Brak | Wartość logiczna | Fałsz | Jeśli ta właściwość jest włączona, powoduje wyświetlanie nieco przygaszonego tekstu, dzięki czemu tekst mniej rzuca się w oczy |
| Tekst | Tak | Wartość tekstowa | Nowy blok tekstu | Tekst do wyświetlenia |
| Tytuł | Tak | Wartość tekstowa | Przełącznik wprowadzania: nowy przełącznik wprowadzania Prześlij: OK |
Tytuł formularza niestandardowego, przełącznika lub etykiety przycisku reprezentującego tę akcję |
| Adres URL | Tak | Wartość tekstowa | Adres URL obrazu (dla elementu obrazu i formularza niestandardowego) lub adres URL do otwarcia (w przypadku akcji Otwórz adres URL) | |
| Wymagana walidacja | Tak | Wartość logiczna | Fałsz | Określa, czy te dane wejściowe są wymagane, czy nie |
| Wartość w przypadku wyłączenia | Tak | Wartość tekstowa | Fałsz | Wartość wyłączonego przełącznika |
| Wartość w przypadku włączenia | Tak | Wartość tekstowa | Prawda | Wartość włączonego przełącznika |
| Wyrównanie w pionie | Brak | Góra, Środek, Dół | Opisuje sposób dopasowywania obrazu w sytuacji, gdy musi on zostać przycięty lub gdy jest używany tryb wypełniania Powtarzaj | |
| Wyrównanie zawartości w pionie | Brak | Góra, Środek Dół | Góra | Określa sposób pionowego wyrównania zawartości w kontenerze. Dotyczy to tylko formularzy o stałej wysokości lub formularzy o określonej minimalnej wysokości |
| Waga | Brak | Domyślna, Lżejsza, Cięższa | Wartość domyślna | Określa grubość tekstu |
| Szerokość w pikselach | Nie | Wartość liczbowa | 0 | Żądana szerokość obrazu na ekranie. Zastępuje to właściwość „Rozmiar”. Domyślna wartość 0 określa, że nie jest podana żadna szerokość |
| Zawijanie | Brak | Wartość logiczna | Fałsz | Jeśli ta opcja jest włączona, tekst może być zawijany. W przeciwnym razie tekst jest przycięty |
Znane problemy i ograniczenia
Problem: okienko podglądu wydaje się działać zgodnie z oczekiwaniami, gdy właściwość adresu URL zawiera znaki procentowe, ale występuje błąd sprawdzania poprawności Nieprawidłowa wartość.
Obejście: ten problem występuje, ponieważ usługa Power Automate próbuje rozpoznać znaki procentowe jako zmienne lub wyrażenia. Aby rozwiązać ten problem, należy przechowywać adres URL w zmiennej wcześniejszej w przepływie, ująć znaki procentowe, a następnie użyć tej zmiennej we właściwości adresu URL. Podgląd nie wyświetli obrazu, ale będzie wyświetlany w czasie wykonywania.