Akcje XML
Artykuł 03/16/2023
Współautorzy: 8
Opinia
W tym artykule
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 .
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.
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.
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.
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.
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.
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
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.
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.
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.
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
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.
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.
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.
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
