엔터프라이즈 통합 팩이 포함된 Azure Logic Apps에서 맵을 사용하여 XML 변환Transform XML with maps in Azure Logic Apps with Enterprise Integration Pack

Azure Logic Apps에서 엔터프라이즈 통합 시나리오의 형식 간에 XML 데이터를 전송하기 위해 논리 앱을 맵, 구체적으로 말하면, XLST(Extensible Stylesheet Language Transformation) 맵을 사용할 수 있습니다.To transfer XML data between formats for enterprise integration scenarios in Azure Logic Apps, your logic app can use maps, or more specifically, Extensible Style sheet Language Transformations (XSLT) maps. 맵은 XML 문서의 데이터를 다른 형식으로 변환하는 방법을 설명하는 XML 문서입니다.A map is an XML document that describes how to convert data from an XML document into another format.

예를 들어, YYYMMDD 날짜 형식을 사용하는 고객에게서 정기적으로 B2B 주문 또는 송장을 받는 경우를 가정해 보겠습니다.For example, suppose you regularly receive B2B orders or invoices from a customer who uses the YYYMMDD date format. 그러나 조직은 MMDDYYY 날짜 형식을 사용합니다.However, your organization uses the MMDDYYY date format. 고객 작업 데이터베이스에서 주문 또는 송장 세부 정보를 저장하기 전에 YYYMMDD 날짜 형식을 MMDDYYY 형식으로 변환하는 맵을 정의하여 사용할 수 있습니다.You can define and use a map that transforms the YYYMMDD date format to the MMDDYYY format before storing the order or invoice details in your customer activity database.

통합 계정 및 아티팩트(예: 맵)와 관련된 제한에 대해서는 Azure Logic Apps에 대한 제한 및 구성 정보를 참조하세요.For limits related to integration accounts and artifacts such as maps, see Limits and configuration information for Azure Logic Apps.

필수 구성 요소Prerequisites

  • Azure 구독An Azure subscription. 구독이 없는 경우 Azure 체험 계정에 등록합니다.If you don't have a subscription, sign up for a free Azure account.

  • 통합 계정: 엔터프라이즈 통합 및 B2B(기업 간) 솔루션을 위한 맵 및 기타 아티팩트를 저장합니다.An integration account where you store your maps and other artifacts for enterprise integration and business-to-business (B2B) solutions.

  • 맵이 외부 어셈블리를 참조하는 경우 어셈블리 및 맵을 둘 다 통합 계정에 업로드해야 합니다.If your map references an external assembly, you have to upload both the assembly and the map to your integration account. 먼저 어셈블리를 업로드한 다음 어셈블리를 참조 하는 맵을 업로드 해야 합니다.Make sure you upload your assembly first, and then upload the map that references the assembly.

    어셈블리가 2MB 이하 이면 Azure Portal에서 직접 통합 계정에 어셈블리를 추가할 수 있습니다.If your assembly is 2 MB or smaller, you can add your assembly to your integration account directly from the Azure portal. 그러나 어셈블리 또는 맵이 2MB보다는 크지만 어셈블리 또는 맵의 크기 제한보다 크지 않으면 다음 옵션을 사용할 수 있습니다.However, if your assembly or map is bigger than 2 MB but not bigger than the size limit for assemblies or maps, you have these options:

맵을 만들고 추가할 때 논리 앱은 필요하지 않습니다.You don't need a logic app when creating and adding maps. 그러나 맵을 사용하려면 논리 앱에서 해당 맵을 저장하는 통합 계정에 연결해야 합니다.However, to use a map, your logic app needs linking to an integration account where you store that map. 논리 앱을 통합 계정에 연결하는 방법을 알아봅니다.Learn how to link logic apps to integration accounts. 논리 앱이 아직 없는 경우 논리 앱을 만드는 방법을 알아봅니다.If you don't have a logic app yet, learn how to create logic apps.

