Návod: Vytvoření externího seznamu v SharePointu pomocí obchodních dat

Služba BDC (Business Data Připojení ivity) umožňuje SharePointu zobrazit obchodní data z back-endových serverových aplikací, webových služeb a databází.

Tento názorný postup ukazuje, jak vytvořit model pro službu BDC, která vrací informace o kontaktech v ukázkové databázi. Pak pomocí tohoto modelu vytvoříte externí seznam v SharePointu.

Tento návod znázorňuje následující úlohy:

• Vytvoření projektu
• Přidání entity do modelu
• Přidání vyhledávací metody
• Přidání konkrétní vyhledávací metody
• Testování projektu

Požadavky

K dokončení tohoto návodu budete potřebovat následující komponenty:

• Podporované edice Windows a SharePointu

• Přístup k ukázkové databázi AdventureWorks Další informace o instalaci databáze AdventureWorks naleznete v tématu Ukázkové databáze SQL Serveru.

Vytvoření projektu, který obsahuje model služby BDC

1. Na řádku nabídek v sadě Visual Studio zvolte Soubor>nový>projekt.

   Otevře se dialogové okno Nový projekt .

2. V části Visual C# nebo Visual Basic rozbalte uzel SharePointu a pak zvolte položku 2010.

3. V podokně Šablony zvolte SharePoint 2010 Project, pojmenujte projekt AdventureWorksTest a pak zvolte tlačítko OK.

   Zobrazí se Průvodce přizpůsobením SharePointu. V tomto průvodci můžete určit web, který použijete k ladění projektu, a nastavit úroveň důvěryhodnosti řešení.

4. Zvolte tlačítko Nasadit jako řešení farmy a nastavte úroveň důvěryhodnosti.

5. Pokud chcete přijmout výchozí místní sharepointový web, zvolte tlačítko Dokončit.

6. V Průzkumník řešení zvolte uzel projektu Služby SharePoint.

7. Na řádku nabídek zvolte Přidat novou položku projektu>.

   Otevře se dialogové okno Přidat novou položku .

8. V podokně Šablony zvolte Model obchodních dat Připojení ivity (pouze model farmy), pojmenujte projekt AdventureWorksContacts a pak zvolte tlačítko Přidat.

Přidání tříd přístupu k datům do projektu

1. Na řádku nabídek zvolte Nástroje> Připojení do databáze.

   Otevře se dialogové okno Přidat Připojení ion.

2. Přidejte připojení k ukázkové databázi SQL Server AdventureWorks.

   Další informace naleznete v tématu Přidání nebo úprava Připojení ion (Microsoft SQL Server).

3. V Průzkumník řešení zvolte uzel projektu.

4. Na řádku nabídek zvolte Přidat novou položku projektu>.

5. V podokně Nainstalované šablony zvolte uzel Data.

6. V podokně Šablony zvolte LINQ to SQL Classes.

7. Do pole Název zadejte AdventureWorks a pak zvolte tlačítko Přidat.

   Do projektu se přidá soubor .dbml a otevře se Návrhář relací objektů (Návrhář relací objektů).

8. Na řádku nabídek zvolte Zobrazit>Průzkumníka serveru.

9. V Průzkumníku serveru rozbalte uzel, který představuje ukázkovou databázi AdventureWorks, a poté rozbalte uzel Tabulky .

10. Přidejte tabulku Kontakt (osoba) do Návrháře relací objektů.

    Vytvoří se třída entity a zobrazí se na návrhové ploše. Třída entity má vlastnosti, které se mapuje na sloupce v tabulce Kontakt (Osoba).

Odebrání výchozí entity z modelu služby BDC

Projekt Modelu Připojení ivity obchodních dat přidá do modelu výchozí entitu s názvem Entity1. Odeberte tuto entitu. Později přidáte novou entitu. Počínaje prázdným modelem snižuje počet kroků potřebných k dokončení návodu.

1. V Průzkumník řešení rozbalte uzel BdcModel1 a pak otevřete soubor BdcModel1.bdcm.

2. Soubor modelu Připojení ivity obchodních dat se otevře v návrháři služby BDC.

3. V návrháři otevřete místní nabídku entity1 a pak zvolte Odstranit.

