Instruktaż: Tworzenie zewnętrznych listy programu SharePoint przy użyciu danych biznesowych

Usługa łączności danych biznesowych (BDC) umożliwia programu SharePoint wyświetlić dane biznesowe z aplikacji serwera typu back-end, usług sieci Web i baz danych.

W tym instruktażu przedstawiono sposób utworzyć model usługi BDC, który zwraca informacje o kontaktach w przykładowej bazy danych.Spowoduje to utworzenie listy zewnętrznej programu SharePoint za pomocą danego modelu.

W przewodniku przedstawiono następujące zagadnienia:

• Tworzenie projektu.

• Dodawanie jednostki do modelu.

• Dodanie metody wyszukiwania.

• Dodanie metody określonej metody wyszukiwania.

• Testowanie projektu.

Wymagania wstępne

Następujące składniki są wymagane do przeprowadzenia tego instruktażu:

• Obsługiwane wersje systemu Windows i programu SharePoint.Aby uzyskać więcej informacji, zobacz Wymagania dotyczące rozwiązań programu SharePoint.

• Visual Studio Professional, Visual Studio Ultimate, or Visual Studio Premium.

• Dostęp do bazy danych AdventureWorks.Aby uzyskać więcej informacji na temat instalowania bazy danych AdventureWorks, zobacz Programu SQL Server przykładowe bazy danych.

Tworzenie projektu, który zawiera Model usługi BDC

Aby utworzyć projekt, który zawiera model usługi BDC

1. Na pasku menu w programie Visual Studio wybierz Plik, Nowy, Projekt.

   Zostanie otwarte okno dialogowe Nowy projekt.

2. Mocy jednej Visual C# lub języka Visual Basic, rozwiń węzeł SharePoint węzła, a następnie wybierz polecenie 2010 elementu.

3. W Szablony okienka, wybierz polecenie Programu SharePoint 2010 projektu, nazwa projektu AdventureWorksTest, a następnie wybierz OK przycisk.

   Kreator dostosowania programu SharePoint jest wyświetlany.Za pomocą tego kreatora można określić witrynę, będziesz używać do debugowania projektu i ustawić poziom zaufania roztworu.

4. Wybierz polecenie Wdrażanie rozwiązań farmy jako przycisk opcji, aby ustawić poziom zaufania.

5. Wybierz polecenie Zakończ przycisk, aby zaakceptować domyślny lokalnej witryny programu SharePoint.

6. W Solution Explorer, wybierz węzeł projektu programu SharePoint.

7. Na pasku menu wybierz polecenie Projekt, Add New Item.

   Add New Item zostanie otwarte okno dialogowe.

8. W Szablony okienka, wybierz polecenie Model usługi łączności danych biznesowych (farmy rozwiązanie tylko), nazwa projektu AdventureWorksContacts, a następnie wybierz Dodaj przycisk.

Dodawanie klas danych programu Access do projektu

Aby dodać klasy dostępu do danych w projekcie

1. Na pasku menu wybierz polecenie Narzędzia, Nawiązywanie połączenia z bazą danych.

   Dodawanie połączenia zostanie otwarte okno dialogowe.

2. Dodać połączenie z przykładową bazą danych programu SQL Server AdventureWorks.

   Aby uzyskać więcej informacji, zobacz Dodawanie/modyfikowanie połączenia (Microsoft SQL Server).

3. W Solution Explorer, wybór węzła projektu.

4. Na pasku menu wybierz polecenie Projekt, Add New Item.

5. W Szablonów okienka, wybierz polecenie danych węzła.

6. W Szablony okienka, wybierz polecenie programu LINQ to SQL klas.

7. W Nazwa pole, określ AdventureWorks i wybierz polecenie Dodaj przycisk.

   Plik .dbml jest dodawany do projektu, a zostanie otwarty w programie Object Relational Designer (Projektant O/R).

8. Na pasku menu wybierz polecenie View, Server Explorer.

9. W Server Explorer, rozwiń węzeł, który reprezentuje AdventureWorks przykładowa baza danych, a następnie rozwiń tabele węzła.

10. Dodać kontaktu (osoby) tabeli na projektanta O/R.

    Jednostka klasy jest tworzony i wyświetlany na powierzchni projektowej.Klasa encji ma właściwości, które są mapowane do kolumn w tabeli kontaktu (osoby).

Usuwanie jednostki domyślnej z modelu usługi BDC

Model usługi łączności danych biznesowych project dodaje podmiot domyślny o nazwie Entity1 do modelu.Usuń tę jednostkę.Później należy dodać nowy podmiot.Począwszy od pustego modelu zmniejsza liczbę kroków w celu wykonania czynności opisanych w instruktażu.