참조된 어셈블리 추가Add referenced assemblies

  1. Azure 계정 자격 증명을 사용하여 Azure Portal에 로그인합니다.Sign in to the Azure portal with your Azure account credentials.

  2. 통합 계정을 찾아서 열려면 Azure 주 메뉴에서 모든 서비스 를 선택합니다.To find and open your integration account, on the main Azure menu, select All services. 검색 상자에 "통합 계정"을 입력합니다.In the search box, enter "integration account". 통합 계정 을 선택 합니다.Select Integration accounts.

    통합 계정 찾기

  3. 어셈블리를 추가할 통합 계정을 선택합니다. 예를 들면 다음과 같습니다.Select the integration account where you want to add your assembly, for example:

    통합 계정 선택

  4. 통합 계정의 개요 페이지에 있는 구성 요소 에서 어셈블리 타일을 선택합니다.On your integration account's Overview page, under Components, select the Assemblies tile.

    “어셈블리” 선택

  5. 어셈블리 페이지가 열리면 추가 를 선택합니다.After the Assemblies page opens, choose Add.

    어셈블리 페이지의 추가 단추를 강조 표시 하는 스크린샷

어셈블리 파일의 크기에 따라 2MB보다 작거나2MB보다 크고 8MB보다 작은 어셈블리를 업로드하는 단계를 따릅니다.Based on your assembly file's size, follow the steps for uploading an assembly that's either up to 2 MB or more than 2 MB but only up to 8 MB. 통합 계정의 어셈블리 수량 제한에 대해서는 Azure Logic Apps의 제한 및 구성을 참조하세요.For limits on assembly quantities in integration accounts, see Limits and configuration for Azure Logic Apps.

참고

어셈블리를 변경 하는 경우 지도에 변경 내용이 있는지 여부에 관계 없이 맵도 업데이트 해야 합니다.If you change your assembly, you must also update your map whether or not the map has changes.

최대 2MB의 어셈블리 추가Add assemblies up to 2 MB

  1. 어셈블리 추가 에서 어셈블리의 이름을 입력합니다.Under Add Assembly, enter a name for your assembly. 작은 파일 을 선택한 상태로 둡니다.Keep Small file selected. 어셈블리 상자 옆에서 폴더 아이콘을 선택합니다.Next to the Assembly box, choose the folder icon. 업로드하려는 어셈블리를 찾아 선택합니다. 예를 들면 다음과 같습니다.Find and select the assembly you're uploading, for example:

    더 작은 어셈블리 업로드

    어셈블리를 선택하면 어셈블리 이름 속성에 어셈블리 파일 이름이 자동으로 나타납니다.In the Assembly Name property, the assembly's file name appears automatically after you select the assembly.

  2. 준비가 되면 확인 을 선택합니다.When you're ready, choose OK.

    어셈블리 파일 업로드가 완료되면 어셈블리가 어셈블리 목록에 나타납니다.After your assembly file finishes uploading, the assembly appears in the Assemblies list.

    업로드된 어셈블리 목록

    통합 계정의 개요 페이지에 있는 구성 요소 에서 어셈블리 타일에는 이제 업로드된 어셈블리의 수가 표시됩니다. 예를 들면 다음과 같습니다.On your integration account's Overview page, under Components, the Assemblies tile now shows the number of uploaded assemblies, for example:

    업로드된 어셈블리

2MB보다 큰 어셈블리 추가Add assemblies more than 2 MB

더 큰 어셈블리를 추가하려면 Azure Storage 계정의 Azure blob 컨테이너에 어셈블리를 업로드할 수 있습니다.To add larger assemblies, you can upload your assembly to an Azure blob container in your Azure storage account. 어셈블리를 추가 하는 단계는 blob 컨테이너에 공용 읽기 권한이 있는지 여부에 따라 달라 집니다.Your steps for adding assemblies differ based whether your blob container has public read access. 먼저 다음 단계를 수행 하 여 blob 컨테이너에 공용 읽기 액세스 권한이 있는지 확인 합니다. blob 컨테이너에 대 한 공용 액세스 수준 설정So first, check whether or not your blob container has public read access by following these steps: Set public access level for blob container

