Udostępnij za pośrednictwem

Jak: Definiowanie profilu, aby rozszerzyć UML

  • Artykuł

W Visual Studio Ultimate, można zdefiniować profilu UML do dostosowywania standardowe elementy dla określonych celów.Profil definiuje jeden lub więcej Stereotypy UML.Stereotypu może służyć do oznaczenia typu, reprezentujących obiektów określonego typu.Stereotyp można rozszerzać elementu listy właściwości.

Instalowanych jest kilka profili Visual Studio Ultimate.Aby uzyskać więcej informacji na temat tych profilów i sposobu stosowania Stereotypy, zobacz Dopasowanie modelu z profilami i stereotypami.

Można zdefiniować własne profile adaptowanie i rozszerzanie UML do własnych obszar działalności lub architektury.Na przykład:

  • Jeśli często zdefiniować witryn sieci Web, można zdefiniować własny profil, który zapewnia stereotyp określenie «strony sieci Web», które mogą być stosowane do klas w diagramy klas.Diagramy klas można używać do planowania witryny sieci Web.Każda klasa określenie «strony sieci Web» miałoby dodatkowe właściwości dla zawartości strony, stylu i tak dalej.

  • Jeśli wystąpią oprogramowania usług bankowych, można zdefiniować profil, który zapewnia stereotypem «Konto».Diagramy klas można używać do definiowania różnych typów kont i pokazanie relacji między nimi.

Do zespołu można dystrybuować własne profile.Każdy członek zespołu może zainstalować profil.Umożliwia im do edytowania i tworzenia modeli, które używają jej stereotypów.

[!UWAGA]

Jeżeli zastosujesz Stereotypy profilu w modelu, edycji, a następnie udostępnić innym użytkownikom modelu powinny instalacji tego samego profilu na ich komputerach.W przeciwnym razie nie będą mogli zobaczyć Stereotypy, które były używane.

Profil, który często jest częścią większego Visual Studio rozszerzenia.Na przykład można zdefiniować polecenia, który tłumaczy niektóre części modelu do kodu.Można zdefiniować profil, który użytkownicy muszą stosować pakietów, które chcą tłumaczenie.Będzie dystrybuować swoje nowe polecenie, łącznie z profilu w jednym Visual Studio rozszerzenia.

Można także zdefiniować zlokalizowane warianty profilu.Użytkownicy ładowania Twojego rozszerzenia Zobacz wariant, który należy do własnej kultury.

Jak określić profil

Do definiowania profilu UML

  1. Utwórz nowy plik XML z rozszerzeniem nazwy pliku .profile.

  2. Dodawanie definicji stereotypu zgodnie z wytycznymi, opisane w Struktury profilu.

  3. Dodawanie profilu do rozszerzenie Visual Studio (.vsix pliku).Można utworzyć nowe rozszerzenie dla profilu lub dodać profil do istniejące rozszerzenie.

    W następnej sekcji, jak dodać profil, który ma rozszerzenie Visual Studio.

  4. Na komputerze, należy zainstalować rozszerzenie.

    1. Kliknij dwukrotnie plik rozszerzenia, który ma rozszerzenie nazwy pliku .vsix.

    2. Uruchom ponownie program Visual Studio.

  5. Sprawdź, czy profil został zainstalowany.

    1. Wybierz model, w Eksploratorze UML.

    2. W oknie dialogowym właściwości kliknij przycisk Profile właściwość.W menu pojawi się Twój profil.Ustaw znacznik wyboru obok profilu.

    3. Zaznacz element, dla którego profilu definiuje stereotypów.W oknie dialogowym właściwości kliknij przycisk Stereotypy właściwość.Twój Stereotypy pojawi się na liście.Ustaw znacznik wyboru przeciwko jednemu stereotypy.

    4. Jeśli Twój profil definiuje dodatkowe właściwości dla tego stereotypu, należy rozwinąć właściwości stereotypu je zobaczyć.

  6. Wyślij plik rozszerzenia do innych użytkowników Visual Studio do zainstalowania na swoich komputerach.

Jak dodać profil do rozszerzenie programu Visual Studio