Aby usunąć z modelu jednostki domyślnej

1. W Solution Explorer, rozwiń węzeł BdcModel1 węzła, a następnie otwórz plik BdcModel1.bdcm.

2. Plik modelu usługi łączności danych biznesowych zostanie otwarty w Projektancie usługi łączności danych biznesowych.

3. W projektancie, otwórz menu skrótów dla Entity1, a następnie wybierz polecenie usunąć.

4. W Solution Explorer, otwórz menu skrótów dla Entity1.vb (w języku Visual Basic) lub Entity1.cs (w języku C#), a następnie wybierz usunąć.

5. Otwórz menu skrótów dla Entity1Service.vb (w języku Visual Basic) lub Entity1Service.cs (w języku C#), a następnie wybierz usunąć.

Dodawanie jednostki do modelu

Dodaj obiekt do modelu.Może dodawać jednostki z programu Visual Studio Przybornik na projektanta usługi łączności danych biznesowych.

Aby dodać obiekt do modelu

1. Na pasku menu wybierz polecenie View, Przybornik.

2. Na BusinessDataConnectivity karta Przybornik, dodać encji na projektanta usługi łączności danych biznesowych.

   Nowy obiekt pojawia się w projektancie.Visual Studio dodaje plik, który jest nazwany EntityService.vb (w języku Visual Basic) lub EntityService.cs (w języku C#) w projekcie.

3. Na pasku menu wybierz polecenie View, Właściwości, okna.

4. W Właściwości okno, ustawić Nazwa wartość właściwości do kontaktu.

5. W projektancie, otwórz menu skrótów dla encji, wybierz polecenie Dodaj, a następnie wybierz polecenie identyfikator.

   Identyfikator nowego pojawia się na obiekt.

6. W Właściwości okna, Zmień nazwę identyfikatora na ContactID.

7. W Nazwy typu listy, wybierz polecenie System.Int32.

Dodanie określonej metody wyszukiwania

Aby włączyć usługi BDC do wyświetlania określonego kontaktu, należy dodać określono metody wyszukiwania.Usługa BDC wywołuje metodę określonej metody wyszukiwania, gdy użytkownik wybierze element na liście, a następnie wybiera Wyświetl element przycisk na Wstążce.

Dodać metodę określonej metody wyszukiwania do obiektu kontakt za pomocą Szczegóły metody usługi łączności danych biznesowych okna.Aby przywrócić określonej encji, Dodaj kod do metody.

Aby dodać metodę określonej metody wyszukiwania

1. W Projektancie usługi łączności danych biznesowych, wybierz polecenie kontakt encji.

2. Na pasku menu wybierz polecenie View, Other Windows, Szczegóły metody usługi łączności danych biznesowych.

   Zostanie otwarte okno Szczegóły metody usługi łączności danych biznesowych.

3. W Dodaj metodę listy, wybierz polecenie Utworzyć określonej metody wyszukiwania.

   Visual Studio dodaje następujące elementy do modelu.Te elementy są wyświetlane w Szczegóły metody usługi łączności danych biznesowych okna.

   • Metodę o nazwie ReadItem.

   • Parametr wejściowy dla metody.

   • Parametru zwrotnego dla metody.

   • Deskryptor typu dla każdego parametru.

   • Wystąpienia metody dla metody.

4. W Szczegóły metody usługi łączności danych biznesowych okna, otwórz listę, które pojawiają się kontakt wpisz deskryptora, a następnie wybierz polecenie edytować.

   Explorer usługi łączności danych biznesowych otwiera i ustala hierarchiczny widok modelu.

5. W Właściwości okna, otwórz listę obok TypeName właściwość, wybierz polecenie Bieżącego projektu kartę, a następnie wybierz kontakt właściwość.

6. W Explorer usługi łączności danych biznesowych, otwórz menu skrótów z kontakt, a następnie wybierz polecenie Dodać deskryptor typu.

   Nowy deskryptor typu o nazwie TypeDescriptor1 pojawia się w Explorer usługi łączności danych biznesowych.

7. W Właściwości okno, ustawić Nazwa wartość właściwości, aby ContactID.

8. Otwórz listę obok TypeName właściwość, a następnie wybierz polecenie Int32.

9. Otwórz listę obok identyfikator właściwość, a następnie wybierz polecenie ContactID.

10. Powtórz krok 6, aby utworzyć deskryptora typu dla każdego z następujących pól.

    Nazwa	Nazwa typu
    Imię	System.String
    Nazwisko	System.String
    Phone	System.String
    AdresEmail	System.String
    EmailPromotion	System.Int32
    NameStyle	Typu System.Boolean
    PasswordHash	System.String
    PasswordSalt	System.String

11. W Projektancie usługi łączności danych biznesowych na kontakt encji, otwórz ReadItem metoda.

    Plik kod usługi kontakt zostanie otwarty w edytorze kodu.

12. W ContactService klasę, Zamień ReadItem metoda następujący kod.Ten kod wykonuje następujące zadania:

    • Pobiera rekordu z tabeli Kontakt bazy danych AdventureWorks.

    • Przywraca obiektu kontakt usługi BDC.

    [!UWAGA]

    Zamień wartość ServerName pole z nazwą serwera.

    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
    

    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;
    }
    

Dodanie metody wyszukiwania

Aby włączyć usługi BDC wyświetlić kontakty na liście, należy dodać metodę wyszukiwania.Dodać metodę wyszukiwania obiektu kontakt za pomocą Szczegóły metody usługi łączności danych biznesowych okna.Aby przywrócić zbioru obiektów usługi BDC, Dodaj kod do metody.

Aby dodać metodę wyszukiwania

1. W Projektancie usługi łączności danych biznesowych, wybierz polecenie kontakt encji.

2. W Szczegóły metody usługi łączności danych biznesowych okna, Zwiń ReadItem węzła.

3. W Dodaj metodę listy w obszarze ReadList metoda, wybierz polecenie Utworzyć metody wyszukiwania.

   Visual Studio dodaje metodę, parametru zwrotnego i deskryptora typu.

4. W Projektancie usługi łączności danych biznesowych na kontakt encji, otwórz ReadList metoda.

   Plik kodu dla usługi kontakt zostanie otwarty w edytorze kodu.

5. W ContactService klasę, Zamień ReadList metoda następujący kod.Ten kod wykonuje następujące zadania:

   • Pobiera dane z tabeli Kontakty bazy danych AdventureWorks.

   • Zwraca listę podmiotów kontakt do usługi BDC.

   [!UWAGA]

   Zamień wartość ServerName pole z nazwą serwera.

   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
   

   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;
   
   }
   

Testowanie projektu

Po uruchomieniu projektu, zostanie otwarta witryna programu SharePoint i Visual Studio dodaje modelu do usługi łączności danych biznesowych.Tworzenie listy zewnętrznej programu SharePoint, która odwołuje się do obiektu Kontakt.Dane dla kontaktów w bazie danych AdventureWorks są wyświetlane na liście.

[!UWAGA]

Trzeba będzie zmodyfikować ustawienia zabezpieczeń w programie SharePoint, zanim można debugować swoje rozwiązanie.Aby uzyskać więcej informacji, zobacz Projektowanie modelu połączeń danych biznesowych.

Aby przetestować projekt

1. Wybierz polecenie F5 klucz.

   Otwieranie witryny programu SharePoint.

2. Na Akcje witryny menu, wybierz polecenie Więcej opcji polecenia.

3. Na Tworzenie wybierz Listy zewnętrznej szablonu, a następnie wybierz polecenie Tworzenie przycisk.

4. Nazwa niestandardowej listy kontaktów.

5. Kliknij przycisk Przeglądaj obok Typu zawartości zewnętrznej pole.

6. W Selektor typów zawartości zewnętrznej okno dialogowe Wybierz AdventureWorksContacts.BdcModel1.Contact element, a następnie wybierz Tworzenie przycisk.

   Program SharePoint tworzy listy zewnętrznej, który zawiera kontakty z przykładowej bazy danych AdventureWorks.

7. Aby przetestować metodę określonej metody wyszukiwania, wybierz kontakt z listy.

8. Na Wstążce, wybierz polecenie elementy kartę, a następnie wybierz Wyświetl element polecenia.

   Na formularzu są wyświetlane szczegóły dotyczące kontaktu, który został wybrany.

Następne kroki

Można uzyskać więcej informacji o się zaprojektować modele usługi BDC w programie SharePoint następujących tematów:

• Jak: Dodaj metodę Creator.

• Jak: Dodaj metodę Updater.

• Jak: Dodaj metodę Deleter.

Zobacz też

Koncepcje

Omówienie narzędzi projektowania modelu kontrolera BDC

Inne zasoby

Projektowanie modelu połączeń danych biznesowych

Tworzenie modelu połączeń danych biznesowych

Integrowanie danych biznesowych programu SharePoint