Sdílet prostřednictvím

Postup: definování profilu rozšíření UML

  • Článek

V Visual Studio Ultimate, můžete definovat profil UML a upravte prvky standardní model pro zvláštní účely.Profil definuje jednu nebo více Stereotypy UML.Stereotypu lze použít k označení typu jako představující určitého druhu objektu.Stereotypu, můžete také rozšířit seznam vlastností prvku.

Několik profilů, které jsou nainstalovány s Visual Studio Ultimate.Další informace o těchto profilů a nastavení Stereotypy, viz Přizpůsobení modelu pomocí profilů a stereotypů.

Můžete definovat své vlastní profily přizpůsobovat a rozšiřovat UML obchodní oblast nebo architektury.Příklad:

  • Pokud definujete často webových serverů, můžete definovat vlastní profil, který poskytuje «Webové stránky» stereotyp, který lze použít třídy v diagramy tříd.Diagramy tříd pak můžete použít k plánování webového serveru.Každé třídy «Webové stránky» by mít další vlastnosti pro obsah stránky, styl a tak dále.

  • Pokud vyvíjíte software bankovnictví, můžete definovat profil, který obsahuje stereotypem «Účet».Diagramy tříd pak můžete použít k definování různých typů účtů a vztahů mezi nimi.

Dodáváte-li vlastní profily vašeho týmu.Každý člen týmu můžete nainstalovat profil.Díky tomu mohou upravovat a vytvářet modely, které používají jeho stereotypy.

[!POZNÁMKA]

Pokud použijete Stereotypy profilu v modelu jsou úpravy a pak model sdílet s jinými uživateli, by měly stejný profil instalace na jejich vlastních počítačích.Jinak nebudou moci zobrazit Stereotypy, které jste použili.

Profil je často větší část Visual Studio rozšíření.Můžete například definovat příkazu, který převádí některé části modelu kódu.Můžete definovat profil, který uživatelé se musí vztahovat na balíčky, které si chce přeložit.Distribuujete by váš nový příkaz spolu s profilem v jediném Visual Studio rozšíření.

Můžete také definovat lokalizované varianty profilu.Načtení rozšíření uvidí varianty, která je vhodná pro vlastní jazykovou verzi.

Jak definovat profil

Chcete-li definovat profil UML

  1. Vytvořte nový XML soubor s příponou názvu souboru .profile.

  2. Přidání stereotypu definice podle pokynů popsaných v Strukturu profilu.

  3. Přidání profilu rozšíření aplikace Visual Studio (.vsix soubor).Můžete vytvořit novou příponu pro váš profil nebo profil přidat do existující příponu.

    Přečtěte si následující část jak přidat profil k rozšíření aplikace Visual Studio.

  4. Nainstalujte rozšíření ve vašem počítači.

    1. Poklepejte na příponu souboru, který má příponu názvu souboru .vsix.

    2. Restartujte aplikaci Visual Studio.

  5. Instalaci profilu ověřte.

    1. Vyberte model v Průzkumníku UML.

    2. V okně Vlastnosti klepněte profily vlastnost.Profil se objeví v nabídce.Nastavení zaškrtněte políčko vedle položky profilu.

    3. Vyberte element, jehož profil definuje stereotypy.V okně Vlastnosti klepněte Stereotypy vlastnost.V seznamu se zobrazí vaše stereotypy.Zaškrtněte políčko nastavte proti jedné stereotypy.

    4. Pokud váš profil definuje další vlastnosti tohoto stereotypu, rozbalte položku Vlastnosti stereotypu k jejich zobrazení.

  6. Rozšíření soubor odeslat ostatním uživatelům Visual Studio k instalaci do jejich počítačů.

Jak přidat profil rozšíření aplikace Visual Studio

Instalace profilu a umožňují odeslat jiným uživatelům, je nutné přidat profil k rozšíření aplikace Visual Studio.Další informace naleznete v tématu Nasazení Visual Studio Extensions.