Aby zainstalować profil, a także aby możliwe było wysłać do innych użytkowników, należy dodać profil na rozszerzenie programu Visual Studio.Aby uzyskać więcej informacji, zobacz Wdrażanie rozszerzeń programu Visual Studio.

Aby zdefiniować profil w nowe rozszerzenie programu Visual Studio

  1. Tworzenie projektu programu Visual Studio rozszerzenie.

    [!UWAGA]

    Należy zainstalować Visual Studio SDK Aby użyć tej procedury.

    1. W menu Plik, wskaż Nowy i kliknij przycisk Projekt.

    2. W Nowy projekt dialogowe, pod Szablonów, rozwiń Visual C#, kliknij przycisk rozszerzalności, a następnie kliknij przycisk projektu VSIX.Ustaw nazwę projektu i kliknij przycisk OK.

  2. Dodaj swój profil do projektu.

    • W oknie Solution Explorer, kliknij prawym przyciskiem myszy projekt, wskaż polecenie Dodaj, a następnie kliknij przycisk Istniejącego elementu.W oknie dialogowym Zlokalizuj plik profilu.

  3. Ustaw plik profilu Kopiuj, aby dane wyjściowe właściwość.

    1. W oknie Solution Explorer, kliknij prawym przyciskiem myszy plik profilu, a następnie kliknij przycisk Właściwości.

    2. W oknie dialogowym właściwości zestaw Kopiuj do katalogu wyjściowego właściwość, aby Zawsze Kopiuj.

  4. W oknie Solution Explorer Otwórz source.extension.vsixmanifest.

    Plik zostanie otwarty w edytorze manifestu rozszerzenie.

  5. Na aktywów strony, aby dodać wiersz opisu profilu:

    • Kliknij przycisk Nowy.Ustaw pola Dodać nowego środka okno dialogowe, w następujący sposób.

    • Ustaw typu doMicrosoft.VisualStudio.UmlProfile

      Nie jest jedną z opcji menu rozwijanego.Nazwa ta może być wprowadzona przy użyciu klawiatury.

    • Kliknij przycisk plik na system plików i wybierz nazwę pliku profilu, na przykładMyProfile.profile

  6. Skompiluj projekt.

  7. Aby debugować profilu, naciśnij klawisz F5.

    Otwiera doświadczalnych wystąpienie programu Visual Studio.W tym wypadku Otwórz projekt modelowania.W Eksploratorze UML wybierz element główny, modelu i w oknie dialogowym właściwości, wybierz swój profil.Następnie wybierz elementy wewnątrz modelu i ustaw Stereotypy, które zostały określone dla nich.

  8. Aby wyodrębnić VSIX dla wdrażania

    1. W Eksploratorze Windows otwórz folder .\bin\Debug lub .\bin\Release Aby znaleźć .vsix pliku.Jest to Visual Studio pliku rozszerzenia.Może być zainstalowana na komputerze i wysyłane do innych użytkowników programu Visual Studio.

    2. Aby zainstalować rozszerzenia:

      1. Kliknij dwukrotnie .vsix pliku.Zostanie uruchomiony Instalator rozszerzenia programu Visual Studio.

      2. Ponownie uruchomić wszystkie wystąpienia programu Visual Studio, które są uruchomione.

Poniższej procedury alternatywne może służyć do rozszerzenia małych, jeśli nie zainstalowano Visual Studio SDK.

Aby zdefiniować rozszerzenie profilu bez korzystania z programu Visual Studio SDK

  1. Utwórz katalog systemu Windows, który zawiera trzy następujące pliki:

    • YourProfile.profile

    • extension.vsixmanifest

    • [Content_Types].xml-wpisz tę nazwę, jak pokazano poniżej, w nawiasy kwadratowe

  2. Edytowanie [Content_Types].xml zawiera następujący tekst.Należy zauważyć, że zawiera wpis dla każdego rozszerzenia nazwy pliku.

    <?xml version="1.0" encoding="utf-8"?>
<Types xmlns="https://schemas.openxmlformats.org/package/2006/content-types">
  <Default Extension="profile" ContentType="application/octet-stream" />
  <Default Extension="vsixmanifest" ContentType="text/xml" />
