DMM 스튜디오 온라인 도움말 › DMM 스튜디오 › 언어 구조 › 일반 명령

일반 명령

다음은 CA DMM 스크립트에서 사용되는 일반 명령입니다.

Break

현재 루프의 끝으로 제어 흐름을 넘기고 루프 다음의 첫 번째 명령을 실행합니다. 이것은 모든 루프와 함수 범위를 벗어나는 return과 다릅니다. break는 루프 내에서만 의미가 있습니다.

예제:

function Foo()
{
     while (true)
     {
          while (z < 5)
          {
               ...
               if (x == false)
               {
               break;     // jumps to line following while (z < 5) {}
               }
               if (y == true)
               {
          return 5;     // returns from Foo() immediately
               }
          }
          if (x == false)
          {
               break;     // jumps to line following while (true) {}
          }
     }
     ...
     return -1;	// returns from Foo() immediately

}

ConvertBinaryToString

바이너리 문자열을 ASCII 문자열로 변환합니다. 변환할 바이너리 데이터가 포함된 문자열인 필수 매개 변수 하나를 사용합니다. 두 번째 매개 변수는 선택 사항이며 바이너리입니다. 부울 값이 true이면 문자열을 유니코드 문자열로 변환합니다. 부울 값이 false인 경우 ASCII 문자열로 변환합니다.

첫 번째 매개 변수:

바이너리 문자열

두 번째 매개 변수:

부울 값

사용법:

ConvertBinaryToString(<값>,[부울]);

예제:

var result = ConvertBinaryToString("000FFFDCB709E")

ConvertStringToBinary

ASCII 문자열을 바이너리 문자열로 변환합니다. 변환할 ASCII 문자열인 필수 매개 변수 하나를 사용합니다. 두 번째 매개 변수는 선택 사항입니다. 이 매개 변수가 true이면 문자열을 유니코드 바이너리로 변환합니다.

첫 번째 매개 변수:

ASCII 문자열

두 번째 매개 변수:

부울 값

사용법:

ConvertStringToBinary(<값>,[부울]);

예제:

var result = ConvertStringToBinary("이 문자열을 바이너리로 변환")

Detect

스크립트와 연결된 응용 프로그램을 지정합니다. 응용 프로그램 하나만 스크립트와 연결할 수 있습니다. 원본 컴퓨터에서는 Detection 함수에서 호출됩니다. 대상 컴퓨터에서는 응용 프로그램 경로를 확인하기 위해 어느 곳에서나 호출할 수 있습니다. 인터프리터는 APPLICATIONPATH 키워드를 확인합니다. 이 키워드는 이 함수가 호출되기 전에 유효하지 않으므로 사용해서는 안됩니다. 스크립트는 불필요한 처리 작업을 피하기 위해 Detection 함수에서 Detect를 호출해야 합니다.

Detect의 매개 변수는 실행 파일 이름과 레지스트리 키 값(선택 사항)입니다. 두 가지 매개 변수는 모두 문자열 값입니다. 레지스트리 값 경로 매개 변수는 실행 파일의 경로를 포함하는 레지스트리 값의 전체 경로입니다. 레지스트리 값이 기본 매개 변수인 경우 경로는 키 이름과 슬래시로 끝나야 합니다. 다음 예제를 참조하십시오. Detection 함수에서 스크립트는 Detect의 반환 값을 확인하고 스크립트를 계속 처리할지 아니면 스크립트를 종료할지 여부를 결정해야 합니다.

첫 번째 매개 변수:

실행 파일 이름(문자열 값)

두 번째 매개 변수:

레지스트리 경로(문자열 값)

사용법:

Detect ( <실행 파일 이름>, [레지스트리 경로] );

예제:

if( Detect( "MyApp.exe", "HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\App Paths\\MyApp.exe\\"  ) == false)
{
     return;
}
if (Detect ( <실행 파일 이름>) == false)
return;

Execute

실행 파일 또는 dll을 실행합니다. execute 함수가 호출할 파일이나 dll을 찾을 수 없으면 false를 반환합니다.

첫 번째 매개 변수:

첫 번째 매개변수는 실행할 항목의 경로입니다. dll의 경로인 경우 두 개의 콜론 뒤에 API 함수가 나와야 합니다. dll 호출 형식은 PATH::APIFunctionName입니다. dll의 Execute인 경우 다음 두 함수 유형에서만 호출을 찾습니다.

    int FunctionName();

    int FunctionName( const char * );

두 번째 매개 변수:

호출이 명령줄 인수를 사용할 경우 인수를 입력하거나 빈 문자열을 입력하십시오.

세 번째 매개 변수:

스크립트가 실행 파일이 완료될 때까지 기다릴지 여부를 나타내는는 부울 값입니다. dll 호출의 경우 이 매개 변수를 무시합니다.

예제:

/*executes notepad with the following file, myfile.txt and waits for the process to end.*/
Execute( "c:\\windows\\notepad.exe", "myfile.txt", true );

/*executes notepad without parameters and waiting.*/
Execute( "c:\\windows\\notepad.exe" );

