İzlenecek yol: İş verilerini kullanarak SharePoint'te dış liste oluşturma

İş Verileri Bağlan ivity (İVB) hizmeti, SharePoint'in arka uç sunucu uygulamalarından, Web hizmetlerinden ve veritabanlarından iş verilerini görüntülemesini sağlar.

Bu kılavuzda, örnek veritabanındaki kişiler hakkında bilgi döndüren İVB hizmeti için bir modelin nasıl oluşturulacağı gösterilmektedir. Ardından bu modeli kullanarak SharePoint'te bir dış liste oluşturacaksınız.

Bu izlenecek yol aşağıdaki görevleri gösterir:

• Proje oluşturma.
• Modele varlık ekleme.
• Bulucu yöntemi ekleme.
• Belirli bir Bulucu yöntemi ekleme.
• Projeyi test etme.

Önkoşullar

Bu izlenecek yolu tamamlamak için aşağıdaki bileşenlere ihtiyacınız vardır:

• Desteklenen Windows ve SharePoint sürümleri.

• AdventureWorks örnek veritabanına erişim. AdventureWorks veritabanını yükleme hakkında daha fazla bilgi için bkz . SQL Server Örnek Veritabanları.

İVB modeli içeren bir proje oluşturma

1. Visual Studio'daki menü çubuğunda Dosya>Yeni Proje'yi> seçin.

   Yeni Proje iletişim kutusu açılır.

2. Visual C# veya Visual Basic altında SharePoint düğümünü genişletin ve 2010 öğesini seçin.

3. Şablonlar bölmesinde SharePoint 2010 Projesi'ni seçin, projeyi AdventureWorksTest olarak adlandırın ve ardından Tamam düğmesini seçin.

   SharePoint Özelleştirme Sihirbazı görüntülenir. Bu sihirbazda, projede hata ayıklamak ve çözümün güven düzeyini ayarlamak için kullanacağınız siteyi belirtebilirsiniz.

4. Güven düzeyini ayarlamak için Grup çözümü olarak dağıt seçeneği düğmesini seçin.

5. Varsayılan yerel SharePoint sitesini kabul etmek için Son düğmesini seçin.

6. Çözüm Gezgini SharePoint proje düğümünü seçin.

7. Menü çubuğunda Proje>Yeni Öğe Ekle'yi seçin.

   Yeni Öğe Ekle iletişim kutusu açılır.

8. Şablonlar bölmesinde İş Verileri Bağlan Üretkenlik Modeli (Yalnızca Grup Çözümü) öğesini seçin, projeye AdventureWorksContacts adını verin ve ekle düğmesini seçin.

Projeye veri erişim sınıfları ekleme

1. Menü çubuğunda Araçlar> Bağlan Veritabanı'nı seçin.

   Bağlan ekle iletişim kutusu açılır.

2. SQL Server AdventureWorks örnek veritabanına bir bağlantı ekleyin.

   Daha fazla bilgi için bkz. Bağlan (Microsoft SQL Server) Ekleme/Değiştirme.

3. Çözüm Gezgini'da proje düğümünü seçin.

4. Menü çubuğunda Proje>Yeni Öğe Ekle'yi seçin.

5. Yüklü Şablonlar bölmesinde Veri düğümünü seçin.

6. Şablonlar bölmesinde LINQ to SQL Sınıfları'nı seçin.

7. Ad kutusunda AdventureWorks'u belirtin ve ekle düğmesini seçin.

   Projeye bir .dbml dosyası eklenir ve Nesne İlişkisel Tasarımcısı (O/R Tasarım Aracı) açılır.

8. Menü çubuğunda Sunucu Gezginini Görüntüle'yi>seçin.

9. Sunucu Gezgini'nde AdventureWorks örnek veritabanını temsil eden düğümü genişletin ve ardından Tablolar düğümünü genişletin.

10. Kişi (Kişi) tablosunu O/R Tasarım Aracı ekleyin.

    Bir varlık sınıfı oluşturulur ve tasarım yüzeyinde görünür. Varlık sınıfı, Kişi (Kişi) tablosundaki sütunlara eşleyen özelliklere sahiptir.

İVB modelinden varsayılan varlığı kaldırma

İş Verileri Bağlan Üretkenlik Modeli projesi, modele Entity1 adlı bir varsayılan varlık ekler. Bu varlığı kaldırın. Daha sonra yeni bir varlık ekleyebilirsiniz. Boş bir modelle başlamak, izlenecek yolu tamamlamak için gereken adım sayısını azaltır.

1. Çözüm Gezgini BdcModel1 düğümünü genişletin ve BdcModel1.bdcm dosyasını açın.

2. İş Verileri Bağlan üretkenlik modeli dosyası İVB tasarımcısında açılır.

3. Tasarımcıda Entity1 kısayol menüsünü açın ve sil'i seçin.