</Types>

  3. Kopiowanie istniejącego extension.vsixmanifest i edytować za pomocą edytora XML.Zmienia identyfikator, nazwę oraz zawartości węzłów.

    • Przykład można znaleźć extension.vsixmanifest w tym katalogu:

      dysk**:\Program Files\Microsoft Visual Studio 11.0\Common7\IDE\Extensions\Microsoft\Architecture Tools\UmlProfiles**

    • Węzeł zawartości powinny być w następujący sposób:

      <Content>
  <CustomExtension Type="Microsoft.VisualStudio.UmlProfile"
  >YourProfile.Profile</CustomExtension>
</Content>

  4. Skompresować trzy pliki w pliku zip.

    W Eksploratorze Windows, wybierz trzy pliki, kliknij prawym przyciskiem myszy, wskaż polecenie Wyślij do, a następnie kliknij przycisk (zip) folderu skompresowanego.

  5. Zmień nazwę spakowany plik i zmień rozszerzenie nazwy pliku z .zip do .vsix.

  6. Aby zainstalować profil na dowolnym komputerze ze odpowiednie wersje programu Visual Studio, kliknij dwukrotnie .vsix pliku.

Aby zainstalować profil UML z programu Visual Studio rozszerzenie

  1. Kliknij dwukrotnie .vsix plik w Eksploratorze Windows, czy otworzyć go w programie Visual Studio.

  2. Kliknij przycisk zainstalować pojawi się okno dialogowe.

  3. Aby odinstalować lub tymczasowo wyłączyć rozszerzenia, otwórz Extension Manager z Narzędzia menu.

Jak definiować zlokalizowane profilów

Można zdefiniować różne profile dla różnych kultur lub językach i pakietu ich wszystkich w tym samym rozszerzenie.Gdy użytkownik wczytuje Twojego rozszerzenia, będą widzieć profilu, który został zdefiniowany dla ich kultury.

Należy zawsze podać profil domyślny.Jeżeli nie zdefiniowano profil dla kultury użytkownika, będą widzieć profil domyślny.

Do definiowania profilu zlokalizowane

  1. Utwórz profil, jak opisano w poprzednich sekcjach sposobów definiowania profilu i jak dodać profil, który ma rozszerzenie Visual Studio.To jest domyślny profil i będą używane w dowolnej instalacji, dla którego nie wprowadzono profilu zlokalizowane.

  2. W tym samym katalogu co plik profilu domyślnego, należy dodać nowy katalog.

    [!UWAGA]

    Jeśli tworzysz rozszerzenie korzystając z projektu programu Visual Studio rozszerzenie, należy użyć Solution Explorer dodać nowy folder do projektu.

  3. Zmień nazwę nowego katalogu na krótki kod ISO dla kultury zlokalizowane, takich jak bg dla języka bułgarskiego, lub fr francuski.Należy używać kodu kultury neutralnej, zazwyczaj dwie litery, nie określonej kultury takich jak fr-CA.Aby uzyskać więcej informacji na temat kodów kultury, zobacz Metoda CultureInfo.GetCultures, który zapewnia pełną listę kodów kultury.

  4. Dodanie kopii profilu domyślnego do nowego katalogu.Nie należy zmieniać nazwy pliku.

    Próbkę Visual Studio folder rozszerzenia, zanim zostanie zbudowany lub skompresowane w .vsix plik, będzie zawierać następujące foldery i pliki:

    extension.vsixmanifest

    MyProfile.profile

    fr\MyProfile.profile

    de\MyProfile.profile

    [!UWAGA]

    Nie należy wstawić do extension.vsixmanifest odwołanie do zlokalizowanych wersjach profile.Pliki skopiowanego profilu musi mieć taką samą nazwę jak profil w folderze nadrzędnym.

  5. Edytuj tę nową kopię profilu, co przekłada się na język docelowy wszystkich części, które będą widoczne dla użytkownika, takich jak displayName atrybuty.

  6. Można utworzyć foldery dodatkowe kultury i zlokalizowane profilów dla tylu kultur, jak chcesz.

  7. Stworzenie rozszerzenia programu Visual Studio, przez budowanie projektu rozszerzenie lub kompresowanie plików, jak opisano w poprzednich sekcjach.

