벌크 데이터 로드 유틸리티
벌크 데이터 로드 유틸리티를 사용하여 ZIP 아카이브에서 구성 및 마스터 데이터를 로드합니다. 조직 유틸리티 또는 비즈니스 구성 관리(BCA) 페이지에서 이 유틸리티에 액세스할 수 있습니다.
액세스하려면 비즈니스 관리자 또는 조직 관리자 권한이 필요합니다.
이 유틸리티는 한 번에 여러 개의 Windchill+ 로드 파일을 로드할 수 있도록 지원합니다. 업로드하기 전에 로드 파일을 ZIP 아카이브로 압축해야 합니다. 이 기능을 사용하면 데이터를 구조화되고 일관된 방식으로 Windchill 환경으로 가져올 수 있습니다.
자세한 내용은 다음 항목을 참조하십시오.
• 조직 작업
• 조직 유틸리티
벌크 데이터 로드를 클릭하면 다음 보기가 표시됩니다.
액세스 및 권한 관리
• 조직 컨텍스트에서 유틸리티를 엽니다(이 유틸리티는 사이트 유틸리티에 나타나지 않습니다).
• Windchill에 데이터를 로드하기 위해 벌크 데이터 로드 유틸리티를 실행하기 전에 필요한 액세스 권한이 있는지 확인해야 합니다.
• 조직 관리자로서 사이트 레벨 액세스 제어 권한이 없는 경우 사이트 컨텍스트 내에서 데이터를 로드할 수 없습니다.
• 로드 파일에 컨테이너 경로가 지정되지 않은 경우 데이터가 사이트 레벨에서 로드됩니다. 자세한 내용은 로드 파일 정보를 참조하십시오.
ZIP 패키지 구성
.zip 패키지의 구조는 다음과 같습니다.
loadFiles 폴더에는 개별 로드 파일이 포함됩니다. loadXMLFiles 폴더에는 재사용 가능한 템플릿과 로드 프로세스를 지원하는 정의가 저장됩니다.
로드 파일 폴더 내용의 예는 다음과 같습니다.
loadFileSet.xml 파일의 예는 다음과 같습니다.
로드 파일 세트에서 참조된 로드 파일이 ZIP 패키지에 있는지 확인합니다. 예를 들어, 로드 파일 세트에 OIR.xml 및 BulkLoadReportTemplate.xml이 나열되어 있습니다. 이러한 파일이 ZIP 패키지에 포함되어 있는지 확인합니다.
 | loadFileSet.xml 파일은 항상 loadFiles 폴더에 있어야 합니다. |
