Udostępnij przez

Akcje XML

Power Automate umożliwia korzystanie z przepływów pulpitu do zarządzania atrybutami i elementami XML.

Aby odczytać plik XML, użyj akcji Odczytaj kod XML z pliku. Określ ścieżkę lub wyszukaj plik i wybierz jedną z opcji kodowania.

Po wybraniu pliku, aby uruchomić zapytanie Xpath, wybierz akcję Wykonaj wyrażenie XPath. W poniższym przykładzie do określenia dokumentu jest używana akcja Czytaj XML z pliku.

Zrzut ekranu przedstawiający akcję wyrażenia Wykonaj XPath.

Aby pobrać atrybut z pliku XML, użyj akcji Pobierz atrybut XML. W poniższym przykładzie stan jest atrybutem klienta, który jest elementem listy klientów. Wartość zostanie uzyskana jako wartość tekstowa.

Zrzut ekranu akcji Pobierz atrybut XML.

Podobnie, aby pobrać wartości elementu, należy użyć akcji Pobierz wartość elementu XML. Elementami i atrybutami można zarządzać za pomocą odpowiedniej akcji, aby uzyskać, ustawić lub usunąć atrybuty lub elementy XML.

Odczytaj kod XML z pliku

Odczytaj zawartość pliku XML do zmiennej.

Parametry wejściowe

Argument Opcjonalnie Akceptuje Wartość domyślna opis
Ścieżka pliku Nie Plik Plik zawierający dokument XML do odczytania
Kodowanie Brak Domyślny system, ASCII, Unicode, Unicode big-endian, UTF-8 Ustawienie domyślne systemu Kodowanie używane dla określonego pliku

Utworzone zmienne

Argument Type opis
XmlDocument Węzeł XML Zmienna zawierająca odczytany dokument XML

Wyjątki

Wyjątek Opis
Nie znaleziono katalogu Wskazuje, że katalog nie istnieje
Nie znaleziono pliku Wskazuje, że plik nie istnieje
Nie można wykonać odczytu z pliku Wskazuje problem podczas odczytu z pliku
Plik nie zawiera prawidłowego dokumentu XML Wskazuje, że plik nie zawiera prawidłowego dokumentu XML

Zapisz kod XML w pliku

Zapisz zawartość zmiennej węzła XML w pliku.

Parametry wejściowe

Argument Opcjonalnie Akceptuje Wartość domyślna opis
Ścieżka pliku Nie Plik Plik, w którym ma zostać zapisany dokument XML
Kod XML do zapisania Nie Wartość tekstowa Węzeł lub dokument XML, który ma zostać zapisany w pliku
Kodowanie Brak Domyślny system, ASCII, Unicode, Unicode big-endian, UTF-8 Ustawienie domyślne systemu Kodowanie używane dla określonego pliku
XML — format Brak Wartość logiczna Prawda Określa, czy kod XML ma być formatowany
Wcięcie na poziom Tak Wartość liczbowa 2 Określa, o ile spacji ma być wcięty każdy poziom kodu XML

Utworzone zmienne

Ta akcja nie wywołuje żadnych zmiennych.

Wyjątki

Wyjątek opis
Określono nieprawidłowy katalog Wskazuje, że określony katalog jest nieprawidłowy
Nie można zapisać kodu XML w pliku Wskazuje problem podczas zapisywania kodu XML w pliku

Wyrażenie Wykonaj XPath

Wyodrębnij wartości z dokumentu XML na podstawie dostarczonego zapytania XPath.

Parametry wejściowe

Argument Opcjonalnie Akceptuje Wartość domyślna opis
Dokument XML do przeanalizowania Nie Wartość tekstowa Kod XML jako tekst lub uprzednio zdefiniowana zmienna zawierająca dokument XML do przeanalizowania
Zapytanie XPath Nie. Wartość tekstowa Wyrażenie XPath, które ma zostać wykonane w odniesieniu do dokumentu XML
Pobierz tylko pierwszą wartość Brak Wartość logiczna Fałsz Określa, czy ma być pobierana pojedyncza wartość (tylko pierwsza wartość), czy wszystkie wartości spełniające kryteria dostarczonego wyrażenia XPath

Utworzone zmienne

