Wskazówki: tworzenie listy zewnętrznej w SharePoint za pomocą danych biznesowych

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

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

W przewodniku przedstawiono następujące zagadnienia:

• Tworzenie projektu.

• Dodawanie jednostki do modelu.

• Dodawanie metody wyszukiwania.

• Dodawanie metody wyszukiwania.

• Testowanie projektu.

Wymagania wstępne

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

• Obsługiwane edycje systemu Windows i programu SharePoint.Aby uzyskać więcej informacji, zobacz Wymagania związane z opracowywaniem rozwiązań SharePoint.

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

• Dostęp do przykładowej bazy danych AdventureWorks.Aby uzyskać więcej informacji dotyczących sposobu instalowania bazy danych AdventureWorks, zobacz Baz danych programu SQL Server próbki.

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. W obszarze albo programu Visual C# lub języka Visual Basic, rozwiń programu SharePoint węzła, a następnie wybierz 2010 elementu.

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

   Wyświetla sięKreator ustawień niestandardowych SharePoint .Tego kreatora można określić witryny, które będzie używane do debugowania projektu i ustaw poziom zaufania roztworu.

4. Wybierz wdrożyć rozwiązanie farmy przycisk opcji, aby ustawić poziom zaufania.

5. Wybierz przycisk Zakończ , aby zaakceptować domyślną lokalną witrynę programu SharePoint.

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

7. Na pasku menu, kliknij Projekt, Dodaj nowy element.

   Otworzy się okno dialogowe Dodaj nowy element.

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 dostępu do danych do projektu

Aby dodać klasy dostępu do danych do projektu

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

   Dodawanie połączenia zostanie otwarte okno dialogowe.

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

   Aby uzyskać więcej informacji, zobacz Dodaj/modyfikuj połączenie (Microsoft SQL Server).

3. W Eksploratorze rozwiązań wybierz węzeł projektu.

4. Na pasku menu, kliknij Projekt, Dodaj nowy element.

5. W Zainstalowane szablony okienka, wybierz polecenie danych węzła.

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

7. W Nazwa polu Określ AdventureWorks, a następnie wybierz polecenie Dodaj przycisk.

   Plik .dbml jest dodawane do projektu i otwiera w programie Object Relational Designer (Projektant O/R).

8. Na pasku menu wybierz widoku, Server Explorer.

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

10. Dodaj kontaktu (osoby) tabelę do konstruktora O/R.

    Klasą jednostki jest tworzony i wyświetlany na powierzchni projektowej.Klasa podmiot 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 projektu dodaje podmiot domyślny o nazwie Entity1 do modelu.Usuń tę jednostkę.Później dodasz nowy podmiot.Począwszy od pusty model zmniejsza liczbę kroków w celu ukończenia Instruktaż.

Aby usunąć jednostkę domyślną z modelu

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

2. Otwiera plik modelu usługi łączności danych biznesowych 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 jednostkę do modelu.Z programu Visual Studio może dodawać jednostki Przybornik do konstruktora usługi łączności danych biznesowych.

Aby dodać obiekt do modelu

1. Na pasku menu wybierz Widok, Przybornik.

2. Na BusinessDataConnectivity na karcie Przybornik, dodać jednostek do konstruktora usługi łączności danych biznesowych.

   Nowy podmiot pojawia się w projektancie.Program 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 widoku, 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 obiektu, wybierz polecenie Dodaj, a następnie wybierz polecenie identyfikatora.

   Identyfikator nowego pojawia się na obiekt.

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

7. W Nazwy typu listy, wybierz opcję System.Int32.

Dodawanie określonej metody wyszukiwania

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

Dodawanie metody wyszukiwania do obiektu kontakt przy użyciu Usługi BDC szczegóły metody okna.Aby zwrócić określonej encji, Dodaj kod do metody.

Aby dodać określoną metodę wyszukiwania

1. W Projektancie BDC wybierz kontakt encji.

2. Na pasku menu wybierz widoku, Windows inne, Usługi BDC szczegóły metody.

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

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

   Program Visual Studio dodaje następujące elementy do modelu.Te elementy są wyświetlane w Usługi BDC szczegóły metody okna.

   • Metoda o nazwie ReadItem.

   • Parametr wejściowy metody.

   • Parametr zwrotny metody.

   • Deskryptor typu dla każdego parametru.

   • Wystąpienia metody dla metody.

