스프레드시트에서 파생 사양 로드
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>
