Návod: Vytvoření externího seznamu ve službě SharePoint s použitím obchodních dat

Služby Business Data Connectivity (BDC) umožňuje zobrazovat obchodní data z back-end serverových aplikací, webových služeb a databází serveru SharePoint.

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.

• Model přidání entity.

• 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 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 typu SQL Server.

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

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

1. V panelu nabídek v aplikaci 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 SharePoint 2010, název AdventureWorksTest projektu a poté vyberte OK tlačítko.

   Zobrazí se Průvodce přizpůsobením SharePoint.V tomto průvodci můžete určit serveru, který budete chtít použít k ladění projektu a nastavení úrovně důvěryhodnosti řešení.

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

5. Zvolte tlačítko Dokončit k přijetí výchozího místního webu služby SharePoint.

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

7. V panelu nabídky vyberte možnosti Projekt, 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říd pro přístup k datům do projektu

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

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

   Přidat připojení dialogové okno.

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

   Další informace naleznete v tématu Přidat/změnit připojení (Microsoft SQL Server).

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

4. V panelu nabídky vyberte možnosti Projekt, 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 pak zvolte Přidat tlačítko.

   Soubor DBML je přidána 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ázkovou databázi AdventureWorks a potom rozbalte uzel tabulky uzlu.

10. Přidat kontakt (osoba) 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 (osoba).

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

Model Připojení obchodních dat project přidá výchozí entitu, do modelu s názvem Entity1.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.

Odebrání výchozí entity z modelu

1. V Průzkumník řešení, 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 služby BDC.

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

4. V Průzkumník řešení, Entity1.vb (v jazyce Visual Basic) nebo Entity1.cs (v jazyce C#) otevřete místní nabídku a 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 do modelu

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

Přidání entity do modelu

1. Na panelu nabídek zvolte možnost Zobrazení > Souprava nástrojů.

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

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

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

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

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

   U entity se zobrazí nový identifikátor.

6. V Vlastnosti okna, změnit název identifikátoru KódKontaktu.

7. V Název typu vyberte System.Int32.

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

Chcete-li povolit služby BDC, chcete-li zobrazit konkrétní kontakt, je nutné přidat konkrétní vyhledávací metoda.Služby BDC volá konkrétní vyhledávací metoda, když 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 okno.Vrátit konkrétní entity, přidejte kód do metody.

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

1. V Návrháři služby BDC, zvolte kontakt 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 vyberte 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 okno.

   • Metoda s názvem ReadItem.

   • Vstupním parametrem metody.

   • Návratový parametr metody.

   • Typ popisovače pro každý parametr.

   • Metoda instance metody.

4. V Podrobnosti metody služby BDC okna, otevřete seznam, který se zobrazí kontakt zadejte popisovače a pak zvolte 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 a potom klikněte na příkaz kontakt vlastnost.

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

   Nový popisovač typu s názvem TypeDescriptor1 se zobrazí v BDC Explorer.

7. V Vlastnosti okno, nastavit jméno hodnotu vlastnosti KódKontaktu.

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

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

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

    Název	Napište jméno
    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 záložního řadiče domény na kontakt entity, otevřete ReadItem metody.

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

12. V ContactService třídy, nahraďte 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

Chcete-li povolit služby BDC 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 okno.Pro navrácení kolekce entit služby BDC, přidejte kód do metody.

Přidání vyhledávací metody

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

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

3. V Přidat metodu seznamů v rámci ReadList metoda, zvolte Vytvořit vyhledávací metody.

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

4. V Návrháři záložního řadiče domény na kontakt entity, otevřete ReadList metody.

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

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

   • Načítá 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 webu SharePoint se otevře a aplikace Visual Studio přidá modelu pro službu Připojení obchodních dat.Vytvořte externí seznam služby SharePoint, který odkazuje na entitu kontakt.V seznamu se zobrazí data pro kontakty v databázi AdventureWorks.

[!POZNÁMKA]

Je třeba změnit nastavení zabezpečení ve službě SharePoint před můžete ladit vašeho řešení. Další informace naleznete v tématu Navrhování modelu připojení obchodních dat.

Otestování projektu

1. Zvolte klávesu F5.

   Otevře se web 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 šablonu a pak zvolte vytvořit tlačítko.

4. Název vlastního seznamu kontaktů.

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

6. V Externího obsahu pro výběr typu 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. Testování konkrétní vyhledávací metoda, vyberte v seznamu kontakt.

8. Na pásu karet, zvolte položky a potom klikněte na příkaz 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:

• Postupy: Přidání metody vytvoření.

• Postupy: Přidání aktualizační metody.

• Postupy: Přidání metody odstranění.

Viz také

Koncepty

Přehled nástrojů pro navrhování modelů služby BDC

Další zdroje

Navrhování modelu připojení obchodních dat

Vytvoření modelu připojení obchodních dat

Integrace obchodních dat do služby SharePoint