4. V Průzkumník řešení otevřete místní nabídku entity1.vb (v jazyce Visual Basic) nebo Entity1.cs (v jazyce C#) a pak zvolte Odstranit.

5. Otevřete místní nabídku entity1Service.vb (v jazyce Visual Basic) nebo Entity1Service.cs (v jazyce C#) a pak zvolte Odstranit.

Přidání entity do modelu

Přidejte do modelu entitu. Do návrháře služby BDC můžete přidat entity ze sady nástrojů sady Visual Studio.

1. Na řádku nabídek zvolte Zobrazit>panel nástrojů.

2. Na kartě BusinessData Připojení ivity panelu nástrojů přidejte entitu do návrháře služby BDC.

   Nová entita se zobrazí v návrháři. Visual Studio přidá do projektu soubor s názvem EntityService.vb (v jazyce Visual Basic) nebo EntityService.cs (v jazyce C#).

3. Na řádku nabídek zvolte Okno Zobrazit>vlastnosti>.

4. V okně Vlastnosti nastavte hodnotu vlastnosti Název na Kontakt.

5. V návrháři otevřete místní nabídku entity, zvolte Přidat a pak zvolte Identifikátor.

   V entitě se zobrazí nový identifikátor.

6. V okně Vlastnosti změňte název identifikátoru na ContactID.

7. V seznamu Název typu zvolte System.Int32.

Přidání konkrétní vyhledávací metody

Chcete-li službě BDC povolit zobrazení konkrétního kontaktu, musíte přidat konkrétní vyhledávací metodu. Služba služby BDC volá metodu Specific Finder, když uživatel vybere položku v seznamu a pak zvolí tlačítko Zobrazit položku na pásu karet.

Přidejte do entity Kontakt metodu Specific Finder pomocí okna Podrobnosti metody služby BDC. Pokud chcete vrátit konkrétní entitu, přidejte do metody kód.

1. V návrháři služby BDC zvolte entitu Kontakt .

2. Na řádku nabídek zvolte Zobrazit>další podrobnosti metody služby BDC systému Windows.>

   Otevře se okno Podrobnosti metody služby BDC.

3. V seznamu Přidat metodu zvolte Vytvořit konkrétní vyhledávací metodu.

   Visual Studio přidá do modelu následující prvky. Tyto prvky se zobrazí v okně Podrobnosti metody služby BDC.

   • Metoda s názvem ReadItem.

   • Vstupní parametr pro metodu.

   • Návratový parametr pro metodu.

   • Popisovač typu pro každý parametr.

   • Instance metody pro metodu.

4. V okně Podrobnosti metody služby BDC otevřete seznam, který se zobrazí pro popisovač typu kontaktu, a pak zvolte Upravit.

   Otevře se Průzkumník služby BDC a zobrazí hierarchické zobrazení modelu.

5. V okně Vlastnosti otevřete seznam vedle vlastnosti TypeName, zvolte kartu Aktuální projekt a pak zvolte vlastnost Kontakt.

6. V Průzkumníku služby BDC otevřete místní nabídku kontaktu a pak zvolte Přidat popisovač typu.

   V Průzkumníku služby BDC se zobrazí nový popisovač typu TypeDescriptor1.

7. V okně Vlastnosti nastavte hodnotu vlastnosti Name na ContactID.

8. Otevřete seznam vedle vlastnosti TypeName a pak zvolte Int32.

9. Otevřete seznam vedle vlastnosti Identifikátor a pak zvolte ContactID.

10. Opakováním kroku 6 vytvořte popisovač typu pro každé z následujících polí.

    Název	Název typu
    FirstName	System.string
    LastName	System.string
    telefonní	System.string
    EmailAddress	System.string
    EmailPromotion	System.Int32
    NameStyle	System.Boolean
    PasswordHash (Hodnota hash hesla)	System.string
    PasswordSalt	System.string

11. V návrháři služby BDC otevřete v entitě Kontakt metodu ReadItem .

    Soubor kódu služby Kontakt se otevře v Editoru kódu.

12. ContactService Ve třídě nahraďte metodu ReadItem následujícím kódem. Tento kód provádí následující úlohy:

    • Načte záznam z tabulky Kontaktů databáze AdventureWorks.

    • Vrátí entitu Kontakt do služby BDC.

    Poznámka:

    Nahraďte hodnotu ServerName pole názvem vašeho serveru.

    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
    

Přidání vyhledávací metody

Pokud chcete službě BDC povolit zobrazení kontaktů v seznamu, musíte přidat vyhledávací metodu. Přidejte do entity Kontakt metodu Finder pomocí okna Podrobnosti metody služby BDC. Chcete-li vrátit kolekci entit do služby služby BDC, přidejte do metody kód.

1. V návrháři služby BDC zvolte entitu Kontakt .

2. V okně Podrobnosti metody služby BDC sbalte uzel ReadItem .

3. V seznamu Přidat metodu v části ReadList metoda zvolte Create Finder Method.

   Visual Studio přidá metodu, návratový parametr a popisovač typu.

4. V návrháři služby BDC otevřete v entitě Kontakt metodu ReadList .

   Soubor kódu pro službu Kontakt se otevře v Editoru kódu.

5. ContactService Ve třídě nahraďte metodu ReadList následujícím kódem. Tento kód provádí následující úlohy:

   • Načte data z tabulky Kontakty databáze AdventureWorks.

   • Vrátí seznam entit kontaktů do služby služby BDC.

     Poznámka:

     Nahraďte hodnotu ServerName pole názvem vašeho serveru.

     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
     

   ---

Testování projektu

Když projekt spustíte, otevře se sharepointový web a Visual Studio přidá váš model do služby Připojení ivity obchodních dat. Vytvořte externí seznam v SharePointu, který odkazuje na entitu Kontakt. Data kontaktů v databázi AdventureWorks se zobrazí v seznamu.

Poznámka:

Možná budete muset před laděním řešení upravit nastavení zabezpečení na SharePointu. Další informace najdete v tématu Návrh modelu připojení obchodních dat.

1. Zvolte klávesu F5 .

   Otevře se sharepointový web.

2. V nabídce Akce webu zvolte příkaz Další možnosti.

3. Na stránce Vytvořit zvolte šablonu Externí seznam a pak zvolte tlačítko Vytvořit.

4. Pojmenujte vlastní seznam Kontakty.

5. Zvolte tlačítko procházet vedle pole Typ externího obsahu.

6. V dialogovém okně Výběr typu externího obsahu zvolte položku AdventureWorksContacts.BdcModel1.Contact a pak zvolte tlačítko Vytvořit .

   SharePoint vytvoří externí seznam, který obsahuje kontakty z ukázkové databáze AdventureWorks.

7. Pokud chcete otestovat konkrétní vyhledávací metodu, zvolte kontakt v seznamu.

8. Na pásu karet zvolte kartu Položky a pak zvolte příkaz Zobrazit položku .

   Podrobnosti o zvoleném kontaktu se zobrazí ve formuláři.

Související obsah

• Postupy: Přidání metody Tvůrce
• Postupy: Přidání metody Updater
• Postupy: Přidání metody Deleter
• Přehled nástrojů pro návrh modelů služby BDC
• Integrace obchodních dat do SharePointu