İş verileri bağlantı modeli tasarlama

Bir model dosyasına varlıklar ve yöntemler ekleyerek İş Verileri Bağlan ivity (İVB) hizmeti için bir model geliştirebilirsiniz. Varlık, veri alanları koleksiyonunu açıklar. Örneğin, bir varlık veritabanındaki bir tabloyu temsil edebilir. Yöntem, varlıklar tarafından temsil edilen verileri ekleme, silme veya güncelleştirme gibi bir görev gerçekleştirir. Daha fazla bilgi için bkz . İş verilerini SharePoint ile tümleştirme.

Varlık ekleme

Visual Studio Araç Kutusu'ndan bir Varlığı İVB Tasarım Aracı sürükleyerek veya kopyalayarak varlık ekleyebilirsiniz. Daha fazla bilgi için bkz . Nasıl yapılır: Modele varlık ekleme.

Bir sınıftaki varlığın alanlarını tanımlayın. Örneğin, sınıfına adlı Address bir Customer alan ekleyebilirsiniz. Projeye yeni bir sınıf ekleyebilir veya Nesne İlişkisel Tasarımcısı (O/R Tasarım Aracı) gibi diğer araçları kullanarak oluşturulmuş mevcut bir sınıfı kullanabilirsiniz. Varlığın adı ve varlığı temsil eden sınıfın adı eşleşmesi gerekmez. Modelinizdeki yöntemleri tanımlarken sınıfını varlıkla ilişkilendirebilirsiniz.

Yöntem ekleme

İVB hizmeti, kullanıcılar modelinizi temel alan bir listede veya Web Bölümünde bilgileri görüntüler, ekler, güncelleştirir veya silerken modelinizdeki yöntemleri çağırır. Kullanıcının gerçekleştirebileceği her görev için modele bir yöntem eklemeniz gerekir. İVB Yöntem Ayrıntıları penceresinden beş temel yöntem türünden birini seçerek yöntemler oluşturun. Aşağıdaki tabloda bir İVB modelinin beş temel yöntemi açıklanmaktadır.

Metot	Açıklama
Bulucu	Varlık örneklerinin bir koleksiyonunu döndürür. Kullanıcı listeyi veya Web Bölümünü açtığında çağrılır. Daha fazla bilgi için bkz . Nasıl yapılır: Bulucu yöntemi ekleme.
Belirli Bir Bulucu	Belirli bir varlık örneği döndürür. Kullanıcı listedeki belirli bir öğenin ayrıntılarını görüntülediğinde çağrılır. Daha fazla bilgi için bkz . Nasıl yapılır: Belirli bir Bulucu yöntemi ekleme.
Oluşturucu	Bir varlığın veri kaynağına yeni veri ekler. Kullanıcılar modeli temel alan bir listenin Şeridindeki Yeni Öğe düğmesini seçtiğinde çağrılır. Daha fazla bilgi için bkz . Nasıl yapılır: Oluşturucu yöntemi ekleme.
Güncelleştirici	Listedeki verileri değiştirir. Kullanıcılar listedeki bilgileri güncelleştirdiğinde çağrılır. Daha fazla bilgi için bkz . Nasıl yapılır: Güncelleştirici yöntemi ekleme.
Silici	Verileri kaldırır. Kullanıcılar listeden bir öğeyi sildiğinde çağrılır. Daha fazla bilgi için bkz . Nasıl yapılır: Deleter yöntemi ekleme.

Yöntem parametrelerini tanımlama

Bir yöntem oluşturduğunuzda, Visual Studio yöntem türüne uygun giriş ve çıkış parametrelerini ekler. Bu parametreler yalnızca yer tutuculardır. Çoğu durumda, parametreleri geçirebilecekleri veya doğru veri türünü döndürebilecekleri şekilde değiştirmeniz gerekir. Örneğin, varsayılan olarak Bir Bulucu yöntemi bir dize döndürür. Çoğu durumda, Finder yönteminin dönüş parametresini değiştirerek varlık koleksiyonunu döndürmesini istersiniz. Bunu yapmak için parametresinin tür tanımlayıcısını değiştirebilirsiniz. Tür tanımlayıcısı, bir parametrenin veri türünü açıklayan bir öznitelik koleksiyonudur. Daha fazla bilgi için bkz . Nasıl yapılır: Parametrenin tür tanımlayıcısını tanımlama.

