IBM Enterprise Records, 버전 5.1.2    

파일 계획 가져오기 및 내보내기 도구 사용

IBM® Enterprise Records 배치의 경우, 파일 계획 가져오기 내보내기 도구를 사용하여 외부 파일 계획을 가져오거나 파일 계획을 외부 환경으로 내보내십시오. 이 도구에서는 XML 파일을 사용하여 가져오기 및 내보내기 프로세스를 완료합니다.

개요

스케줄 상속, 대체 보유, 처리 트리거 및 동적 보류를 포함하도록 내보낸 XML 파일 수정에 대한 자세한 내용은 파일 계획 가져오기 및 내보내기 도구 문제점 해결 주제를 참조하십시오.

제한사항

파일 계획 가져오기 내보내기 도구를 사용하여 파일 계획을 마이그레이션하십시오. 그러나, 이 도구는 다음 시나리오를 지원하지 않습니다. 나머지 파일 계획을 가져오기 전에, 먼저 사용자 정의 특성(예: 선택 목록) 및 클래스를 개별 XML 파일로 내보내고 가져오십시오. 또한 파일 계획을 가져온 후 닫힘 또는 처리 준비 완료와 같은 엔티티 상태는 더 이상 적용되지 않습니다.

도구 실행

명령행 Java 실행 프로그램에서 파일 계획 가져오기 내보내기 도구를 실행할 수 있습니다. 또는 명령 파일(FilePlanTool.bat 또는 FilePlanTool.sh)을 사용하여 도구를 시작할 수 있습니다. 다음 5가지 모드 중 하나로 도구를 실행할 수 있습니다.

도구 구성

가져오기 또는 내보내기 모드에서 도구를 실행하기 전에 도구를 구성해야 합니다. 도구를 구성하려면 다음을 수행하십시오.
  1. 파일 계획 가져오기 내보내기 도구가 설치된 폴더로 이동하십시오.
  2. 명령행에서 다음 중 하나를 실행하십시오.
    운영 체제 명령
    Windows FilePlanTool -mode configure
    AIX, HP-UX, Linux 및 Solaris FilePlanTool.sh -mode configure
    파일 계획 도구 대화 상자에서 다음 정보를 입력하십시오.

파일 계획 내보내기

내보내려는 파일 계획에 다음 항목이 포함되어 있는 경우 범위 옵션으로 파일 계획 내보내기를 참조하십시오.

도구를 구성한 후 도구를 사용하여 파일 계획을 내보낼 수 있습니다. 파일 계획을 내보내려면 다음 명령을 입력하십시오.

FilePlanTool -mode export -fileplan file plan name -o XML filename.xml

여기서 file plan name은 내보낼 파일 계획의 이름이며 필수입니다. 파일 계획 이름에 공백 또는 특수 문자가 포함되어 있는 경우, file plan name을 따옴표로 묶으십시오.

XML filename은 작성할 파일의 이름 및 경로입니다. 명령행에서 파일 이름을 제공하지 않는 경우, 도구에서는 출력 파일 이름 필드에 지정된 기본 파일 이름을 사용합니다. 이 필드는 구성 대화 상자에 있습니다. 기본 XML 출력 파일 이름 지정에 대한 자세한 내용은 도구 구성을 참조하십시오.

범위 옵션으로 파일 계획 내보내기

파일 계획을 내보낼 때 대용량 파일 계획이나 사용자 정의 클래스 또는 특성을 포함하는 파일 계획에 대해서는 범위 옵션을 사용하십시오. 범위 옵션을 사용하여 파일 계획을 내보내려면 다음 명령을 입력하십시오.

FilePlanTool -mode export -fileplan file plan name -o XML filename.xml -scope parameter

여기서 file plan name은 내보낼 파일 계획의 이름이며 필수입니다. 파일 계획 이름에 공백 또는 특수 문자가 포함되어 있는 경우, file plan name을 따옴표로 묶으십시오.

