IBM® Enterprise Records 배치의 경우, 파일 계획 가져오기 내보내기 도구를 사용하여
외부 파일 계획을 가져오거나 파일 계획을 외부 환경으로 내보내십시오. 이 도구에서는 XML 파일을 사용하여 가져오기 및 내보내기 프로세스를 완료합니다.
개요
스케줄 상속, 대체 보유, 처리 트리거 및 동적 보류를 포함하도록 내보낸 XML 파일 수정에 대한 자세한 내용은
파일 계획 가져오기 및 내보내기 도구 문제점 해결 주제를 참조하십시오.
제한사항
파일 계획 가져오기 내보내기 도구를 사용하여
파일 계획을 마이그레이션하십시오. 그러나, 이 도구는 다음 시나리오를 지원하지 않습니다.
- 상호 데이터 모델 내보내기/가져오기. 예를 들어, PRO 데이터 모델 오브젝트 저장소에서 내보낼 경우 DoD 데이터 모델 오브젝트 저장소에 가져올 수 없습니다.
- 레코드 오브젝트, 볼륨, 문서 오브젝트, 보안 정보 및 보안 표식 내보내기 또는 가져오기.
- 롤백 메커니즘.
- 널 값을 가지는 특성 내보내기. 보유 기간이 없는 처리 스케줄의 단계를 가져오는 것을 예로 들 수 있습니다. 또한 다른 오브젝트 저장소로 처리 스케줄을 가져오면
보유 기간이 널로 업데이트되지 않습니다. 그러나, 수동으로 XML 파일을 업데이트하여 보유 기간을 업데이트할 수 있습니다. 자세한 정보는
파일 계획 가져오기 및 내보내기 도구 문제점 해결 주제를 참조하십시오.
나머지 파일 계획을 가져오기 전에,
먼저 사용자 정의 특성(예: 선택 목록) 및 클래스를 개별 XML 파일로 내보내고 가져오십시오. 또한 파일 계획을 가져온 후
닫힘 또는
처리 준비 완료와 같은 엔티티 상태는 더 이상 적용되지 않습니다.
도구 실행
명령행 Java 실행 프로그램에서 파일 계획 가져오기 내보내기 도구를
실행할 수 있습니다. 또는 명령 파일(
FilePlanTool.bat 또는
FilePlanTool.sh)을 사용하여 도구를 시작할 수 있습니다.
다음 5가지 모드 중 하나로 도구를 실행할 수 있습니다.
- 구성: 필수 정보를 지정하는 대화 상자를 엽니다. 이 필수 정보는
컨텐츠 플랫폼 엔진 서버 이름, 오브젝트 저장소 이름, 관리자 이름 및 비밀번호와
모드(가져오기 또는 내보내기)입니다.
- 내보내기: 나중에 다른 환경으로 가져올 수 있는 완전히 호환 가능하고 규격에 적합한 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의 전체 경로를 포함해야 합니다. 예를 들어,
Cat03이라는 레코드 카테고리의 모든 하위를 내보내려면 다음 명령을 입력하십시오. Cat03은 Cat01에 포함된 Cat02 내에 포함되어 있습니다.
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를 지정합니다. 업데이트 모드를 사용하면
선택 목록과 같은 사용자 정의 특성을 수정할 수 없습니다.
오류 메시지가 표시되거나 가져오기 프로세스가 중지될 경우에는 Information Center의 문제점 해결 및 지원 노드를 참조하거나
FileNet® p8 플랫폼 페이지에 대한 제품 문서에서 IBM FileNet P8 문제점 해결 안내서의 내용을 참조하십시오. 대부분의 경우 가져오기 프로세스는
오류가 발생한 후 중지되고 메시지를 표시하지 않습니다.
도구에서는 조건부 보류를 가져오지 않으므로, 필요한 경우 보류 스윕을 실행하여 가져오기 후 엔티티에 조건부 보류를 적용합니다. 제한사항을 참조하십시오.
파일 계획 검증
XML 파일을 수동으로 작성한 후,
XML 파일에 오류 또는 비준수 문제가 없음을 확인하십시오. 파일 계획 가져오기 내보내기 도구를 통해 파일의
유효성을 검증할 수 있습니다. 유효성 검증 모드에서 가져오기 내보내기 도구를 실행하려면
다음 명령을 입력하십시오.
FilePlanTool -mode validate -f XML
filename.xml
XML filename은 검증할 파일의 이름 및 경로입니다. 파일 이름을
제공하지 않는 경우, 도구에서는 구성 대화 상자의 출력 파일 이름 필드에 지정된 기본 파일 이름을
사용합니다. 기본 XML 출력 파일 이름 지정에 대한 정보는
도구 구성을 참조하십시오.
다시 가져오기 옵션 사용
다시 가져오기 옵션을 사용하여
파일 계획에 있는 엔티티를 가져올 때 도구의 기본 동작을 결정하십시오. 다시 가져오기 옵션에는 다음과 같은 세 개의 매개변수가 있습니다.
- 없음 - 엔티티를 추가할 때, 엔티티가 존재하고 엔티티를 추가하지 않고 계속 작업을 수행하는 경우
도구에서 예외 로그에 경고를 보고합니다.
- 건너 뛰기: 엔티티를 추가할 때, 도구에서는 기존 엔티티를 건너 뛰고,
계속하여 작업을 수행하며 활동 로그에 건너 뛰기 수행을 보고합니다.
- 바꾸기: 엔티티를 추가할 때, 도구에서는 기존 엔티티를 대체하고,
계속하여 작업을 수행하며 활동 로그에 수정 수행을 보고합니다.
대용량 파일 계획 가져오기에 실패한 후
건너 뛰기 옵션을 사용하십시오. 두 번째 동일한 파일 계획 가져오기 시도 도중, 건너 뛰기 옵션은
가져온 엔티티를 다시 가져오는 경우를 피합니다. 그러나 두 번째 가져오기 시도에서 처음에 가져온 엔티티를 부분적으로 수정해야 할 경우에는
바꾸기 옵션을 사용하십시오. 이후에 소수의 엔티티에 대한 부분적 수정을 가져오는 중에는
XML 파일의 RMEntityObjectType 섹션에서 엔티티에 대해
Action="Modify"를 지정하십시오. 원래 XML 파일을 변경하는 대신 이러한 엔티티를 변경하십시오. 또한 업데이트 모드를 사용하여 처음 전체 가져오기와 후속 업데이트를 더 쉽게 식별하십시오.
파일 계획 가져오기/업데이트를 참조하십시오.