Názorný postup: Vytvoření externího seznamu služby SharePoint pomocí obchodních dat

Služba Business Data připojení (BDC) umožňuje SharePoint, chcete-li zobrazit obchodní data ze serveru back-end aplikace, webové služby a databáze.

Tento návod ukazuje, jak vytvořit model služby BDC, který vrací informace o kontaktech v ukázkové databázi.Pomocí tohoto modelu bude potom vytvořit externí seznam ve službě SharePoint.

Tento návod ilustruje následující úkoly:

• Vytvoření projektu.

• Přidání entity k modelu.

• Přidání vyhledávací metody.

• Přidání konkrétní vyhledávací metoda.

• Testování projektu.

Požadavky

Chcete-li dokončit tento návod, potřebujete následující komponenty:

• Podporované edice systému Windows a serveru SharePoint.Další informace naleznete v tématu Požadavky na vývoj řešení služby SharePoint.

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

• Přístup k ukázkové databázi AdventureWorks.Další informace o instalaci databáze AdventureWorks, viz Ukázkové databáze serveru SQL Server.

Vytvoření projektu, která obsahuje Model služby BDC

Chcete-li vytvořit projekt, který obsahuje model služby BDC

1. V panelu nabídek v sadě Visual Studio zvolte položku Soubor, Nový a nakonec Projekt.

   Otevře se dialogové okno Nový projekt.

2. Pod každým Visual C# nebo jazyka Visual Basic, rozbalte SharePoint uzlu a pak zvolte 2010 zboží.

3. V šablony podokně zvolte Projektu služby SharePoint 2010, název AdventureWorksTest projektu a pak zvolte OK tlačítko.

   Průvodce vlastním nastavením aplikace SharePoint se zobrazí.V tomto průvodci zadáte web, který použijete k ladění projektu a nastavení úrovně důvěryhodnosti roztoku.

4. Zvolte nasazení jako řešení farmy přepínač k nastavení úrovně důvěryhodnosti.

5. Zvolte Dokončit tlačítko přijměte výchozí místní web služby SharePoint.

6. V Průzkumníku, zvolte uzel projektu služby SharePoint.

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

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

8. V šablony podokně zvolte Model Připojení obchodních dat (pouze řešení farmy), název projektu AdventureWorksContacts a potom zvolte Přidat tlačítko.

Přidání třídy dat aplikace Access do projektu

Chcete-li přidat datové třídy do projektu

1. V řádku nabídek zvolte Nástroje, připojit k databázi.

   Přidat připojení otevře se dialogové okno.

2. Přidání připojení k ukázkové databázi AdventureWorks serveru SQL.

   Další informace naleznete v tématu Přidat nebo upravte připojení (Microsoft SQL Server).

3. V Průzkumníku, zvolte uzel projektu.

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

5. V Nainstalované šablony podokně zvolte dat uzlu.

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

7. V jméno pole, zadejte AdventureWorks a potom zvolte Přidat tlačítko.

   Soubor DBML je přidán do projektu a otevře se Návrhář relací objektů (O/R Designer).

8. V řádku nabídek zvolte zobrazení, Server Explorer.

9. V Server Explorer, rozbalte uzel, který představuje ukázkové databáze AdventureWorks a potom rozbalte uzel tabulky uzlu.

10. Přidat kontaktu (osoby) tabulky do Návrháře relací objektů.

    Entitní třídu je vytvořena a zobrazí se na návrhové ploše.Třída entity má vlastnosti, které jsou mapovány na sloupce v tabulce Kontakt (osoby).

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

Model Připojení obchodních dat projektu přidá výchozí entity s názvem Entity1 do modelu.Odeberte tuto entitu.Později přidáte novou entitu.Počínaje prázdný model snižuje počet kroky potřebné k dokončení návodu.

Chcete-li odebrat výchozí entity z modelu

1. V Průzkumníku, rozbalte BdcModel1 uzel a pak otevřete soubor BdcModel1.bdcm.

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

3. V návrháři otevřít místní nabídku pro Entity1a pak zvolte Odstranit.

