XML 작업
Power Automate는 데스크톱 흐름을 사용하여 XML 특성 및 요소를 관리하는 기능을 제공합니다.
XML 파일을 읽으려면 파일에서 XML 읽기 작업을 사용합니다. 경로를 지정하거나 파일을 찾은 다음 인코딩 옵션 중 하나를 선택합니다.
파일을 선택한 후 Xpath 쿼리를 실행하려면 XPath 표현식 실행 작업을 선택합니다. 다음 예제에서는 파일에서 XML 읽기 작업에서 생성된 변수를 사용하여 문서를 지정합니다.
XML 파일에서 속성을 검색하려면 XML 속성 가져오기 작업을 사용합니다. 다음 예에서 상태는 clientlist의 요소인 클라이언트의 속성입니다. 값은 텍스트 값으로 획득됩니다.
마찬가지로 요소 값을 검색하려면 XML 요소 값 가져오기 작업을 사용합니다. XML 특성 또는 요소를 가져오거나 설정하거나 제거하는 해당 작업을 사용하여 요소 및 특성을 관리할 수 있습니다.
파일에서 XML 읽기
변수에서 XML 파일의 내용을 읽습니다.
| 인수 |
선택 항목 |
수락 |
기본값 |
Description |
| 파일 경로 |
아니요 |
파일 |
|
읽을 XML 문서가 들어 있는 파일입니다 |
| 인코딩 |
사용 불가 |
시스템 기본값, ASCII, 유니코드, 유니코드 빅엔디안, UTF-8 |
시스템 기본값 |
지정한 파일에 사용되는 인코딩입니다 |
변수 생성됨
| 인수 |
Type |
Description |
| XmlDocument |
XML 노드 |
XML 문서 읽기를 보유하는 변수입니다. |
예외
| 예외 |
설명 |
| 디렉터리 없음 |
디렉터리가 존재하지 않음을 나타냄 |
| 파일 없음 |
파일이 없음을 나타냄 |
| 파일을 읽지 못함 |
파일에서 읽는 데 문제가 있음을 나타냄 |
| 파일에 유효한 XML 문서가 포함되어 있지 않음 |
파일에 유효한 XML 문서가 포함되어 있지 않음을 나타냄 |
파일에 XML 쓰기
XML 노드 변수의 내용을 파일에 씁니다.
| 인수 |
선택 항목 |
수락 |
기본값 |
Description |
| 파일 경로 |
아니요 |
파일 |
|
XML 문서를 쓸 파일입니다 |
| 쓰기할 XML |
아니요 |
텍스트 값 |
|
파일에 쓸 XML 노드 또는 문서입니다 |
| 인코딩 |
사용 불가 |
시스템 기본값, ASCII, 유니코드, 유니코드 빅엔디안, UTF-8 |
시스템 기본값 |
지정한 파일에 사용되는 인코딩입니다 |
| 형식 XML |
사용 불가 |
부울 값 |
True |
XML의 형식을 지정할지 여부를 지정합니다 |
| 수준당 들여쓰기 |
네 |
숫자 값 |
2 |
XML의 각 수준을 들여쓰기할 공백을 지정합니다 |
변수 생성됨
이 작업은 변수를 생성하지 않습니다.
예외
| 예외 |
Description |
| 지정된 디렉터리가 유효하지 않음 |
지정된 디렉터리가 잘못되었음을 나타냄 |
| 파일에 XML을 쓰지 못함 |
파일에 XML을 쓰는 데 문제가 있음을 나타냄 |
XPath 식 실행
제공된 XPath 쿼리를 기반으로 XML 문서에서 값을 추출합니다.
| 인수 |
선택 항목 |
수락 |
기본값 |
Description |
| 구문 분석할 XML 문서 |
아니요 |
텍스트 값 |
|
구문 분석할 XML 문서를 포함하는 텍스트 또는 이전에 정의된 변수로서의 XML입니다 |
| XPath 쿼리 |
아니요 |
텍스트 값 |
|
XML 문서에 대해 실행할 XPath 식 |
| 첫 번째 값만 얻기 |
사용 불가 |
부울 값 |
False |
단일 값(첫 번째 값만)을 검색할지, 아니면 제공된 XPath 식과 일치하는 모든 값을 검색할지 지정합니다 |
변수 생성됨
| 인수 |
Type |
Description |
| XPathResult |
XML 노드 |
XML 노드로 추출된 노드 |
| XPathResults |
XML 노드목록 |
XML 노드 목록으로 추출된 노드 |
예외
| 예외 |
설명 |
| 잘못된 XML 문서가 제공됨 |
제공된 XML 문서가 잘못되었음을 나타냄 |
| 잘못된 XPath 식 제공됨 |
제공된 XPath 식이 잘못되었음을 나타냄 |
XML 요소 특성 가져오기
XML 요소의 특성 값을 가져옵니다.
| 인수 |
선택 항목 |
수락 |
기본값 |
Description |
| XML 문서 |
아니요 |
XML 노드 |
|
특성을 검색할 XML 문서 또는 XML 요소입니다 |
| XPath 쿼리 |
네 |
텍스트 값 |
|
하위 요소를 찾고 특성을 검색하는 XPath 식입니다 |
| Attribute name |
아니요 |
텍스트 값 |
|
값을 검색할 특성의 이름입니다 |
| 다른 형식으로 값 가져오기 |
사용 불가 |
텍스트 값, 숫자 값, 날짜/시간 값, 부울 값 |
텍스트 값 |
특성 값의 데이터 형식을 지정합니다． |
변수 생성됨
| 인수 |
Type |
Description |
| XmlAttributeValue |
부울 값 |
XML 특성의 검색된 값 |
| XmlAttributeValue |
날짜/시간 |
XML 특성의 검색된 값 |
| XmlAttributeValue |
숫자 값 |
XML 특성의 검색된 값 |
| XmlAttributeValue |
텍스트 값 |
XML 특성의 검색된 값 |
예외
| 예외 |
Description |
| 잘못된 XPath 식 제공됨 |
제공된 XPath 식이 잘못되었음을 나타냄 |
| XPath 식이 요소가 없음을 반환함 |
XPath 식이 요소가 없음을 반환한 것을 나타냄 |
| 특성을 요소에서 찾을 수 없음 |
특성이 요소에 존재하지 않음을 나타냄 |
| 특성 값을 요청한 데이터 형식으로 변환하지 못함 |
특성 값을 요청한 데이터 형식으로 변환하는 데 문제가 있음을 나타냄 |
XML 요소 특성 설정
XML 요소의 특성 값을 설정합니다.
| 인수 |
선택 항목 |
수락 |
기본값 |
Description |
| XML 문서 |
아니요 |
XML 노드 |
|
특성을 설정할 XML 문서 또는 XML 요소입니다 |
| XPath 쿼리 |
네 |
텍스트 값 |
|
하위 요소를 찾고 특성을 설정하는 XPath 식입니다 |
| Attribute name |
아니요 |
텍스트 값 |
|
값을 설정할 특성의 이름입니다 |
| 특성 값 |
아니요 |
텍스트 값 |
|
특성의 새 값입니다 |
변수 생성됨
이 작업은 변수를 생성하지 않습니다.
예외
| 예외 |
Description |
| 잘못된 XPath 식 제공됨 |
제공된 XPath 식이 잘못되었음을 나타냄 |
| XPath 식이 요소가 없음을 반환함 |
XPath 식이 요소가 없음을 반환한 것을 나타냄 |
| XML 특성을 설정하지 못했습니다. |
XML 특성을 설정하는 데 문제가 있음을 나타냅니다. |
XML 요소 특성 제거하기
XML 요소에서 특성을 제거합니다.
| 인수 |
선택 항목 |
수락 |
기본값 |
Description |
| XML 문서 |
아니요 |
XML 노드 |
|
특성을 제거할 XML 문서 또는 XML 요소입니다 |
| XPath 쿼리 |
네 |
텍스트 값 |
|
하위 요소를 찾고 특성을 제거하는 XPath 표현식 |
| Attribute name |
아니요 |
텍스트 값 |
|
제거할 특성의 이름입니다 |
변수 생성됨
이 작업은 변수를 생성하지 않습니다.
예외
| 예외 |
Description |
| 잘못된 XPath 식 제공됨 |
제공된 XPath 식이 잘못되었음을 나타냄 |
| XPath 식이 요소가 없음을 반환함 |
XPath 식이 요소가 없음을 반환한 것을 나타냄 |
| 특성을 요소에서 찾을 수 없음 |
특성이 요소에 존재하지 않음을 나타냄 |
| XML 특성을 제거하지 못했습니다. |
XML 특성을 제거하는 데 문제가 있음을 나타냄 |
XML 요소 값 가져오기
XML 요소의 값을 가져옵니다.
| 인수 |
선택 항목 |
수락 |
기본값 |
Description |
| XML 문서 |
아니요 |
XML 노드 |
|
값을 검색할 XML 문서 또는 XML 요소입니다 |
| XPath 쿼리 |
네 |
텍스트 값 |
|
하위 요소를 찾고 값을 검색하는 XPath 식입니다. |
| 다른 형식으로 값 가져오기 |
사용 불가 |
텍스트 값, 숫자 값, 날짜/시간 값, 부울 값 |
텍스트 값 |
XML 요소 값의 데이터 형식을 지정합니다. |
변수 생성됨
| 인수 |
Type |
Description |
| XmlElementValue |
부울 값 |
XML 요소 값입니다． |
| XmlElementValue |
날짜/시간 |
XML 요소 값입니다． |
| XmlElementValue |
숫자 값 |
XML 요소 값입니다． |
| XmlElementValue |
텍스트 값 |
XML 요소 값입니다． |
예외
| 예외 |
Description |
| 잘못된 XPath 식 제공됨 |
제공된 XPath 식이 잘못되었음을 나타냄 |
| XPath 식이 요소가 없음을 반환함 |
XPath 식이 요소가 없음을 반환한 것을 나타냄 |
| 요소 값을 요청한 데이터 형식으로 변환하지 못함 |
요소 값을 요청한 데이터 형식으로 변환하는 데 문제가 있음을 나타냄 |
XML 요소 값 설정
XML 요소의 값을 설정합니다.
| 인수 |
선택 항목 |
수락 |
기본값 |
Description |
| XML 문서 |
아니요 |
XML 노드 |
|
값을 검색할 XML 문서 또는 XML 요소입니다 |
| XPath 쿼리 |
네 |
텍스트 값 |
|
하위 요소를 찾고 값을 검색하는 XPath 식입니다. |
| XML 요소 값 |
아니요 |
텍스트 값 |
|
XML 요소의 새 값입니다 |
변수 생성됨
이 작업은 변수를 생성하지 않습니다.
예외
| 예외 |
Description |
| 잘못된 XPath 식 제공됨 |
제공된 XPath 식이 잘못되었음을 나타냄 |
| XPath 식이 요소가 없음을 반환함 |
XPath 식이 요소가 없음을 반환한 것을 나타냄 |
| 요소 값을 설정하지 못함 |
요소 값을 설정하는 데 문제가 있음을 나타냄 |
XML 요소 삽입
새 XML 요소를 XML 문서에 삽입합니다.
| 인수 |
선택 항목 |
수락 |
기본값 |
Description |
| XML 문서 |
아니요 |
XML 노드 |
|
새 XML 요소를 삽입할 XML 문서입니다 |
| XPath 쿼리 |
아니요 |
텍스트 값 |
|
상위 XML 요소를 찾아 새 요소를 삽입하는 XPath 식입니다 |
| 삽입할 XML 요소 |
아니요 |
XML 노드 |
|
XML 문서에 삽입할 새 XML 요소입니다 |
변수 생성됨
이 작업은 변수를 생성하지 않습니다.
예외
| 예외 |
Description |
| 잘못된 XPath 식 제공됨 |
제공된 XPath 식이 잘못되었음을 나타냄 |
| XPath 식이 요소가 없음을 반환함 |
XPath 식이 요소가 없음을 반환한 것을 나타냄 |
| XML 요소를 삽입하지 못함 |
XML 요소를 삽입하는 데 문제가 있음을 나타냄 |
XML 요소 제거
XML 문서에서 하나 이상의 XML 요소를 제거합니다.
| 인수 |
선택 항목 |
수락 |
기본값 |
Description |
| XML 문서 |
아니요 |
XML 노드 |
|
제거할 XML 요소가 들어 있는 XML 문서입니다 |
| XPath 쿼리 |
아니요 |
텍스트 값 |
|
제거할 요소를 찾는 XPath 식입니다. |
변수 생성됨
이 작업은 변수를 생성하지 않습니다.
예외
| 예외 |
Description |
| 잘못된 XPath 식 제공됨 |
제공된 XPath 식이 잘못되었음을 나타냄 |
| XML 요소를 제거하지 못함 |
XML 요소를 제거하는 데 문제가 있음을 나타냄 |