Sdílet prostřednictvím

Návrh modelu připojení obchodních dat

  • Článek

Model pro službu BDC (Business Data Připojení ivity) můžete vyvinout přidáním entit a metod do souboru modelu. Entita popisuje kolekci datových polí. Například entita může představovat tabulku v databázi. Metoda provádí úlohu, jako je přidání, odstranění nebo aktualizace dat představovaných entitami. Další informace najdete v tématu Integrace obchodních dat do SharePointu.

Přidání entit

Entitu můžete přidat přetažením nebo zkopírováním entity z panelu nástrojů sady Visual Studio do Návrháře služby BDC. Další informace naleznete v tématu Postupy: Přidání entity do modelu.

Definujte pole entity ve třídě. Můžete například přidat pole pojmenované Address Customer do třídy. Do projektu můžete buď přidat novou třídu, nebo použít existující třídu vytvořenou pomocí jiných nástrojů, jako je Návrhář relací objektů (Návrhář relací objektů). Název entity a název třídy, která představuje entitu, se nemusí shodovat. Třídu spojíte s entitou při definování metod v modelu.

Přidání metod

Služba služby BDC volá metody v modelu, když uživatelé zobrazí, přidají, aktualizují nebo odstraní informace v seznamu nebo webové části založené na vašem modelu. Pro každou úlohu, kterou může uživatel provést, musíte do modelu přidat metodu. Metody můžete vytvořit výběrem některého z pěti základních typů metod z okna Podrobnosti metody služby BDC. Následující tabulka popisuje pět základních metod modelu služby BDC.

metoda Popis
Finder Vrátí kolekci instancí entity. Volá se, když uživatel otevře seznam nebo webovou část. Další informace naleznete v tématu Postupy: Přidání vyhledávací metody.
specifická metoda Finder Vrátí konkrétní instanci entity. Volá se, když uživatel zobrazí podrobnosti konkrétní položky v seznamu. Další informace naleznete v tématu Postupy: Přidání konkrétní vyhledávací metody.
Tvůrce Přidá nová data do zdroje dat entity. Volá se, když uživatelé vyberou tlačítko Nová položka na pásu karet seznamu založeného na modelu. Další informace naleznete v tématu Postupy: Přidání metody Creator.
aktualizační metoda Upraví data v seznamu. Volá se, když uživatelé aktualizují informace v seznamu. Další informace naleznete v tématu Postupy: Přidání metody updateru.
metoda odstranění Odebere data. Volá se, když uživatelé odstraní položku ze seznamu. Další informace naleznete v tématu Postupy: Přidání metody Deleter.

Definování parametrů metody

Když vytvoříte metodu, Visual Studio přidá vstupní a výstupní parametry, které jsou vhodné pro typ metody. Tyto parametry jsou jen zástupné symboly. Ve většině případů je nutné parametry upravit tak, aby předávaly nebo vracely správný typ dat. Například ve výchozím nastavení vrátí vyhledávací metoda řetězec. Ve většině případů chcete upravit návratový parametr vyhledávací metody tak, aby vrátil kolekci entit. Toho můžete dosáhnout úpravou popisovače typu parametru. Popisovač typu je kolekce atributů, které popisují datový typ parametru. Další informace naleznete v tématu Postupy: Definování popisovače typu parametru.

Visual Studio umožňuje kopírovat popisovače typů mezi parametry v modelu. Můžete například definovat popisovač typu pojmenovaný CustomerTD pro návratový parametr GetCustomer metody. V Průzkumníku CustomerTD služby BDC můžete zkopírovat popisovač typu a potom tento popisovač typu vložit do vstupního parametru CreateCustomer metody. Díky tomu nemusíte definovat stejný popisovač typu více než jednou.

Instance metody

Když vytvoříte metodu, Visual Studio přidá výchozí instanci metody. Instance metody je odkaz na metodu a navíc výchozí hodnoty parametrů. Jedna metoda může mít více instancí metody. Každá instance je kombinací podpisu metody a sady výchozích hodnot. Další informace naleznete v tématu Postupy: Definování popisovače typu parametru.

Při spuštění projektu se instance metod zobrazí v rozevíracím seznamu nad sharepointovým seznamem. Uživatelé můžou zvolit instance metod pro zobrazení dat.

Pokud chcete do instance metody přidat výchozí hodnoty, musíte přímo upravit XML modelu. Další informace naleznete v tématu DefaultValue.

Přidání popisovačů filtru

Příjemci modelu můžou chtít načíst instance entity, které odpovídají určitým kritériím. Pokud chcete tuto funkci povolit, můžete do metody přidat popisovač filtru. Popisovače filtru umožňují příjemcům modelu filtrovat sady výsledků metod předáním hodnot metodám před jejich spuštěním. Další informace naleznete v tématu Postupy: Přidání parametrů filtru do operací za účelem omezení instancí z externího systému.