/* makes a call into the dll with parameters*/
Execute( "c\\windows\\Somelib.dll::CheckNetwork", "000d1");

**dll PATH::APIFunctionName 형식에 주의하십시오.

Exit

스크립트를 종료합니다. 이 키워드 뒤에 값이 있으면 디버그 및 오류 로그에 기록됩니다. 괄호는 선택 사항입니다.

예제:

Exit ("MS Word가 컴퓨터에 존재하지 않기 때문에 종료합니다.");

ExpandString

지정된 문자열의 모든 환경 변수를 확장하고 결과를 반환합니다.

첫 번째 매개 변수:

환경 변수가 포함된 문자열

사용법:

ExpandString(<문자열>);

예제:

var result = ExpandString("%WinDir%")

GetEngineData

CommandID를 기준으로 엔진 관련 데이터를 반환합니다. 잘못된 CommandID가 전달되면 마이그레이션 중에 오류를 반환합니다. 마이그레이션의 두 가지 기능(저장 및 적용)에서 모두 이 명령을 사용할 수 있습니다.

참고: 이전 버전 제품에서는 이 명령을 사용할 수 없습니다. 이전 버전 CA DMM에서 이 명령을 사용하려고 하면 구문 오류가 발생합니다.

첫 번째 매개 변수:

마이그레이션을 위해 현재 선택된 노드 이름(응용 프로그램 또는 시스템 설정)을 가져오기 위한 CommandID(예: GET_CUR_SEL)

사용법:

GetEngineData(<CommandID>);

예제:

var strNewPath = GetEngineData(GET_CUR_SEL)

GetMappedPath

새 컴퓨터에 매핑된 새 파일 경로를 반환합니다. 이 명령은 또한 일반 \\ 문자와 다른 구분 기호를 가진 경로를 사용할 수 있습니다.

첫 번째 매개 변수:

기존 파일 경로(문자열 값)

두 번째 매개 변수:

경로 구분 기호(문자열 값)

사용법:

GetMappedPath( <기존 파일 경로>, [<경로 구분 기호>] );

예제:

newPath = GetMappedPath("c:\\old path\\file.txt");
/* newPath will equal the new file path.*/		
oldPath = "c:_old path_file.txt";
newPath = GetMappedPath( oldPath, "_" );
/* newPath will equal the new file path with the delimiter*/

/* for example newPath could equal e:_new path_file.txt*/

GetPlatform

컴퓨터의 플랫폼을 반환합니다. 반환 값은 WIN2000, WINXP, WINVI, WIN7입니다(정의 목록 참조). 이 함수는 원본 컴퓨터의 플랫폼을 가져올지 아니면 대상 컴퓨터의 플랫폼을 가져올지 나타내는 매개 변수 하나를 사용합니다. 이 매개 변수는 선택 사항이며 부울 값입니다. False(기본값)는 대상 컴퓨터를 나타내고 True는 현재 컴퓨터를 나타냅니다.

참고: 부울 매개 변수는 일반 함수 및 Apply 함수에서만 사용할 수 있습니다. 이와 다르게 매개 변수를 사용하면 구문 오류 또는 런타임 오류가 발생합니다.

첫 번째 매개 변수:

컴퓨터(부울 값)

사용법:

GetPlatform( [부울] );

예제:

if (GetPlatform(DESTINATION) == WINXP)
    ApplyWinXPWord();

IsLikeNT

운영 체제가 Windows 2000, Windows XP, Windows Vista, Windows 7인지 확인합니다. 매개 변수는 선택 사항입니다. 매개 변수가 True이면 CA DMM가 원본 컴퓨터의 OS를 가져오고, 그렇지 않으면 대상 컴퓨터의 OS를 가져옵니다. 기본값은 False입니다.

참고: 매개 변수는 일반 함수 및 Apply 함수에서만 True로 설정할 수 있습니다. Store 함수에서 사용하면 구문 오류 또는 런타임 오류가 발생합니다.

첫 번째 매개 변수:

컴퓨터(부울 값)

사용법:

Value = IsLikeNT([부울]);

예제:

IsLikeNT(SOURCE);

MapPath

스크립트를 사용하는 동안 하나의 경로를 다른 경로로 매핑합니다. 이 경로-매핑은 현재 스크립트에서 MapPath 키워드 다음에 나오는 모든 Apply 작업에 적용됩니다. 이 키워드를 사용하면 ApplyDirectory, ApplyFile 및 ApplyMappedValue 작업에서 <기존 경로>와 일치하는 모든 경로를 <새 경로>로 바꿉니다.

첫 번째 매개 변수:

기존 경로(문자열 값)

두 번째 매개 변수:

새 경로(문자열 값)

사용법:

MapPath(<기존 경로>, <새 경로>);

예제:

MapPath("c:\\winword\\data", "c:\\winword\\Application Data");

Message

사용자에게 메시지를 표시합니다. 이 명령은 문자열 값인 매개 변수 하나를 사용합니다. 괄호는 선택 사항입니다.

첫 번째 매개 변수:

