UML Genişletmek için Profil Nasıl Tanımlanır
Visual Studio Ultimate'da belirli amaçlar için standart model öğelerini özelleştirmek amacıyla UML profil tanımlayabilirsiniz. Profil birkaç UML stereotip tanımlar. Stereotip, öğenin özellikler listesini genişletmek için kullanılabilir.
Birkaç profil Visual Studio Ultimate ile yüklenir. Bu profiller ve stereotiplerin nasıl uygulandığı hakkında daha fazla bilgi için bkz. Modelinizi Profiller ve Stereotipler ile Özelleştirme.
Kendi iş alanınız veya mimariniz için UML'i uyarlamak ve genişletmek amacıyla kendi profilinizi tanımlayabilirsiniz. Örneğin:
Eğer sık sık Web siteleri tanımlıyorsanız, sınıf diyagramlardaki sınıflara uygulanabilecek «WebSayfası» stereotipi sağlayan kendi profilinizi tanımlayabilirsiniz. Sonra bir Web sitesi planlamak için sınıf diyagramlarını kullanabilirsiniz. Her «WebSayfası» sınıfının; sayfa içeriği, stili ve benzerleri için ek özelliklere sahip olması gerekir.
Eğer bankacılık yazılımı geliştiriyorsanız, «Hesap» stereotipi sağlayan bir profil tanımlayabilirsiniz. Sonra hesabın farklı türlerini tanımlamak ve onlar arasındaki ilişkileri göstermek için sınıf diyagramlarını kullanabilirsiniz.
Kendi profillerinizi ekibinize dağıtabilirsiniz. Her ekip üyesi profilinizi yükleyebilir. Bu, onların stereotiplerini kullanan modelleri düzenlemelerini ve oluşturmalarını sağlar.
Not
Eğer düzenlediğiniz modelde profilin stereotiplerini uyguluyorsanız ve sonra diğer insanlarla paylaşıyorsanız, aynı profili kendi bilgisayarlarına yüklemelidirler. Aksi halde, kullandığınız stereotipleri görme olanakları olmayacaktır.
Bir profil genellikle daha büyük Visual Studio uzantısının bir parçasıdır. Örneğin, modelin bazı bölümlerini koda çeviren komut tanımlayabilirsiniz. Kullanıcıların çevirmek istedikleri paketlere uygulamaları gereken bir profil tanımlayabilirsiniz. Yeni komutunuzu ve profilinizi tek bir Visual Studio uzantısında dağıtmanız gerekir.
Ayrıca, profilin yerelleştirilmiş türevlerini de tanımlayabilirsiniz. Uzantınızı yükleyen kullanıcılar kendi kültürlerine uygun değişkeni görebilirler.
Profil Nasıl Tanımlanır
UML Profili tanımlamak için
.profile dosya adı uzantısı ile yeni bir XML dosyası oluşturun.
Bir Profilin Yapısı'nda açıklanan yönergelere göre stereotip tanımlarını ekleyin.
Profili Visual Studio Uzantısına (.vsix dosya) ekleyin. Profiliniz için yeni bir uzantı oluşturabilir ya da profili varolan uzantıya ekleyebilirsiniz.
Sonraki Visual Studio Uzantısına Profil Nasıl Eklenir bölümüne bakın.
Uzantıyı bilgisayarınıza yükleyin.
.vsix dosya adı uzantısına sahip uzantı dosyasına çift tıklayın.
Visual Studio'yu yeniden başlatın.
Profilin yüklendiğini doğrulayın.
UML Explorer'da modeli seçin.
Özellikler penceresinde Profiller özelliğini tıklatın. Profiliniz menüde görünecektir. Profilin yanındaki onay işaretini ayarlayın.
Profilinizin kendisi için klişeleri tanımladığı bir öğe seçin. Özellikler penceresinde Stereotipler özelliğini tıklatın. Stereotipleriniz listede görüntülenir. Klişelerden bir tanesi karşısındaki onay işaretini ayarlayın.
Profiliniz bu stereotip için ek özellikler tanımlarsa, onları görmek için stereotip özelliğini genişletin.
Visual Studio'nun diğer kullanıcılarına bilgisayarlarına yüklemeleri için uzantı dosyasını gönderin.
Visual Studio Uzantısına Profil Nasıl Eklenir
Bir profili yüklemek ve diğer kullanıcılara göndermenize izin vermek için, profili Visual Studio uzantısına eklemelisiniz. Daha fazla bilgi için bkz. Visual Studio Uzantılarını Dağıtma.
Yeni Visual Studio Uzantısında profil tanımlamak için
Visual Studio Uzantı projesi oluşturun.
Not
Bu yordamı kullanmak için Visual Studio SDK yüklenmiş olması gerekir.
Dosya menüsünde, Yeni'nin üzerine gelin ve Proje'yi tıklatın.
Yeni proje iletişim kutusunda, Yüklü Şablonlar altında Visual C#'ı genişletin, Genişletilebilirlik'e tıklayın ve sonra VSIX proje'sine tıklayın. Proje adını ayarlayın ve Tamam'a tıklayın.
Profilinizi projeye ekleyin.
- Çözüm Gezgini'nde, proje üzerinde sağ tıklayın, Ekle'ye gelin, ve sonra Varolan Öğe'yi seçin. İletişim kutusunda profil dosyanızı bulun.
Profil dosyanızın Çıkışı Kopyala özelliğini ayarlayın.
Çözüm Gezgini profil dosyasına sağ tıklayın ve sonra Özellikler'e tıklayın.
Özellikler penceresinde Çıkış Dizinine Kopyala özelliğini Her zaman Kopyala'ya ayarlayın.
Çözüm Gezgini'nde source.extension.vsixmanifest'i açın.
Dosya, uzantı bildirim düzenleyicisinde açılır.
Kimlik ve Ürün Adı alanlarını ayarlayın. Kimlik benzersiz olmalıdır.
İçerik altında, profili açıklayan bir satır ayarlayın:
İçerik Ekle'ye tıklayın. İçerik Ekle iletişimindeki alanları aşağıdaki gibi ayarlayın.
İçerik Türünü Seç'i Özel Uzantı Türü'ne ayarlayın.
Tür'ü Microsoft.VisualStudio.UmlProfile'na ayarlayın.
Projedeki dosya'ya tıklayın ve profilinizin adını seçin, örneğin MyProfile.profile
Projeyi yapılandırın.
Windows Gezgini'nde, aşağıdaki klasörü açın:. \bin\Debug or . \bin\Release to find the .vsix file. Bu Visual Studio Uzantı dosyasıdır. Bilgisayarınıza yüklenebilir ve diğer Visual Studio kullanıcılarına gönderilebilir.
Uzantıyı yüklemek için:
.vsix dosyasına çift tıklayın. Visual Studio Uzantı Yükleyicisi başlayacaktır.
Çalışan herhangi bir Visual Studio örneğini yeniden başlatın.
Visual Studio SDK'i yüklememişseniz aşağıdaki alternatif yordam küçük uzantılar için kullanılabilir.
Visual Studio SDK kullanmadan profil uzantısı tanımlamak için
Aşağıdaki üç dosyayı içeren Windows dizini oluşturun:
Profiliniz.profile
extension.vsixmanifest
[Content_Types].xml - bu adı köşeli ayraç ile burada gösterildiği gibi yazın.
Aşağıdaki metini kapsamak için [Content_Types].xml'i düzenleyin. Her dosya adı uzantısı için bir girdi içerdiğine dikkat edin.
<?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>Varolan extension.vsixmanifest'i kopyalayın ve XML düzenleyicisi ile düzenleyin. Kimlik, Ad ve İçerik düğümlerini değiştirin.
Bu dizinde extension.vsixmanifest'in örneğini bulabilirsiniz:
sürücü**:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE\Extensions\Microsoft\Architecture Tools\UmlProfiles**
İçerik düğümü aşağıdaki gibi olmalıdır:
<Content> <CustomExtension Type="Microsoft.VisualStudio.UmlProfile" >YourProfile.Profile</CustomExtension> </Content>
Üç dosyayı daraltılmış dosya içine sıkıştırın.
Windows Gezgini'nde, üç dosyayı seçin, sağ tıklayın, Gönder'e gelin, ve sonra Sıkıştırılmış (daraltılmış) klasör'e tıklayın.
Daraltılmış dosyayı yeniden adlandırın ve dosya adı uzantısını .zip'ten .vsix'e değiştirin.
Profili Visual Studio'nun uygun sürümleri ile herhangi bir bilgisayara yüklemek için .vsix dosyasına çift tıklayın.
Visual Studio Uzantısı'ndan UML Profili yüklemek için
Windows Gezgini'nde .vsix dosyasına çift tıklayın veya Visual Studio'da açın.
Görünen iletişim kutusunda Yükle'ye tıklayın.
Uzantıyı kaldırmak veya geçici olarak devre dışı bırakmak için Araçlar menüsünden Uzantı Yöneticisi'ni açın.
Yerelleştirilmiş Profiller Nasıl Tanımlanır
Farklı kültürler ve diller için farklı profiller tanımlayabilir ve tümünü aynı uzantı içinde paketleyebilirsiniz. Bir kullanıcı sizin uzantınızı yüklediği zaman onların kültürü için tanımladığınız profili göreceklerdir.
Her zaman varsayılan bir profil sağlamalısınız. Eğer kullanıcının kültürü için bir profil tanımlamadıysanız, onlar varsayılan profili göreceklerdir.
Yerelleştirilmiş bir profili tanımlamak için
Önceki Profil Nasıl Tanımlanırve Visual Studio Uzantısına Nasıl Profil Eklenir bölümlerinde açıklandığı gibi profil oluşturun. Bu, varsayılan profildir ve yerelleştirilmiş profil için sağlamadığınız herhangi bir yüklemede kullanılacaktır.
Varsayılan profil dosyası ile aynı dizinde yeni bir dizin ekleyin.
Not
Eğer Visual Studio Uzantı projesi kullanarak uzantı oluşturuyorsanız, projeye yeni klasör eklemek için Çözüm Gezgini'ni kullanın.
Yerelleştirilmiş kültür için yeni dizinin adını ISO kısa koduna değiştirin, örneğin Bulgarca için bg veya Fransızca için fr. fr-CA gibi belirli bir kültür kodu değil genellikle iki harf, bağımsız kültür kodu kullanmalısınız. Kültür kodları hakkında daha fazla bilgi için, kültür kodlarının tam listesini sağlayan CultureInfo.GetCultures yöntemi bağlantısına bakın.
Varsayılan profilinizin kopyasını yeni dizine ekleyin. Dosya adını değiştirmeyin.
Örnek Visual Studio Uzantı klasörü, .vsix dosyasınin içine oluşturulmadan veya sıkıştırılmadan önce aşağıdaki klasörleri ve dosyaları içermesi gerekir:
extension.vsixmanifest
MyProfile.profile
fr\MyProfile.profile
de\MyProfile.profile
Not
Profillerin yerelleştirilmiş sürümlerine başvuruları extension.vsixmanifest içine eklememelisiniz. Kopyalanmış profil dosyaları ana klasördeki profille aynı isme sahip olmalıdır.
Profilin yeni kopyasını, displayName öznitelikleri gibi kullanıcıya görünen tüm parçaları hedef dile çevirerek, düzenleyin.
İstediğiniz kadar çok kültür için ek kültür klasörleri ve yerelleştirilmiş profiller oluşturabilirsiniz.
Önceki bölümlerde açıklandığı şekilde Uzantı Projesini oluşturarak veya tüm dosyaları sıkıştırarak Visual Studio uzantısı oluşturun.
Bir Profilin Yapısı
Bu bölümde C# profili örnek olarak kullanılmıştır. Tam profil tanımı şurada görülebilir
sürücü**:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE\Extensions\Microsoft\Architecture Tools\UmlProfiles\CSharp.profile**
Bu yolun ilk bölümleri yüklemenizde farklılık gösterebilir.
.NET profili hakkında daha fazla bilgi için bkz. UML Modeller için Standart Stereotipler..
UML Profil tanımının ana bölümleri
Her profili aşağıdaki içeriği içerir:
<?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>
Not
name olarak adlandırılan öznitelik boşluklar veya noktalama işareti içermemelidir. Kullanıcı arayüzünde görünen displayName özniteliği geçerli XML dizesi olmalıdır.
Her profili üç ana bölüm içerir. Ters sırada onlar aşağıdaki gibidir:
<propertyTypes> - Stereotipler bölümünde tanımlanmış özellikler için kullanılan türlerin listesi.
<metaclasses> - IClass, IInterface, IOperation, IDependency gibi stereotiplerin bu profilde uyguladığı model öğe türlerinin listesi.
<stereotypes> - stereotip tanımları. Her tanım hedef model öğesine eklenen özelliklerin isimleri ve türlerini içerir.
Özellik Türleri
<propertyTypes> bölümü <stereotypes> bölümünde özellikler için kullanılan türlerin listesini bildirir. İki çeşit özellik türü var: dış ve numaralandırma.
Dış tür standart .NET türünün tam nitelikli adını bildirir:
<externalType name="System.String" />
Sabit liste türü değişmez değerler kümesini tanımlar:
<enumerationType name="PackageVisibility">
<enumerationLiterals>
<enumerationLiteral name="internal" displayName="internal" />
<enumerationLiteral name="protectedinternal" displayName="protected internal" />
</enumerationLiterals>
</enumerationType>
Metaclasses
<metaclasses> bölümü bu profildeki stereotiplerin tanımlanabildiği model öğe türleri listesidir:
<metaclass
name="Microsoft.VisualStudio.Uml.Classes.IClass" />
<metaclass
name="Microsoft.VisualStudio.Uml.Classes.IInterface" />
<metaclass
name="Microsoft.VisualStudio.Uml.Components.IComponent" />
Metaclasses olarak kullanılabilen model öğe ve ilişki türlerinin tam listesi için bkz. Model Öğe Türleri.
Stereotip tanımı
<stereotypes> bölümü bir veya daha çok stereotip tanımları içerir:
<stereotype name="CSharpClass" displayName="C# Class"> ...
Her stereotip uygulanabilecek bir veya daha çok model öğe veya ilişki türlerini listeler. Tüm türetilmiş türlerini dahil etmek için temel türün adını verebilirsiniz. Örneğin, eğer Microsoft.VisualStudio.Uml.Classes.IType'ı belirtirseniz, stereotip IClass, IInterface, IEnumeration ve öğenin birçok diğer türüne uygulanabilir.
<metaclasses>
<metaclassMoniker name=
"/CSharpProfile/Microsoft.VisualStudio.Uml.Classes.IClass" />
</metaclasses>
metaclassMoniker'in name özniteliği <metaClasses> bölümündeki öğeye bir bağlantıdır.
Not
Takma ad, yourProfileName'in profilin (bu örnekte "CSharpProfile") name özniteliğinde tanımlandığı yerde /yourProfileName/ ile başlamalıdır. Bilinen ad, metaclasses bölümündeki girdilerin birinin adı ile biter.
Her stereotip, uygulandığı herhangi bir model öğeye eklediği sıfır veya daha çok özelliği listeleyebilir. <propertyType>, <propertyTypes> bölümünde tanımlanmış türlerden birine bir bağlantı içerir. Bağlantı, ya <externalType>,'a başvuran <externalTypeMoniker> ya da <enumerationType> başvuran <enumerationTypeMoniker> olmalıdır. Tekrar, bağlantı profilinizin adı ile başlar.
<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>
Model Öğe Türleri
Stereotipler için tanımlayabileceğiniz türler kümesi Model Öğe Türleri bağlantısında listelenmiştir.
Sorun Giderme
Klişelerim UML modellerimde görünmüyor.
Profilinizi bir paket ya da model içinden seçmeniz gerekir. Sonra model veya paketin içinde öğelerin üzerinde stereotipler görünür. Daha fazla bilgi için bkz. Model Öğelere Klişeler Nasıl Eklenir.UML modeli açtığımda aşağıdaki hata görünür:VS1707: The following profiles cannot be loaded because a serialization error occurred: MyProfile.profile
.Profilin temel XML sözdiziminin doğru olduğunu doğrulayın.
Her Takma adın /profilAdı/düğümAdı formunda olduğundan emin olun. ProfilAdı kök profil düğümündeki ad özniteliğinin değeridir. DüğümAdı; Metasınıf, dışTür veya sabitlisteTürünün ad özniteliğinin değeridir.
Sözdiziminin burada açıklandığı ve gösterildiği gibi sürücü**:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE\Extensions\Microsoft\Architecture Tools\UmlProfiles\** olduğundan emin olun.
Hatalı uzantıyı kaldırın. Araçlar menüsünde Uzantı Yöneticisi'ne tıklayın.
- Eğer uzantı görünmüyorsa sonraki öğeye bakın.
VSIX dosyasını yeniden oluşturun ve tekrar yüklemek için onu Windows Gezgini'nde açın. Visual Studio'u yeniden başlatın.
Uzantı, Uzantı Yöneticisi'nde görünmez, ancak yeniden yüklemeye çalıştığınız zaman aşağıdaki ileti görünür: The extension is already installed to all applicable products.
LocalAppData\Microsoft\VisualStudio\10.0\Extensions\'ın alt dosyasından uzantı dosyasını kaldırın.
LocalAppData görmek için Windows Gezgini Klasör Seçenekleri'nin Görünüm sekmesinde Gizli Dosyaları Göster'i ayarlamalısınız.
LocalAppData genellikle C:\Kullanıcılar\kullanıcıAdı\AppData\Local\'dadır.
Visual Studio'u yeniden başlatın.
Ayrıca bkz.
Görevler
Model Öğelere Klişeler Nasıl Eklenir
Kavramlar
UML Modeller için Standart Stereotipler