C#에서 UML로 변환 구성

사용자가 예상하는 출력을 생성하기 위해 변환에서 사용되는 정보를 지정하려면, 구성 과정을 안내하는 새 변환 구성 마법사변환 구성 편집기를 사용하십시오.
이 태스크 정보

변환 구성의 파일 이름 확장자는 .tc이며 이 변환 구성에는 사용자가 예상하는 출력을 생성하기 위해 변환이 사용하는 정보가 들어 있습니다. 또한 변환 구성에는 특정 유형의 변환에 대한 특정 정보도 들어 있습니다. 기존의 변환 구성을 편집하려면, 작업공간 자원을 표시하는 보기에서 변환 구성 편집기를 여는 변환 구성 파일을 두 번 클릭하십시오.

변환 구성 파일에 대한 작업을 단순화하려면 변환할 요소를 포함하는 프로젝트에서 구성 파일을 저장하십시오.

C#에서 UML로 변환을 구성하려면 다음을 수행하십시오.

  1. 파일 > 새로 작성 > 기타 > 변환 > 변환 구성을 클릭하십시오.
  2. 구성의 세부사항을 지정하십시오. 새 변환 구성 마법사구성 이름 및 변환 지정 페이지에서 다음 단계를 완료하십시오.
    1. 이름 필드에서 구성의 이름을 지정하십시오.
    2. 구성 파일 대상 필드에서 변환 구성 파일의 대상을 지정하십시오. 대상은 현재 작업공간에서 상대 경로입니다. 완전한 프로젝트 이름이나 폴더 이름을 지정할 수 있습니다. 프로젝트에서 폴더를 지정하는 경우 폴더 이름 앞에 슬래시(/) 접두부를 붙여야 합니다.
    3. 변환 목록에서 변환을 선택하십시오.
      주: 설치되어 있지만 사용하도록 설정되지 않은 변환을 표시하려면 모든 변환 표시를 클릭하십시오. 이 목록에 표시되려면 변환이 기능에 바인딩되어야 합니다.
  3. 프로토콜 섹션에서 모델링 프로토콜을 지정하십시오. 이 프로토콜은 DCMP(Design Contract Management Protocol)라고도 합니다. 사용자가 선택하는 값에 따라 변환의 소스 및 대상의 동기화 여부를 판별할 수 있습니다.
    • 소스 모델이 1차 엔지니어링 아티팩트인 경우 개념적을 선택하십시오. 소스 모델의 변경사항이 대상 모델에 전달됩니다.
    • 소스 아티팩트가 표시하는 아키텍처가 대상과 독립적으로 진전되는 경우 조정됨을 선택하십시오. 이 옵션을 선택하면 소스 및 대상을 비교하고 변경사항을 조정하는 데 사용할 수 있는 역변환을 사용할 수 있습니다. 다른 팀이 아키텍처를 구현, 개발 또는 유지보수하는 경우에도 이 옵션을 선택할 수 있습니다.
      주: 이 옵션을 선택할 때 기본 페이지의 "역변환" 섹션에서 추가 특성을 사용할 수 있게 됩니다. 일부 변환의 경우 변환 구성 편집기에서 추가 페이지를 사용할 수 있게 됩니다. 역변환 구성에 대한 정보는 아래에서 관련 링크를 참조하십시오.
  4. 다음을 클릭하십시오.
  5. 변환의 소스 및 대상 요소를 지정하십시오. 올바른 소스 및 대상 요소의 목록은 해당 변환에 대한 관련 개념 주제를 참조하십시오. 소스 및 대상 페이지에서 다음 단계를 완료하십시오.
    1. 선택된 소스 분할창에서 변환할 변환의 소스 요소를 선택하십시오.
    2. 선택된 대상 분할창에서 변환 출력의 대상을 선택하십시오. 출력의 새 대상을 작성하려면 대상 컨테이너 작성을 클릭하십시오.
  6. 완료를 클릭하십시오. 변환 구성 편집기가 열리고 구성의 컨텐츠가 표시됩니다.
  7. 옵션: 변환 구성에 대한 문서를 지정하십시오. 이 필드는 여러 사용자가 공유하는 구성에 대한 정보를 통신하는 데 유용합니다. 기본 페이지의 문서 필드에서 변환 구성에 대한 추가 정보를 지정하십시오.
  8. 옵션: 소스 프로젝트의 각 UML 콜렉션 유형에 대해 변환이 생성하는 C# 콜렉션 유형을 지정하려면 콜렉션 탭을 클릭하십시오. 콜렉션은 모델 요소의 그룹을 표시합니다. 사용자가 선택하는 C# 콜렉션 유형에 따라 콜렉션에 중복 모델 요소가 존재할 수 있는지 또는 모델 요소가 순서대로 정렬되는지 여부가 판별됩니다. UML 콜렉션 유형은 모델 요소의 isOrdered 및 isUnique 특성으로 판별됩니다.
  9. C# 소스 코드가 모델로 변환되는 방법을 구성하려면 C#에서 UML로 변환 추가 옵션 탭을 클릭한 후 다음 옵션 중에서 선택하십시오.
    • 코드에 있는 getter 또는 setter 메소드마다 대상 모델에서 UML 오퍼레이션을 생성하려면 C# getter/setter 메소드마다 UML 오퍼레이션 생성을 선택하십시오.
    • C#에서 UML로 변환을 실행한 후 대상 모델과 맵핑 모델(UML에서 C#으로 변환 구성을 통해 지정한 경우)을 자동으로 저장하려면 C#에서 UML로 변환 실행 후 모델 자동 저장을 선택하십시오.
    • C# 클래스를 표시하는 모든 UML 클래스에서 어셈블리 클래스 System.Object로의 일반화 관계를 생성하려면 System.Object에 대한 일반화 작성을 선택하십시오.
  10. 옵션: 사용자가 구성하는 변환이 맵핑을 지원하는 경우 맵핑 모델을 작성하여 변환이 생성하는 아티팩트에 대한 대체 이름을 지정할 수 있습니다. 기존 또는 새 맵핑 모델을 사용하려면 다음 단계를 완료하십시오.
    1. 변환 구성 편집기맵핑 페이지에서 이 구성에 맵핑 기능 사용 선택란을 선택하십시오.
    2. 모델 파일 이름 맵핑 필드에서 기존 또는 새 맵핑 모델의 이름을 지정하십시오.
  11. 옵션: 디버깅 정보를 생성하려면 기본 페이지에서 디버그 로그 생성 선택란을 선택하십시오. 다음에 변환을 실행할 때 변환 환경 설정에서 지정하는 폴더에 XML 파일로 로그 파일이 생성됩니다. 로그 파일에 대한 위치를 지정하지 않으면 변환은 사용자 작업공간의 .metadata 폴더에 로그 파일을 생성합니다.
    팁: 변환에 대한 환경 설정을 하려면 > 환경 설정을 클릭한 다음 모델링을 펼치고 변환을 클릭하십시오.

    로그 파일은 소스 요소, 대상 요소, 그리고 변환이 소스 요소를 변환하기 위해 적용하는 규칙에 대한 정보를 제공합니다. 변환이 많은 요소를 변환하는 경우 변환이 로그 파일을 생성하는 동안 성능이 저하될 수 있으므로 디버깅 목적으로만 로그 파일을 생성해야 합니다.

  12. 옵션: 변환이 실행되는 동안 새 대화 상자가 열리지 않도록 하려면 기본 페이지에서 순방향 변환 자동 실행 선택란을 선택하십시오.

    변환을 자동 모드에서 실행하면 변환에서 생성되는 모든 대화 상자가 억제됩니다. 변환은 기본 규칙 및 동작을 적용하며 예상하지 못했거나 올바르지 않은 변환 출력이 생성될 수 있습니다. 변환 출력의 유효성을 검증하는 대신 변환 실행의 유효성을 검증해야 할 경우에만 변환을 자동 모드에서 실행해야 합니다. 예를 들어, 자동화된 타스크나 자동화된 테스트 스위트의 일부로 자동 모드에서 변환을 실행할 수 있습니다.

    변환이 자동 모드에서 실행되도록 설정하면 사용자가 지정하는 파일 겹쳐쓰기 옵션이 대체되고 필요에 따라 파일 위에 겹쳐씁니다.

    UML에서 C#으로 변환이 사용 가능한 경우 자동으로 역변환 실행 선택란을 선택할 수 있습니다. UML에서 C#으로 변환 또는 역변환이 자동 모드에서 실행되도록 지정하면 병합 편집기가 억제됩니다. 병합 중에 충돌이 발생하는 경우 변환이 중지되므로 사용자는 자동 옵션을 지운 상태에서 변환을 재실행해야 합니다.

  13. 옵션: 변환 소스 및 대상 사이의 추적 가능 관계를 작성하려면 기본 페이지에서 추적 관계 작성 선택란을 선택하십시오. 이 선택란은 혼합 모델링 or 조정된 모델링 프로토콜을 선택하는 경우에만 사용할 수 있습니다.

    추적 관계와 시각적 개발 도구를 사용하여 소스 모델 요소 및 변환 출력 사이의 관계를 이해할 수 있습니다. 이 기능은 여러 개의 모델과 변환 구성을 포함할 수 있는 대형 프로젝트에서 유용합니다. 변환에서는 소스 모델이 변경되지 않습니다.

  14. 옵션: 변환이 실행될 때 발생한 오류를 표시하려면 기본 페이지에서 변환 완료 시 보고서 대화 상자 열기 선택란을 선택하십시오. 이 선택란을 선택하면 생성된 오류만 표시됩니다. > 보기 표시 > 오류 로그를 클릭하면 사용자가 볼 수 있는 오류 로그에도 동일한 정보가 기록됩니다.

    변환이 실행될 때 발생한 경고를 표시하려면 보고서 대화 상자에 경고 표시 선택란을 선택하십시오.

  15. 옵션: C# 요소와 대상 UML 요소 사이의 연관을 정의하는 파일을 작성하십시오. 이 기능은 범위가 구성하는 변환을 벗어나고 다른 프로젝트에 위치해 있을 수 있는 C# 및 UML 요소 사이의 관계 정의에 유용합니다. 연관 파일을 작성하려면 C# 대 UML 연관 페이지에서 다음 단계 중 하나를 완료하십시오.
    • 새로 작성을 클릭하고 파일의 이름과 위치를 지정하십시오.
    • 기존의 연관 파일을 사용하려면 파일을 찾아보고 선택하십시오.
    • 연관 추가를 클릭한 후 왼쪽 분할창에서 임의를 선택하고 오른쪽 분할창에서 모델 요소를 선택하십시오. 두 항목 모두 소스 대 모델 연관 테이블에 표시됩니다.
  16. 파일 > 저장을 클릭하십시오.
결과
이 옵션은 다음에 변환을 실행할 때 적용됩니다.

피드백