IBM InfoSphere Enterprise Records 배치의 경우, 파일 계획 가져오기 내보내기 툴을 사용하여 외부 파일 계획을 가져오거나 파일 계획을 외부 환경으로 내보낼 수 있습니다. 이 툴에서는 XML 파일을 사용하여 가져오기 및 내보내기 프로세스를 완료합니다. XML 스키마 및 해당 요소에 대한 자세한 내용은 파일 계획 XML 스키마를 참조하십시오.
스케줄 상속, 대체 보유, 처리 트리거 및 동적 보류(조건부 보류)를 포함하도록 내보낸 XML 파일을 수정하는 데 대한 자세한 내용은 Product Documentation for FileNet P8 Platform에 있는 File Plan Import and Export Tool 섹션을 참조하십시오.
파일 계획 가져오기/내보내기 툴을 사용하여 파일 계획을 쉽게 마이그레이션할 수 있습니다. 그러나, 이 툴은 다음을 지원하지 않습니다.
또한 나머지 파일 계획을 가져오기 전에 먼저 선택 목록과 같은 사용자 정의 특성과 클래스를 개별 XML 파일로 내보내고 가져와야 합니다. 또한 파일 계획을 가져온 후 닫힘 또는 처리 준비 완료와 같은 엔티티 상태는 더 이상 적용되지 않습니다.
명령행 Java™ 실행 파일에서 파일 계획 가져오기/내보내기 툴을 실행하거나 명령 파일인 FilePlanTool.bat 또는 FilePlanTool.sh를 사용하여 툴을 시작할 수 있습니다.
다음 다섯 가지 모드 중 하나로 툴을 실행할 수 있습니다.
가져오기 또는 내보내기 모드에서 툴을 실행하기 전에 툴을 구성해야 합니다.
툴 구성
Windows:
FilePlanTool -mode configure
UNIX:
./FilePlanTool.sh -mode configure
주: iiop 연결을 사용하는 경우 보안 소켓 계층(SSL)을 비활성화해야 합니다. SSL을 비활성화하려면 보안 소켓 계층 비활성화를 참조하십시오.
내보내려는 파일 계획에 다음 항목이 포함되어 있는 경우
범위 옵션으로 파일 계획 내보내기를 참조하십시오.
툴을 구성한 후 툴을 사용하여 파일 계획을 내보낼 수 있습니다. 파일 계획을 내보내려면 다음 명령을 입력하십시오.
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는 다음 사항일 수 있습니다.
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를 지정합니다. 업데이트 모드를 사용하면 선택 목록과 같은 사용자 정의 특성을 수정할 수 없습니다.
오류 메시지가 표시되거나 가져오기 프로세스가 중지될 경우 FileNet P8 Troubleshooting Guide를 참조하십시오. 대부분의 경우 가져오기 프로세스는 오류가 발생한 후 중지되고 메시지를 표시하지 않습니다.
툴에서는 조건부 보류를 가져오지 않으므로, 필요한 경우 보류 스윕을 실행하여 가져오기 후 엔티티에 조건부 보류를 적용합니다.제한사항을 참조하십시오.
XML 파일을 수동으로 작성한 후, 파일 계획 가져오기/내보내기 툴을 통해 XML 파일을 검증하여 파일에 오류 또는 비준수 문제가 없음을 확인하십시오.
검증 모드에서 가져오기/내보내기 툴을 실행하려면 다음 명령을 입력하십시오.
FilePlanTool -mode validate -f <XML filename.xml>
XML filename은 검증할 파일의 이름 및 경로입니다. 명령행에서 파일 이름을 제공하지 않는 경우 툴에서는 툴 구성 대화 상자의 출력 파일 이름 필드에 지정된 기본 파일 이름을 사용합니다. 기본 XML 출력 파일 이름 지정에 대한 자세한 내용은 툴 구성을 참조하십시오.
다시 가져오기 옵션을 사용하여 이미 파일 계획에 있는 엔티티를 가져올 때 툴의 기본 동작을 결정하십시오. 다시 가져오기 옵션에는 다음과 같은 세 개의 매개변수가 있습니다.
대용량 파일 계획 가져오기에 실패한 후 건너뛰기 옵션을 사용하십시오. 두 번째 동일한 파일 계획 가져오기 시도 도중 건너뛰기 옵션은 성공적으로 가져온 엔티티를 다시 가져오는 경우를 피합니다. 그러나, 두 번째 가져오기 시도에서 처음에 성공적으로 가져온 엔티티를 부분적으로 수정해야 할 경우에는 바꾸기 옵션을 사용하십시오.
이후에 소수의 엔티티에 대한 부분적 수정을 가져오는 중에는 원래 XML 파일에 변경사항을 적용하는 대신 XML 파일의 RMEntityObjectType 섹션에서 엔티티에 대해 Action="Modify"를 지정하십시오. 또한 업데이트 모드를 사용하여 처음 전체 가져오기와 후속 업데이트를 더 쉽게 식별하십시오. 파일 계획 가져오기/업데이트를 참조하십시오.