Visual Studio, modeldeki parametreler arasında tür tanımlayıcılarını kopyalamanızı sağlar. Örneğin, yönteminin dönüş parametresi için adlı CustomerTD bir tür tanımlayıcısı GetCustomer tanımlayabilirsiniz. İVB Gezgini'nde tür tanımlayıcısını CustomerTDkopyalayabilir ve ardından bu tür tanımlayıcısını yöntemin giriş parametresine CreateCustomer yapıştırabilirsiniz. Bu, aynı tür tanımlayıcısını birden çok kez tanımlamanızı önler.

Yöntem örnekleri

Bir yöntem oluşturduğunuzda, Visual Studio varsayılan bir yöntem örneği ekler. Yöntem örneği, bir yöntemin başvurusu ve parametreler için varsayılan değerlerdir. Tek bir yöntemin birden çok yöntem örneği olabilir. Her örnek, yöntem imzası ile bir dizi varsayılan değerin birleşimidir. Daha fazla bilgi için bkz . Nasıl yapılır: Parametrenin tür tanımlayıcısını tanımlama.

Projeyi çalıştırdığınızda, yöntem örnekleri SharePoint listesinin üzerindeki bir açılan listede görünür. Kullanıcılar, verileri görüntülemek için yöntem örneklerini seçebilir.

Yöntem örneğine varsayılan değerler eklemek için modelin XML'sini doğrudan değiştirmeniz gerekir. Daha fazla bilgi için bkz . DefaultValue.

Filtre tanımlayıcıları ekleme

Modelin tüketicileri, bazı ölçütlerle eşleşen bir varlığın örneklerini almak isteyebilir. Bu işlevi etkinleştirmek için bir yönteme filtre tanımlayıcısı ekleyebilirsiniz. Filtre tanımlayıcıları, model tüketicilerinin yöntem sonuç kümelerini yürütmeden önce yöntemlere değer geçirerek filtrelemesine olanak tanır. Daha fazla bilgi için bkz . Nasıl yapılır: Dış Sistemden Örnekleri Sınırlamak için İşlemlere Filtre Parametreleri Ekleme.

SharePoint, kullanıcıların filtre değerleri sağlamasına olanak tanıyan çeşitli özellikler sağlar. Örneğin, İş Verileri Web Bölümleri bir filtre metin kutusu sağlar. Kullanıcılar, metin kutusuna bir değer girerek listedeki verileri sınırlandırabilir. Bir yönteme filtre tanımlayıcısı ekleme hakkında daha fazla bilgi için bkz . Nasıl yapılır: Bulucu yöntemine filtre tanımlayıcısı ekleme.

Filtre tanımlayıcısı özellikleri

Bir filtre tanımlayıcısının İlişkili Tür Tanımlayıcısı, Ad ve Tür özelliklerinin değerini ayarlamanız gerekir. Diğer tüm özellikler isteğe bağlıdır.

İlişkili Tür Tanımlayıcısı özelliği, filtre tanımlayıcısını bir giriş parametresiyle ilişkilendirmektedir. Kullanıcı bir filtre değeri sağladığında, İVB hizmeti giriş parametresini kullanarak bu değeri yöntemine geçirir.

Type özelliği, kullanmak istediğiniz filtreleme düzenini açıklar. SharePoint'te, seçtiğiniz filtreleme düzeni Kullanıcı Arabirimi'nde (UI) görüntülenen metni etkiler. Örneğin, Karşılaştırıcı filtreleme düzeni için metin, İş Verileri Web Bölümü'nü aşan bir denetim olarak görünür. Her filtreleme düzeni hakkında daha fazla bilgi için bkz . İVB Tarafından Desteklenen Filtre Türleri.

Filtre tanımlayıcısının özellikleri hakkında daha fazla bilgi için bkz . FilterDescriptor.

Varsayılan değerleri sağlama

Bazı durumlarda, kullanıcı bir filtre değeri sağlamayabilir. Yöntem örneğine varsayılan bir değer ekleyerek veya yönteminizin kodunda varsayılan değeri ayarlayarak varsayılan bir değer sağlayabilirsiniz. Yöntem örneğine varsayılan değer ekleme hakkında daha fazla bilgi için bkz . MethodInstance. Yönteminizin kodunda giriş parametresinin varsayılan değerini ayarlama örneği için bkz . Nasıl yapılır: Bulucu yöntemine filtre tanımlayıcısı ekleme.

Modeli doğrulama

Geliştirme sırasında modelinizi doğrulayabilirsiniz. Visual Studio, modelinizin beklendiği gibi davranmasını engelleyebilecek sorunları tanımlar. Bu sorunlar Visual Studio Hata Listesi'nde görüntülenir.