메시지 텍스트(문자열 값)

사용법:

Message ( <문자열> );

예제:

Message ("도와주세요!");

Option

설정 페이지에 표시할 옵션을 만들고, Store 및 Apply 함수를 옵션에 연결합니다. 사용자가 옵션을 선택하면 인터프리터가 옵션과 연결된 함수를 호출합니다. 표시할 문에서 슬래시를 사용하여 계층 구조를 지정할 수 있습니다. 예를 들어 "Microsoft Word\\Toolbar" 옵션은 옵션의 트리 보기의 한 줄에 Microsoft Word를 표시하고 다음 줄에 도구 모음을 들여써서 표시합니다.

첫 번째 매개 변수:

옵션 경로(문자열 값)

두 번째 매개 변수:

Store 함수 이름(문자열 값)

세 번째 매개 변수:

Apply 함수 이름(문자열 값)

네 번째 매개 변수:

예제: 로컬라이제이션(번역)된 설정 트리 만들기를 참조하십시오.

사용법:

Option( <옵션 경로>, [Store 함수 이름], [Apply 함수 이름], [LanguageIndependentPath]);

예제:

Option( "Microsoft Word\\Toolbar");

Option( "MicrosoftWord\\Toolbar\\Tooltips", "StoreTooltips", "ApplyTooltips", "msword\\toolbar\\tooltips");

사용자가 항목을 선택하면 인터프리터가 Store 및 Apply 함수를 호출합니다. 사용자가 옵션을 선택할 경우에는 옵션의 부모 함수도 호출됩니다.

Print

작업 로그 및 디버그 로그에 메시지를 출력합니다. 괄호는 선택 사항입니다. 이 명령은 문자열 값인 매개 변수 하나를 사용합니다. 선택 사항인 두 번째 매개 변수에 대한 자세한 내용은 출력 수준을 참조하십시오. 출력 수준을 지정하지 않으면 매개 변수가 GENERAL로 기본 설정됩니다.

첫 번째 매개 변수:

문자열(문자열 값)

사용법:

print  (<문자열>);

예제:

Print ("경고: win.ini 파일을 덮어씁니다");

PrintException

문자열을 예외 로그에 출력합니다. 예외 로그는 CA DMM가 마이그레이션 명령을 이동하거나 게시하지 못했던 항목을 보기 위해 사용됩니다. 예를 들어 Netscape Communicator 스크립트는 업그레이드 절차를 설명하는 자세한 지침을 예외 로그에 출력합니다. MS Word 스크립트는 업그레이드되지 못한 설정을 출력합니다. PrintException 명령은 ApplyFunction 내에서만 사용할 수 있습니다. 선택 사항인 두 번째 매개 변수에 대한 자세한 내용은 "출력 수준"을 참조하십시오. 출력 수준을 지정하지 않으면 매개 변수가 GENERAL로 기본 설정됩니다.

첫 번째 매개 변수:

문자열(문자열 값)

사용법:

PrintException (<문자열>);

예제:

PrintException ("c:\\windows\\netscapecommunication.ttt 파일을 제거하십시오");

RetrieveValue

원본 컴퓨터 또는 대상 컴퓨터에서 레지스트리 키 값을 검색합니다. 키 경로, 값 이름, 부울 등 세 개의 매개 변수를 사용할 수 있습니다. 처음 두 개 매개 변수는 필수이며 문자열 값입니다. 세 번째 매개 변수는 선택 사항입니다. 세 번째 매개 변수가 True이면 CA DMM가 원본 컴퓨터를 검색하고, 그렇지 않으면 대상 컴퓨터를 검색합니다. 기본값은 False입니다. 명령이 값을 검색할 수 없으면 False를 반환합니다.

참고: 세 번째 부울 매개 변수는 일반 함수 및 Apply 함수에서만 사용할 수 있습니다. 이와 다르게 세 번째 부울 매개 변수를 사용하면 구문 오류 또는 런타임 오류가 발생합니다.

첫 번째 매개 변수:

키 경로(문자열 값)

두 번째 매개 변수:

값 이름(문자열 값)

세 번째 매개 변수:

컴퓨터(부울 값)

사용법:

Value = RetrieveValue(<키 경로>, <값 이름>, [부울]);

예제:

RetrieveValue( "HKCU\\Software\\Microsoft\\Office\\8.0\\Common\\Toolbar", "Tooltips", SOURCE);

RetrieveValue( "HKCU\\Software\\Microsoft\\Office\\8.0\\Common\", "Tooltips", DESTINATION);

RestartRequired

CA DMM에게 마이그레이션 종료 시 다시 시작해야 함 대화 상자를 표시하도록 지시합니다. 마이그레이션을 성공적으로 완료하기 위해 다시 시작이 필요한 스크립트의 경우 이 함수를 사용하십시오. 여기서는 스크립트를 다시 시작해야 하는지 여부를 나타내는 부울 값 매개 변수만 필요합니다.

첫 번째 매개 변수:

(부울 값)

사용법:

RestartRequired(<부울>);

예제:

RestartRequired(true);