컨테이너 액세스 수준 확인Check container access level

  1. Azure Storage Explorer를 엽니다.Open Azure Storage Explorer. 탐색기 창에서 Azure 구독을 아직 확장하지 않은 경우 확장합니다.In the Explorer window, expand your Azure subscription if not already expanded.

  2. Storage 계정 > {your-storage-account} > Blob 컨테이너 를 확장합니다.Expand Storage Accounts > {your-storage-account} > Blob Containers. Blob 컨테이너를 선택합니다.Select your blob container.

  3. Blob 컨테이너의 바로 가기 메뉴에서 공용 액세스 수준 설정 을 선택합니다.From your blob container's shortcut menu, select Set Public Access Level.

공용 액세스 권한이 있는 컨테이너에 업로드Upload to containers with public access

  1. 스토리지 계정에 어셈블리를 업로드합니다.Upload the assembly to your storage account. 오른쪽 창에서 업로드 를 선택합니다.In the right-hand window, choose Upload.

  2. 업로드가 완료되면 업로드된 어셈블리를 선택합니다.After you finish uploading, select your uploaded assembly. 도구 모음에서 어셈블리 URL을 복사할 수 있도록 URL 복사 를 선택합니다.On the toolbar, choose Copy URL so that you copy the assembly's URL.

  3. 어셈블리 추가 창이 열려 있는 Azure Portal로 돌아갑니다.Return to the Azure portal where the Add Assembly pane is open. 어셈블리의 이름을 입력합니다.Enter a name for your assembly. 대용량 파일(2MB 초과) 을 선택합니다.Choose Large file (larger than 2 MB).

    이제 어셈블리 상자가 아닌 콘텐츠 URI 상자가 나타납니다.The Content URI box now appears, rather than the Assembly box.

  4. 콘텐츠 URI 상자에서 어셈블리의 URL을 붙여 넣습니다.In the Content URI box, paste your assembly's URL. 어셈블리 추가를 완료합니다.Finish adding your assembly.

어셈블리 업로드가 완료되면 스키마가 어셈블리 목록에 나타납니다.After your assembly finishes uploading, the schema appears in the Assemblies list. 통합 계정의 개요 페이지에 있는 구성 요소 에서 어셈블리 타일에는 이제 업로드된 어셈블리의 수가 표시됩니다.On your integration account's Overview page, under Components, the Assemblies tile now shows the number of uploaded assemblies.

공용 액세스 권한이 없는 컨테이너에 업로드Upload to containers without public access

  1. 스토리지 계정에 어셈블리를 업로드합니다.Upload the assembly to your storage account. 오른쪽 창에서 업로드 를 선택합니다.In the right-hand window, choose Upload.

  2. 업로드를 마친 후에 어셈블리의 SAS(공유 액세스 서명)을 생성합니다.After you finish uploading, generate a shared access signature (SAS) for your assembly. 어셈블리의 바로 가기 메뉴에서 공유 액세스 서명 가져오기 를 선택합니다.From your assembly's shortcut menu, select Get Shared Access Signature.

  3. 공유 액세스 서명 창에서 컨테이너 수준 공유 액세스 서명 URI 생성 > 만들기 를 선택합니다.In the Shared Access Signature pane, select Generate container-level shared access signature URI > Create. SAS URL이 생성되면 URL 상자 옆에서 복사 를 선택합니다.After the SAS URL gets generated, next to the URL box, choose Copy.

  4. 어셈블리 추가 창이 열려 있는 Azure Portal로 돌아갑니다.Return to the Azure portal where the Add Assembly pane is open. 어셈블리의 이름을 입력합니다.Enter a name for your assembly. 대용량 파일(2MB 초과) 을 선택합니다.Choose Large file (larger than 2 MB).

    이제 어셈블리 상자가 아닌 콘텐츠 URI 상자가 나타납니다.The Content URI box now appears, rather than the Assembly box.

  5. 콘텐츠 URI 상자에서 이전에 생성한 SAS URI를 붙여 넣습니다.In the Content URI box, paste the SAS URI you previously generated. 어셈블리 추가를 완료합니다.Finish adding your assembly.