İVB Tasarım Aracı kısayol menüsünü açıp Doğrula'yı seçerek modeli doğrulayabilirsiniz. Model herhangi bir hata içeriyorsa, Bunlar Hata Listesi'nde görünür. İmleci, listedeki hataya çift tıklayarak hata içeren koda hızla taşıyabilirsiniz. Alternatif olarak, listedeki hatalarda ileri veya geri gitmek için F8 veya Shift+F8 tuşlarını art arda seçebilirsiniz.

Modelin kuralları bir şekilde ihlal edildiğinde doğrulama hataları oluşabilir. Örneğin, bir tür tanımlayıcısının IsCollection özelliği true olarak ayarlandıysa, ancak alt tür tanımlayıcıları yoksa, doğrulama hatası görüntülenir. Visual Studio Hata Listesi'nde görünen bazı hataları anlamak için İVB modelinin kurallarına başvurmanız gerekebilir. İVB modelinin kuralları hakkında daha fazla bilgi için bkz . BDCMetadata Şeması.

Modeli içeren çözümde hata ayıklama

Visual Studio'da herhangi bir kodun hatalarını ayıkladığınız gibi kodunuzun hatalarını ayıklayabilirsiniz. Kodunuzun hatalarını ayıklamak için kodunuzun herhangi bir yerinde kesme noktaları ayarlayın ve hata ayıklayıcısını başlatın. Visual Studio, SharePoint sitesini açar. SharePoint'te, iş verilerinizi kullanan bir liste veya Web Bölümü oluşturun. Ardından kodunuzda adım adım ilerleyebilirsiniz. SharePoint projelerinde hata ayıklama hakkında daha fazla bilgi için bkz . SharePoint çözümlerinde sorun giderme.

Ayrıca projeye eklediğiniz özel derlemelerde kod hatalarını ayıklayabilirsiniz. Ancak, özel bir derlemedeki kodun hatalarını ayıklamak için derlemeyi çözüm paketine eklemeniz gerekir. Daha fazla bilgi için bkz . Nasıl yapılır: Ek derlemeler ekleme ve kaldırma.

Projenize özel derleme ekleme hakkında daha fazla bilgi için bkz . Nasıl yapılır: İVB özelliğine özel derleme ekleme.

İVB güvenliğini yapılandırma

Çözümünüzün hatalarını ayıklamadan önce SharePoint'teki güvenlik ayarlarınızı değiştirmeniz gerekebilir. Bu ayarları değiştirmek için SharePoint 2010 Central Yönetici istration Web sitesinde İş Verileri Bağlan ivity Service Uygulaması'nı açın. Meta Veri Deposu İzinlerini Ayarla iletişim kutusunda kullanıcı hesabınızı ekleyin ve aşağıdaki seçeneklerden birini belirleyin:

Görev	Seçenek
Modelleri İVB hizmetine dağıtmak için.	Düzenle
Modelinizde dış içerik türlerini (varlıklar) kullanarak listeler ve Web Bölümleri oluşturmak için.	İstemcilerde Seçilebilir
Varlık verilerini oluşturmak, okumak, güncelleştirmek ve silmek için.	Yürütme

Bu ayarlar hakkında daha fazla bilgi için bkz. İş Verileri Bağlan üretkenlik hizmeti yönetimi.

Ayrıca, tek tek modeller veya dış içerik türleri için güvenlik izinleri de ayarlayabilirsiniz. Bir modelin güvenlik izinlerini ayarlama hakkında daha fazla bilgi için bkz . İVB model yönetimi. Dış içerik türünün güvenlik izinlerini ayarlama hakkında daha fazla bilgi için bkz . Dış içerik türü yönetimi.

Not

Yerel SharePoint Server'ınızdaki bir çözümün hatalarını ayıklamak için bu ayarları kullanın. Üretim SharePoint sunucusunda İVB ile ilgili güvenlik ayarlarını yapılandırma hakkında daha fazla bilgi için bkz. İş Verileri Bağlan ivity Services güvenliğine genel bakış.

Bozulan modelleri geri çekme

Hata ayıklayıcıyı ilk kez başlattığınızda, Visual Studio modelin tamamını SharePoint'e dağıtır. Bundan sonra Visual Studio, SharePoint'teki modeli dağıtımlar arasında yaptığınız tüm değişikliklerle güncelleştirir.

Visual Studio'dan modeli SharePoint'ten tamamen geri çekmesini istediğiniz durumlar olabilir. Örneğin, bir model bozulabilir. Modelinizi SharePoint'e yeniden dağıtmak için modelin Artımlı Güncelleştirme özelliğini False olarak ayarlayın ve hata ayıklayıcısını başlatın. Artımlı Güncelleştirme özelliği, İVB Gezgini'nde modeli temsil eden düğümü seçtiğinizde Özellikler penceresinde görüntülenir. Varsayılan olarak, modelin adı BdcModel1'dir.

