KB: 기존 관리형 컴포넌트를 새 컴포넌트 유형 및 템플릿으로 업데이트

솔루션 세부 정보

기존 컴포넌트에 새로운 구조 적용

조직에서 샘플 컴포넌트 유형과 템플릿을 사용자 지정 구성으로 대체하면 기존 관리형 컴포넌트를 업데이트해야 할 수 있습니다. 이 경우 컴포넌트를 새로운 컴포넌트 유형, 템플릿 및 폴더 구조로 마이그레이션해야 합니다. 컴포넌트 구조를 재편할 때는 다양한 요구 사항과 초기 상태를 고려하는 것이 중요합니다. 따라서 엄격한 단계별 절차가 항상 적합한 것은 아닙니다.

컴포넌트 유형으로 구성 체계 및 템플릿 관리

컴포넌트 유형은 일반적으로 컴포넌트 템플릿 및 기본 폴더 구조와 연결됩니다. 컴포넌트 템플릿은 파라미터 세트, 파라미터 표시 여부, 기본값 및 필수 파라미터 설정을 정의합니다. 컴포넌트 유형을 업데이트할 때는 워크스페이스 전체의 일관성을 유지하기 위해 연결된 템플릿과 폴더 구조도 업데이트해야 하는 경우가 많습니다.

컴포넌트 구조 재편 방법

• 샘플 데이터 없이 새 워크스페이스를 활성화하고 사용자 지정 컴포넌트 유형, 템플릿 및 폴더 구조를 생성합니다. 현재 워크스페이스에 이미 실제 프로젝트 데이터를 생성했다면 이 방법은 사용할 수 없습니다.
   
• 컴포넌트를 생성하기 전에 기존 컴포넌트 템플릿과 유형을 업데이트합니다. 
  
• 새 컴포넌트 유형, 템플릿 및 폴더 구조를 생성한 다음, 일괄 편집을 사용하여 기존 컴포넌트를 새 구성으로 업데이트합니다.

일괄 편집을 사용한 컴포넌트 업데이트

1. 새 컴포넌트 유형, 템플릿 및 폴더 구조를 생성합니다.
   
2. 기존 템플릿과 새 템플릿을 검토하여 파라미터의 일관성을 확인합니다. 파라미터 이름과 유형을 일치시키면 파라미터 중복을 방지하고 마이그레이션 후 정리 작업을 줄일 수 있습니다. 파라미터를 추가해도 되지만, 주요 파라미터는 가능한 한 일관되게 유지해야 합니다. 새 템플릿 파라미터를 만들 때는 해당 데이터를 수동으로 입력할 예정인 경우가 아니라면 필수로 지정하지 마세요. 
    
3. 대규모 컴포넌트 라이브러리를 업데이트하기 전에 소규모 테스트 컴포넌트 묶음으로 프로세스를 검증합니다.
4. Explorer에서 기존 컴포넌트를 이전 폴더 구조에서 새 폴더 구조로 이동합니다.
    
5. 마이그레이션한 컴포넌트를 일괄 편집 모드로 엽니다
   
6. Models and Parameters 섹션에서 Add을 클릭하고 Template: None을 선택합니다. 그러면 기존 템플릿 파라미터가 사용자 파라미터로 변환됩니다.
    
7. Add을 다시 클릭하고 새 컴포넌트 템플릿을 선택합니다
8. 메시지가 표시되면 선택한 모든 컴포넌트의 컴포넌트 유형 업데이트를 확인합니다. 새 템플릿은 사용자 파라미터를 템플릿 파라미터 이름으로 대체하고 새로 정의된 파라미터를 추가합니다.
    
9. Draft 수명 주기 상태의 컴포넌트부터 시작하여 일괄 업데이트를 수행한 다음, 다른 수명 주기 상태의 컴포넌트를 업데이트합니다.
10. 일괄 편집기를 통해 컴포넌트 릴리스 작업을 수행할 때 수명 주기 상태가 유지되는지 확인합니다.
11. 마이그레이션한 컴포넌트를 성공적으로 검증한 후에는 혼동을 방지하기 위해 더 이상 사용하지 않는 컴포넌트 유형, 템플릿 및 관련 항목을 제거합니다.

추가 참고 사항

• 컴포넌트 이동과 수명 주기 상태 관리는 점진적으로 수행할 수 있습니다.
• 기존 템플릿과 새 템플릿 간에 파라미터가 일치하지 않으면 일괄 편집 도구를 사용하여 수동으로 정리해야 할 수 있습니다. 링크

참고 자료

• 컴포넌트 일괄 편집
• 컴포넌트 템플릿
• 컴포넌트 유형