SharePoint poskytuje několik funkcí, které uživatelům umožňují poskytovat hodnoty filtru. Například obchodní data Webové části poskytují textové pole filtru. Uživatelé můžou omezit data v seznamu zadáním hodnoty do textového pole. Další informace o tom, jak přidat popisovač filtru do metody, naleznete v tématu Postupy: Přidání popisovače filtru do vyhledávací metody.

Vlastnosti popisovače filtru

Je nutné nastavit hodnotu vlastnosti Přidružený popisovač typu, Název a Typ popisovače filtru. Všechny ostatní vlastnosti jsou volitelné.

Vlastnost Přidružený popisovač typu souvisí popisovač filtru se vstupním parametrem. Když uživatel poskytne hodnotu filtru, služba služby BDC předá danou hodnotu do metody pomocí vstupního parametru.

Vlastnost Typ popisuje vzor filtrování, který chcete použít. V SharePointu má vybraný vzor filtrování vliv na text, který se zobrazí v uživatelském rozhraní. Například pro vzor filtrování srovnávacího filtru se text rovná ovládacímu prvku nad webovou částí Obchodní data. Další informace o jednotlivýchvzorch

Další informace o vlastnostech popisovače filtru naleznete v tématu FilterDescriptor.

Zadání výchozích hodnot

V některých případech nemusí uživatel zadat hodnotu filtru. Výchozí hodnotu můžete zadat přidáním výchozí hodnoty do instance metody nebo nastavením výchozí hodnoty v kódu metody. Další informace o tom, jak přidat výchozí hodnotu do instance metody, naleznete v tématu MethodInstance. Příklad nastavení výchozí hodnoty vstupního parametru v kódu metody naleznete v tématu Postupy: Přidání popisovače filtru do vyhledávací metody.

Ověření modelu

Model můžete ověřit během vývoje. Visual Studio identifikuje problémy, které můžou zabránit tomu, aby se váš model choval podle očekávání. Tyto problémy se zobrazí v seznamu chyb sady Visual Studio.

Model můžete ověřit tak, že otevřete místní nabídku návrháře služby BDC a pak zvolíte Ověřit. Pokud model obsahuje nějaké chyby, zobrazí se v seznamu chyb. Kurzor můžete rychle přesunout do kódu, který obsahuje chybu, poklikáním na chybu v seznamu. Jako alternativu můžete opakovaně zvolit klávesy F8 nebo Shift+F8 a procházet chyby v seznamu dopředu nebo dozadu.

K chybám ověřování může dojít v případě, že pravidla modelu jsou nějakým způsobem porušena. Pokud je například vlastnost IsCollection popisovače typu nastavena na true, ale neexistují žádné podřízené popisovače typu, zobrazí se chyba ověření. Možná budete muset odkazovat na pravidla modelu služby BDC, abyste porozuměli některým chybám, které se zobrazují v seznamu chyb sady Visual Studio. Další informace o pravidlech modelu služby BDC naleznete v tématu Schéma služby BDCMetadata.

Ladění řešení obsahujícího model

Kód můžete ladit stejně jako jakýkoliv kód v sadě Visual Studio. Pokud chcete kód ladit, nastavte zarážky kdekoli v kódu a spusťte ladicí program. Visual Studio otevře sharepointový web. V SharePointu vytvořte seznam nebo webovou část, která používá vaše obchodní data. Pak můžete procházet kód. Další informace o ladění projektů Služby SharePoint naleznete v tématu Řešení potíží se službou SharePoint.

Kód můžete také ladit ve vlastních sestaveních, která přidáte do projektu. Pokud ale chcete kód ladit ve vlastním sestavení, musíte sestavení přidat do balíčku řešení. Další informace naleznete v tématu Postupy: Přidání a odebrání dalších sestavení.

Další informace o přidání vlastního sestavení do projektu naleznete v tématu Postupy: Zahrnutí vlastního sestavení do funkce služby BDC.

Konfigurace zabezpečení služby BDC

Možná budete muset před laděním řešení upravit nastavení zabezpečení na SharePointu. Chcete-li tato nastavení upravit, otevřete aplikaci služby Business Data Připojení ivity na webu Správa istrace služby SharePoint 2010 Central. V dialogovém okně Nastavit oprávnění úložiště metadat přidejte svůj uživatelský účet a vyberte některou z následujících možností:

Úloha Možnost
Nasazení modelů do služby BDC Upravit
Pokud chcete vytvořit seznamy a Webové části pomocí externích typů obsahu (entit) v modelu. Možnost výběru v klientech
Vytvoření, čtení, aktualizace a odstranění dat entity Spustit

Další informace o těchto nastaveních najdete v tématu Správa služby Připojení ivity obchodních dat.