4. Çözüm Gezgini'da Entity1.vb (Visual Basic'te) veya Entity1.cs (C#'de) kısayol menüsünü açın ve ardından Sil'i seçin.

5. Entity1Service.vb (Visual Basic'te) veya Entity1Service.cs (C# dilinde) kısayol menüsünü açın ve sil'i seçin.

Modele varlık ekleme

Modele bir varlık ekleyin. Visual Studio Araç Kutusu'ndan İVB tasarımcısına varlık ekleyebilirsiniz.

1. Menü çubuğunda Araç Kutusunu Görüntüle'yi>seçin.

2. Araç Kutusu'nun BusinessData Bağlan ivity sekmesinde, İVB tasarımcısına bir Varlık ekleyin.

   Yeni varlık tasarımcıda görünür. Visual Studio projeye EntityService.vb (Visual Basic'te) veya EntityService.cs (C#'de) adlı bir dosya ekler.

3. Menü çubuğunda Özellikler>Penceresini Görüntüle'yi>seçin.

4. Özellikler penceresinde, Ad özellik değerini Kişi olarak ayarlayın.

5. Tasarımcıda varlığın kısayol menüsünü açın, Ekle'yi ve ardından Tanımlayıcı'yı seçin.

   Varlıkta yeni bir tanımlayıcı görüntülenir.

6. Özellikler penceresinde, tanımlayıcının adını ContactID olarak değiştirin.

7. Tür Adı listesinde System.Int32'yi seçin.

Belirli bir Bulucu yöntemi ekleme

İVB hizmetinin belirli bir kişiyi görüntülemesini sağlamak için Belirli bir Bulucu yöntemi eklemeniz gerekir. İVB hizmeti, kullanıcı listedeki bir öğeyi seçtiğinde ve ardından Şeritteki Öğeyi Görüntüle düğmesini seçtiğinde Belirli Bulucu yöntemini çağırır.

İVB Yöntemi Ayrıntıları penceresini kullanarak Kişi varlığına Belirli bir Bulucu yöntemi ekleyin. Belirli bir varlığı döndürmek için yöntemine kod ekleyin.

1. İVB tasarımcısında Kişi varlığını seçin.

2. Menü çubuğunda Diğer Windows>İVB Yöntemi Ayrıntılarını Görüntüle'yi>seçin.

   İVB Yöntemi Ayrıntıları penceresi açılır.

3. Yöntem Ekle listesinde Belirli Bulucu Yöntemi Oluştur'u seçin.

   Visual Studio modele aşağıdaki öğeleri ekler. Bu öğeler İVB Yöntemi Ayrıntıları penceresinde görünür.

   • ReadItem adlı bir yöntem.

   • yöntemi için bir giriş parametresi.

   • yöntemi için bir dönüş parametresi.

   • Her parametre için bir tür tanımlayıcısı.

   • yöntemi için bir yöntem örneği.

4. İVB Yöntemi Ayrıntıları penceresinde, Kişi türü tanımlayıcısı için görüntülenen listeyi açın ve düzenle'yi seçin.

   İVB Gezgini açılır ve modelin hiyerarşik bir görünümünü sağlar.

5. Özellikler penceresinde TypeName özelliğinin yanındaki listeyi açın, Geçerli Proje sekmesini seçin ve ardından Kişi özelliğini seçin.

6. İVB Gezgini'nde, Kişi'nin kısayol menüsünü açın ve ardından Tür Tanımlayıcısı Ekle'yi seçin.

   İVB Gezgini'nde TypeDescriptor1 adlı yeni bir tür tanımlayıcısı görüntülenir.

7. Özellikler penceresinde Name özelliği değerini ContactID olarak ayarlayın.

8. TypeName özelliğinin yanındaki listeyi açın ve Int32'yi seçin.

9. Tanımlayıcı özelliğinin yanındaki listeyi açın ve ContactID'yi seçin.

10. Aşağıdaki alanların her biri için bir tür tanımlayıcısı oluşturmak için 6. adımı yineleyin.

    Veri Akışı Adı	Tür Adı
    FirstName	System
    LastName	System
    Phone	System
    EmailAddress	System
    EmailPromotion	System.Int32
    NameStyle	System.Boolean
    PasswordHash	System
    PasswordSalt	System

11. İVB tasarımcısında, Kişi varlığında ReadItem yöntemini açın.

    Kişi hizmeti kod dosyası Kod Düzenleyicisi'nde açılır.

12. ContactService sınıfında yöntemini aşağıdaki kodla değiştirinReadItem. Bu kod aşağıdaki görevleri gerçekleştirir:

    • AdventureWorks veritabanının Contact tablosundan bir kayıt alır.

    • İVB hizmetine bir Kişi varlığı döndürür.

    Not

    alanının değerini ServerName sunucunuzun adıyla değiştirin.

    C#

    public static Contact ReadItem(int contactID)
    {
        const string ServerName = "MySQLServerName";
        AdventureWorksDataContext dataContext = new AdventureWorksDataContext
              ("Data Source=" + ServerName + ";" +
               "Initial Catalog=AdventureWorks;Integrated Security=True");
    
        Contact Contact =
            (from contacts in dataContext.Contacts.AsEnumerable().Take(20)
             where contacts.ContactID == contactID
             select contacts).Single();
        return Contact;
    }
    

    VB

    Public Shared Function ReadItem(ByVal contactID As Integer) As Contact
        Const ServerName As String = "MySQLServerName"
        Dim dataContext As AdventureWorksDataContext = _
            New AdventureWorksDataContext("Data Source=" & ServerName & _
                ";Initial Catalog=AdventureWorks;Integrated Security=True")
    
        Dim Contact As Contact = _
            (From TempContacts In dataContext.Contacts.AsEnumerable().Take(20) _
            Where TempContacts.ContactID = contactID _
            Select TempContacts).[Single]()
        Return Contact
    End Function
    

Bulucu yöntemi ekleme

İVB hizmetinin listedeki kişileri görüntülemesini sağlamak için bir Bulucu yöntemi eklemeniz gerekir. İVB Yöntemi Ayrıntıları penceresini kullanarak Kişi varlığına bir Bulucu yöntemi ekleyin. İVB hizmetine varlık koleksiyonu döndürmek için yöntemine kod ekleyin.

1. İVB tasarımcısında Kişi varlığını seçin.

2. İVB Yöntemi Ayrıntıları penceresinde ReadItem düğümünü daraltın.

3. ReadList yönteminin altındaki Yöntem Ekle listesinde Bulucu Yöntemi Oluştur'u seçin.

   Visual Studio bir yöntem, dönüş parametresi ve tür tanımlayıcısı ekler.

4. İVB tasarımcısında, Kişi varlığında ReadList yöntemini açın.

   Kişi hizmetinin kod dosyası Kod Düzenleyicisi'nde açılır.

5. ContactService sınıfında yöntemini aşağıdaki kodla değiştirinReadList. Bu kod aşağıdaki görevleri gerçekleştirir:

   • AdventureWorks veritabanının Kişiler tablosundan veri alır.

   • İVB hizmetine Kişi varlıklarının listesini döndürür.

     Not

     alanının değerini ServerName sunucunuzun adıyla değiştirin.

     C#

     public static IEnumerable<Contact> ReadList()
     {
         const string ServerName = "MySQLServerName";
         AdventureWorksDataContext dataContext = new AdventureWorksDataContext
               ("Data Source=" + ServerName + ";" +
                "Initial Catalog=AdventureWorks;Integrated Security=True");
     
         IEnumerable<Contact> Contacts =
             from contacts in dataContext.Contacts.Take(20)
             select contacts;
         return Contacts;
     
     }
     

     VB

     Public Shared Function ReadList() As IEnumerable(Of Contact)
         Const ServerName As String = "MySQLServerName"
         Dim dataContext As AdventureWorksDataContext = _
             New AdventureWorksDataContext("Data Source=" & ServerName & _
                 ";Initial Catalog=AdventureWorks;Integrated Security=True")
     
         Dim Contacts As IEnumerable(Of Contact) = _
             From TempContacts In dataContext.Contacts.Take(20) _
                   Select TempContacts
         Return Contacts
     End Function
     

   ---

Projeyi test etme

Projeyi çalıştırdığınızda, SharePoint sitesi açılır ve Visual Studio modelinizi İş Verileri Bağlan ivity hizmetine ekler. SharePoint'te Kişi varlığına başvuran bir dış liste oluşturun. AdventureWorks veritabanındaki kişilerin verileri listede görünür.

Not

Çözümünüzün hatalarını ayıklamadan önce SharePoint'teki güvenlik ayarlarınızı değiştirmeniz gerekebilir. Daha fazla bilgi için bkz . İş verileri bağlantı modeli tasarlama.

1. F5 tuşunu seçin.

   SharePoint sitesi açılır.

2. Site Eylemleri menüsünde Diğer Seçenekler komutunu seçin.

3. Oluştur sayfasında Dış Liste şablonunu ve ardından Oluştur düğmesini seçin.

4. Özel listeye Kişiler adını verin.

5. Dış İçerik Türü alanının yanındaki gözat düğmesini seçin.

6. Dış İçerik Türü Seçici iletişim kutusunda AdventureWorksContacts.BdcModel1.Contact öğesini seçin ve ardından Oluştur düğmesini seçin.

   SharePoint, AdventureWorks örnek veritabanındaki kişileri içeren bir dış liste oluşturur.

7. Belirli Bulucu yöntemini test etmek için listeden bir kişi seçin.

8. Şeritte Öğeler sekmesini seçin ve ardından Öğeyi Görüntüle komutunu seçin.

   Seçtiğiniz kişinin ayrıntıları formda görünür.

İlgili içerik

• Nasıl yapılır: Oluşturucu yöntemi ekleme.
• Nasıl yapılır: Güncelleştirici yöntemi ekleme.
• Nasıl yapılır: Deleter yöntemi ekleme.
• İVB modeli tasarım araçlarına genel bakış
• İş verilerini SharePoint ile tümleştirme