Udostępnij za pośrednictwem

Przewodnik: tworzenie listy zewnętrznej w programie SharePoint przy użyciu danych biznesowych

  • Artykuł

Usługa Połączenie ivity (BDC) danych biznesowych umożliwia programowi SharePoint wyświetlanie danych biznesowych z aplikacji serwera zaplecza, usług sieci Web i baz danych programu SharePoint.

W tym przewodniku pokazano, jak utworzyć model dla usługi BDC, który zwraca informacje o kontaktach w przykładowej bazie danych. Następnie utworzysz listę zewnętrzną w programie SharePoint przy użyciu tego modelu.

W instruktażu przedstawiono następujące zagadnienia:

  • Tworzenie projektu.
  • Dodawanie jednostki do modelu.
  • Dodawanie metody wyszukiwania.
  • Dodawanie określonej metody wyszukiwania.
  • Testowanie projektu.

Wymagania wstępne

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

  • Obsługiwane wersje systemów Windows i SharePoint.

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

Tworzenie projektu zawierającego model usługi BDC

  1. Na pasku menu w programie Visual Studio wybierz pozycję Plik>nowy>projekt.

    Zostanie otwarte okno dialogowe Nowy projekt .

  2. W obszarze Visual C# lub Visual Basic rozwiń węzeł programu SharePoint, a następnie wybierz element 2010.

  3. W okienku Szablony wybierz pozycję Projekt programu SharePoint 2010, nadaj projektowi nazwę AdventureWorksTest, a następnie wybierz przycisk OK .

    Zostanie wyświetlony Kreator dostosowywania programu SharePoint. W tym kreatorze możesz określić witrynę, która będzie używana do debugowania projektu i ustawiać poziom zaufania rozwiązania.

  4. Wybierz przycisk Wdróż jako rozwiązanie farmy, aby ustawić poziom zaufania.

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

  6. W Eksplorator rozwiązań wybierz węzeł projektu programu SharePoint.

  7. Na pasku menu wybierz pozycję Projekt>Dodaj nowy element.

    Zostanie otwarte okno dialogowe Dodawanie nowego elementu .

  8. W okienku Szablony wybierz pozycję Dane biznesowe Połączenie ivity Model (tylko rozwiązanie farmy), nadaj projektowi nazwę AdventureWorksContacts, a następnie wybierz przycisk Dodaj.

Dodawanie klas dostępu do danych do projektu

  1. Na pasku menu wybierz pozycję Narzędzia> Połączenie do pozycji Baza danych.

    Zostanie otwarte okno dialogowe Dodawanie Połączenie ion.

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

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

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

  4. Na pasku menu wybierz pozycję Projekt>Dodaj nowy element.

  5. W okienku Zainstalowane szablony wybierz węzeł Dane .

  6. W okienku Szablony wybierz pozycję LINQ to SQL Classes( Klasy LINQ to SQL).

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

    Plik dbml jest dodawany do projektu, a zostanie otwarty Projektant relacyjne obiektów (O/R Projektant).

  8. Na pasku menu wybierz pozycję Wyświetl>Eksploratora serwera.

  9. W Eksploratorze serwera rozwiń węzeł reprezentujący przykładową bazę danych AdventureWorks, a następnie rozwiń węzeł Tabele .

  10. Dodaj tabelę Kontakt (osoba) do Projektant O/R.

    Klasa jednostki jest tworzona i wyświetlana na powierzchni projektowej. Klasa jednostki ma właściwości mapujące kolumny w tabeli Contact (Person).

Usuwanie jednostki domyślnej z modelu usługi BDC