4. W Usługi BDC szczegóły metody okna, otwarcie listy, które pojawiają się kontakt deskryptora typu, a następnie wybierz edytować.

   BDC Explorer otwiera i udostępnia hierarchiczny widok modelu.

5. W Właściwości okna, dalej, aby otworzyć listę TypeName właściwości, wybierz polecenie Bieżącego projektu kartę, a następnie wybierz kontakt właściwości.

6. W Explorer usługi BDC, otwórz menu skrótów kontakt, a następnie wybierz polecenie Dodać deskryptor typu.

   Nowy deskryptor typu o nazwie TypeDescriptor1 pojawia się w BDC Explorer.

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

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

9. Otwórz listę obok identyfikatora 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
    Telefon	System.String
    AdresEmail	System.String
    EmailPromotion	System.Int32
    NameStyle	Typu System.Boolean
    PasswordHash	System.String
    PasswordSalt	System.String

11. W Projektancie BDC na kontakt encji, otwórz ReadItem metody.

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

12. W ContactService klasę, Zamień ReadItem metoda z następującego kodu.Ten kod wykonuje poniższe zadania:

    • Pobiera rekordu z tabeli Kontakt bazy danych AdventureWorks.

    • Zwraca obiekt kontaktu do usługi BDC.

    [!UWAGA]

    Zamień wartość ServerName 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;
    }
    

Dodawanie 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ą Usługi BDC szczegóły metody okna.Aby przywrócić zbioru obiektów usługi BDC, Dodaj kod do metody.

Aby dodać metodę wyszukiwania

1. W Projektancie BDC wybierz kontakt encji.

2. W Usługi BDC szczegóły metody okna, Zwiń ReadItem węzła.

3. W Dodaj metodę lista pod ReadList metoda, wybierz polecenie Utworzyć metody wyszukiwania.

   Visual Studio dodaje metody, parametr zwrotny i deskryptora typu.

4. W Projektancie BDC na kontakt encji, otwórz ReadList metody.

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

5. W ContactService klasę, Zamień ReadList metoda z następującego kodu.Ten kod wykonuje poniższe zadania:

   • Pobiera dane z tabeli Kontakty bazy danych AdventureWorks.

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

   [!UWAGA]

   Zamień wartość ServerName 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, otwieranie witryny programu SharePoint i Visual Studio dodaje model usługi łączności danych biznesowych.Tworzenie listy zewnętrznej programu SharePoint, która odwołuje się do obiektu Kontakt.Dane dotyczące kontaktów w bazie danych AdventureWorks są wyświetlane na liście.

[!UWAGA]

Być może trzeba zmodyfikować ustawienia zabezpieczeń w programie SharePoint przed można debugować swoje rozwiązanie. Aby uzyskać więcej informacji, zobacz Projektowanie modelu łączności danych biznesowych.

Aby przetestować projekt

1. Wybierz klawisz F5.

   Witryna SharePoint otwiera się.

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

3. Na Utwórz wybierz Listy zewnętrznej szablon, a następnie wybierz polecenie Utwórz przycisk.

4. Nazwa niestandardowej listy kontaktów.

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

6. W Zewnętrzne Selektor typów zawartości okno dialogowe Wybierz AdventureWorksContacts.BdcModel1.Contact przedmiotu, a następnie wybierz Create przycisk.

   SharePoint tworzy listy zewnętrznej zawierający kontakty z przykładowej bazy danych AdventureWorks.

7. Aby przetestować metody wyszukiwania, wybierz kontakt z listy.

8. Na Wstążce wybierz elementy kartę, a następnie wybierz Elementu widoku polecenia.

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

Następne kroki

Można dowiedzieć się więcej o tym, jak się zaprojektować modele usługi BDC w programie SharePoint z tych tematów:

• Porady: dodawanie metody Creator.

• Porady: dodawanie metody Updater.

• Porady: dodawanie metody Deleter.

Zobacz też

Koncepcje

Omówienie narzędzi projektowania modelu BDC

Inne zasoby

Projektowanie modelu łączności danych biznesowych

Tworzenie modelu łączności danych biznesowych

Integrowanie danych biznesowych z SharePoint