Chcete-li definovat profil v nové rozšíření Visual Studia

  1. Vytvořte projekt Visual Studio Extension.

    [!POZNÁMKA]

    Je třeba nainstalovat Visual Studio SDK k provedení tohoto postupu.

    1. V nabídce File (Soubor) přejděte na příkaz New (Nový) a klepněte na příkaz Project (Projekt).

    2. V Nový projekt dialogovém okně vyberte v seznamu Nainstalované šablony, rozbalte položku Visual C#, klepněte na tlačítko rozšířenía potom klepněte na tlačítko Projekt VSIX.Nastavte na název projektu a klepněte na OK.

  2. Přidání profilu do projektu.

    • V okně Průzkumník řešení klikněte pravým tlačítkem projekt, přejděte na příkaz Přidata potom klepněte na tlačítko Existující položku.V dialogovém okně vyhledejte soubor profilu.

  3. Nastavení souboru profilu Kopírovat do výstupu vlastnost.

    1. V okně Průzkumník řešení klikněte pravým tlačítkem myši na soubor profilu a klepněte na tlačítko Vlastnosti.

    2. V okně Vlastnosti nastavte vlastnost Kopírovat do výstupního adresáře vlastnost Kopie vždy.

  4. V okně Průzkumník řešení otevřete source.extension.vsixmanifest.

    Soubor se otevře v editoru manifestu rozšíření.

  5. Na majetku stránky, přidejte řádek s popisem profilu:

    • Klikněte na tlačítko Nový.Nastavit pole Přidat nový majetek dialogovém okně následovně.

    • Set typu kMicrosoft.VisualStudio.UmlProfile

      To je jeden z rozevíracího seznamu možností.Tento název zadejte z klávesnice.

    • Klepněte na tlačítko souboru na filesystem a vyberte název souboru profilu, napříkladMyProfile.profile

  6. Projekt sestavte.

  7. Chcete-li ladit profil, stiskněte klávesu F5.

    Experimentální instanci aplikace Visual Studio otevře.V takovém případě otevřete projekt modelování.V Průzkumníku UML vyberte kořenový prvek modelu a v okně Vlastnosti, vyberte požadovaný profil.Pak vyberte prvky uvnitř modelu a nastavte Stereotypy, které jste definovali pro ně.

  8. Chcete-li extrahovat VSIX pro nasazení

    1. V programu Průzkumník Windows otevřete složku .\bin\Debug nebo .\bin\Release k nalezení .vsix souboru.Jedná se Visual Studio příponu souboru.Může být v počítači nainstalována a odeslat jiným uživatelům aplikace Visual Studio.

    2. Chcete-li nainstalovat rozšíření:

      1. Poklepejte .vsix souboru.Visual Studio Instalační služba rozšíření bude spuštěn.

      2. Restartujte všechny instance aplikace Visual Studio, které jsou spuštěny.

Následující alternativní postup lze použít pro malé rozšíření, pokud jste nenainstalovali Visual Studio SDK.

Chcete-li definovat rozšíření profilu bez použití Visual Studio SDK

  1. Vytvořte adresář systému Windows, který obsahuje následující tři soubory:

    • YourProfile.profile

    • extension.vsixmanifest

    • [Content_Types].xml-Zadejte tento název, jak je uvedeno hranatých závorkách

  2. Upravit [Content_Types].xml obsahuje následující text.Všimněte si, že obsahuje položku pro každou příponu názvu souboru.

    <?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. Zkopírujte existující extension.vsixmanifest a upravit pomocí editoru XML.Změnit ID, název a obsah uzlů.

    • Příklad můžete nalézt extension.vsixmanifest v tomto adresáři:

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

    • Obsahu uzel by měl být takto:

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

  4. Tři soubory zkomprimujte do souboru ZIP.

    V Průzkumníkovi Windows vyberte tři soubory, klepněte pravým tlačítkem myši, přejděte na příkaz Odeslata potom klepněte na tlačítko Komprimovaná složka (metoda ZIP).

  5. Přejmenujte soubor s příponou ZIP a změnit jeho příponu názvu souboru z .zip na .vsix.

  6. Chcete-li instalovat profil v libovolném počítači s odpovídající vydání sady Visual Studio, poklepejte .vsix souboru.

Chcete-li instalovat profil UML z rozšíření aplikace Visual Studio

  1. Poklepejte .vsix soubor v programu Průzkumník Windows nebo otevřít v aplikaci Visual Studio.

  2. Klepněte na tlačítko nainstalovat v dialogovém okně, které se zobrazí.

  3. Chcete-li odinstalovat nebo dočasně zakažte rozšíření, otevřete Extension Manager z Nástroje nabídky.