Argument Type opis
XPathResult Węzeł XML Wyodrębnione węzły jako węzeł XML
XPathResults Lista węzłów XML Wyodrębnione węzły jako lista węzłów XML

Wyjątki

Wyjątek Opis
Dostarczono nieprawidłowy dokument XML Wskazuje, że dostarczony dokument XML jest nieprawidłowy
Dostarczono nieprawidłowe wyrażenie XPath Wskazuje, że dostarczone wyrażenie XPath jest nieprawidłowe

Pobierz atrybut elementu XML

Pobierz wartość atrybutu elementu XML.

Parametry wejściowe

Argument Opcjonalnie Akceptuje Wartość domyślna opis
Dokument XML Nie Węzeł XML Dokument XML lub element XML, którego atrybut ma zostać pobrany
Zapytanie XPath Tak Wartość tekstowa Wyrażenie XPath służące do lokalizowania elementu podrzędnego i pobierania jego atrybutu
Attribute name Nie. Wartość tekstowa Nazwa pola atrybutu, którego wartość ma zostać pobrana
Pobierz wartość jako Brak Wartość tekstowa, Wartość liczbowa, Wartość data/godzina, Wartość logiczna Wartość tekstowa Określa typ danych dla wartości atrybutu

Utworzone zmienne

Argument Type opis
XmlAttributeValue Wartość logiczna Pobrana wartość atrybutu XML
XmlAttributeValue Data i godzina Pobrana wartość atrybutu XML
XmlAttributeValue Wartość liczbowa Pobrana wartość atrybutu XML
XmlAttributeValue Wartość tekstowa Pobrana wartość atrybutu XML

Wyjątki

Wyjątek opis
Dostarczono nieprawidłowe wyrażenie XPath Wskazuje, że dostarczone wyrażenie XPath jest nieprawidłowe
Wyrażenie XPath nie zwraca elementu Wskazuje, że wyrażenie XPath nie zwraca żadnego elementu
Nie znaleziono atrybutu w elemencie Wskazuje, że atrybut nie istnieje w elemencie
Nie można przekonwertować wartości atrybutu na żądany typ danych Wskazuje problem podczas konwertowania wartości atrybutu na żądany typ danych

Ustaw atrybut elementu XML

Ustaw wartość atrybutu elementu XML.

Parametry wejściowe

Argument Opcjonalnie Akceptuje Wartość domyślna opis
Dokument XML Nie Węzeł XML Dokument XML lub element XML, którego atrybut ma zostać ustawiony
Zapytanie XPath Tak Wartość tekstowa Wyrażenie XPath służące do lokalizowania elementu podrzędnego i ustawiania jego atrybutu
Attribute name Nie. Wartość tekstowa Nazwa atrybutu, którego wartość ma zostać ustawiona
Wartość atrybutu Nie. Wartość tekstowa Nowa wartość atrybutu

Utworzone zmienne

Ta akcja nie wywołuje żadnych zmiennych.

Wyjątki

Wyjątek opis
Dostarczono nieprawidłowe wyrażenie XPath Wskazuje, że dostarczone wyrażenie XPath jest nieprawidłowe
Wyrażenie XPath nie zwraca elementu Wskazuje, że wyrażenie XPath nie zwraca żadnego elementu
Nie można ustawić atrybutu XML Wskazuje problem podczas ustawiania atrybutu XML

Usuń atrybut elementu XML

Usuń atrybut z elementu XML.

Parametry wejściowe

Argument Opcjonalnie Akceptuje Wartość domyślna opis
Dokument XML Nie Węzeł XML Dokument XML lub element XML, z którego ma zostać usunięty atrybut
Zapytanie XPath Tak Wartość tekstowa Wyrażenie XPath służące do lokalizowania elementu podrzędnego i usuwania jego atrybutu
Attribute name Nie. Wartość tekstowa Nazwa atrybutu do usunięcia

Utworzone zmienne

Ta akcja nie wywołuje żadnych zmiennych.

Wyjątki

Wyjątek opis
Dostarczono nieprawidłowe wyrażenie XPath Wskazuje, że dostarczone wyrażenie XPath jest nieprawidłowe
Wyrażenie XPath nie zwraca elementu Wskazuje, że wyrażenie XPath nie zwraca żadnego elementu
Nie znaleziono atrybutu w elemencie Wskazuje, że atrybut nie istnieje w elemencie
Nie można usunąć atrybutu XML Wskazuje problem podczas usuwania atrybutu XML