Struktura profilu

Plik XSD dla profilów UML można znaleźć w następującym przykładzie: Ustawienie stereotypów i XSD profile.Aby edytować pliki profilu, należy zainstalować .xsd plik:

%ProgramFiles%\Microsoft Visual Studio 11.0\Xml\Schemas

Ta sekcja używa profilu C# jako przykład.Definicja kompletny profil można zobaczyć w:

dysk**:\Program Files\Microsoft Visual Studio 11.0\Common7\IDE\Extensions\Microsoft\Architecture Tools\UmlProfiles\CSharp.profile**

Pierwszej części tej ścieżki mogą różnić się do instalacji.

Aby uzyskać więcej informacji o profilu .NET, zobacz Standard stereotypy dla modeli UML.

Dd465143.collapse_all(pl-pl,VS.110).gifGłównych sekcji definicji profilu UML

Każdy profil zawiera następującej treści:

<?xml version="1.0" encoding="utf-8"?>
<profile dslVersion="1.0.0.0" 
       name="CSharpProfile" displayName="C# Profile" 
       xmlns="https://schemas.microsoft.com/UML2.1.2/ProfileDefinition">
  <stereotypes>...</stereotypes>
  <metaclasses>...</metaclasses>
  <propertyTypes>...</propertyTypes>
</profile>

[!UWAGA]

Atrybut o nazwie name nie może zawierać spacji ani znaków przestankowych.Atrybut displayName, który pojawia się w interfejsie użytkownika powinny być prawidłowy ciąg XML.

Każdy profil zawiera trzy główne sekcje.W odwrotnej kolejności są one następujące:

  • <propertyTypes>-Lista typów, które są używane dla właściwości, które zdefiniowano w sekcji stereotypy.

  • <metaclasses>-Lista typów elementu modelu, do których stereotypy w tym profilu stosuje takie jak IClass, IInterface, IOperation, IDependency.

  • <stereotypes>-definicji stereotypu.Każda definicja zawiera nazwy i typy właściwości, które są dodawane do elementu modelu docelowego.

Dd465143.collapse_all(pl-pl,VS.110).gifTypy właściwości

<propertyTypes> Sekcji deklaruje listę typów, które są używane do właściwości w <stereotypes> sekcji.Istnieją dwa rodzaje typy właściwości: zewnętrzne i wyliczenie.

Typ zewnętrznej oświadcza, że w pełni kwalifikowanej nazwy standardowy typ .NET:

<externalType name="System.String" />

Typ wyliczenia definiuje zestaw wartości literałów:

    <enumerationType name="PackageVisibility">
      <enumerationLiterals>
        <enumerationLiteral name="internal" displayName="internal"  />
        <enumerationLiteral name="protectedinternal" displayName="protected internal" />
      </enumerationLiterals>
    </enumerationType>

Dd465143.collapse_all(pl-pl,VS.110).gifWiemy

<metaclasses> Sekcji znajduje się lista typów elementu modelu, do których można zdefiniować stereotypy w tym profilu:

<metaclass 
      name="Microsoft.VisualStudio.Uml.Classes.IClass" />
<metaclass
      name="Microsoft.VisualStudio.Uml.Classes.IInterface" />
<metaclass
      name="Microsoft.VisualStudio.Uml.Components.IComponent" />

Aby uzyskać pełną listę typów element i relacji modelu, które służą jako wiemy, zobacz Typy elementów modelu.

Dd465143.collapse_all(pl-pl,VS.110).gifDefinicji stereotypu

<stereotypes> Sekcji zawiera jeden lub więcej definicji stereotypu:

    <stereotype name="CSharpClass" displayName="C# Class"> ...

Każdy stereotyp zawiera listę przynajmniej jeden element lub relacji typów modeli do których mogą być stosowane.Można podać nazwę typu podstawowego, aby uwzględnić wszystkie jego typy pochodne.Na przykład, jeśli określisz Microsoft.VisualStudio.Uml.Classes.IType, stereotyp, mogą być stosowane do IClass, IInterface, IEnumerationi kilka innych rodzajów element.

      <metaclasses>
        <metaclassMoniker name=
         "/CSharpProfile/Microsoft.VisualStudio.Uml.Classes.IClass" />
      </metaclasses>