Můžete také nastavit oprávnění zabezpečení pro jednotlivé modely nebo typy externího obsahu. Další informace o tom, jak nastavit oprávnění zabezpečení modelu, naleznete v tématu Správa modelů služby BDC. Další informace o nastavení oprávnění zabezpečení externího obsahu naleznete v tématu Správa externího obsahu.

Poznámka:

Pomocí těchto nastavení můžete ladit řešení na místním SharePoint Serveru. Další informace o tom, jak nakonfigurovat nastavení zabezpečení související s BDC na produkčním sharepointovém serveru, najdete v tématu Přehled zabezpečení služby Business Data Připojení ivity Services.

Odvolání modelů, které jsou poškozené

Při prvním spuštění ladicího programu sada Visual Studio nasadí celý model do SharePointu. Pro každou další dobu Visual Studio aktualizuje model v SharePointu o všechny změny, které provedete mezi nasazeními.

V situacích, kdy chcete, aby sada Visual Studio úplně odvolala model ze SharePointu. Například model může být poškozený. Pokud chcete model znovu nasadit na SharePoint, nastavte vlastnost přírůstkové aktualizace modelu na False a spusťte ladicí program. Vlastnost Přírůstková aktualizace se zobrazí v okně Vlastnosti, když vyberete uzel, který představuje model v Průzkumníku služby BDC. Ve výchozím nastavení je název modelu BdcModel1.

Změna názvů identifikátorů entit v modelu

Pokud po nasazení modelu změníte název identifikátoru, může se zobrazit chyba nasazení. Tuto chybu nelze vyřešit nastavením vlastnosti přírůstkové aktualizace modelu na hodnotu False. Model musíte odvolat ručně a pak řešení znovu nasadit. Další informace najdete v tématu Řešení potíží se sharepointovými řešeními. Této chybě se můžete vyhnout nastavením vlastnosti Přírůstková aktualizace na False před počátečním nasazením modelu.

Vyhledání dokumentace k prvkům modelu služby BDC

Visual Studio přidá do modelu element XML pro každou entitu, metodu nebo jinou položku, kterou vytvoříte. Atributy elementu se v okně Vlastnosti zobrazují jako vlastnosti. Informace o prvcích a atributech, které Visual Studio generuje při návrhu modelu, naleznete v tématu Schéma BDCMetadata.

Titulek Popis
Přehled nástrojů pro návrh modelů služby BDC Popisuje nástroje, které můžete použít k vizuálnímu návrhu modelu pro BDC.
Postupy: Přidání entity do modelu Ukazuje, jak do modelu přidat typy externího obsahu nebo entity.
Postupy: Přidání metody Finderu Ukazuje, jak přidat metodu, která uživatelům umožňuje zobrazit seznam entit v seznamu nebo webové části.
Postupy: Přidání konkrétní vyhledávací metody Ukazuje, jak přidat metodu, která uživatelům umožňuje zobrazit podrobnosti konkrétní entity.
Postupy: Přidání metody Creator Ukazuje, jak přidat metodu, která uživatelům umožňuje přidávat záznamy do zdroje dat přímo ze seznamu nebo webové části.
Postupy: Přidání metody Deleter Ukazuje, jak přidat metodu, která uživatelům umožňuje odebrat data ze zdroje dat pomocí možností v uživatelském rozhraní seznamu nebo webové části.
Postupy: Přidání metody updateru Ukazuje, jak přidat metodu, která uživatelům umožňuje měnit datové záznamy ve zdroji dat přímo ze seznamu nebo webové části.
Postupy: Přidání parametru do metody Ukazuje, jak pomocí okna podrobnosti metody v sadě Visual Studio přidat vstupní a návratové parametry do metody.
Postupy: Definování popisovače typu parametru Ukazuje, jak v modelu definovat datové typy parametrů.
Postupy: Definování instance metody Ukazuje, jak vytvořit instanci metody, kterou služba BDC spustí.
Postupy: Přidání popisovače filtru do metody Finderu Ukazuje, jak povolit uživatelům omezit počet instancí vrácených metodou Finderu.
Vytváření přidružení mezi entitami Popisuje, jak můžete definovat vztahy mezi entitami v modelu. Obchodní data Webové části, externí seznamy a vlastní aplikace můžou tyto relace dat zobrazit v uživatelském rozhraní.
Postupy: Vytvoření přidružení mezi entitami Ukazuje, jak definovat vztahy mezi entitami v modelu.
Návod: Vytvoření externího seznamu v SharePointu pomocí obchodních dat Obsahuje podrobné pokyny, které ukazují, jak vytvořit a otestovat model, který zobrazuje kontakty v externím seznamu SharePointu.
Integrace obchodních dat do SharePointu Poskytuje přehled vytváření a navrhování modelů pro službu BDC.