Jak definovat lokalizované profily

Můžete definovat různé profily pro různé jazykové verze nebo jazyky a je zabalit do stejné přípony.Když uživatel načte rozšíření, uvidí profil, který jste definovali pro jejich jazykovou verzi.

Vždy je nutné zadat výchozí profil.Pokud jste nedefinovali profil pro jazykovou verzi uživatele, zobrazí výchozí profil.

Chcete-li definovat lokalizované profilu

  1. Vytvoření profilu, jak je popsáno v předchozích částech jak definovat profil a jak přidat profil k rozšíření aplikace Visual Studio.To je výchozí profil a budou používány v každé zařízení, u kterého není poskytují lokalizované profilu.

  2. Přidáte nový adresář ve stejném adresáři jako soubor výchozí profil.

    [!POZNÁMKA]

    Pokud vytváříte příponu pomocí Visual Studio rozšíření projektu, přidejte novou složku do projektu pomocí Průzkumníku řešení.

  3. Změňte název nového adresáře na krátký kód ISO pro lokalizovanou jazykovou verzi, jako je například bg pro bulharštinu, nebo fr pro francouzštinu.Pokud použijete kód neutrální jazykové verze, obvykle dvě písmena, nikoli konkrétní jazykovou verzi, jako je například fr-CA.Další informace o kódech jazykovou verzi, naleznete v CultureInfo.GetCultures metoda, který obsahuje úplný seznam kódů jazykových verzí.

  4. Přidáte kopii výchozího profilu do nového adresáře.Neměňte název souboru.

    Vzorek Visual Studio rozšíření složky, než je sestavena nebo komprimovány do .vsix soubor, bude obsahovat následující složky a soubory:

    extension.vsixmanifest

    MyProfile.profile

    fr\MyProfile.profile

    de\MyProfile.profile

    [!POZNÁMKA]

    Neměli vložte do extension.vsixmanifest odkaz na lokalizovaných verzích profily.Zkopírovaný profil soubory musí mít stejný název jako profil v nadřazené složce.

  5. Upravte novou kopii profilu, překlad do jazyka cílového všechny části, které budou viditelné pro uživatele, jako je například displayName atributy.

  6. Můžete vytvořit další jazykovou verzi složky a lokalizované profily pro tolik kultury, jak chcete.

  7. Vytvoření rozšíření aplikace Visual Studio, vytváření rozšíření projektu nebo komprimovat všechny soubory, jak je popsáno v předchozích částech.

Struktura profilu

Soubor XSD profilů UML lze najít v následující ukázce: Nastavení Stereotypy a profily XSD.Můžete upravovat soubory profilů, nainstalovat .xsd v souboru:

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

Tato část profilu C# používá jako příklad.Definice kompletní profil můžete vidět v:

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

První části této cesty se mohou lišit v instalaci aplikace.

Další informace o profilu rozhraní .NET, naleznete v Standardní Stereotypy UML modely.

Dd465143.collapse_all(cs-cz,VS.110).gifHlavní části Definice profilů UML

Každý profil obsahuje následující obsah:

<?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>

[!POZNÁMKA]

Atribut nazvaný name nesmí obsahovat mezery či interpunkci.Atribut displayName, které se zobrazí v uživatelském rozhraní musí být platný řetězec XML.

Každý profil obsahuje tři hlavní části.V opačném pořadí jsou takto:

  • <propertyTypes>-seznam typů, které se používají pro vlastnosti definované v oddílu stereotypy.

  • <metaclasses>-seznam typů prvek modelu, ke kterým stereotypy v tomto profilu použít, například IClass, IInterface, IOperation, IDependency.

  • <stereotypes>-definice stereotypu.Každá definice obsahuje názvy a typy vlastností, které jsou přidány do cílového elementu modelu.

Dd465143.collapse_all(cs-cz,VS.110).gifTypy vlastností

<propertyTypes> Oddílu deklaruje seznamu typů, které se používají pro vlastnosti v <stereotypes> oddílu.Existují dva druhy typy vlastností: external a výčet.

