Çözüm bileşenleri için bağımlılık izleme

Bu konu, Dynamics 365 Customer Engagement (on-premises) için geçerlidir. Bu konunun Power Apps sürümü için bkz: Çözüm bileşenleri için bağımlılık izleme.

Çözümler çözüm bileşenlerinden oluşur. Çözüm bileşenleri oluşturmak veya eklemek için Dynamics 365 Müşteri Katılımı'ndaki (şirket içi) Çözümler alanını kullanacaksınız. Bu eylemleri, iletiyi veya parametre içeren AddSolutionComponentRequest çözüm bileşenlerini oluşturan veya güncelleştiren iletileri kullanarak SolutionUniqueName program aracılığıyla gerçekleştirebilirsiniz.

Çözüm bileşenleri genellikle diğer çözüm bileşenlerine bağlıdır. Başka bir çözüm bileşenine bağımlılıkları olan hiçbir çözüm bileşenini silemezsiniz. Örneğin, özelleştirilmiş bir şerit genellikle simgeleri görüntülemek ve betikleri kullanarak eylemler gerçekleştirmek için görüntü veya betik web kaynakları gerektirir. Özelleştirilmiş şerit çözümde olduğu sürece, kullandığı belirli web kaynakları gereklidir. Web kaynaklarını silebilmeniz için önce özelleştirilmiş şeritte bunlara yönelik başvuruları kaldırmanız gerekir. Bu çözüm bileşeni bağımlılıkları uygulamada Bağımlılıkları Göster'e tıklanarak görüntülenebilir.

Bu konu başlığında çözümlerinize ekleyebileceğiniz çözüm bileşeni türleri ve bunların birbirine nasıl bağımlı olduğu açıklanmaktadır.

Tüm çözüm bileşenleri

Kullanılabilir çözüm bileşen türlerinin tam listesi sistem componenttype genel seçenek kümesinde bulunur. Rest uç noktasını kullanarak https://[ORGANIZATION_NAME].api.crm.dynamics.com/api/data/v9.0/GlobalOptionSetDefinitions(Name='componenttype')bu verileri sorgulayabilir ve kod kullanarak tüm componenet'i görebilirsiniz. Bu özellik için desteklenen değer aralığı, projenize SampleCode\CS\HelperCode\OptionSets.cs veya SampleCode\VB\HelperCode\OptionSets.vb dosyası eklenerek kullanılabilir. Ancak, burada listelenen çözüm bileşeni türlerinin çoğu yalnızca iç kullanım içindir ve liste çözüm bileşenleri arasındaki ilişkiler hakkında bilgi sağlamaz.

Çözüm bileşeni bağımlılıkları

Çözüm bileşeni bağımlılıkları, çözümlerle çalışırken güvenilir bir deneyime sahip olduğunuzdan emin olmanıza yardımcı olur. Normalde gerçekleştirdiğiniz eylemlerin, bir çözümde tanımlanan istemeden özelleştirmeleri bozmasını engeller. Bu bağımlılıklar, yönetilen çözümün yalnızca bir çözümü içeri aktararak veya silerek yüklenmesine ve kaldırılmasına olanak sağlayan bağımlılıklardır.

Çözüm çerçevesi, çözüm bileşenleri için bağımlılıkları otomatik olarak izler. Çözüm bileşenindeki her işlem, sistemdeki diğer bileşenlere yönelik bağımlılıkları otomatik olarak hesaplar. Bağımlılık bilgileri, sistemin bütünlüğünü korumak ve tutarsız duruma yol açabilecek işlemleri önlemek için kullanılır.

Bağımlılık izlemenin bir sonucu olarak aşağıdaki davranışlar uygulanır:

Bir bileşenin silinmesi, sistemdeki başka bir bileşenin buna bağlı olması durumunda engellenir.
Çözümün dışarı aktarılması, başka bir sistemde bu çözümü içeri aktarırken hataya neden olabilecek eksik bileşenler varsa kullanıcıyı uyarır.

Dışarı aktarma sırasındaki uyarılar, çözüm geliştiricisi çözümün yalnızca bağımlı bileşenlerin bulunması beklenen bir kuruluşa yüklenmesini istiyorsa yoksayılabilir. Örneğin, önceden yüklenmiş bir "temel" çözüm üzerine yüklenecek şekilde tasarlanmış bir çözüm oluşturduğunuzda.
Tüm gerekli bileşenler çözüme dahil değilse ve hedef sistemde yoksa çözümün içeri aktarılması başarısız olur.
- Ayrıca, yönetilen çözümü içeri aktardığınızda tüm gerekli bileşenler çözümün paket türüyle eşleşmelidir. Yönetilen çözümdeki bir bileşen yalnızca başka bir yönetilen bileşene bağımlı olabilir.
Üç tür çözüm bileşeni bağımlılığı vardır:

Çözüm İç
İç bağımlılıklar Dynamics 365 Customer Engagement (şirket içi) tarafından yönetilir. Bunlar, belirli bir çözüm bileşeni başka bir çözüm bileşeni olmadan mevcut olmadığında vardır.

Yayımlanmış
Yayımlanan bağımlılıklar, iki çözüm bileşeni birbiriyle ilişkilendirildiğinde ve sonra yayımlandığında oluşturulur. Bu tür bir bağımlılığı kaldırmak için ilişkilendirmenin kaldırılması ve varlıkların yeniden yayımlanması gerekir.

Yayımlanmamış
Yayımlanmamış bağımlılıklar, güncelleştirilmekte olan yayımlanabilir çözüm bileşeninin yayımlanmamış sürümü için geçerlidir. Çözüm bileşeni yayımlandıktan sonra yayımlanmış bir bağımlılık haline gelir.

Çözüm iç bağımlılıkları, bir çözüm bileşenine sahip eylemlerin başka bir çözüm bileşeni için eylem gerektirdiği bağımlılıklardır. Örneğin, bir varlığı silerseniz, tüm varlık özniteliklerinin onunla birlikte silinmesini beklemeniz gerekir. Diğer varlıklarla tüm varlık ilişkileri de silinir.

Ancak, iç bağımlılık yayımlanmış bir bağımlılıkla sonuçlanabilir ve yine de el ile müdahale gerektirebilir. Örneğin, bir varlık formuna arama alanı ekler ve sonra ilişkideki birincil varlığı silerseniz, ilgili varlık formundan arama alanını kaldırıp formu yayımlamadan bu silme işlemini tamamlayamazsınız.

Çözümlerle program aracılığıyla eylemler gerçekleştirdiğinizde, varlıkla ilgili Dependency iletileri kullanabilirsiniz. Bir bileşeni silmeden veya çözümü kaldırmadan önce var olabilecek bağımlılıkları tanımlamak için kullanabileceğiniz iletiler için bkz. Bağımlılık Varlığı .

Çözüm bileşeni bağımlılıklarını denetleme

Çözümleri düzenlerken, bir çözüm bileşeninin başka bir çözüm bileşeniyle yayımlanmış bağımlılığı olduğundan silemezsiniz. Veya yönetilen çözümdeki bileşenlerden biri başka bir yönetilmeyen çözümdeki özelleştirmede kullanıldığından yönetilen çözümü kaldıramayabilirsiniz.

Aşağıdaki tabloda, çözüm bileşeni bağımlılıkları hakkındaki verileri almak için kullanabileceğiniz iletiler listelenmektedir.

Message	Description
RetrieveDependentComponentsRequest	Doğrudan bir çözüm bileşenine bağımlı olan çözüm bileşenleri için bağımlılıkların listesini döndürür. Örneğin, genel seçenek kümesi çözüm bileşeni için bu iletiyi kullandığınızda, genel seçenek kümesi çözüm bileşenine başvuran tüm seçenek kümesi özniteliklerini temsil eden çözüm bileşenleri için bağımlılık kayıtları döndürülür. Hesap varlığı için çözüm bileşeni kaydı için bu iletiyi kullandığınızda, bu varlık için kullanılan öznitelikleri, görünümleri ve formları temsil eden tüm çözüm bileşenlerinin bağımlılık kayıtları döndürülür.
RetrieveRequiredComponentsRequest	Başka bir çözüm bileşeninin doğrudan bağımlı olduğu çözüm bileşenlerine yönelik bağımlılıkların listesini döndürür. Bu ileti, iletinin tersini `RetrieveDependentComponentsRequest` sağlar.
RetrieveDependenciesForDeleteRequest	Çözüm bileşenlerinin silinmesini engelleyebilecek tüm bağımlılıkların listesini döndürür.
RetrieveDependenciesForUninstallRequest	Yönetilen çözümün kaldırılmasını engelleyebilecek çözüm bileşenlerinin tüm bağımlılıklarının listesini döndürür.

Ortak Çözüm bileşenleri