4. V Průzkumníku, otevřete místní nabídku pro Entity1.vb (v jazyce Visual Basic) nebo Entity1.cs (v jazyce C#) a pak zvolte Odstranit.

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

Přidání Entity modelu

Do modelu přidáte entitu.Entit můžete přidat z aplikace Visual Studio nástrojů do návrháře služby BDC.

Chcete-li přidat Entity modelu

1. V řádku nabídek zvolte zobrazení, nástrojů.

2. Na BusinessDataConnectivity karty nástrojů, přidat Entity do návrháře služby BDC.

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

3. V řádku nabídek zvolte zobrazení, Vlastnosti, okna.

4. V Vlastnosti okno, nastavit jméno hodnotu vlastnosti kontaktu.

5. V návrháři, otevřete místní nabídku pro entitu, zvolte Přidata pak zvolte identifikátor.

   U entity se zobrazí nový identifikátor.

6. V Vlastnosti okno, změňte název identifikátoru KódKontaktu.

7. V Název typu seznam, zvolte System.Int32.

Přidání konkrétní metoda vyhledávání

Chcete-li povolit služby BDC, chcete-li zobrazit určitý kontakt, je nutné přidat konkrétní vyhledávací metoda.Služba BDC volá konkrétní vyhledávací metoda, pokud uživatel vybere položku v seznamu a potom zvolí Zobrazit položku tlačítko na pásu karet.

Přidat konkrétní vyhledávací metoda pomocí entity Kontakt Podrobnosti metody služby BDC okna.K vrácení konkrétní entity, přidejte kód do metody.

Chcete-li přidat konkrétní vyhledávací metoda

1. V Návrháři model služby BDC zvolte Contact entity.

2. V řádku nabídek zvolte zobrazení, Ostatní okna, Podrobnosti metody služby BDC.

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

3. V Přidat metodu seznam, zvolte Vytvořit konkrétní metoda vyhledávání.

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

   • Metoda s názvem ReadItem.

   • Vstupní parametr pro metodu.

   • Návratový parametr pro metodu.

   • Popisovač typu pro každý parametr.

   • Metoda instance metody.

4. V Podrobnosti metody služby BDC okna, otevřete seznam, který se zobrazí kontakt typ popisovače a Upravit.

   BDC Explorer otevře a poskytuje hierarchické zobrazení modelu.

5. V Vlastnosti okna, otevřete seznam vedle TypeName vlastnosti, zvolte Aktuálního projektu kartu a pak zvolte kontakt vlastnost.

6. V BDC Explorer, otevřete místní nabídku kontakta pak zvolte Přidat popisovač typu.

   Nový typ popisovače, který se nazývá TypeDescriptor1 se zobrazí v BDC Explorer.

7. V Vlastnosti okno, nastavit název hodnotu vlastnosti KódKontaktu.

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

9. Otevřete seznam vedle identifikátor vlastnost a pak zvolte KódKontaktu.

10. Opakujte krok 6 Chcete-li vytvořit popisovač typu pro každý z těchto polí.

    Název	Název typu
    Jméno	System.String
    Příjmení	System.String
    Telefon	System.String
    Email	System.String
    EmailPromotion	System.Int32
    NameStyle	System.Boolean
    PasswordHash	System.String
    PasswordSalt	System.String

11. V Návrháři modelu služby BDC na Contact entity, otevřete ReadItem metoda.

    Otevře soubor kontaktů služby kódu v editoru kódu.

12. V ContactService třídou, nahradit ReadItem metodu následujícím kódem.Tento kód provede následující úlohy:

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

    • Vrátí entity kontakt služby BDC.

    [!POZNÁMKA]

    Nahraďte hodnotu ServerName pole s názvem serveru.

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

Přidání vyhledávací metody

Povolení služby katalogu obchodních dat pro zobrazení kontaktů v seznamu, je nutné přidat vyhledávací metody.Přidat vyhledávací metody pomocí entity Kontakt Podrobnosti metody služby BDC okna.Pro navrácení kolekce entit služby katalogu obchodních dat, přidejte kód do metody.

Chcete-li přidat vyhledávací metody

1. V Návrháři modelu služby BDC, zvolte Contact entity.

2. V Podrobnosti metody služby BDC okno Sbalit ReadItem uzlu.

3. V Přidat metodu jsou uvedeny v části ReadList metoda, zvolte Vytvořit vyhledávací metody.

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

4. V Návrháři modelu služby BDC na Contact entity, otevřete ReadList metoda.

   Soubor kódu pro službu kontaktu se otevře v editoru kódu.

5. V ContactService třídou, nahradit ReadList metodu následujícím kódem.Tento kód provede následující úlohy:

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

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

   [!POZNÁMKA]

   Nahraďte hodnotu ServerName pole s názvem serveru.

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

Testování projektu

Při spuštění projektu otevře web služby SharePoint a Visual Studio přidá modelu služby Připojení obchodních dat.Vytvořte externí seznam služby SharePoint, který odkazuje entity Kontakt.V seznamu se zobrazují data kontaktů v databázi AdventureWorks.

[!POZNÁMKA]

Pravděpodobně budete muset změnit nastavení zabezpečení ve službě SharePoint před ladění vašeho řešení.Další informace naleznete v tématu Navržení modelu obchodních dat připojení.

K testování projektu

1. Zvolte F5 klíč.

   Otevření webu služby SharePoint.

2. Na Akce webu nabídky, zvolte Další možnosti příkaz.

3. Na vytvořit stránky, zvolte Externího seznamu šablony a pak zvolte vytvořit tlačítko.

4. Název vlastní seznam kontaktů.

5. Klepněte na tlačítko Procházet vedle Typu externího obsahu pole.

6. V Výběr typu externího obsahu dialogové okno pole, zvolte AdventureWorksContacts.BdcModel1.Contact bodu a pak zvolte vytvořit tlačítko.

   SharePoint vytvoří externí seznam obsahující kontakty z ukázkové databáze AdventureWorks.

7. Chcete-li testovat konkrétní vyhledávací metoda v seznamu zvolte kontakt.

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

   Ve formuláři se zobrazí podrobnosti o kontaktu, který jste zvolili.

Další kroky

Další informace o navrhování modely služby BDC služby SharePoint z těchto témat:

• Jak: Přidat metodu Creator.

• Jak: Přidat metodu Updater.

• Jak: Přidat metodu Deleter.

Viz také

Koncepty

Přehled nástrojů pro návrh modelu záložní řadič domény

Další zdroje

Navržení modelu obchodních dat připojení

Vytváření připojení k modelu obchodních dat

Integraci obchodních dat do služby SharePoint