Visual Studio Code를 사용하여 논리 앱 워크플로에서 데이터를 변환하는 맵 만들기
적용 대상: Azure Logic Apps(표준)
논리 앱 워크플로에서 다른 XML 또는 JSON 형식을 사용하는 메시지를 교환하는 경우 원본 형식에서 대상 형식(예: XML 문서 간 또는 JSON 문서 간)으로 데이터를 변환하거나 변환하는 방법을 지정해야 합니다. 이 작업은 특히 원본 스키마와 대상 스키마의 데이터 구조 간에 간격이 있는 경우에 중요합니다. 스키마는 XML 또는 JSON 문서의 데이터 요소, 특성 및 데이터 형식을 설명합니다.
데이터 구조 간의 변환을 정의하고 간격을 메우기 위해 원본 스키마와 대상 스키마의 데이터 요소 간의 관계를 지정하는 맵(.xslt 파일)을 만들 수 있습니다. 표준 논리 앱 프로젝트의 컨텍스트 내에서 Azure Logic Apps(표준) 확장과 함께 Visual Studio Code를 사용하여 맵을 시각적으로 만들거나 편집할 수 있습니다. 데이터 매퍼 도구는 끌어서 놓기 제스처를 사용하여 매핑 및 변환을 위한 통합된 환경, 식을 빌드하기 위한 미리 빌드된 함수 및 워크플로에서 맵을 사용하기 전에 수동으로 테스트하는 방법을 제공합니다.
맵을 만든 후 논리 앱 프로젝트의 워크플로 또는 Azure Portal의 표준 논리 앱 워크플로에서 해당 맵을 직접 호출할 수 있습니다. 이 작업의 경우 워크플로에서 데이터 매퍼 XSLT를 사용하여 변환이라는 데이터 매퍼 작업 작업을 사용할 수 있습니다.
이 방법 가이드에서는 빈 데이터 맵을 만들고, 원본 및 대상 스키마를 선택하고, 스키마 요소 간에 다양한 종류의 매핑을 만들고, 맵을 저장 및 테스트한 다음, 논리 앱 프로젝트의 워크플로에서 맵을 호출하는 방법을 보여 줍니다.
제한 사항 및 알려진 문제
데이터 매퍼는 현재 Windows 운영 체제에서 실행되는 Visual Studio Code에서만 작동합니다.
데이터 매퍼는 현재 Azure Portal이 아닌 Visual Studio Code에서만 사용할 수 있으며 사용량 논리 앱 프로젝트가 아닌 표준 논리 앱 프로젝트 내에서만 사용할 수 있습니다.
데이터 매퍼는 현재 쉼표로 구분된 값(.csv) 파일 형식을 사용하는 스키마를 지원하지 않습니다.
데이터 매퍼의 코드 창은 현재 읽기 전용입니다.
데이터 매퍼의 레이아웃 및 항목 위치는 현재 자동이며 읽기 전용입니다.
Filter 함수는 큰따옴표로 묶인 숫자 조건(예: ">=10")을 올바르게 처리합니다. 그러나 이 함수는 현재 항목 이름이 "= '펜'인지 여부를 확인하는 것과 같은 문자열 비교에 대해 일관되게 동작하지 않습니다.
원본 및 대상 스키마의 부모 배열 요소 간에 매핑을 만들 때 매퍼는 배열 항목 요소를 반복하는 루프를 자동으로 추가합니다. 그러나 원본 및 대상 배열 항목 요소 간에 매핑을 명시적으로 만들어야 합니다.
데이터 매퍼를 사용하여 만든 맵을 호출하려면 데이터 매퍼 XSLT를 사용하여 Transform이라는 데이터 매퍼 작업 작업만 사용할 수 있습니다. 다른 도구를 사용하여 만든 맵의 경우 XML 변환이라는 XML 작업 작업을 사용합니다.
Azure Portal에서 워크플로와 함께 데이터 매퍼로 만든 맵을 사용하려면 표준 논리 앱 리소스에 직접 추가해야 합니다.
사용자 지정 함수는 현재 이 릴리스에서 지원되지 않습니다.
필수 조건
표준 논리 앱 워크플로를 만들 수 있는 Visual Studio Code 및 Azure Logic Apps(표준) 확장
참고 항목
이전의 별도 데이터 매퍼 확장은 이제 Azure Logic Apps(표준) 확장과 병합됩니다. 충돌을 방지하기 위해 Azure Logic Apps(표준) 확장을 설치하거나 업데이트할 때 기존 버전의 데이터 매퍼 확장이 제거됩니다. 확장이 설치되거나 업데이트되면 Visual Studio Code를 다시 시작하세요.
변환할 데이터 형식을 설명하는 원본 및 대상 스키마 파일. 이러한 파일은 다음 형식 중 하나일 수 있습니다.
- .xsd 파일 확장명을 사용하는 XML 스키마 정의 파일
- .json 파일 확장명을 사용하는 JavaScript 개체 표기법 파일
최소한 트리거가 있는 상태 저장 또는 상태 비정상 워크플로를 포함하는 표준 논리 앱 프로젝트입니다. 프로젝트가 없는 경우 Visual Studio Code에서 다음 단계를 수행합니다.
아직 연결하지 않은 경우 Azure 계정에 연결합니다.
로컬 폴더, 로컬 표준 논리 앱 프로젝트, 상태 저장 또는 상태 비저장 워크플로를 만듭니다. 워크플로를 만드는 동안 현재 창에서 열기를 선택합니다.
맵을 테스트하고 변환이 예상대로 작동하는지 확인하려는 경우 입력 데이터를 샘플링합니다.
XSLT 실행 함수를 사용하려면 XSLT 코드 조각이 .xml 또는 .xslt 파일 이름 확장명을 사용하는 파일에 있어야 합니다. XSLT 코드 조각을 로컬 프로젝트 폴더 구조(Artifacts>DataMapper>Extensions>InlineXslt)의 InlineXslt 폴더에 배치해야 합니다. 이 폴더 구조가 없으면 누락된 폴더를 만드세요.
데이터 맵 만들기
Visual Studio Code에서 표준 논리 앱 프로젝트의 폴더를 엽니다.
Visual Studio Code의 왼쪽 메뉴에서 Azure 아이콘을 선택합니다.
Azure 창의 데이터 매퍼 아래에서 데이터 맵 만들기를 선택합니다.
Visual Studio Code 제목 표시줄에서 지도의 이름을 제공할 수 있도록 프롬프트 상자가 열립니다.
프롬프트 상자에 데이터 맵 이름을 입력합니다.
이 가이드의 경우 이러한 단계에서는 Example-data-map이라는 이름을 사용합니다.
데이터 매퍼는 빈 데이터 맵을 만들고 엽니다.
다음 단계에 따라 원본 및 대상 스키마를 선택합니다.
원본 창에서 새>찾아보기 추가를 선택하여 원본 스키마를 찾아 업로드합니다.
원본 스키마를 추가한 후 원본 창은 원본 스키마의 데이터 형식에 대한 XML 요소 "노드"로 채워집니다. 예를 들면 다음과 같습니다.
대상 창에서 새>찾아보기 추가를 선택하여 대상 스키마를 찾아 업로드합니다.
대상 스키마를 추가한 후 대상 창은 대상 스키마의 데이터 형식에 대한 XML 요소 "노드"로 채워집니다. 예를 들면 다음과 같습니다.
팁
스키마를 로드하는 데 문제가 발생하는 경우 논리 앱 프로젝트의 아티/팩트 스키마 폴더에 원본 및 대상 스키마 파일을 로컬로 추가할 수 있습니다. 이 시나리오에서는 데이터 매퍼에서 원본 및 대상 스키마를 지정하려면 원본 및 대상 창에서 새로 추가를 사용하는 대신 기존 목록 선택을 열고 스키마를 선택합니다.
스키마 데이터 형식
다음 표에서는 스키마에 나타날 수 있는 가능한 데이터 형식을 설명합니다.
| 기호 | Type | 추가 정보 |
|---|---|---|
|
복합(배열) | 항목 또는 반복 항목 노드를 포함합니다. 배열 요소에는 다음 연결점도 표시됩니다. 
|
|
Bool | 참 또는 거짓만 |
|
복합 | Object JSON 형식과 비슷한 자식 속성이 있는 XML 개체 |
|
DateTime | |
|
소수 | |
|
정수 | 정수만 |
|
문자열 |
요소 간 직접 매핑 만들기
원본 스키마와 대상 스키마에서 형식이 동일한 요소 간에 간단한 변환을 지정하려면 다음 단계를 수행합니다.
매핑을 만드는 동안 코드에서 발생하는 작업을 보려면 매퍼의 오른쪽 위 모서리에서 코드 보기를 선택합니다.
매퍼 화면의 원본 창에서 매핑할 원본 요소를 찾습니다.
기본적으로 부모 요소는 자동으로 확장되어 자식을 표시합니다.
이 예제에서는 원본 요소에서 매핑을 시작하지만 대상 요소에서 매핑을 시작하도록 선택할 수 있습니다.
포인터가 더하기 기호(+)로 변경될 때까지 원본 요소 이름 옆의 원 위로 마우스 포인터를 이동합니다.
이 예제에서는 Employee ID 원본 요소에서 시작하는 매핑을 만듭니다.
원본 요소가 대상 창의 대상 요소에 대한 원에 연결되도록 선을 끌어서 그립니다.
다음은 원본 요소와 데이터 형식이 같은 ID 대상 요소와의 매핑을 완료하는 예제입니다.
이제 데이터 형식이 동일한 두 요소 간에 직접 매핑을 만들었습니다.
코드 창에는 사용자가 만든 매핑 관계가 표시됩니다.
팁
매핑에 문제가 있는지 확인하려면 문제 보기를 선택합니다. 예를 들어 데이터 형식이 일치하지 않는 요소 간에 매핑을 만들면 경고 탭의 문제 목록에 경고 가 표시됩니다.
복잡한 요소 간 매핑 만들기
원본 스키마와 대상 스키마의 요소 간에 보다 복잡한 변환을 지정하려면(예: 다른 데이터 형식을 결합하거나 사용하려는 요소) 매핑에서 원하는 변환을 수행하는 하나 이상의 함수 를 사용할 수 있습니다.
매퍼 화면에서 함수 레이블은 함수 그룹에 따라 색으로 구분됩니다. 함수 이름 옆에 함수의 기호가 나타납니다. 예를 들면 다음과 같습니다.
다음 표에서는 사용할 수 있는 함수 그룹 및 몇 가지 예제 함수를 나열합니다. 전체 목록은 데이터 매퍼의 함수 목록을 참조하세요.
| 그룹 | 예제 함수 |
|---|---|
| 컬렉션 | Average, Count, Direct Access, Distinct values, Filter, Index, Join, Maximum, Minimum, Reverse, Sort, Subsequence, Sum |
| 전환 | 현재까지, 정수로, 숫자로, 문자열로 |
| 날짜 및 시간 | 일, 현재 날짜, 현재 시간, 같음 날짜 추가 |
| 논리적 비교 | Equal, Exists, Greater, Greater 또는 equal, If, If, If Nil, Is Null, Is Number, Is String, Less, Less or Equal, Logical AND, Logical NOT, Logical OR, Not Equal |
| Math | Absolute, Add, Arctangent, Ceiling, Cosine, Divide, Exponential, Exponential (base 10), Floor, Integer Divide, Log, Log (base 10), Module, Multiply, Power, Round, Sine, Square Root, Subtract, Tangent |
| String | Codepoints to String, Concat, Contains, Ends with, Length, Lowercase, Name, Regular Expression Matches, Regular Expression Replace, Replace, Starts with, String to Codepoints, Substring, Substring after, Substring before, Trim, Trim Left, Trim Right, Uppercase |
| Utility | 복사, 오류, XPath 실행, DateTime 서식, 서식 번호, XSLT 실행 |
매핑 없이 함수 추가
이 섹션의 예제에서는 원본 요소의 데이터를 대상 요소 형식인 String에서 DateTime으로 변환합니다. 이 예제는 먼저 매핑을 만들지 않고 시작하고 단일 입력을 허용하는 To Date 함수를 사용합니다.
매핑을 만드는 동안 코드에서 발생하는 작업을 보려면 매퍼의 오른쪽 위 모서리에서 코드 보기를 선택합니다.
함수 목록에서 사용하려는 함수를 찾아 선택합니다. 그러면 매퍼 화면에 함수가 추가됩니다. 함수 목록이 축소되면 매퍼의 왼쪽 위 모서리에서 함수 아이콘(
)을 선택합니다.다음은 변환 함수 그룹에 있는 To Date 함수를 선택하는 예제입니다.
참고 항목
맵에 매핑이 없거나 맵에 함수를 추가할 때 매핑이 선택되면 함수가 나타나지만 요소나 다른 함수에 연결되지 않습니다. 예를 들면 다음과 같습니다.
함수를 원본 및 대상 요소에 연결합니다.
소스 요소와 함수의 왼쪽 가장자리에 있는 원 사이의 선을 끌어서 그립니다. 원본 요소 또는 함수에서 시작할 수 있습니다.
함수의 오른쪽 가장자리와 대상 요소 사이에 선을 끌어서 그립니다. 대상 요소 또는 함수에서 시작할 수 있습니다.
코드 창에는 사용자가 만든 매핑 관계가 표시됩니다.
매퍼 화면에서 함수 셰이프를 선택하여 함수 세부 정보를 봅니다.
입력 탭에서 사용할 입력을 확인하거나 편집합니다.
일부 시나리오에서는 원본 및 대상 요소의 즉각적인 쌍을 넘어 변환을 정의해야 합니다. 예를 들어 배열 쌍과 해당 항목 간의 변환을 정의하려면 배열 간에 루프를 만들어야 합니다. 또는 요소의 값이 조건을 충족할 때 작업을 수행하려면 요소 간에 조건을 추가해야 합니다.
여러 입력을 사용하는 함수 추가
이 섹션의 예제에서는 여러 소스 요소를 입력으로 연결하고 단일 출력을 대상 요소에 매핑합니다. 이 예제에서는 여러 입력을 허용하는 Concat 함수를 사용합니다.
매핑을 만드는 동안 코드에서 발생하는 작업을 보려면 매퍼의 오른쪽 위 모서리에서 코드 보기를 선택합니다.
함수 목록에서 사용하려는 함수를 찾아 선택합니다. 그러면 매퍼 화면에 함수가 추가됩니다.
함수 목록이 축소되면 매퍼의 왼쪽 위 모서리에서 함수 아이콘(
)을 선택합니다.다음은 문자열 함수 그룹에 있는 Concat 함수를 선택하는 예제입니다.
참고 항목
맵에 매핑이 없거나 맵에 함수를 추가할 때 매핑이 선택되면 함수가 나타나지만 요소나 다른 함수에 연결되지 않습니다. 예를 들면 다음과 같습니다.
매퍼 화면에서 함수 셰이프를 선택하여 함수 세부 정보를 봅니다.
입력 탭에서 입력으로 사용할 원본 스키마 요소를 선택합니다.
다음은 FirstName 및 LastName 원본 스키마 요소를 함수 입력으로 선택하는 예제입니다. 매퍼는 원본 요소와 함수 간에 각 매핑을 자동으로 추가합니다.
매핑을 완료하려면 함수의 오른쪽 가장자리와 대상 요소 사이에 선을 끌어서 그립니다. 대상 요소 또는 함수에서 시작할 수 있습니다.
코드 창에는 사용자가 만든 매핑 관계가 표시됩니다.
배열 반복
원본 및 대상 스키마에 배열이 포함된 경우 배열의 항목을 반복하는 루프를 만들 수 있습니다. 이 섹션의 예제에서는 배열 항목 간의 매핑과 함께 Employee 원본 배열 및 Person 대상 배열을 통해 루프를 만듭니다.
매핑을 만드는 동안 코드에서 발생하는 작업을 보려면 매퍼의 오른쪽 위 모서리에서 코드 보기를 선택합니다.
매퍼 화면의 원본 및 대상 창에서 매핑할 배열을 찾습니다.
배열 항목 쌍 사이에 선을 끌어서 그립니다. 원본 창 또는 대상 창에서 시작할 수 있습니다.
다음 예제는 원본 창에서 시작하여 Employee 원본 배열 및 Person 대상 배열의 이름 항목을 매핑 합니다.
배열 항목의 첫 번째 쌍 매핑을 완료한 후 매퍼는 원본 및 대상 배열 부모 요소 간에 루프를 자동으로 추가합니다. 연결점 유형은 다음과 같습니다.
다음 예제에서는 원본 Employee 과 대상 사람 부모 배열 간에 자동으로 추가된 루프를 강조 표시합니다.
코드 창에는 사용자가 만든 매핑 및 루프가 표시됩니다.
다른 배열 요소 매핑을 계속합니다. 예를 들면 다음과 같습니다.
작업을 수행하는 조건 평가
조건을 평가하고 조건이 충족되면 작업을 수행하는 매핑을 추가하려고 합니다. 이 시나리오에서는 여러 함수를 사용할 수 있습니다.
다음 예제에서 구매 수량이 20개 항목을 초과하면 매핑은 다음 함수를 사용하여 적용할 할인을 계산합니다.
| 함수 그룹 | 함수 | 이 예제의 용도 |
|---|---|---|
| 비교 | 더 큼 | 구매 수량이 20을 초과하는지 확인합니다. |
| 비교 | If | Greater 함수가 true를 반환하는지 확인합니다. |
| Math | 곱하기 | 조건이 맞으면 항목 가격을 10%로 곱하여 할인을 계산합니다. |
원본 및 대상 창에서 시나리오에서 매핑할 요소를 찾습니다.
이 예제에서는 다음 요소를 사용합니다.
원본 창: ItemPrice 및 ItemQuantity
대상 창: ItemPrice, ItemQuantity 및 ItemDiscount
함수 목록에서 사용하려는 함수를 찾아 선택하여 매퍼 화면에 함수를 추가합니다.
함수 목록이 축소되면 매퍼의 왼쪽 위 모서리에서 함수 아이콘(
)을 선택합니다.필요한 경우 더 쉽게 선택할 수 있도록 매퍼 화면에서 함수 셰이프를 이동합니다.
다음은 매퍼 화면에 다음 함수를 추가하는 예제입니다. Greater, If 및 Multiply
매핑을 만드는 동안 코드에서 발생하는 작업을 보려면 매퍼의 오른쪽 위 모서리에서 코드 보기를 선택합니다.
시나리오에 필요한 대로 원본 요소, 함수 및 대상 요소를 특정 순서대로 연결합니다.
다음은 지정된 순서대로 다음 항목을 연결하여 매핑을 올바르게 만드는 예제입니다.
시작 끝 ItemPrice 원본 요소 ItemPrice 대상 요소 ItemQuantity 원본 요소 셰이프의 왼쪽 가장자리에 더 큰 함수의 입력입니다. 이 입력은 함수 세부 정보의 값 1 필드에 대한 데이터를 제공합니다. 셰이프의 오른쪽 가장자리에 있는 더 큰 함수의 출력 셰이프의 왼쪽 가장자리에 함수가 입력된 경우 이 입력은 함수 세부 정보의 조건 필드에 대한 데이터를 제공합니다. ItemPrice 원본 요소 셰이프의 왼쪽 가장자리에 함수의 입력을 곱 합니다. 이 입력은 함수 세부 정보의 Multiplicand 필드에 대한 데이터를 제공합니다. 셰이프의 오른쪽 가장자리에 함수의 출력을 곱 합니다. 셰이프의 왼쪽 가장자리에 함수가 입력된 경우 이 입력은 함수 세부 정보의 값 필드에 대한 데이터를 제공합니다. 셰이프의 오른쪽 가장자리에 있는 함수의 출력인 경우 ItemDiscount 대상 요소 다음 예제에서는 이 시점의 매핑을 보여 줍니다.
다음 함수 세부 정보의 입력 탭에서 다음 값을 확인하거나 제공합니다.
함수 입력 필드 및 값 더 큼 - 값 1: ItemQuantity 원본 요소
- 값 2: 사용자 지정 값으로 20곱하기 - Multiplicand 1: ItemPrice 원본 요소
- 곱하기 2: .10 을 사용자 지정 값으로If - 조건: is-greater-than(ItemQuantity, 20)
- Value: multiply(ItemPrice, .10)완성된 맵의 예는 다음과 같습니다.
코드 창에는 사용자가 만든 매핑이 표시됩니다.
맵 저장
완료되면 맵 도구 모음에서 저장을 선택합니다.
Visual Studio Code에서 맵을 다음 아티팩트로 저장합니다.
- Artifacts MapDefinitions> 프로젝트 폴더의 your-map-name.love> my life 파일<
- < your-map-name>.xslt 파일을 Artifacts>Maps 프로젝트 폴더에 저장
맵 테스트
변환이 예상대로 작동하는지 확인하려면 샘플 입력 데이터가 필요합니다.
지도 도구 모음에서 테스트 패널 열기를 선택합니다.
테스트 맵 창의 샘플 데이터 상자에 샘플 입력을 붙여넣고 테스트를 선택합니다.
결과 상자에는 테스트 결과가 표시됩니다.
프로젝트의 워크플로에서 맵 호출
Visual Studio Code 작업 표시줄에서 탐색기(파일 아이콘)를 선택하여 논리 앱 프로젝트 구조를 봅니다.
워크플로 이름이 있는 폴더를 확장합니다. workflow.json 파일의 바로 가기 메뉴에서 디자이너 열기를 선택합니다.
워크플로 디자이너에서 데이터 매퍼 XSLT를 사용하여 변환이라는 데이터 매퍼 작업 기본 제공 작업을 추가하는 일반 단계를 수행합니다.
디자이너에서 데이터 매퍼 XSLT를 사용하여 변환 작업을 선택합니다.
표시되는 작업 정보 창에서 콘텐츠 값을 지정하고 맵 원본을 LogicApp에 설정된 상태로 둡니다.
지도 이름 목록을 열고 지도(.xslt 파일)를 선택합니다.
Azure Portal에서 동일한 데이터 매퍼 XSLT를 사용하여 변환 작업을 사용하려면 맵을 표준 논리 앱 리소스에 추가해야 합니다.
관련 콘텐츠
- Azure Logic Apps에서 B2B 작업을 사용하는 데이터 변환은 Azure Logic Apps를 사용하여 워크플로에서 변환을 위한 맵 추가를 참조하세요.