데이터 관리 기능 > 부품 구조 관리 > Windchill 옵션 및 변형 기능 > 변형 작성 및 관리 > 변형 사양 정보 페이지 > 파생 사양 로드 > 스프레드시트에서 파생 사양 로드
  
스프레드시트에서 파생 사양 로드
Windchill 명령줄 유틸리티를 사용하여 스프레드시트에서 여러 파생 사양을 로드할 수 있습니다. 이 유틸리티는 프로그램에서 파생 사양을 로드하는 데 사용되는 API에 의존합니다.
* 
이 기능을 사용하려면 다음 사항을 준수해야 합니다.
Platform Structures 모듈이 설치되어 있어야 합니다.
사이트 관리자 및 Platform Structures 그룹의 멤버여야 합니다.
스프레드시트에서 파생 사양을 로드하려면 다음 절차를 따르십시오.
1. WT_HOME\loadFiles\ato\testdata\variantSpecLoader에서 사용할 수 있는 템플릿 VariantSpecLoader1.xlsx을 사용하여 스프레드시트를 작성합니다.
2. 다음과 같은 Windchill 명령줄 유틸리티를 실행합니다.
Windchill com.ptc.windchill.option.variantspec.loader.VariantSpecLoader -d <My_Spreadsheet_Path>\<My_Spreadsheet>.xlsx -u <my_user> -p <my_password>
3. 출력 파일을 검토하여 오류를 해결합니다. 출력 파일은 WT_HOME\logs 아래에 있습니다.
스프레드시트에는 파생 사양과 부품 구조 구성에 연관된 정보를 입력하는 3가지 워크시트가 포함되어 있습니다.
부품 구성 사양 워크시트(Part Config Specs) - 이 워크시트에 대한 정보는 부품을 구성할 때 구성 창의 구성 사양 탭에 지정한 정보와 유사합니다. 이 워크시트에는 구성 사양 이름, 보기, 라이프 사이클 상태, 베이스라인유효성 날짜의 5가지 필드가 있습니다. 이름은 필수입니다. 보기에 대한 값은 구성 창의 보기 필드에 해당하는 유효한 엔트리여야 합니다. 입력한 값은 시스템에서 검증됩니다.
옵션 필터 구성 사양 워크시트(Option Filter Config Specs) - 이 워크시트는 옵션 필터에 대한 구성 사양을 정의합니다. 이 워크시트에는 구성 사양 이름, 라이프 사이클 상태유효성 날짜의 3가지 필드가 있습니다. 입력한 정보는 옵션 필터 창에서 아이콘을 클릭하여 액세스하는 옵션 필터에 대한 구성 사양 설정 창에서 지정하는 사항과 유사합니다. 입력한 값은 시스템에서 검증됩니다.
탐색 조건 워크시트(Navigation Criteria) - 옵션 필터에서 선택을 캡처하기 위해 선택 규칙 및 선택한 선택 항목에 대한 정보를 제공합니다. 워크시트에는 다음 필드가 있습니다.
파생 사양 섹션:
이름 - 파생 사양에 지정할 이름을 입력합니다.
번호 - 기존 파생 사양을 재구성하려는 경우에만 이 열을 사용합니다. 유효한 번호가 제공되고 이 번호가 있는 파생 사양이 존재하는 경우 지속되는 이름이 사용됩니다.
* 
이름 또는 번호를 둘 다가 아닌 하나만 제공해야 합니다.
설명 - 파생 사양에 대한 설명을 제공합니다(최대 2000자).
위치 - 파생 사양을 저장할 위치를 지정합니다. 이 필드가 비어 있는 경우 유틸리티는 기본 위치를 사용합니다. 파생 사양 생성에 대해 이 필드가 비어 있는 경우 유틸리티에서는 오류가 발생합니다.
파생 생성 - 이는 부울 값입니다. true로 설정된 경우 시스템에서는 파생 사양에 대해 모듈 파생을 생성합니다. 모듈 파생의 생성은 비동기적이므로 유틸리티는 실제 파생이 아닌 각 파생에 대한 대기열 엔트리의 생성 성공/실패만 기록합니다. 이 필드가 false로 설정된 경우 유틸리티에서는 파생 사양만 생성됩니다.
부품 섹션 - 이 섹션에서는 파생 사양을 사용하여 구성할 부품의 세부내용을 제공합니다. 유틸리티에서는 부품에 지정된 옵션 세트가 있다고 예상합니다. 지정된 옵션 세트가 없는 경우 행이 처리되지 않습니다.
번호 - 부품의 번호입니다(예: Bicycle1).
개정 - 부품의 개정입니다(예: A).
이터레이션 - 부품의 이터레이션입니다(예: 1). 이 예에서 부품은 Bicycle1 A.1입니다.
* 
부품에 대한 정보를 제공하는 경우 옵션 세트에 대한 정보가 중복됩니다. 부품이나 옵션 세트 필드 둘 다가 아닌 하나에 대한 정보를 제공해야 합니다.
OptionSet 섹션 - 파생 사양은 옵션 세트를 사용하여 생성됩니다. 부품이 해당 행에 대해 지정되지 않은 경우 해당 파생 사양은 유틸리티로 생성됩니다.
이름 - 옵션 세트의 이름입니다.
개정 - 부품의 개정입니다(예: A).
이터레이션 - 부품의 이터레이션입니다(예: 1).
탐색 조건 섹션 - 이 섹션에서는 사용자 인터페이스의 구성 사양 탭과 옵션 필터 탭에 지정된 정보를 캡처합니다.
상위에 적용 - 이 속성을 true로 설정하면 구성 창의 구성 사양 탭에 있는 동일한 상자를 선택하는 것과 동일하게 됩니다. 상위에 적용true로 설정하면 시스템에서는 제공된 부품 구조의 최상위 부품에 구성 사양을 적용합니다.
* 
옵션 세트만 사용하여 생성된 파생 사양에 대해서는 이 정보가 필요하지 않습니다. 이 정보가 제공되는 경우 검증자가 오류를 보고합니다.
부품 구성 사양 - 워크시트 1을 사용하여 이미 로드된 부품 구성 사양의 목록을 제공합니다. 쉼표(,)로 구분하여 여러 구성 사양을 제공할 수 있습니다. 부품이 열 F-H에서 지정되고 이 열이 비어 있는 경우 유틸리티에서는 최신 부품 구성 사양을 로드하여 파생 사양을 생성하는 데 사용합니다.
옵션 필터 구성 사양 - 워크시트 2를 사용하여 이미 로드된 옵션 필터 구성 사양의 목록을 제공합니다. 쉼표(,)로 구분하여 여러 구성 사양을 제공할 수 있습니다. 이 정보를 비워두면 유틸리티에서는 최신 옵션 필터 구성 사양을 로드하여 파생 사양을 생성하는 데 사용합니다.
규칙 확인 사용 안 함 - 기본적으로 이 필드는 false로 설정됩니다. true로 설정되면 구성 창에 있는 상자를 선택하는 것과 동일하게 됩니다.
필터 모드 - 이 필드는 옵션 필터 탭(표준 또는 대체를 선택한 위치)의 드롭다운 목록과 유사합니다.
시작 옵션 열 - 빈 열은 옵션 필터에 대해 선택할 선택 항목 정의의 시작을 나타냅니다.
추가 열 - 옵션 필터에 대해 선택하려는 선택 항목이 있는 옵션당 열 하나만 제공합니다.
예를 들어, OptionA에서 ChoiceA, ChoiceB 및 ChoiceC를 선택하고 Option B에서 ChoiceD를 선택하려는 경우 시작 옵션 열에 따라 OptionA 및 OptionB의 2가지 열을 생성해야 합니다. 파생 사양 정보를 생성하는 행에서 OptionA에 따라 쉼표로 구분된 ChoiceA, ChoiceB 및 ChoiceC의 목록을 입력하고 OptionB에 따라 ChoiceD를 입력합니다. 다음 행(즉, 다음 파생 사양)에 다른 옵션에서 선택한 선택 항목이 있는 경우 옵션 이름이 있는 새 열과 해당 선택 항목을 작성 중인 행에 대해 그 아래의 셀에 생성합니다. 이 행에 대해 OptionA 및 OptionB 아래의 셀을 비워둘 수 있습니다.
* 
동일한 파생 사양의 버전이 시스템에 있는 경우 해당 번호로 파생 사양을 참조해야 합니다.
끝 옵션 - 이 필드는 워크시트의 마지막 열입니다. 해당 필드에는 옵션 필터에 대한 모든 옵션과 선택 항목 선택의 끝이 표시됩니다.
출력 파일
스프레드시트를 가져오도록 유틸리티를 실행할 때 시스템에서는 출력 파일을 생성합니다. 출력 파일은 로그 폴더 WT_HOME\logs에 있으며 VariantSpecLoaderReport_<random_generated_number>*로 이름이 지정됩니다.
출력 파일에는 다음과 같은 정보가 포함됩니다.
처리 중인 탐색 조건 워크시트의 행 번호
작업 상태: 성공 또는 실패
파생 사양 번호입니다(파생 사양이 성공적으로 작성된 경우).
CREATED - 새 파생 사양이 작성되면 CREATED가 true로 설정됩니다. 그렇지 않으면 CREATED는 false로 설정됩니다.
UPDATED - 파생 사양이 기존의 파생 사양인 경우 UPDATED가 true로 설정됩니다. 즉, 파생 사양이 스프레드시트에 제공된 파생 사양 번호에 따라 재구성되었음을 의미합니다.
ERROR - 스프레드시트를 처리하는 동안 검증 중 발생한 오류 또는 객체를 생성하는 동안 발생한 오류를 보고합니다. 오류가 발생하는 경우 유틸리티에서는 해당 행을 처리하지 않고 보고서에 오류를 기록하며 다음 행으로 이동합니다.
WARNING - 행을 처리하는 동안 경고 또는 가정이 발생한 경우 보고서에 경고로 기록됩니다.
파생 사양을 로드하기 위한 스프레드시트 사용 지침
다음 정보를 고려하십시오.
파생 사양을 로드하려면 .xlsx(기본 Microsoft office Excel 2007) 스프레드시트 형식만 사용합니다.
UNIX에서 파생 사양을 로드하기 위한 windchill 명령은 대소문자를 구분합니다.
windchill com.ptc.windchill.option.variantspec.loader.VariantSpecLoader -d <My_spreadsheetpath>
구문을 사용합니다.
스프레드시트를 사용하고 Create Variants = True를 입력하여 파생 사양을 재구성할 때 파생 사양에 대한 구조와 선택 항목 선택이 변경되지 않은 경우에도 새 파생을 생성합니다(기존 파생 무시).
옵션 세트를 사용하여 생성된 파생 사양은 재구성할 수 없습니다.
사용자 정의 파생 사양 번호를 통한 파생 사양의 생성에는 바로 사용할 수 있는 API 또는 스프레드시트의 사용이 지원되지 않습니다.
스프레드시트에서 파생 사양에 대한 폴더 위치를 제공하려면 해당 제품의 /Default 캐비닛에서 생성된 모든 폴더(예: /Default/ABC)를 사용할 수 있습니다.
기존 파생 사양을 재구성하려면 파생 사양이 연관된 부품을 지정해야 합니다. 이러한 경우 옵션 세트를 지정하지 마십시오.
파생 사양을 해당 버전을 기준으로 재구성할 수 없습니다. 최신 버전은 항상 재구성됩니다.
특수 문자에 대한 다음 지침을 따르십시오.
이름에 따옴표가 있는 선택 항목은 백슬래시 "\"로 처리되어야 합니다(예: "\a"1\").
이름에 특수 문자가 있는 선택 항목은 따옴표로 묶어야 합니다(예: "a_1").
스프레드시트 검증
스프레드시트가 처리 중인 경우 다음 검증이 수행됩니다.
부품 또는 옵션 세트 모두가 아닌 하나만 지정할 수 있습니다.
부품에는 지정된 옵션 세트가 있어야 합니다.
부품이 있어야 합니다.
옵션 세트가 있어야 합니다.
폴더가 있어야 하며 새 파생 사양을 생성할 때 지정되어야 합니다.
지정된 부품 구성 사양이 있어야 합니다.
지정된 옵션 필터 구성 사양이 있어야 합니다.
파생 사양 이름 또는 번호 모두가 아닌 하나만 지정할 수 있습니다.
지정된 번호가 있는 파생 사양이 있어야 합니다.
기존 파생 사양을 재구성하려면 파생 사양이 연관된 부품을 지정해야 합니다. 이러한 경우 옵션 세트를 지정하지 마십시오.
부품이나 옵션 세트를 제공해야 합니다.
디버그 모드에서 유틸리티 실행
오류를 디버깅하는 데 사용할 수 있는 wt_home\logs 폴더에서 log4j 파일을 생성하는 디버그 모드에서 유틸리티를 실행할 수 있습니다. 로그 파일은 처리 중인 스프레드시트의 각 행에 대한 오류를 기록합니다.
디버그 모드에서 유틸리티를 사용하려면 다음 구문을 사용합니다.
Windchill --jap=wt.properties?com.ptc.windchill.option.variantload.java.args com.ptc.windchill.option.variantspec.loader.VariantSpecLoader -d <My_Spreadsheet_Path>\<My_Spreadsheet>.xlsx -u <my_user> -p <my_password>