XML filename은 작성할 파일의 이름 및 경로입니다. 명령행에서 파일 이름을 제공하지 않는 경우, 도구에서는 출력 파일 이름 필드에 지정된 기본 파일 이름을 사용합니다. 이 필드는 구성 대화 상자에 있습니다. 범위 옵션이 있는 도구를 사용할 때 도구에서는 파일 계획의 각 부분에 대한 XML 파일을 작성합니다. 따라서, 내보내기 모드에서 도구를 사용할 때마다 다른 XML 파일 이름을 지정해야 합니다. 기본 XML 출력 파일 이름 지정에 대한 정보는 도구 구성을 참조하십시오.

parameter는 다음 항목일 수 있습니다.
  • metadata: 파일 계획이 사용자 정의 클래스 또는 특성을 포함할 경우, 이 매개변수는 필수입니다. metadata 매개변수 옵션은 사용자 정의 클래스 및 특성에 대한 개별 XML 파일을 작성합니다. 따라서, 파일 계획이 사용자 정의 클래스 또는 특성을 포함할 때 내보내기 및 가져오기 프로세스는 각각 두 단계로 구성됩니다.
    • 사용자 정의 클래스 및 특성에 대한 단계
    • 파일 계획의 나머지 부분에 대한 단계. metadata 매개변수를 사용하지 않을 경우 도구에서는 사용자 정의 특성 없이 파일 계획을 내보냅니다.
  • includecategory "record category name": 특정 레코드 카테고리를 내보내려면 이 매개변수를 사용하십시오. includecategory를 사용하는 경우, 도구에서는 지정된 레코드 카테고리 내에 포함된 하위 카테고리와 하위 폴더를 모두 내보냅니다. record category nameIBM Enterprise Records의 전체 경로를 포함해야 합니다. 예를 들어, Cat03이라는 레코드 카테고리의 모든 하위를 내보내려면 다음 명령을 입력하십시오. Cat03은 Cat01에 포함된 Cat02 내에 포함되어 있습니다.

FilePlanTool.bat -mode export -scope includecategory "/Cat01/Cat02/Cat03" -o expfile.xml

FilePlanTool.bat -mode export -scope includecategories file01.txt -o export01.xml

File01.txt에 다음과 같은 내용이 들어 있습니다.

/categoryB /CategoryC/SubcategoryC2 /CatogoryA/SubcategoryA1

카테고리 이름은 한 줄에 전체 경로 이름과 레코드 카테고리 하나로 표시됩니다.

파일 계획 가져오기/업데이트

파일 계획 또는 파일 계획의 세그먼트를 가져오려면, 내보내기 모드에서 도구를 실행하십시오. 도구가 내보내기 모드에서 작성한 XML 파일을 지정하십시오. 파일 계획이 사용자 정의 클래스 또는 특성을 포함할 경우 가져오기 프로세스에는 두 단계가 필요합니다. 첫 번째 단계는 파일 계획의 사용자 정의 클래스 및 특성을 가져옵니다. 두 번째 단계는 파일 계획의 나머지를 가져옵니다. 먼저 사용자 정의 클래스 및 특성을 가져오십시오. 그런 다음, 사용자 정의 클래스 및 특성 메타데이터가 메모리에 캐시되기 때문에 파일 계획을 가져오기 전에 최소 5분은 대기합니다. 캐시 TTL(Time-To-Live)은 5분이며, 그 후에 캐시가 삭제됩니다. 파일 계획을 가져오려면/업데이트하려면 다음 명령을 입력하십시오.

FilePlanTool -mode import -f XML filename.xml -reimportoption option

FilePlanTool -mode update -f XML filename.xml -reimportoption option

XML filename은 가져올 파일의 이름 및 경로입니다. 파일 이름을 제공하지 않는 경우, 도구에서는 구성 대화 상자의 출력 파일 이름 필드에 지정된 기본 파일 이름을 사용합니다. 기본 XML 출력 파일 이름 지정에 대한 정보는 도구 구성을 참조하십시오.