어셈블리 업로드가 완료되면 어셈블리가 스키마 목록에 나타납니다.After your assembly finishes uploading, the assembly appears in the Schemas list. 통합 계정의 개요 페이지에 있는 구성 요소 에서 어셈블리 타일에는 이제 업로드된 어셈블리의 수가 표시됩니다.On your integration account's Overview page, under Components, the Assemblies tile now shows the number of uploaded assemblies.

맵 만들기Create maps

맵으로 사용할 수 있는 XSLT 문서를 만들려면 엔터프라이즈 통합 팩을 사용하여 BizTalk 통합 프로젝트를 만들기 위해 Visual Studio 2015를 사용할 수 있습니다.To create an XSLT document you can use as a map, you can use Visual Studio 2015 for creating a BizTalk Integration project by using the Enterprise Integration Pack. 이 프로젝트에서 두 개의 XML 스키마 파일 간에 항목을 시각적으로 매핑할 수 있는 통합 맵 파일을 빌드할 수 있습니다.In this project, you can build an integration map file, which lets you visually map items between two XML schema files. 이 프로젝트를 빌드하면 XSLT 문서가 생성됩니다.After you build this project, you get an XSLT document. 통합 계정의 맵 수량 제한에 대해서는 Azure Logic Apps의 제한 및 구성을 참조하세요.For limits on map quantities in integration accounts, see Limits and configuration for Azure Logic Apps.

맵 추가Add maps

맵이 참조하는 모든 어셈블리를 업로드한 후에는 맵을 업로드할 수 있습니다.After you upload any assemblies that your map references, you can now upload your map.

  1. 아직 로그인하지 않은 경우 Azure 계정 자격 증명을 사용하여 Azure Portal에 로그인합니다.If you haven't signed in already, sign in to the Azure portal with your Azure account credentials.

  2. 통합 계정을 아직 열지 않은 경우 Azure 주 메뉴에서 모든 서비스 를 선택합니다.If your integration account isn't already open, on the main Azure menu, select All services. 검색 상자에 "통합 계정"을 입력합니다.In the search box, enter "integration account". 통합 계정 을 선택 합니다.Select Integration accounts.

    통합 계정 찾기

  3. 맵을 추가할 통합 계정을 선택합니다. 예를 들면 다음과 같습니다.Select the integration account where you want to add your map, for example:

    통합 계정 선택

  4. 통합 계정의 개요 페이지에 있는 구성 요소 에서 타일을 선택합니다.On your integration account's Overview page, under Components, select the Maps tile.

    “맵” 선택

  5. 페이지가 열리면 추가 를 선택합니다.After the Maps page opens, choose Add.

    "추가" 선택