Modeldeki varlıkların tanımlayıcı adlarını değiştirme

Modeli dağıttığınızda tanımlayıcının adını değiştirirseniz dağıtım hatası alabilirsiniz. Modelin Artımlı Güncelleştirme özelliğini False olarak ayarlayarak bu hatayı çözemezsiniz. Modeli el ile geri çekmeniz ve ardından çözümü yeniden dağıtmanız gerekir. Daha fazla bilgi için bkz . SharePoint çözümlerinde sorun giderme. Modeli ilk kez dağıtmadan önce Artımlı Güncelleştirme özelliğini False olarak ayarlayarak bu hatayı önleyebilirsiniz.

İVB model öğeleri için belgeleri bulma

Visual Studio, oluşturduğunuz her varlık, yöntem veya diğer öğe için modele bir XML öğesi ekler. Öğe öznitelikleri Özellikler penceresinde özellik olarak görünür. Modeli tasarladığınızda Visual Studio'da oluşturulan öğeler ve öznitelikler hakkında bilgi için bkz . BDCMetadata Şeması.

İlgili konular

Ünvan	Açıklama
İVB modeli tasarım araçlarına genel bakış	İVB için bir modeli görsel olarak tasarlamak için kullanabileceğiniz araçları açıklar.
Nasıl yapılır: Modele varlık ekleme	Modele dış içerik türlerinin veya varlıkların nasıl ekleneceğini gösterir.
Nasıl yapılır: Finder yöntemi ekleme	Kullanıcıların bir listedeki veya Web Bölümündeki varlıkların listesini görüntülemesine olanak tanıyan bir yöntemin nasıl ekleneceğini gösterir.
Nasıl yapılır: Belirli bir Finder yöntemi ekleme	Kullanıcıların belirli bir varlığın ayrıntılarını görüntülemesini sağlayan bir yöntemin nasıl ekleneceğini gösterir.
Nasıl yapılır: Oluşturucu yöntemi ekleme	Kullanıcıların doğrudan bir listeden veya Web Bölümünden veri kaynağına kayıt eklemesine olanak tanıyan bir yöntemin nasıl ekleneceğini gösterir.
Nasıl yapılır: Deleter yöntemi ekleme	Bir listenin veya Web Bölümünün Kullanıcı Arabirimi 'ndeki (UI) seçenekleri kullanarak kullanıcıların veri kaynağından veri kaldırmasını sağlayan bir yöntemin nasıl ekleneceğini gösterir.
Nasıl yapılır: Güncelleştirici yöntemi ekleme	Kullanıcıların doğrudan bir listeden veya Web Bölümünden veri kaynağındaki veri kayıtlarını değiştirmesine olanak tanıyan bir yöntemin nasıl ekleneceğini gösterir.
Nasıl yapılır: Yönteme parametre ekleme	Bir yönteme giriş ve dönüş parametreleri eklemek için Visual Studio'daki Yöntem Ayrıntıları Penceresini nasıl kullanacağınızı gösterir.
Nasıl yapılır: Parametrenin tür tanımlayıcısını tanımlama	Modelde parametre veri türlerini tanımlamayı gösterir.
Nasıl yapılır: Yöntem örneği tanımlama	İVB'nin yürüttüğü bir yöntemin örneğini nasıl oluşturabileceğinizi gösterir.
Nasıl yapılır: Bulucu yöntemine filtre tanımlayıcısı ekleme	Kullanıcıların bir Finder yöntemi tarafından döndürülen örnek sayısını sınırlamasına nasıl olanak tanıyabileceğinizi gösterir.
Varlıklar Arasında İlişkilendirme Oluşturma	Modeldeki varlıklar arasındaki ilişkileri nasıl tanımlayabileceğinizi açıklar. İş Verileri Web Bölümleri, Dış Listeler ve özel uygulamalar bu veri ilişkilerini bir kullanıcı arabiriminde (UI) görüntüleyebilir.
Nasıl yapılır: Varlıklar arasında ilişki oluşturma	Modeldeki varlıklar arasındaki ilişkileri tanımlamayı gösterir.
İzlenecek yol: İş verilerini kullanarak SharePoint'te dış liste oluşturma	SharePoint dış listesinde kişileri görüntüleyen bir model oluşturma ve test etme adım adım yönergeler sağlar.
İş verilerini SharePoint ile tümleştirme	İVB hizmeti için model oluşturmaya ve tasarlamaya genel bir bakış sağlar.