DLL 패키지

동적 링크 라이브러리(DLL) 파일에는 Windows 프로그램에서 이용할 수 있는 공유 함수 라이브러리가 포함되어 있습니다. DLL 패키지.dll 파일을 참조로 사용하고 Bot에서 함수를 호출합니다.

시작하기 전에

사용 가능한 작업 세트 사용하는 과정의 일부로 DLL 패키지 내에서 다음 작업을 수행합니다.
주:
  • 사용자 지정 DLL을 사용하는 Bot을 생성하고 사용자 지정 DLL이 Apache log4net 라이브러리에 종속성을 가진 경우, 다음을 사용하는 것이 좋습니다.
    • 사용자 지정 DLL의 log4net 버전 2.0.11 이상.
    • Bot 에이전트 업데이트가 선택 사항이더라도 Bot 에이전트(버전 21.210 이상)를 업데이트하십시오.
  • Microsoft .NET Framework을 사용하여 빌드된 DLL만 지원됩니다.
  • DLL 실행 패키지는 다음 버전의 Microsoft .NET와 호환됩니다. 4.6, 4.7, 4.8.
  • 루프가 있는 로컬 세션을 사용하여 Bot을 생성하는 경우 Bot에서 세션 닫기 작업을 사용해야 합니다. 세션 닫기 명령을 사용하지 않으면 루프가 반복될 때마다 로컬 세션에서 AutomationAnywhere.ManagedDLLWrapper.exe가 열립니다. 결과적으로 메모리 공간이 부족해지고 Bot이 실패합니다.
Important: 상위 Bot 및 하위 Bot에서 서로 다른 버전의 DLL 패키지를 사용하는 경우 현재 Bot 간 세션 공유는 지원되지 않습니다. 상위 및 하위 Bot 간에 세션을 공유하려면 상위 및 하위 Bot 모두에서 동일한 버전의 패키지를 사용하는지 확인하십시오.
  1. 열기 작업을 사용하여 사용하려는 .dll 파일의 위치와 세션 이름을 지정합니다. 다른 작업에 대해서도 이 동일한 세션 이름을 사용합니다. 참조된 .dllBot 종속 파일로 자동으로 추가됩니다.
  2. 함수 실행 작업을 사용하여 .dll에서 특정 함수를 실행하고 그 출력 값을 변수로 저장합니다.
  3. 필요한 함수를 실행한 후, .dll 참조 파일을 닫습니다. .dll 참조 파일을 닫아 운영 체제의 메모리를 비워두는 것이 중요합니다.

    DLL을 실행하는 기기에서는 Windows 및 적절한 Microsoft .NET Framework 버전을 이용할 수 있습니다.

    Bot 시작 프로그램 로그를 검토하려면 C:\ProgramData\AutomationAnywhere\BotRunner\Logs\<current month>\Bot_Launcher-<today's date>.log.zip으로 이동합니다. 각 압축 폴더에는 디버깅에 유용한 코드 실행에 관한 데이터가 있는 파일이 포함되어 있습니다.

주: .dll 파일이 다른 .dll 파일의 .NET 함수 또는 클래스를 사용하는 경우, Bot의 수동 종속 파일로서 두 번째 .dll 파일을 추가해야 합니다.

Bot 의존 패키지

하나의 기본 DLL과 이것이 참조하는 다른 여러 DLL을 함께 가져오는 경우, 모든 DLL이 하나의 폴더에 있어야 합니다. 또한 참조된 DLL은 기본 DLL에 이용된 이름과 다른 세션 이름을 이용하여 호출해야 합니다. 기본 DLL과 참조된 DLL에 동일한 세션 이름을 사용하는 경우, Bot이 실행되지 않습니다.

DLL 패키지 내의 작업

DLL 패키지에는 다음 작업이 포함되어 있습니다.

작업 설명
닫기

닫기 작업 항목을 참조하십시오.

열기

작업을 엽니다. 항목을 참조하십시오.

함수 실행 함수 실행 작업 사용 항목을 참조하십시오.

DLL 함수에서 지원되는 데이터 유형

다음 테이블에는 DLL 함수에서 입력 또는 출력 매개변수로 이용할 수 있는 변수와 데이터 유형이 나와 있습니다.
주: 함수 실행 작업함수에 대한 매개변수 또는 출력을 변수에 지정 필드에서 사용자 정의 데이터 유형을 지원하지 않습니다.
입력 또는 출력 매개변수로서의 변수 유형 .NET에서 지원되는 데이터 유형
문자열
  • Char
  • Byte
  • 문자열
  • 문자열
  • SByte
숫자
  • UInt16
  • Int16
  • UInt32
  • Int32
  • UInt64
  • Int64
  • Int
  • 단일
  • Decimal
  • Float
  • 이중
부울
  • 부울
  • bool
날짜 시간
  • 날짜 시간
목록
  • UInt16[]
  • Int16[]
  • Int32[]
  • Int64[]
  • Int[]
  • Char[]
  • Single[]
  • Decimal[]
  • Float[]
  • Double[]
  • Boolean[]
  • bool[]
  • Byte[]
  • String[]
  • Datetime[]
  • List<UInt16>
  • List<Int16>
  • List<Int32>
  • List<Int64>
  • List<Int>
  • List<Char>
  • List<Single>
  • List<Decimal>
  • List<Float>
  • List<Double>
  • List<Boolean>
  • List<bool>
  • List<Byte>
  • List<String>
  • List<Datetime>
  • List<SByte>
  • List<UInt32>
  • List<UInt64>
주: C# IList 데이터 유형은 지원되지 않으며 Automation 360 List 데이터 유형에서 작동하지 않습니다.
테이블
  • UInt16[,]
  • Int16[,]
  • Int32[,]
  • Int64[,]
  • Int[,]
  • Char[,]
  • Single[,]
  • Decimal[,]
  • Float[,]
  • Double[,]
  • Boolean[,]
  • bool[,]
  • Byte[,]
  • String[,]
  • Datetime[,]
  • Byte[,]
  • UInt32[,]
  • UInt64[,]
주: 테이블 유형 변수는 .NET의 2차원 배열 유형 변수와 동일합니다.
사전
  • Dictionary<String,UInt16>
  • Dictionary<String,Int16>
  • Dictionary<String,Int32>
  • Dictionary<String,Int64>
  • Dictionary<String,Int>
  • Dictionary<String,Char>
  • Dictionary<String,Single>
  • Dictionary<String,Decimal>
  • Dictionary<String,Float>
  • Dictionary<String,Double>
  • Dictionary<String,Boolean>
  • Dictionary<String,bool>
  • Dictionary<String,Byte>
  • Dictionary<String,String>
  • Dictionary<String,Datetime>
  • Dictionary<Int,String>
  • Dictionary<Decimal,String>
  • Dictionary<Boolean,String>
  • Dictionary<String,SByte>
  • Dictionary<String,UInt32>
  • Dictionary<String,UInt64>
주: .Net DLL 함수를 생성할 때 Dictionary 데이터 유형 대신 IDictionary 데이터 유형을 사용하십시오.