다시 가져오기 옵션은 파일 계획에 있는 엔티티를 가져올 때 도구의 기본 동작을 결정합니다. 다시 가져오기 옵션에 대한 자세한 내용은 다시 가져오기 옵션 사용을 참조하십시오.

가져오기 모드에서 도구은 범위 옵션을 사용하지 않고 XML 태그를 살펴보고 가져올 항목을 결정합니다. 메타데이터(사용자 정의 클래스 및 특성) 및 파일 계획에 대한 다른 XML 파일 이름을 제공해야 합니다.

주의: XML 파일의 ClassificationScheme 태그가 파일 계획의 이름을 지정합니다.

업데이트 모드에서 도구를 실행하여 파일 계획의 초기 가져오기 후 부분적으로 수정하십시오. 처음에 가져온 XML 파일에서 후속 업데이트를 식별하십시오. XML 파일에서 FilePlan 태그의 InputMode 속성으로 update를 지정합니다. 업데이트 모드를 사용하면 선택 목록과 같은 사용자 정의 특성을 수정할 수 없습니다.

오류 메시지가 표시되거나 가져오기 프로세스가 중지될 경우에는 Information Center의 문제점 해결 및 지원 노드를 참조하거나 FileNet® p8 플랫폼 페이지에 대한 제품 문서에서 IBM FileNet P8 문제점 해결 안내서의 내용을 참조하십시오. 대부분의 경우 가져오기 프로세스는 오류가 발생한 후 중지되고 메시지를 표시하지 않습니다.

도구에서는 조건부 보류를 가져오지 않으므로, 필요한 경우 보류 스윕을 실행하여 가져오기 후 엔티티에 조건부 보류를 적용합니다. 제한사항을 참조하십시오.

파일 계획 검증

XML 파일을 수동으로 작성한 후, XML 파일에 오류 또는 비준수 문제가 없음을 확인하십시오. 파일 계획 가져오기 내보내기 도구를 통해 파일의 유효성을 검증할 수 있습니다. 유효성 검증 모드에서 가져오기 내보내기 도구를 실행하려면 다음 명령을 입력하십시오.

FilePlanTool -mode validate -f XML filename.xml

XML filename은 검증할 파일의 이름 및 경로입니다. 파일 이름을 제공하지 않는 경우, 도구에서는 구성 대화 상자의 출력 파일 이름 필드에 지정된 기본 파일 이름을 사용합니다. 기본 XML 출력 파일 이름 지정에 대한 정보는 도구 구성을 참조하십시오.

다시 가져오기 옵션 사용

다시 가져오기 옵션을 사용하여 파일 계획에 있는 엔티티를 가져올 때 도구의 기본 동작을 결정하십시오. 다시 가져오기 옵션에는 다음과 같은 세 개의 매개변수가 있습니다. 대용량 파일 계획 가져오기에 실패한 후 건너 뛰기 옵션을 사용하십시오. 두 번째 동일한 파일 계획 가져오기 시도 도중, 건너 뛰기 옵션은 가져온 엔티티를 다시 가져오는 경우를 피합니다. 그러나 두 번째 가져오기 시도에서 처음에 가져온 엔티티를 부분적으로 수정해야 할 경우에는 바꾸기 옵션을 사용하십시오. 이후에 소수의 엔티티에 대한 부분적 수정을 가져오는 중에는 XML 파일의 RMEntityObjectType 섹션에서 엔티티에 대해 Action="Modify"를 지정하십시오. 원래 XML 파일을 변경하는 대신 이러한 엔티티를 변경하십시오. 또한 업데이트 모드를 사용하여 처음 전체 가져오기와 후속 업데이트를 더 쉽게 식별하십시오. 파일 계획 가져오기/업데이트를 참조하십시오.


피드백

마지막 업데이트 날짜: 2013년 11월
fileplan_import_export.htm

© Copyright IBM Corp. 2013