Projekt model Połączenie ivity danych biznesowych dodaje do modelu domyślną jednostkę o nazwie Entity1. Usuń tę jednostkę. Później dodasz nową jednostkę. Począwszy od pustego modelu, zmniejsza liczbę kroków wymaganych do ukończenia przewodnika.

  1. W Eksplorator rozwiązań rozwiń węzeł BdcModel1, a następnie otwórz plik BdcModel1.bdcm.

  2. Plik modelu Połączenie ivity danych biznesowych zostanie otwarty w projektancie usługi BDC.

  3. W projektancie otwórz menu skrótów dla jednostki Entity1, a następnie wybierz pozycję Usuń.

  4. W Eksplorator rozwiązań otwórz menu skrótów dla jednostki Entity1.vb (w Visual Basic) lub Entity1.cs (w języku C#), a następnie wybierz pozycję Usuń.

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

Dodawanie jednostki do modelu

Dodaj jednostkę do modelu. Jednostki z przybornika programu Visual Studio można dodawać do projektanta usługi BDC.

  1. Na pasku menu wybierz pozycję Wyświetl>przybornik.

  2. Na karcie BusinessData Połączenie ivity przybornika dodaj jednostkę do projektanta usługi BDC.

    Nowa jednostka zostanie wyświetlona w projektancie. Program Visual Studio dodaje do projektu plik o nazwie EntityService.vb (w języku Visual Basic) lub EntityService.cs (w języku C#).

  3. Na pasku menu wybierz pozycję Wyświetl>okno właściwości.>

  4. W oknie Właściwości ustaw wartość właściwości Name na Contact.

  5. W projektancie otwórz menu skrótów dla jednostki, wybierz pozycję Dodaj, a następnie wybierz pozycję Identyfikator.

    W jednostce zostanie wyświetlony nowy identyfikator.

  6. W oknie Właściwości zmień nazwę identyfikatora na ContactID.

  7. Na liście Nazwa typu wybierz pozycję System.Int32.

Dodawanie określonej metody wyszukiwania

Aby umożliwić usłudze BDC wyświetlanie określonego kontaktu, należy dodać metodę określonej metody wyszukiwania. Usługa BDC wywołuje metodę Określonej metody wyszukiwania, gdy użytkownik wybierze element na liście, a następnie wybierze przycisk Wyświetl element na wstążce.

Dodaj konkretną metodę wyszukiwania do jednostki Contact przy użyciu okna Szczegóły metody usługi BDC. Aby zwrócić określoną jednostkę, dodaj kod do metody .

  1. W projektancie usługi BDC wybierz jednostkę Kontakt .

  2. Na pasku menu wybierz pozycję Wyświetl>inne szczegóły metody usługi Windows>BDC.

    Zostanie otwarte okno Szczegóły metody usługi BDC.

  3. Na liście Dodaj metodę wybierz pozycję Utwórz konkretną metodę wyszukiwania.

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

    • Metoda o nazwie ReadItem.

    • Parametr wejściowy dla metody .

    • Parametr zwracany dla metody .

    • Deskryptor typów dla każdego parametru.

    • Wystąpienie metody dla metody .

  4. W oknie Szczegóły metody usługi BDC otwórz listę wyświetlaną dla deskryptora typu Kontakt, a następnie wybierz pozycję Edytuj.

    Zostanie otwarty Eksplorator usługi BDC i udostępni hierarchiczny widok modelu.

  5. W oknie Właściwości otwórz listę obok właściwości TypeName, wybierz kartę Bieżący projekt, a następnie wybierz właściwość Contact.

  6. W Eksploratorze usługi BDC otwórz menu skrótów kontaktu, a następnie wybierz pozycję Dodaj deskryptor typów.

    Nowy deskryptor typu o nazwie TypeDescriptor1 pojawia się w Eksploratorze usługi BDC.

  7. W oknie Właściwości ustaw wartość właściwości Name na ContactID.

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

  9. Otwórz listę obok właściwości Identifier , a następnie wybierz pozycję ContactID.

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

    Nazwisko Nazwa typu
    FirstName System.string
    LastName System.string
    Phone System.string
    EmailAddress (Adres e-mail) System.string
    E-mailPromotion System.Int32
    Styl nazwy System.Boolean
    PasswordHash System.string
    PasswordSalt System.string

  11. W projektancie usługi BDC w jednostce Contact otwórz metodę ReadItem .

    Zostanie otwarty plik kodu usługi Kontakt w Edytorze kodu.

  12. ContactService W klasie zastąp metodę ReadItem następującym kodem. Ten kod wykonuje następujące zadania:

    • Pobiera rekord z tabeli Contact bazy danych AdventureWorks.

    • Zwraca jednostkę Contact do usługi BDC.

    Uwaga

    Zastąp wartość ServerName pola nazwą serwera.

    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 umożliwić usłudze BDC wyświetlanie kontaktów na liście, należy dodać metodę wyszukiwania. Dodaj metodę wyszukiwania do jednostki Contact przy użyciu okna Szczegóły metody usługi BDC. Aby zwrócić kolekcję jednostek do usługi BDC, dodaj kod do metody .

  1. W projektancie usługi BDC wybierz jednostkę Kontakt .

  2. W oknie Szczegóły metody usługi BDC zwiń węzeł ReadItem.

  3. Na liście Dodaj metodę w metodzie ReadList wybierz pozycję Utwórz metodę wyszukiwania.

    Program Visual Studio dodaje metodę, parametr zwracany i deskryptor typów.

  4. W projektancie usługi BDC w jednostce Contact otwórz metodę ReadList .

    Plik kodu usługi Kontakt zostanie otwarty w Edytorze kodu.

  5. ContactService W klasie zastąp metodę ReadList następującym kodem. Ten kod wykonuje następujące zadania:

    • Pobiera dane z tabeli Contacts bazy danych AdventureWorks.

    • Zwraca listę jednostek Kontakt do usługi BDC.

      Uwaga

      Zastąp wartość ServerName pola nazwą serwera.

      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, a program Visual Studio doda model do usługi Połączenie ivity danych biznesowych. Utwórz listę zewnętrzną w programie SharePoint, która odwołuje się do jednostki Contact. Dane dotyczące kontaktów w bazie danych AdventureWorks są wyświetlane na liście.

Uwaga

Zanim będzie można debugować rozwiązanie, może być konieczne zmodyfikowanie ustawień zabezpieczeń w programie SharePoint. Aby uzyskać więcej informacji, zobacz Projektowanie modelu łączności danych biznesowych.

  1. Wybierz klawisz F5.

    Zostanie otwarta witryna programu SharePoint.

  2. W menu Akcje witryny wybierz polecenie Więcej opcji.

  3. Na stronie Tworzenie wybierz szablon Lista zewnętrzna, a następnie wybierz przycisk Utwórz.

  4. Nazwij listę niestandardową Kontakty.

  5. Wybierz przycisk przeglądania obok pola Typ zawartości zewnętrznej.

  6. W oknie dialogowym Selektor typów zawartości zewnętrznej wybierz element AdventureWorksContacts.BdcModel1.Contact, a następnie wybierz przycisk Utwórz.

    Program SharePoint tworzy listę zewnętrzną zawierającą kontakty z przykładowej bazy danych AdventureWorks.

  7. Aby przetestować metodę Określonej metody wyszukiwania, wybierz kontakt na liście.

  8. Na wstążce wybierz kartę Elementy , a następnie wybierz polecenie Wyświetl element .

    Szczegóły wybranego kontaktu są wyświetlane w formularzu.

Powiązana zawartość