로드 파일 실행 옵션
로드 파일을 실행할 때 데이터 로드 방식 필드에서 사용할 수 있는 다음 실행 옵션 중 하나를 선택할 수 있습니다.
• 전부 또는 전혀 없음
◦ 시스템은 모든 로드 파일을 성공적으로 실행하거나, 모든 변경 사항을 롤백합니다.
◦ 로드 파일이 하나라도 실패하면 전체 실행이 실패합니다.
◦ 예를 들어, 로드 파일 세트에 4개의 로드 파일이 포함된 경우를 가정합니다. 처음 두 파일이 성공하고 세 번째 파일이 실패하면 시스템은 처음 두 파일에서 로드한 모든 데이터를 롤백합니다. 네 번째 파일은 실행되지 않습니다. 시스템은 전체 로드 작업이 실패한 것으로 보고합니다.
| | 전부 또는 전혀 없음 모드에서 로드 작업이 실패하면 시스템이 롤백을 수행하고 일반 오류 메시지를 표시합니다. 오류의 세부 원인은 작업 모니터 페이지의 첨부 파일 섹션에 있는 메서드 서버 로그에 캡처됩니다. 이 로그는 각 로드 파일의 실행 상태를 보여주며 올바른 파일이 처리되었는지 확인하는 데 도움이 됩니다. 이러한 세부 정보는 문제 해결에 도움이 됩니다. |
• 첫 번째 오류까지
◦ 시스템은 첫 번째 오류를 발견하면 실행을 중지합니다.
◦ 오류가 발생하기 전에 실행된 로드 파일은 로드된 상태로 유지됩니다
예를 들어, 로드 파일 세트에 4개의 로드 파일이 포함된 경우를 가정합니다. 처음 두 파일이 성공하고 세 번째 파일이 실패하면 처음 두 로드 파일의 데이터는 로드된 상태로 유지됩니다. 네 번째 로드 파일은 처리되지 않습니다. 시스템은 로드 작업이 실패한 것으로 보고합니다.
• 가능한 한 많이
◦ 시스템은 오류가 발생해도 로드를 계속 실행합니다.
◦ 오류를 기록하지만 프로세스를 중지하지는 않습니다.
예를 들어, 로드 파일 세트에 4개의 로드 파일이 있는 경우를 가정합니다. 처음 두 개의 로드 파일이 성공합니다. 세 번째 로드 파일이 실패합니다. 네 번째 로드 파일이 성공합니다. 처음 두 파일의 데이터와 네 번째 파일의 데이터는 시스템에 남아 있습니다. 세 번째 파일의 데이터만 로드되지 않습니다.
필수조건
• 유효한 .zip 또는 .jar 패키지를 준비합니다. 다른 파일 유형은 지원되지 않습니다.
• 로드 세트가 참조하는 정확한 로드 파일이 ZIP에 포함되어 있는지 확인합니다.
• loadFileSet.xml 내 종속성을 기준으로 로드 파일을 올바른 순서로 정렬합니다.
• 필요한 파일이 패키지에 모두 포함되어 있는지 확인합니다. 로더가 참조하는 모든 파일을 패키지 내에 포함시킵니다. zip 패키지 외부에 있는 로드 파일이나 콘텐츠를 참조하지 마십시오.
ZIP 업로드
다음 단계를 수행하십시오.
1. > > 로 이동합니다.
2. 벌크 데이터 로드를 클릭합니다. 다음과 같은 엔티티가 나타납니다.
3. 파일 번들 로드 필드를 사용하여 ZIP 파일을 찾아보거나 끌어서 놓습니다.
4. 데이터 로드 방식 필드를 사용하여 실행 모드를 선택합니다. 전부 또는 전혀 없음이 기본 실행 모드입니다.
5. 확인을 클릭합니다. 업로드가 완료되면 페이지에 모니터링 사용자 인터페이스를 여는 링크가 표시됩니다.
해당 링크를 클릭하여 작업 모니터 정보 페이지를 엽니다.
| | 작업 모니터 정보 페이지의 작업 로그를 사용하여 성공적으로 실행된 로드 파일을 확인합니다. 예를 들어, 첨부 파일 섹션의 파일을 검토합니다. 이러한 파일은 각 로드 파일의 실행 상태를 표시하며 올바른 파일이 처리되었는지 확인하는 데 도움이 됩니다. 첨부 파일 섹션에는 메서드 서버 로그도 들어 있습니다. |
◦ 첨부 파일 섹션에는 로그 파일이 포함되어 있습니다. 로그 파일에는 실패를 진단하고 해결하는 데 필요한 모든 정보가 포함되어 있습니다. 로그를 보려면 로그 파일을 클릭합니다.
◦ 상황 필드에 작업 상황이 표시됩니다.
◦ 주요 콘텐츠 섹션에는 로드 파일 .zip이 포함되어 있습니다.
| | 빠른 링크 목록에서 사용할 수 있는 벌크 유틸리티 작업 모니터 작업을 클릭하여 작업 모니터 페이지를 볼 수도 있습니다.  |
진행률 및 결과 모니터링
• 업로드 후 링크에서 모니터링 사용자 인터페이스를 열거나 > 를 클릭합니다.
• 작업 상황(실행 중, 완료 또는 실패)을 검토합니다. 작업 유형이 데이터 로드로 표시됩니다.
• 작업 세부내용에서 로그를 열어 처리된 로드 파일 및 오류를 봅니다.
• 자세한 실행 흐름 및 이슈 분석은 첨부된 메서드 서버 로그를 참조하십시오.
| | • 전부 또는 전혀 없음 모드에서는 진행률 로그가 커밋 시간에 생성됩니다. 다른 모드는 각 파일 로드 후에 업데이트됩니다. • 필요한 경우 작업 세부내용에서 원본 ZIP을 다운로드합니다. |
로드 검증
• 객체가 올바른 컨텍스트에 표시되는지 확인합니다. 로드 세트가 GolfCart와 같은 컨테이너를 지정하는 경우 유틸리티는 객체를 컨테이너 안에 배치합니다. 컨테이너를 지정하지 않으면 사이트 레벨에 표시됩니다.
• 작업 로그를 사용하여 어떤 로드 파일이 성공적으로 실행되었는지 확인합니다.
오류 처리
• 작업 로그에서 간결한 예외 사항을 검토합니다.
• 자세한 실패 이유는 메서드 서버 로그를 확인하십시오. 작업 모니터 정보 페이지의 첨부 파일 섹션에서 파일을 검토합니다.
• 메서드 서버 로그를 검색하여 특정 작업 실패를 찾습니다. 작업에 첨부된 메서드 서버 로그에서 실패 세부내용을 검토합니다.
문제 해결
• 잘못된 파일 형식 - 유효한 ZIP 또는 JAR을 선택하라는 메시지가 표시됩니다.
• 중복 데이터 - ID가 고유하지 않으면 로드가 실패합니다. 데이터를 조정하고 다시 시도하십시오.
• 액세스 권한 부족 - 사용자의 역할에 대상 사이트나 컨테이너에 대한 권한이 없으면 작업이 실패합니다. 권한을 조정하거나 충분한 권한이 있는 계정을 사용하십시오.
| | 전부 또는 전혀 없음 모드에서 로드 작업이 실패하면 시스템이 롤백을 수행하고 일반 오류 메시지를 표시합니다. 오류의 세부 원인은 작업 모니터 페이지의 첨부 파일 섹션에 있는 메서드 서버 로그에 캡처됩니다. 이 로그는 각 로드 파일의 실행 상태를 보여주며 올바른 파일이 처리되었는지 확인하는 데 도움이 됩니다. |