최대 2MB의 맵 추가Add maps up to 2 MB

  1. 맵 추가 에서 맵의 이름을 입력합니다.Under Add Map, enter a name for your map.

  2. 지도 유형 아래에서 유형 (예: 액체, Xslt, xslt 2.0 또는 xslt 3.0)을 선택 합니다.Under Map type, select the type, for example: Liquid, XSLT, XSLT 2.0, or XSLT 3.0.

  3. 작은 파일 을 선택한 상태로 둡니다.Keep Small file selected. 상자 옆에서 폴더 아이콘을 선택합니다.Next to the Map box, choose the folder icon. 업로드하려는 맵을 찾아 선택합니다. 예를 들면 다음과 같습니다.Find and select the map you're uploading, for example:

    맵 업로드

    이름 속성을 비워 두면 맵 파일을 선택한 후에 해당 속성에 맵의 파일 이름이 자동으로 나타납니다.If you left the Name property empty, the map's file name automatically appears in that property automatically after you select the map file. 그러나 어떤 고유한 이름도 사용할 수 있습니다.However, you can use any unique name.

  4. 준비가 되면 확인 을 선택합니다.When you're ready, choose OK. 맵 파일 업로드가 완료되면 목록에 해당 맵이 나타납니다.After your map file finishes uploading, the map appears in the Maps list.

    업로드된 맵 목록

    통합 계정의 개요 페이지에 있는 구성 요소 에서 타일에는 이제 업로드된 맵의 수가 표시됩니다. 예를 들면 다음과 같습니다.On your integration account's Overview page, under Components, the Maps tile now shows the number of uploaded maps, for example:

    업로드된 맵

2MB보다 큰 맵 추가Add maps more than 2 MB

현재, 더 큰 맵을 추가하려면 Azure Logic Apps REST API - 맵을 사용합니다.Currently, to add larger maps, use the Azure Logic Apps REST API - Maps.

맵 편집Edit maps

기존 맵을 업데이트하려면 원하는 변경 내용이 있는 새 맵 파일을 업로드해야 합니다.To update an existing map, you have to upload a new map file that has the changes you want. 그러나 편집을 위해 기존 맵을 먼저 다운로드할 수 있습니다.However, you can first download the existing map for editing.

  1. Azure Portal에서 통합 계정이 아직 열려 있지 않으면 찾아서 엽니다.In the Azure portal, find and open your integration account, if not already open.

  2. Azure 주 메뉴에서 모든 서비스 를 선택합니다.On the main Azure menu, select All services. 검색 상자에 "통합 계정"을 입력합니다.In the search box, enter "integration account". 통합 계정 을 선택 합니다.Select Integration accounts.

  3. 맵을 업데이트할 통합 계정을 선택합니다.Select the integration account where you want to update your map.

  4. 통합 계정의 개요 페이지에 있는 구성 요소 에서 타일을 선택합니다.On your integration account's Overview page, under Components, select the Maps tile.

  5. 페이지가 열리면 맵을 선택합니다.After the Maps page opens, select your map. 맵을 먼저 다운로드한 후 편집하려면 다운로드 를 선택하고 맵을 저장합니다.To download and edit the map first, choose Download, and save the map.

  6. 업데이트된 맵을 업로드할 준비가 되면 페이지에서 업데이트하려는 맵을 선택하고 업데이트 를 선택합니다.When you're ready to upload the updated map, on the Maps page, select the map you want to update, and choose Update.

  7. 업로드하려는 업데이트된 맵을 찾아 선택합니다.Find and select the updated map you want to upload. 맵 파일 업로드가 완료되면 업데이트된 목록에 해당 맵이 나타납니다.After your map file finishes uploading, the updated map appears in the Maps list.

맵 삭제Delete maps

  1. Azure Portal에서 통합 계정이 아직 열려 있지 않으면 찾아서 엽니다.In the Azure portal, find and open your integration account, if not already open.

  2. Azure 주 메뉴에서 모든 서비스 를 선택합니다.On the main Azure menu, select All services. 검색 상자에 "통합 계정"을 입력합니다.In the search box, enter "integration account". 통합 계정 을 선택 합니다.Select Integration accounts.

  3. 맵을 삭제할 통합 계정을 선택합니다.Select the integration account where you want to delete your map.

  4. 통합 계정의 개요 페이지에 있는 구성 요소 에서 타일을 선택합니다.On your integration account's Overview page, under Components, select the Maps tile.

  5. 페이지가 열리면 맵을 선택하고 삭제 를 선택합니다.After the Maps page opens, select your map, and choose Delete.

  6. 맵을 삭제할지 확인하려면 를 선택합니다.To confirm you want to delete the map, choose Yes.

다음 단계Next steps