name Atrybut metaclassMoniker jest łącze do elementu w <metaClasses> sekcji.

[!UWAGA]

Nazwa moniker musi zaczynać się /yourProfileName/, gdzie yourProfileName jest zdefiniowany w name atrybut profilu ("CSharpProfile" w tym przykładzie).Moniker kończy się nazwą jednego z wpisów w sekcji wiemy.

Każdy stereotyp można wyświetlić listę zero lub więcej właściwości, które dodaje do dowolnego elementu modelu, do którego ją zastosowano.<propertyType> Zawiera łącze do jednego z typów, które są zdefiniowane w <propertyTypes> sekcji.Łącze musi być albo <externalTypeMoniker> do odwoływania się do <externalType>, lub <enumerationTypeMoniker> do odwoływania się do <enumerationType>.Ponownie łącze zaczyna się nazwę profilu.

      <properties>
        <property name="IsStatic" 
                displayName="Is Static" defaultValue="false">
          <propertyType>
    <externalTypeMoniker 
                   name="/CSharpProfile/System.Boolean" />
          </propertyType>
        </property>
        <property name="PackageVisibility" 
                  displayName="Package Visibility"
                  defaultValue="internal">
          <propertyType>
            <enumerationTypeMoniker 
                  name="/CSharpProfile/PackageVisibility"/>
          </propertyType>
        </property>
      </properties>
    </stereotype>

Typy elementów modelu

Zestaw typów, dla których można zdefiniować Stereotypy znajduje się w Typy elementów modelu.

Rozwiązywanie problemów

  • Moje Stereotypy nie są wyświetlane moje modele UML.
    Musisz wybrać swój profil w paczce lub modelu.Stereotypy pojawi się na elementy wewnątrz pakietu lub modelu.Aby uzyskać więcej informacji, zobacz Porady: dodawanie stereotypów do elementów modelu.

  • Gdy otwieram modelu UML, pojawia się następujący błąd:VS1707: The following profiles cannot be loaded because a serialization error occurred: MyProfile.profile

    1. Sprawdź poprawność podstawowej składni XML .profile.

    2. Upewnij się, że każda nazwa Moniker jest w /profileName/nodeName formularza.Nazwa_profilu jest wartością atrybutu name w węźle głównym profilu.NazwaWęzła jest wartością atrybutu nazwy Metaklasa, externalType lub enumerationType.

    3. Upewnij się, składnia jest zgodnie z instrukcją i, jak pokazano w dysk**:\Program Files\Microsoft Visual Studio 11.0\Common7\IDE\Extensions\Microsoft\Architecture Tools\UmlProfiles\**.

    4. Odinstalować rozszerzenie wadliwy.W menu Narzędzia kliknij Menedżer rozszerzeń.

      • Jeśli nie ma rozszerzenia, zobacz następną sekcję.

    5. Rekonstruowanie pliku VSIX i otworzyć go w Eksploratorze Windows, aby zainstalować go ponownie.Uruchom ponownie program Visual Studio.

  • Rozszerzenie jest niewidoczny w Menedżerze rozszerzeń, ale gdy próbujesz zainstalować go ponownie, zostanie wyświetlony następujący komunikat:The extension is already installed to all applicable products.

    1. Usuń rozszerzenie pliku z podfolderem LocalAppData\Microsoft\VisualStudio\11.0\Extensions\

      • Aby zobaczyć LocalAppData, należy ustawić Pokaż ukryte pliki i foldery na karcie Widok Opcje folderów Eksploratora Windows.

      • LocalAppData jest zazwyczaj w C:\Users\Nazwa użytkownika\AppData\Local\

    2. Uruchom ponownie program Visual Studio.

Zobacz też

Zadania

Porady: dodawanie stereotypów do elementów modelu

Koncepcje

Standard stereotypy dla modeli UML

Inne zasoby

Dopasowanie modelu z profilami i stereotypami

Próbki: Elementów UML kolorów przez stereotyp

próbki: ustawienie Stereotypy, profile XSD