Bunlar uygulamada görüntülenen çözüm bileşenleri ve çözüm sayfasını kullanarak çözüm bileşenlerini eklerken veya kaldırırken doğrudan birlikte çalışacağınız bileşenlerdir. Diğer çözüm bileşeni türlerinin her biri, bu çözüm bileşenlerinin mevcut olması için bir veya daha fazla bileşene bağlıdır.

Uygulama şeritleri (ŞeritÖzelleştirme)

Uygulama şeridi ve varlık şerit şablonları için şerit özelleştirmeleri. Uygulama şeritleri, varlık veya form düzeyinde şerit tanımlarını içermez.

Özel uygulama şeritlerinde genellikle web kaynakları üzerinde yayımlanan bağımlılıklar bulunur. Web kaynakları, şerit öğelerinin ne zaman görüntüleneceğini veya belirli bir şerit denetimi kullanıldığında hangi eylemlerin gerçekleştirildiğini denetlemek için şerit düğmesi simgelerini ve JavaScript işlevlerini tanımlamak için kullanılır. Bağımlılıklar yalnızca şerit tanımları web kaynağını şeritle ilişkilendirmek için yönergesini $webresource: kullandığında oluşturulur. Daha fazla bilgi: $webresource yönergesi

Makale şablonu (KBArticleTemplate)

Bir makalenin standart özniteliklerini içeren şablon. Makale şablonu ile KbArticle varlığı arasında her zaman bir iç bağımlılık vardır.

Bağlantı rolü (ConnectionRole)

İki kayıt arasındaki ilişkiyi açıklayan rol. Her bağlantı rolü, bağlantı rolü kullanılarak hangi tür varlık kayıtlarının bağlanabileceğini tanımlar. Bu, bağlantı rolü ile varlık arasında yayımlanmış bir bağımlılık oluşturur.

Sözleşme şablonu (ContractTemplate)

Bir sözleşmenin standart özniteliklerini içeren şablon. Sözleşme şablonuyla sözleşme varlığı arasında her zaman bir iç bağımlılık vardır.

Pano veya varlık formu (SystemForm)

Sistem formu varlık kayıtları, panoları ve varlık formlarını tanımlamak için kullanılır. Bir SystemForm varlık formu olarak kullanıldığında, varlıkta bir iç bağımlılık vardır. Bir SystemForm pano olarak kullanıldığında iç bağımlılık yoktur. Hem varlık formları hem de panolar genellikle içerikleriyle ilgili yayımlanmış bağımlılıklara sahiptir. Varlık formunun bir varlık ilişkisine bağlı arama alanları olabilir. Hem panolar hem de varlık formları, görünümde yayımlanmış bir bağımlılık oluşturacak grafikler veya alt kılavuzlar içerebilir ve bu da bir varlığa iç bağımlılığı vardır. Panoda veya formda görüntülenen içerik nedeniyle veya bir form JavaScript kitaplıkları içerdiğinde, web kaynaklarına yayımlanmış bir bağımlılık oluşturulabilir. Varlık formları, formda alan olarak görüntülenen tüm özniteliklerde yayımlanmış bağımlılıklara sahiptir.

E-posta şablonu (EmailTemplate)

E-posta iletisinin standart özniteliklerini içeren şablon. E-posta şablonu genellikle belirtilen varlık özniteliklerinden veri ekleyen alanlar içerir. Bir e-posta şablonu oluşturulduğunda belirli bir varlığa bağlanabilir, böylece varlığa bir iç bağımlılık olabilir. Genel e-posta şablonu belirli bir varlıkla ilişkili değildir, ancak veri sağlamak için kullanılan varlık özniteliklerinde yayımlanmış bağımlılıkları olabilir. Bir işlem (iş akışı) genellikle iş akışıyla yayımlanmış bir bağımlılık oluşturan bir e-posta şablonu kullanarak e-posta gönderecek şekilde yapılandırılır.

Varlık (Varlık)

Dynamics 365 Customer Engagement'ta (şirket içi) verileri modellemek ve yönetmek için kullanılan birincil yapı. Bir varlıkla ilişkili grafikler, formlar, varlık ilişkileri, görünümler ve öznitelikler, aralarındaki iç bağımlılıklar nedeniyle varlık silindiğinde otomatik olarak silinir. Varlıklar genellikle işlemler, panolar ve e-posta şablonlarıyla yayımlanmış bağımlılıklara sahiptir.

