IBM® Enterprise Records 배치의 경우
파일 계획 가져오기 내보내기 도구를 사용하여 외부 파일 계획을 가져오거나
파일 계획을 외부 환경으로 내보낼 수 있습니다. 이 도구에서는 XML 파일을 사용하여 가져오기 및 내보내기 프로세스를 완료합니다.
제한사항
파일 계획 가져오기/내보내기 도구를 사용하여 파일 계획을 쉽게 마이그레이션할 수 있습니다. 그러나, 이 도구은 다음을 지원하지 않습니다.
또한 나머지 파일 계획을 가져오기 전에 먼저 선택 목록과 같은 사용자 정의 특성과 클래스를 개별 XML 파일로 내보내고 가져와야 합니다. 또한 파일 계획을 가져온 후
닫힘 또는
처리 준비 완료와 같은 엔티티 상태는 더 이상 적용되지 않습니다.
도구 실행
명령행 Java 실행 파일에서 파일 계획 가져오기 내보내기 도구를 실행하거나
명령 파일인
FilePlanTool.bat 또는
FilePlanTool.sh를 사용하여 도구를 시작할 수 있습니다.
다음 다섯 가지 모드 중 하나로 도구를 실행할 수 있습니다.
- 구성 - Content Engine(CE) 서버 이름, 오브젝트 저장소 이름, 관리자 이름과 비밀번호
및 모드(가져오기 또는 내보내기)와 같은 필수 정보를 지정하는 대화 상자를 엽니다.
- 내보내기 - 나중에 다른 환경으로 가져올 수 있는 완전히 호환 가능하고 규격에 적합한 XML 파일을 작성합니다.
- 가져오기/업데이트 - 지정된 XML 파일을 환경으로 가져옵니다.
- 검증 - XML 파일을 읽고 호환성 및 준수성을 확인합니다.
파일 계획 내보내기
내보내려는 파일 계획에 다음 항목이 포함되어 있는 경우
- 사용자 정의 클래스 또는 특성
- 300,000개 이상의 폴더
- 15,000개 이상의 폴더를 포함하는 레코드 카테고리
범위 옵션으로 파일 계획 내보내기를 참조하십시오.
도구를 구성한 후 도구를 사용하여 파일 계획을 내보낼 수 있습니다. 파일 계획을 내보내려면 다음 명령을 입력하십시오.
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 name은 IBM Enterprise
Records의 전체 경로를 포함해야 합니다. 예를 들어,
"Cat01"에 포함된 "Cat02" 내에 포함된 "Cat03"이라는 레코드 카테고리의 모든 하위를 내보내려면 다음 명령을 입력하십시오.
FilePlanTool.bat -mode export -scope includecategory
"/Cat01/Cat02/Cat03" -o expfile.xml
- includecategories file 01 -
입력 텍스트 파일 file 01에 지정된 레코드 카테고리 및 해당 하위만 내보내려면 이 매개변수를 사용합니다. 명령행에
각 레코드 카테고리 이름을 지정하지 않고 많은 레코드 카테고리를 동일한 파일에 내보내려면 includecategories 매개변수를
사용합니다. 이 매개변수를 사용하려면 다음 명령을 입력하십시오.
FilePlanTool.bat -mode export -scope includecategories file01.txt -o export01.xml
File01.txt에 다음과 같은 내용이 들어 있습니다.
/categoryB /CategoryC/SubcategoryC2 /CatogoryA/SubcategoryA1
카테고리 이름은 한 줄에 전체 경로 이름과 레코드 카테고리 하나로 표시됩니다.
- excludecategory "excluded record
category name" - 특정 레코드 카테고리 및 해당 하위를 제외하려면
이 매개변수를 사용합니다. 예를 들어, excluded
record category name이 "Cat01/Cat02/Catlarge"인 경우
도구가 파일 계획에서 "Cat01/Cat02/CatLarge" 노드 내에 포함된 레코드 카테고리 및 레코드 폴더를 제외한 모든 레코드 카테고리 및 레코드 폴더를 내보냅니다. 이 매개변수는 includecategory와 유사하게 작동합니다.
- excludecategories file 02 - file 02 텍스트 파일에 지정된 루트 이름의 하위 트리를 제외하려면 이 매개변수를 사용하십시오. 이 매개변수는 includecategories와 유사하게 작동합니다.
파일 계획 가져오기/업데이트
파일 계획 또는 파일 계획의 세그먼트를 가져오려면 내보내기 모드에서 도구를 실행하고 도구가 내보내기 모드에서 작성한 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를 지정합니다. 업데이트 모드를 사용하면
선택 목록과 같은 사용자 정의 특성을 수정할 수 없습니다.
오류 메시지가 표시되거나 가져오기 프로세스가 중지될 경우
IBM FileNet® P8 문제점 해결 안내서를 참조하십시오. 대부분의 경우 가져오기 프로세스는
오류가 발생한 후 중지되고 메시지를 표시하지 않습니다.
도구에서는 조건부 보류를 가져오지 않으므로, 필요한 경우 보류 스윕을 실행하여 가져오기 후 엔티티에 조건부 보류를 적용합니다. 제한사항을 참조하십시오.
파일 계획 검증
XML 파일을 수동으로 작성한 후
파일 계획 가져오기 내보내기 도구를 통해 XML 파일을 검증하여 파일에 오류 또는 비준수 문제가 없음을 확인하십시오. 검증 모드에서 가져오기/내보내기 도구를 실행하려면 다음 명령을 입력하십시오.
FilePlanTool -mode validate -f XML
filename.xml
XML filename은 검증할 파일의 이름 및 경로입니다. 명령행에서 파일 이름을 제공하지 않는 경우 도구에서는 도구 구성 대화 상자의 출력 파일 이름 필드에 지정된 기본 파일 이름을 사용합니다. 기본 XML 출력 파일 이름 지정에 대한
자세한 내용은 도구 구성을 참조하십시오.
다시 가져오기 옵션 사용
다시 가져오기 옵션을 사용하여 이미 파일 계획에 있는 엔티티를 가져올 때 도구의 기본 동작을 결정하십시오. 다시 가져오기 옵션에는 다음과 같은 세 개의 매개변수가 있습니다.
- 없음 - 엔티티를 추가할 때 도구에서는 엔티티가 이미 있는 경우 예외 로그에 경고를 보고하고, 엔티티를 추가하지 않고, 계속합니다.
- 건너뛰기 - 엔티티를 추가할 때 도구에서는 기존 엔티티를 건너뛰고 계속하여 작업을 수행하며 활동 로그에 건너뛰기 조치를 보고합니다.
- 바꾸기 - 엔티티를 추가할 때 도구에서는 기존 엔티티를 대체하고, 계속하여 작업을 수행하며 활동 로그에 수정 조치를 보고합니다.
대용량 파일 계획 가져오기에 실패한 후 건너뛰기 옵션을 사용하십시오. 두 번째 동일한 파일 계획 가져오기 시도 도중 건너뛰기 옵션은 성공적으로 가져온 엔티티를 다시 가져오는 경우를 피합니다. 그러나, 두 번째 가져오기 시도에서 처음에 성공적으로 가져온 엔티티를 부분적으로 수정해야 할 경우에는 바꾸기 옵션을 사용하십시오. 이후에 소수의 엔티티에 대한 부분적인
수정을 가져오는 중에는 원래 XML 파일에 변경사항을 적용하는 대신 XML 파일의 RMEntityObjectType 절에서
엔티티에 대해 Action="Modify"를 지정하십시오. 또한 업데이트 모드를 사용하여 처음 전체 가져오기와 후속 업데이트를 더 쉽게 식별하십시오.
파일 계획 가져오기/업데이트를 참조하십시오.