전문 관리 > 등록 정보 및 명령줄 유틸리티 작업 > 기본 설정 내보내기 및 가져오기 > 기본 설정 가져오기
  
기본 설정 가져오기
가져오기 유틸리티를 사용하여 이전에 내보낸 기본 설정 정보를 가져올 수 있습니다. 가져오기 유틸리티가 내보내기 파일에서 가져오는 기본 설정 인스턴스를 제한할 수 있습니다. 예를 들어, 특정 사용자나 컨텍스트의 기본 설정 인스턴스만 가져올 수 있습니다. 또한 가져온 기본 설정 인스턴스를 특정 조직이나 사용자 같은 특정 수준에 적용할 수 있습니다. 이 경우 -applyTo 매개변수에 지정된 수준에 대해서만 기본 설정 인스턴스가 작성됩니다. 가져온 기본 설정 인스턴스의 원래 수준에 따라 기본 설정 인스턴스가 작성되지 않습니다.
가져오기 유틸리티 구문은 다음과 같습니다.
windchill wt.preference.ImportPreferences -importfile="<filepath>"
가져오기 유틸리티를 실행하면 도구를 실행한 디렉토리에 PreferenceImport_<YYYYMMDD_HHmm>.txt라는 로그 파일이 작성됩니다. 여기서 <YYYYMMDD_HHmm>은 유틸리티를 실행한 날짜 및 시간을 나타냅니다. 기존 기본 설정 정보와 가져온 기본 설정 정보 사이에 일치하지 않는 내용이 있으면 충돌로 표시되며 이러한 충돌은 도구를 실행한 디렉토리에 작성되는 PreferenceImport불완전한 객체의_<YYYYMMDD_HHmm>.txt 로그 파일에 기록됩니다.
이러한 충돌이 발생할 경우 수행할 작업을 결정하는 매개변수를 명령에 지정할 수 있습니다. 새 기본 설정 정의와 인스턴스도 기록됩니다. 가져올 기본 설정 인스턴스에 지정된 것과 일치하는 기본 설정 정의, 카테고리 또는 클라이언트가 없으면 오류로 표시되고 기록됩니다. 기본 설정 정의가 있지만 가져오기를 통해 가져온 기본 설정 인스턴스를 적용하려는 수준보다 높은 수준에 이미 정의되어 있으면 오류가 기록됩니다.
오류가 발생하면 전체 가져오기 파일이 처리되고 모든 오류가 기록된 후 어떤 기본 설정 인스턴스도 가져오지 않은 상태로 유틸리티가 종료됩니다.
불일치나 오류가 발생하지 않으면 가져오기가 성공적으로 완료됩니다.
다음은 가져오기 명령에 지원되는 매개변수입니다.
매개변수
설명
-importfile="<filepath>"
가져올 기본 설정이 들어 있는 XML 파일입니다(전체 경로 포함). 일반적으로 기본 설정 내보내기 유틸리티를 사용하여 작성된 파일입니다. 잘못된 파일이나 파일 경로를 제공하면 오류 메시지가 표시됩니다.
이 매개변수는 필수입니다.
-user="<adminID>"
사이트 관리자 사용자의 사용자 ID입니다. 이 매개변수는 -password 매개변수와 함께 지정해야 합니다. 이 매개변수를 지정하지 않으면 유틸리티를 실행할 때 인증하라는 메시지가 표시됩니다.
-password="<adminpassword>"
사이트 관리자 사용자의 암호입니다. 이 매개변수는 -user 매개변수와 함께 지정해야 합니다. 이 매개변수를 지정하지 않으면 유틸리티를 실행할 때 인증하라는 메시지가 표시됩니다.
-usage
명령에 사용할 수 있는 모든 인수를 표시합니다.
-debug="<debugLevel>"
정보 또는 디버깅 메시지의 수준을 제어합니다. 1이 수준이 가장 낮고 3이 수준이 가장 높습니다.
-importSiteLevel
사이트 수준 기본 설정 인스턴스만 가져오기 파일에서 가져옵니다.
-importSiteLevel, -importOrgLevel, -importContainerLevel 또는 -importUserLevel 매개변수는 한 번에 하나만 지정할 수 있습니다.
가져오기 파일에 지정한 수준의 기본 설정 인스턴스가 없으면 정보 메시지가 로그에 추가되지만 오류로 간주되지는 않습니다.
-importOrgLevel="<FullPath>"
지정한 조직의 기본 설정 인스턴스만 가져오기 파일에서 가져옵니다. 조직은 한 번에 하나만 지정할 수 있습니다. 조직의 전체 경로를 매개변수 값으로 지정해야 합니다.
예를 들어, 데모 조직이라는 조직의 기본 설정 인스턴스를 가져오려면 다음과 같이 매개변수를 지정합니다.
-importOrgLevel="/wt.inf.container.OrgContainer=Demo Organization"
-importSiteLevel, -importOrgLevel, -importContainerLevel 또는 -importUserLevel 매개변수는 한 번에 하나만 지정할 수 있습니다.
가져오기 파일에 지정한 수준의 기본 설정 인스턴스가 없으면 정보 메시지가 로그에 추가되지만 오류로 간주되지는 않습니다.
-importContainerLevel="<FullPath>"
지정한 컨텍스트(제품, 라이브러리, 프로젝트 또는 프로그램)의 기본 설정 인스턴스만 가져오기 파일에서 가져옵니다. 컨텍스트는 한 번에 하나만 지정할 수 있습니다. 컨텍스트의 전체 경로를 매개변수 값으로 지정해야 합니다.
예를 들어, 데모 조직에서 Product1이라는 제품의 모든 기본 설정 인스턴스를 가져오려면 다음과 같이 매개변수를 지정합니다.
-importContainerLevel="/wt.inf.container.OrgContainer=Demo Organization/wt.pdmlink.PDMLinkProduct=Product1"
-importSiteLevel, -importOrgLevel, -importContainerLevel 또는 -importUserLevel 매개변수는 한 번에 하나만 지정할 수 있습니다.
가져오기 파일에 지정한 수준의 기본 설정 인스턴스가 없으면 정보 메시지가 로그에 추가되지만 오류로 간주되지는 않습니다.
-importUserLevel=<userId>
지정한 사용자의 기본 설정 인스턴스만 가져오기 파일에서 가져옵니다. 사용자는 한 번에 하나만 지정할 수 있습니다. 예를 들어, wcadmin 사용자의 모든 기본 설정 인스턴스를 가져오려면 다음과 같이 매개변수를 지정합니다.
-userLevel=wcadmin
-importSiteLevel, -importOrgLevel, -importContainerLevel 또는 -importUserLevel 매개변수는 한 번에 하나만 지정할 수 있습니다.
가져오기 파일에 지정한 수준의 기본 설정 인스턴스가 없으면 정보 메시지가 로그에 추가되지만 오류로 간주되지는 않습니다.
-overwriteValueConflicts
모든 값 불일치 충돌은 기존 값을 가져올 값으로 덮어써서 해결됩니다. 이 매개변수를 지정하면 데이터베이스의 다중 값 기본 설정이 가져온 기본 설정 값으로 교체됩니다.
이 기본 설정은 -skipUnresolvedConflicts 기본 설정과 함께 지정할 수 있으며, 이 경우 충돌하는 값은 모두 덮어쓰고 해결되지 않은 충돌은 건너뛰어서 가져오기 작업이 성공적으로 완료됩니다.
-skipUnresolvedConflicts
해결되지 않은 충돌은 건너뛰고 파일의 나머지 부분만 가져옵니다.
이 기본 설정은 -overwriteValueConflicts 기본 설정과 함께 지정할 수 있으며, 이 경우 충돌하는 값은 모두 덮어쓰고 해결되지 않은 충돌은 건너뛰어서 가져오기 작업이 성공적으로 완료됩니다.
-applyToSiteLevel
가져온 기본 설정 인스턴스를 사이트 수준에만 적용합니다.
-applyToOrgLevel="<FullPath>"
가져온 기본 설정 인스턴스를 지정한 조직에만 적용합니다. 조직의 전체 경로를 매개변수 값으로 지정해야 합니다. 쉼표로 구분된 목록을 사용하여 여러 조직을 지정할 수 있습니다.
이 매개변수는 -importSiteLevel, -importOrgLevel, -importContainerLevel 또는 -importUserLevel 매개변수 중 하나와 함께 사용해야 합니다.
여러 조직을 지정할 경우 가져오기 작업은 각 조직에 별도로 적용됩니다. 지정한 조직 중 일부 조직에 대해서만 가져오기 작업이 성공적으로 완료된 경우 가져오기 작업이 성공한 조직에 대한 자세한 정보가 있는 메시지가 표시됩니다. 가져오기 작업이 실패한 조직의 충돌 내용은 로그 파일에 기록됩니다.
-applyToContainerLevel="<FullPath>"
가져온 기본 설정 인스턴스를 지정한 컨텍스트(제품, 라이브러리, 프로젝트 또는 프로그램)에 적용합니다. 컨텍스트의 전체 경로를 매개변수 값으로 지정해야 합니다. 쉼표로 구분된 목록을 사용하여 여러 컨텍스트를 지정할 수 있습니다.
이 매개변수는 -importSiteLevel, -importOrgLevel, -importContainerLevel 또는 -importUserLevel 매개변수 중 하나와 함께 사용해야 합니다.
여러 컨텍스트를 지정할 경우 가져오기 작업은 각 컨텍스트에 별도로 적용됩니다. 지정한 컨텍스트 중 일부 컨텍스트에 대해서만 가져오기 작업이 성공적으로 완료된 경우 가져오기 작업이 성공한 컨텍스트에 대한 자세한 정보가 있는 메시지가 표시됩니다. 가져오기 작업이 실패한 컨텍스트의 충돌 내용은 로그 파일에 기록됩니다.
-applyToUserLevel="<UserId>"
가져온 기본 설정 인스턴스를 지정한 사용자에게만 적용합니다. 쉼표로 구분된 목록을 사용하여 여러 사용자를 지정할 수 있습니다.
이 매개변수는 -importSiteLevel, -importOrgLevel, -importContainerLevel 또는 -importUserLevel 매개변수 중 하나와 함께 사용해야 합니다.
여러 사용자를 지정할 경우 가져오기 작업은 각 사용자에게 별도로 적용됩니다. 지정한 사용자 중 일부 사용자에 대해서만 가져오기 작업이 성공적으로 완료된 경우 가져오기 작업이 성공한 사용자에 대한 자세한 정보가 있는 메시지가 표시됩니다. 가져오기 작업이 실패한 사용자의 충돌 내용은 로그 파일에 기록됩니다.