Pobierz wartość elementu XML

Pobierz wartość elementu XML.

Parametry wejściowe

Argument Opcjonalnie Akceptuje Wartość domyślna opis
Dokument XML Nie Węzeł XML Dokument XML lub element XML, którego wartość ma zostać pobrana
Zapytanie XPath Tak Wartość tekstowa Wyrażenie XPath służące do lokalizowania elementu podrzędnego i pobierania jego wartości
Pobierz wartość jako Brak Wartość tekstowa, Wartość liczbowa, Wartość data/godzina, Wartość logiczna Wartość tekstowa Określa typ danych dla wartości elementu XML

Utworzone zmienne

Argument Type opis
XmlElementValue Wartość logiczna Wartość elementu XML
XmlElementValue Data i godzina Wartość elementu XML
XmlElementValue Wartość liczbowa Wartość elementu XML
XmlElementValue Wartość tekstowa Wartość elementu XML

Wyjątki

Wyjątek opis
Dostarczono nieprawidłowe wyrażenie XPath Wskazuje, że dostarczone wyrażenie XPath jest nieprawidłowe
Wyrażenie XPath nie zwraca elementu Wskazuje, że wyrażenie XPath nie zwraca żadnego elementu
Nie można przekonwertować wartości elementu na żądany typ danych Wskazuje problem podczas konwertowania wartości elementu na żądany typ danych

Ustaw wartość elementu XML

Ustaw wartość elementu XML.

Parametry wejściowe

Argument Opcjonalnie Akceptuje Wartość domyślna opis
Dokument XML Nie Węzeł XML Dokument XML lub element XML, którego wartość ma zostać pobrana
Zapytanie XPath Tak Wartość tekstowa Wyrażenie XPath służące do lokalizowania elementu podrzędnego i pobierania jego wartości
Wartość elementu XML Nie. Wartość tekstowa Nowa wartość elementu XML

Utworzone zmienne

Ta akcja nie wywołuje żadnych zmiennych.

Wyjątki

Wyjątek opis
Dostarczono nieprawidłowe wyrażenie XPath Wskazuje, że dostarczone wyrażenie XPath jest nieprawidłowe
Wyrażenie XPath nie zwraca elementu Wskazuje, że wyrażenie XPath nie zwraca żadnego elementu
Nie można ustawić wartości elementu Wskazuje problem podczas ustawiania wartości elementu

Wstaw element XML

Wstaw nowy element XML do dokumentu XML.

Parametry wejściowe

Argument Opcjonalnie Akceptuje Wartość domyślna opis
Dokument XML Nie. Węzeł XML Dokument XML, do którego ma zostać wstawiony nowy element XML
Zapytanie XPath Nie. Wartość tekstowa Wyrażenie XPath służące do lokalizowania nadrzędnego elementu XML i wstawiania do niego nowego elementu
Element XML do wstawienia Nie Węzeł XML Nowy element XML, który ma zostać wstawiony do dokumentu XML

Utworzone zmienne

Ta akcja nie wywołuje żadnych zmiennych.

Wyjątki

Wyjątek opis
Dostarczono nieprawidłowe wyrażenie XPath Wskazuje, że dostarczone wyrażenie XPath jest nieprawidłowe
Wyrażenie XPath nie zwraca elementu Wskazuje, że wyrażenie XPath nie zwraca żadnego elementu
Nie można wstawić elementu XML Wskazuje problem podczas wstawiania elementu XML

Usuń element XML

Usuń co najmniej jeden element XML z dokumentu XML.

Parametry wejściowe

Argument Opcjonalnie Akceptuje Wartość domyślna opis
Dokument XML Nie Węzeł XML Dokument XML zawierający element(y) XML do usunięcia
Zapytanie XPath Nie. Wartość tekstowa Wyrażenie XPath służące do lokalizowania elementów do usunięcia

Utworzone zmienne

Ta akcja nie wywołuje żadnych zmiennych.

Wyjątki

Wyjątek opis
Dostarczono nieprawidłowe wyrażenie XPath Wskazuje, że dostarczone wyrażenie XPath jest nieprawidłowe
Nie można usunąć elementu XML Wskazuje problem podczas usuwania elementu XML
  • Last updated on