Funkcja Trace

Dotyczy: Aplikacje kanwy Aplikacje oparte na modelu Power Platform CLI

Często w aplikacji działa wiele logiki, która działa wewnątrz aplikacji. Czasami wpływ będzie widoczny, na przykład wartość formantu lub zmiana kolorów, przez co logika działa prawidłowo. Czasami jednak nie jest oczywiste do zwizualizowania i zrozumienia, co dzieje się w aplikacji. Funkcja śledzenia umożliwia rejestrowanie informacji diagnostycznych w tle, tworzenie osi czasu dla tego, co faktycznie się stało, aby lepiej zrozumieć sposób działania aplikacji i pomóc w debugowaniu problemów.

Po użyciu w aplikacji Power Apps dane wyjściowe ze śledzenia są wyświetlane w narzędziu Monitor Power Apps wraz z innymi działaniami w aplikacji. Jeśli aplikacji zezwolono na wysyłanie danych telemetrycznych do Azure Application Insights, funkcja Śledzenia może być również używana do wysyłania informacji do zasobu Application Insights. Funkcja Śledzenie może być używana tylko w formułach zachowania.

Używana w Test Studio funkcja Śledzenia jest opcjonalnym wyrażeniem, które może służyć do dostarczania dodatkowych informacji w wynikach testu ze zdarzenia OnTestCaseComplete. Komunikaty zdarzeń funkcji Śledzenie, a także wszystkie komunikaty dla asercji zakończonych pomyślnie i zakończonych niepowodzeniem, są zawarte w tabeli Śledzenia w rekordzie TestCaseResult. Tabela Śledzenie ma dwie właściwości: Message i Timestamp. Informacje funkcji Śledzenie używane w testach również będą rejestrowane w Application Insights. Informacje o śledzeniu testu nie będą dostępne w narzędziu Monitor, ponieważ narzędzie Monitor będzie połączony z aplikacją podczas jej odtwarzania z Power Apps Studio.

Składnia

Śledzenie( Message [, TraceSeverity [, CustomRecord [, TraceOptions ] ] ] )

• Wiadomość – wartość wymagana. Informacje, które mają być śledzone. Liczby, Daty, wartości logiczne i inne typy danych, które mogą być wymuszone w Text.
• Trace_severity — opcjonalne. Poziom ważności śladu zarejestrowanego w Monitorze i Application Insights. Dostępne opcje to TraceSeverity.Information (domyślnie), TraceSeverity.Warning lub TraceSeverity.Error lub TraceSeverity.Critical.
• custom_record — opcjonalne. Rekord zawierający niestandardowe dane, który zostanie zarejestrowany w Monitor lub Application Insights.
• TraceOptions — opcjonalne. Opcje to TraceOptions.None (domyślnie) i TraceOptions.IgnoreUnsupportedTypes, które zignorują typy danych w rekordach CustomRecord, których nie można serializować.

Przykład

1. Utwórz kontrolkę button w Power Apps Studio.
2. Ustaw akcję OnSelect na następującą formułę:

Set( x, x+1 );
Trace( x );

3. Otwórz okno Power Apps Monitor w innym oknie przeglądarki, wybierając ikonę „Narzędzia zaawansowane” w lewym okienku i wybierz opcję „Otwórz monitor”:
4. Wróć do pierwotnego okna przeglądarki programu Studio i wybierz cztery razy swój przycisk. Użyj prawego klawisza Alt na myszy, jeśli jesteś w trybie projektowania.
5. Wyświetl monitor Power Apps.
6. Siatka Monitora będzie zawierać zdarzenie każdego kliknięcia przycisku i każdego wywołania śledzenia, które po każdym przyroście będzie zawierać wartość zmiennej. Przejdź do zdarzenia śledzenia w celu zainicjowania śledzenia oraz wyrażenia użytego w komunikacie w panelu po prawej stronie:

Zobacz też

Omówienie narzędzia Monitor Power Apps
Test Studio — omówienie
Praca z programem Test Studio