Alan güvenlik profili (FieldSecurityProfile)

Güvenli öznitelikler için erişim düzeyini tanımlayan profil.

Adres mektup birleştirme şablonu (MailMergeTemplate)

Adres mektup birleştirme belgesinin standart özniteliklerini içeren şablon. Adres mektup birleştirme şablonunun ilişkili olduğu varlığa yayımlanmış bir bağımlılığı vardır.

Seçenek kümesi (OptionSet)

Seçenek kümesi, bir dizi seçeneği tanımlar. Seçim listesi özniteliği, sağlanan seçenekleri tanımlamak için bir seçenek kümesi kullanır. Çeşitli seçim listesi öznitelikleri genel bir seçenek kümesi kullanabilir, böylece sağladıkları seçenekler her zaman aynı olur ve tek bir yerde korunabilir. Bir seçim listesi özniteliği genel bir seçenek kümesine başvurduğunda yayımlanan bir bağımlılık oluşur. Seçim listesi özniteliği tarafından kullanılan genel seçenek kümesini silemezsiniz.

Eklenti derlemesi (PluginAssembly)

Bir veya daha fazla eklenti türü içeren derleme. Eklentiler genellikle bir varlıkla ilişkili olaylara kaydedilir. Bu, yayımlanmış bir bağımlılık oluşturur.

İşlem (İş Akışı)

Belirli bir iş sürecini, görevi veya gerçekleştirilecek eylem kümesini otomatikleştirmek için gerekli adımları tanımlayan mantıksal kurallar kümesi. İşlemler, işlem tarafından başvuruda bulunılan diğer tüm çözüm bileşenlerinde yayımlanmış bağımlılıklar oluşturan çok çeşitli eylemler sağlar. Her işlemin ilişkili olduğu varlığa yayımlanmış bir bağımlılığı da vardır.

Rapor (Rapor)

Kolay okunan düzende veri özeti. Raporda, rapora dahil edilen herhangi bir varlık veya öznitelik verisine yönelik bağımlılıklar yayımlanmıştır. Her rapor, Raporla İlgili Kategori (ReportCategory) adlı bir çözüm bileşeninde iç bağımlılık oluşturan bir Rapor kategorisiyle de ilişkilendirilmelidir. Raporlar, üst raporla yayımlanmış bir bağımlılık oluşturan alt raporlar olacak şekilde yapılandırılabilir.

SDK ileti işleme adımı (SDKMessageProcessingStep)

Bir eklentinin yürütülecek yürütme işlem hattında aşama oluşturma.

Güvenlik rolü (Rol)

Güvenlik ayrıcalıklarının gruplanması. Kullanıcılara Dynamics 365 Customer Engagement (şirket içi) sistemine erişim yetkisi veren roller atanır. Varlık formları, formu kimlerin görüntüleyebileceğini denetlemek için belirli güvenlik rolleriyle ilişkilendirilebilir. Bu, güvenlik rolü ile form arasında yayımlanmış bir bağımlılık oluşturur.

Uyarı

Çözüme yalnızca kuruluş iş biriminden güvenlik rolleri eklenebilir. Yalnızca bu güvenlik rollerine okuma erişimi olan bir kullanıcı bunları bir çözüme ekleyebilir.

Hizmet uç noktası (ServiceEndpoint)

İletişim kurulabilecek hizmet uç noktası.

Site haritası (Site Haritası)

Uygulama gezinti bölmesini denetlemek için kullanılan XML verileri. Site haritası bir HTML web kaynağı görüntülemek için bağlanabilir veya site haritasındaki bir simge bir görüntü web kaynağı kullanabilir. $webresource: Yönergesi bu ilişkilendirmeleri oluşturmak için kullanıldığında yayımlanmış bir bağımlılık oluşturulur. Daha fazla bilgi: $webresource yönergesi

Web kaynağı (WebResource)

Web geliştirmede kullanılan dosyalara eşdeğer veriler. Web kaynakları, özel kullanıcı arabirimi öğeleri sağlamak için kullanılan istemci tarafı bileşenleri sağlar. Web kaynaklarının varlık formları, şeritler ve Site Haritası ile yayımlanmış bağımlılıkları olabilir. Yönergesi $webresource: bir şeritte veya Site Haritasında ilişkilendirmeler oluşturmak için kullanıldığında, yayımlanmış bir bağımlılık oluşturulur. Daha fazla bilgi için bkz. $webresource yönergesi.