다음을 통해 공유

트랜잭션 통합자 변환 도구

  • 아티클

TIConversionTool 명령줄 유틸리티를 사용하면 HIS 2010, HIS 2009, HIS 2008, HIS 2006 및 HIS 2004에서 호스트 통합 서버로 빠르고 쉽게 마이그레이션할 수 있습니다. 이를 사용하여 이전 버전의 HIS에서 만든 WIP(Window Initiated) 또는 HIP(Host Initiated) TLLB 및 .NET 어셈블리를 Host Integration Server .NET 어셈블리로 변환할 수 있습니다. 이를 사용하여 단일 TLB 또는 어셈블리 또는 여러 TLL 또는 어셈블리를 변환할 수 있습니다.

TIConversionTool.exe 다음 폴더에 있습니다.

OS 위치
X64 C:\Program Files\Microsoft Host Integration Server 2020\SysWOW64\
x86 C:\Program Files\Microsoft Host Integration Server 2020\system\

명령줄에서 변환 유틸리티를 실행하거나 PowerShell과 같은 다른 프로그램에서 호출할 수 있습니다. 런타임에 사용 지침을 보려면 명령줄에서 인수 없이 TIConversionTool.exe 실행합니다.

실행할 때 TIConversion 도구는 변환되는 어셈블리 또는 TLB와 동일한 이름의 다음 디렉터리를 생성합니다. 해당 디렉터리에 다음 파일과 변환된 TI 어셈블리가 포함된 bin 디렉터리가 배치됩니다.

  1. xxxx.asmx - TI 어셈블리를 웹 서비스로 배포하기 위한 구성 파일

  2. xxxx.svc - TI 어셈블리를 wcf 서비스로 배포하기 위한 구성 파일

  3. xxxx.xsd - BizTalk 호스트 애플리케이션 어댑터와 함께 사용할 스키마 파일

  4. web.config. WCF - IIS 배포를 위한 wcf 웹 구성 파일

  5. web.config.WS - II 배포를 위한 asmx 웹 구성 파일

  6. bin/xxxx.dll - 변환된 TI 어셈블리입니다.

    TIConversionTool 고려 사항

  • TIConversionTool.exe 컨텍스트 인터페이스를 Host Integration Server에 도입된 새 컨텍스트 인터페이스로 마이그레이션합니다.

  • TheTIConversionTool.exe 현재 RE 클래스가 더 이상 지원되지 않는 경우에만 RE 클래스를 업데이트합니다.

  • 유틸리티는 호스트 통합 서버에서 작동하도록 이전 형식 라이브러리 및 .NET 어셈블리를 업데이트합니다. 변환된 후에는 변환을 새 RE 구성과 연결하는 것이 좋습니다. HIS 2009 및 HIS 2010 변환을 기존 HIS ES 또는 일치하는 새 호스트 통합 서버 ES와 연결할 수 있습니다.

  • 이전 형식 라이브러리를 .NET 어셈블리로 변환할 때 TI는 다음 표에 설명된 대로 Visual Basic 버전 6.0 Automation 데이터 형식을 Visual Basic .NET 형식으로 변환합니다.

    Visual Basic v6 Visual Basic .NET
    정수 Short
    long 정수
    통화 Decimal
    레코드 집합 DataTable
    UDT 구조체

  • NewRecordset 함수는 .NET에서 지원되지 않습니다. NewRecordset 함수를 사용하여 연결이 끊긴 레코드 집합을 만드는 클라이언트 애플리케이션의 코드를 수정해야 합니다.

  • GUID 변경으로 인해 선언적 바인딩을 사용하는 기존 COM 클라이언트를 다시 컴파일해야 합니다.

  • 다음과 같은 경우 Designer 가져오기 기능을 사용하여 TLB 또는 .NET 어셈블리를 변환해야 합니다.

    • 애플리케이션은 지속성 연결을 사용합니다.

    • 동적 ES와 같은 새 모델을 사용하는 기능을 사용하려고 합니다.

    • TLB의 ProgID가 39자를 초과합니다.

  • TI TLB에는 clientContext 사용을 허용하도록 tlb가 구성되었을 때 TI 컨텍스트에 대한 두 개의 인터페이스가 포함되어 있습니다. HIS2020 TI .Net 어셈블리에는 clientContext 사용을 허용하도록 구성된 경우 단일 인터페이스만 포함됩니다. 직접 호출 모델에서 tlb를 사용하는 클라이언트 애플리케이션에는 TI 메서드 호출의 매개 변수 목록에 정의된 컨텍스트 값이 필요하지 않았습니다. HIS2020 tlb를 실행한 후 TIconversiontool.exe 결과는 .Net 어셈블리로 대체됩니다. 고객은 TI 메서드 호출의 매개 변수 목록에 컨텍스트 값을 포함해야 합니다.

    자세한 내용은 TI Designer 작업을 참조하세요.

사용량

TIConversionTool [[/f] libraryname1 [libraryname1 ...] [/o outputdir] [/fl fileList1 [fileList2 ...]] [/l logFile]]

Syntax

/f
변환할 라이브러리를 지정합니다.

/플로리다
변환할 라이브러리 목록이 포함된 텍스트 파일을 지정합니다.

/O
변환된 어셈블리를 포함할 디렉터리를 지정합니다.

/L
로그 파일 이름을 지정합니다.

/d
변환할 라이브러리가 포함된 디렉터리를 지정합니다.

/Ds
하위 디렉터리에 있는 라이브러리를 포함하여 변환할 라이브러리가 포함된 디렉터리를 지정합니다.

/Ow
모든 기존 어셈블리를 덮어씁 수 있습니다.

/Sk
출력 어셈블리가 이미 있는 형식 라이브러리를 건너뜁니다.

/Ol
존재하는 경우 로그 파일을 덮어씁니다.

샘플 사용

TIConversionTool /f c:\temp\ComClnt1.tlb  

TIConversionTool /f c:\temp\NetClnt1.dll /o c:\output  

TIConversionTool /f c:\temp\NetClnt1.dll NetClnt2.dll  

TIConversionTool /f c:\temp\NetClnt1.dll NetClnt1.dll /o c:\output  

TIConversionTool /fl fileList.txt  

TIConversionTool /fl fileList.txt /l fileList.log  

TIConversionTool /fl fileList.txt /o c:\output

경고

위의 플래그를 사용하지 않고 지정된 명령줄 매개 변수는 변환할 라이브러리로 처리됩니다.