Externí deklaruje plně kvalifikovaný název typu standard .NET:

<externalType name="System.String" />

Typ výčtu definuje sadu literálové hodnoty:

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

Dd465143.collapse_all(cs-cz,VS.110).gifMetaclasses

<metaclasses> Části je uveden seznam typů elementů modelu, ke kterým lze definovat stereotypy v tomto profilu:

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

Úplný seznam typů modelů pro element a vztahu, které lze použít jako metaclasses, viz Typy prvků modelu.

Dd465143.collapse_all(cs-cz,VS.110).gifDefinice stereotypu

<stereotypes> Část obsahuje jeden nebo více definic stereotyp:

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

Každý stereotyp uvádí jeden nebo více prvků nebo vztah typy modelů které mohou být použity.Můžete dát název základní typ, chcete-li zahrnout všechny jeho odvozených typů.Zadáte-li například Microsoft.VisualStudio.Uml.Classes.IType, stereotyp, mohou být použity pro IClass, IInterface, IEnumerationa několik dalších typů prvků.

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

name Atribut metaclassMoniker je odkaz na prvek <metaClasses> oddílu.

[!POZNÁMKA]

Zástupný název musí začínat /yourProfileName/, kde yourProfileName je definován v name atribut profilu ("CSharpProfile" v tomto příkladu).Zástupný název končí názvem jedné z položek v oddílu metaclasses.

Každý stereotyp může být uveden žádný nebo více vlastností, které přidá do jakéhokoli prvku modelu, na kterém je používána.<propertyType> Obsahuje odkaz na jeden z typů, které jsou definovány v <propertyTypes> oddílu.Odkaz musí být buď <externalTypeMoniker> odkazovat <externalType>, nebo <enumerationTypeMoniker> odkázat na <enumerationType>.Propojení znovu začíná název 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 prvků modelu

Nastavit typy, u nichž lze definovat Stereotypy je uveden v Typy prvků modelu.

Poradce při potížích

  • Moje Stereotypy nejsou zobrazeny mé modely UML.
    Je nutné vybrat profil v balíčku nebo model.Stereotypy se pak objeví na prvky uvnitř balíčku nebo model.Další informace naleznete v tématu Postupy: Přidávání stereotypů k elementům modelu.

  • Při otevření modelu UML, zobrazí se následující chybová zpráva:VS1707: The following profiles cannot be loaded because a serialization error occurred: MyProfile.profile

    1. Ověřte správnost základní syntaxi XML programy .profile.

    2. Ujistěte se, že každý zástupný název je v /profileName/nodeName formě.Název_profilu je hodnota atributu name v profilu kořenový uzel.Název_uzlu je hodnota atributu název metatřídy, externalType nebo enumerationType.

    3. Zajištění syntaxe je zde popsaným způsobem a jak je ukázáno v jednotky**:\Program Files\Microsoft Visual Studio 11.0\Common7\IDE\Extensions\Microsoft\Architecture Tools\UmlProfiles\**.

    4. Odinstalujte rozšíření vadný.V nabídce Nástroje klepněte na tlačítko Správce rozšíření.

      • Pokud se nezobrazí rozšíření, viz další položka.

    5. Znovu vytvořit soubor VSIX a otevřete jej v programu Průzkumník Windows ji znovu.Restartujte Visual Studio.

  • Rozšíření není zobrazeno ve Správci rozšíření, ale při pokusu nainstalovat, zobrazí se následující zpráva:The extension is already installed to all applicable products.

    1. Odebrání souborů rozšíření z podsložkou LocalAppData\Microsoft\VisualStudio\11.0\Extensions\

      • Chcete-li zobrazit LocalAppData, je nutné nastavit na kartě zobrazení možnosti složky Windows Explorer zobrazit skryté soubory a složky.

      • LocalAppData je obvykle umístěn v C:\Users\uživatelské jméno\AppData\Local\

    2. Restartujte Visual Studio.

Viz také

Úkoly

Postupy: Přidávání stereotypů k elementům modelu

Koncepty

Standardní Stereotypy UML modely

Další zdroje

Přizpůsobení modelu pomocí profilů a stereotypů

Vzorku: Prvky UML barva podle stereotypu

vzorku: nastavení Stereotypy profily XSD