호스트 파일에 대한 메타데이터 아티팩트 디자인
이 가이드에서는 호스트 파일에 대한 메타데이터 아티팩트 디자인 방법을 보여 줍니다. 그런 다음, 이러한 메타데이터 아티팩트 를 AZURE Logic Apps의 호스트 파일 기본 제공 서비스 공급자 기반 커넥터와 함께 사용할 HIDX(Host Integration Server Definition XML) 파일로 저장할 수 있습니다.
사전 요구 사항
Visual Studio 다운로드 및 설치. 설치 후 Visual Studio에서 C++를 사용하여 데스크톱 개발 이라는 워크로드도 설치해야 합니다. 그렇지 않으면 HRESULT 0x800A007C 예외 오류가 발생합니다.
Azure Logic Apps용 HIS Designer 다운로드하여 설치합니다. 유일한 필수 구성 요소는 Microsoft .NET Framework 4.8입니다.
Azure Logic Apps에서 플랫 파일 프로세서에 대한 Visual Studio 지원을 사용하도록 설정합니다. 이 작업의 경우, 다음 단계를 따릅니다.
Visual Studio를 엽니다. 도구 모음에서 도구 메뉴를 열고 옵션을 선택합니다.
옵션 목록에서 호스트 통합 서버를 확장하고 호스트 파일을 선택합니다.
호스트 환경 탭에서 플랫 파일 프로세서 및 Logic Apps에 대한 지원 포함을 선택합니다.
호스트 파일 프로젝트 만들기
Visual Studio에서 호스트 파일 프로젝트 템플릿을 사용하여 메타데이터 아티팩트 만들기를 수행할 수 있습니다. 그런 다음, Azure Logic Apps용 표준 워크플로에서 호스트 파일 기본 제공 서비스 공급자 기반 커넥터와 함께 이러한 아티팩트 를 사용할 수 있습니다. 새 호스트 파일 프로젝트를 만들려면 다음 단계를 수행합니다.
Visual Studio의 파일 메뉴에서 새 새>프로젝트를 선택합니다.
프로젝트 템플릿 목록에서 호스트 파일>다음을 선택합니다.
새 프로젝트 구성 상자에서 원하는 세부 정보를 변경하고 만들기를 선택합니다.
호스트 파일 정의 추가
Azure Logic Apps에서 호스트 파일 커넥터를 지원하려면 호스트 파일 정의를 추가해야 합니다.
솔루션 탐색기 새 호스트 파일 프로젝트의 바로 가기 메뉴를 열고호스트 파일 정의 추가를> 선택합니다.
새 항목 추가 상자가 나타나면 이름 속성에서 호스트 파일 정의의 이름을 입력하고 추가를 선택합니다.
이러한 단계는 예제 이름 HostFileDefinition1을 계속합니다.
호스트 파일 정의 마법사가 시작되면 호스트 환경 상자에서 다음 표에 따라 호스트 환경 및 호스트 언어를 선택합니다.
호스트 환경 호스트 언어 System z용 호스트 파일 (z 시리즈 IBM 메인프레임 시스템) COBOL System i용 호스트 파일 (i 시리즈 IBM 미드레인지 시스템) COBOL 또는 RPG 완료되면 만들기를 선택합니다.
마법사를 완료하면 메타데이터 아티팩트 만들기 또는 가져오기를 위해 기본 디자인 보기가 나타납니다. 이 작업의 경우 다음 섹션으로 계속 진행합니다.
메타데이터 아티팩트 디자인
이 섹션에서는 메타데이터 아티팩트 만들기를 수동으로 만드는 방법을 보여줍니다. 대신 호스트 정의를 가져오려면 호스트 정의 가져오기를 참조하세요.
다음 표에서는 기본 디자인 뷰의 구성 요소를 나열합니다.
| 구성 요소 | 설명 |
|---|---|
| 테이블 폴더 | 테이블은 호스트 파일과 스키마 간의 매핑을 정의합니다. Tables 폴더는 어셈블리의 데이터 테이블을 그룹화합니다. |
| 스키마 폴더 | 스키마는 호스트 파일 레코드 필드와 .NET 데이터 형식 간의 매핑을 정의합니다. 스키마 폴더는 공유 특성을 사용하여 변수를 그룹화합니다. |
| Unions 폴더 | 공용 구조체는 형식에 따라 규칙 집합을 적용할 수 있습니다. Unions 폴더에는 COBOL 공용 구조체에 해당하는 항목이 포함되어 있습니다. |
테이블 추가
기본 디자인 보기에서 테이블 바로 가기 메뉴를 열고 테이블 추가를 선택합니다.
새 테이블의 바로 가기 메뉴를 열고 속성을 선택합니다. 다음 표에 따라 각 열의 속성에 대한 값을 제공합니다.
속성 설명 또는 값 별칭 [A-Za-z]로 시작하고 최대 길이가 256인 영숫자 문자(예: CUSTOMER)로 시작하는 유효한 별칭입니다. 호스트 파일 이름 메인프레임 파일 이름에는 마침표(.)로 구분된 최대 22개의 부분이 있습니다. 각 파트는 10자로 제한됩니다. 최대 총 크기는 44자입니다(예: HISDEMO). Nwind. 고객 스키마 데이터 형식을 포함하여 호스트 파일의 구조를 나타냅니다. 
스키마 추가
기본 디자인 보기에서 스키마 바로 가기 메뉴를 열고 스키마 추가를 선택합니다.
디자이너는 하나의 필드가 있는 스키마를 만듭니다.
다른 필드를 추가하려면 새 스키마의 바로 가기 메뉴를 열고 필드 추가를 선택합니다. 필요에 따라 이 단계를 반복합니다.
새 필드의 바로 가기 메뉴를 열고 속성을 선택합니다. 다음 표에 따라 각 필드의 속성에 대한 값을 제공합니다.
속성 설명 또는 값 배열인 경우 true이면 최대 7개의 차원과 16,777,215개의 요소가 있는 배열을 지원하는 배열 차원을 설정해야 합니다. 배열 속성에 대한 값도 입력해야 합니다. 데이터 형식 필드의 .NET 데이터 형식 이름 필드의 이름입니다. 오류 처리 오류, 둥글게 또는 자르기를 트리거합니다. 호스트 데이터 형식 필드의 COBOL 또는 RPG 데이터 형식 크기 32비트 정수 문자열 구분 Null 종결 또는공백 패딩 후행 필러 길이가 지정된 최대값보다 작은 필드의 경우 필러 크기를 지정해야 합니다. 
공용 구조체 추가
기본 디자인 보기에서 공용 구조체 바로 가기 메뉴를 열고 공용 구조체 추가를 선택합니다.
디자이너는 두 멤버가 있는 공용 구조체를 만듭니다.
다른 멤버를 추가하려면 새 공용 구조체의 바로 가기 메뉴를 열고 공용 구조체 구성원 추가를 선택합니다. 필요에 따라 이 단계를 반복합니다.
멤버의 바로 가기 메뉴를 열고 속성을 선택합니다. 다음 표에 따라 각 멤버의 속성에 대한 값을 제공합니다.
속성 설명 또는 값 배열입니다. true이면 최대 7개의 차원과 16,777,215개의 요소가 있는 배열을 지원하는 배열 차원을 설정해야 합니다. 배열 속성에 대한 값도 입력해야 합니다. 데이터 형식 멤버의 .NET 데이터 형식입니다. 이 값에는 이전 섹션에 정의된 구조체가 포함될 수 있습니다. 이름 멤버의 이름 오류 처리 오류를 트리거하거나, 반올림하거나, 자립니다. 호스트 데이터 형식 멤버의 COBOL 또는 RPG 데이터 형식 크기 32비트 정수 문자열 구분 Null 종결 또는공백 패딩 후행 필러 길이가 지정된 최대값보다 작은 멤버의 경우 필러 크기를 지정해야 합니다. 
완료되면 다음 섹션으로 계속 이동하여 메타데이터의 디자인을 저장하는 라이브러리를 만듭니다.
HIDX(호스트 통합 정의 XML) 또는 메타데이터 아티팩트 만들기
이 섹션에서는 메타데이터 아티팩트의 디자인을 저장하는 라이브러리를 만드는 방법을 설명합니다.
메타데이터 아티팩트 생성을 위해 Visual Studio 파일 메뉴 또는 도구 모음에서 모두 저장을 선택합니다. (키보드: Ctrl+Shift+S 누르기)
생성된 HIDX 파일을 찾으려면 호스트 파일의 폴더로 이동합니다.
