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

개요

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를 사용하여 툴을 시작할 수 있습니다.

다음 다섯 가지 모드 중 하나로 툴을 실행할 수 있습니다.

툴 구성

가져오기 또는 내보내기 모드에서 툴을 실행하기 전에 툴을 구성해야 합니다.

툴 구성

  1. 파일 계획 가져오기/내보내기 툴이 설치된 폴더를 탐색하십시오.
  2. 명령행에서 다음 중 하나를 실행하십시오.

    Windows:
    FilePlanTool -mode configure

    UNIX:
    ./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는 다음 사항일 수 있습니다.

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"를 지정하십시오. 또한 업데이트 모드를 사용하여 처음 전체 가져오기와 후속 업데이트를 더 쉽게 식별하십시오. 파일 계획 가져오기/업데이트를 참조하십시오.