Utforma en anslutningsmodell för affärsdata

Du kan utveckla en modell för tjänsten Business Data Connectivity (BDC) genom att lägga till entiteter och metoder i en modellfil. En entitet beskriver en samling datafält. En entitet kan till exempel representera en tabell i en databas. En metod utför en uppgift som att lägga till, ta bort eller uppdatera data som representeras av entiteterna. Mer information finns i Integrera affärsdata i SharePoint.

Lägg till entiteter

Du kan lägga till en entitet genom att dra eller kopiera en entitet från Visual Studio Toolbox till BDC Designer. Mer information finns i Så här lägger du till en entitet i en modell.

Definiera fälten för entiteten i en klass. Du kan till exempel lägga till ett fält med namnet Address i en Customer klass. Du kan antingen lägga till en ny klass i projektet eller använda en befintlig klass som skapats med hjälp av andra verktyg, till exempel Object Relational Designer (O/R Designer). Namnet på entiteten och namnet på den klass som representerar entiteten behöver inte matcha. Du relaterar klassen till entiteten när du definierar metoderna i din modell.

Lägg till metoder

BDC-tjänsten anropar metoder i din modell när användare visar, lägger till, uppdaterar eller tar bort information i en lista eller webbdel som baseras på din modell. Du måste lägga till en metod i modellen för varje uppgift som användaren kan utföra. Skapa metoder genom att välja någon av de fem grundläggande metodtyperna från fönstret BDC-metodinformation . I följande tabell beskrivs de fem grundläggande metoderna för en BDC-modell.

Definiera metodparametrar

När du skapar en metod lägger Visual Studio till de indata- och utdataparametrar som är lämpliga för metodtypen. Dessa parametrar är bara platshållare. I de flesta fall måste du ändra parametrarna så att de skickar in eller returnerar rätt typ av data. Som standard returnerar till exempel en Finder-metod en sträng. I de flesta fall vill du ändra returparametern för Metoden Finder så att den returnerar en samling entiteter. Du kan göra det genom att ändra parameterns typbeskrivning. En typbeskrivning är en samling attribut som beskriver datatypen för en parameter. Mer information finns i Så här: Definiera typbeskrivningen för en parameter.

Med Visual Studio kan du kopiera typbeskrivningar mellan parametrar i modellen. Du kan till exempel definiera en typbeskrivning med namnet CustomerTD för metodens GetCustomer returparameter. Du kan kopiera CustomerTD typbeskrivningen i BDC Explorer och sedan klistra in den typbeskrivningen till indataparametern för CreateCustomer metoden. Detta hindrar dig från att behöva definiera samma typbeskrivning mer än en gång.

Metodinstanser

När du skapar en metod lägger Visual Studio till en standardmetodinstans. En metodinstans är en referens till en metod, plus standardvärdena för parametrarna. En enskild metod kan ha flera metodinstanser. Varje instans är en kombination av metodsignaturen och en uppsättning standardvärden. Mer information finns i Så här: Definiera typbeskrivningen för en parameter.

När du kör projektet visas metodinstanser i en listruta ovanför SharePoint-listan. Användare kan välja metodinstanser för att visa data.

Om du vill lägga till standardvärden i metodinstansen måste du ändra modellens XML direkt. Mer information finns i DefaultValue.

Lägga till filterbeskrivningar

Användare av modellen kanske vill hämta instanser av en entitet som matchar vissa kriterier. Om du vill aktivera den här funktionen kan du lägga till en filterbeskrivning till en metod. Filterbeskrivningar gör det möjligt för modellkonsumenter att filtrera metodresultatuppsättningar genom att skicka värden till metoder innan de körs. Mer information finns i Så här lägger du till filterparametrar i åtgärder för att begränsa instanser från det externa systemet.

SharePoint innehåller flera funktioner som gör det möjligt för användare att ange filtervärden. Affärsdatawebbdelar tillhandahåller till exempel en filtertextruta. Användare kan begränsa data i en lista genom att ange ett värde i textrutan. Mer information om hur du lägger till en filterbeskrivning i en metod finns i How to: Add a filter descriptor to a Finder method (Så här lägger du till en filterbeskrivning till en Finder-metod).

Filterdeskriptoregenskaper

Du måste ange värdet för egenskaperna Associerad typbeskrivning, Namn och Typ för en filterbeskrivning. Alla andra egenskaper är valfria.

Egenskapen Associerad typbeskrivning relaterar filterbeskrivningen till en indataparameter. När en användare tillhandahåller ett filtervärde skickar BDC-tjänsten det värdet till metoden med hjälp av indataparametern.

Egenskapen Typ beskriver det filtreringsmönster som du vill använda. I SharePoint påverkar det filtreringsmönster som du väljer den text som visas i användargränssnittet (UI). För ett jämförelsefiltreringsmönster visas till exempel texten lika med som en kontroll ovanför en affärsdatawebbdel. Mer information om varje filtreringsmönster finns i Typer av filter som stöds av BDC.

Mer information om egenskaperna för en filterbeskrivning finns i FilterDescriptor.

Ange standardvärden

I vissa fall kanske användaren inte anger något filtervärde. Du kan ange ett standardvärde genom att lägga till ett standardvärde i metodinstansen eller genom att ange standardvärdet i koden för din metod. Mer information om hur du lägger till ett standardvärde i metodinstansen finns i MethodInstance. Ett exempel på hur du anger standardvärdet för en indataparameter i koden för din metod finns i How to: Add a filter descriptor to a Finder method (Så här lägger du till en filterbeskrivning till en Finder-metod).

Verifiera modellen

Du kan verifiera din modell under utvecklingen. Visual Studio identifierar problem som kan hindra din modell från att bete sig som förväntat. De här problemen visas i Visual Studio-fellistan.

Du kan verifiera en modell genom att öppna snabbmenyn för BDC Designer och sedan välja Verifiera. Om modellen innehåller några fel visas de i fellistan. Du kan snabbt flytta markören till koden som innehåller ett fel genom att dubbelklicka på felet i listan. Alternativt kan du välja F8 - eller Skift+F8-tangenterna flera gånger för att gå framåt eller bakåt genom felen i listan.

Valideringsfel kan inträffa när reglerna för modellen överträds på något sätt. Om egenskapen IsCollection för en typbeskrivning till exempel är inställd på true, men det inte finns några underordnade typbeskrivningar, visas ett verifieringsfel. Du kan behöva referera till reglerna för en BDC-modell för att förstå vissa fel som visas i Visual Studio-fellistan. Mer information om reglerna för en BDC-modell finns i BDCMetadata Schema.

Felsöka lösningen som innehåller modellen

Du kan felsöka koden eftersom du felsöker valfri kod i Visual Studio. Om du vill felsöka koden anger du brytpunkter var som helst i koden och startar sedan felsökningsprogrammet. Visual Studio öppnar SharePoint-webbplatsen. I SharePoint skapar du en lista eller webbdel som använder dina affärsdata. Sedan kan du gå igenom koden. Mer information om felsökning av SharePoint-projekt finns i Felsöka SharePoint-lösningar.

Du kan också felsöka kod i anpassade sammansättningar som du lägger till i projektet. Men om du vill felsöka kod i en anpassad sammansättning måste du lägga till sammansättningen i lösningspaketet. Mer information finns i Så här lägger du till och tar bort ytterligare sammansättningar.

Mer information om hur du lägger till en anpassad sammansättning i projektet finns i Så här: Inkludera en anpassad sammansättning i en BDC-funktion.

Konfigurera BDC-säkerhet

Du kan behöva ändra säkerhetsinställningarna i SharePoint innan du kan felsöka din lösning. Om du vill ändra de här inställningarna öppnar du business data connectivity service-programmet på webbplatsen central administration i SharePoint 2010. I dialogrutan Ange behörigheter för metadataarkiv lägger du till ditt användarkonto och väljer sedan något av följande alternativ:

Mer information om de här inställningarna finns i Tjänsthantering för Business Data Connectivity.

Du kan också ange säkerhetsbehörigheter för enskilda modeller eller externa innehållstyper. Mer information om hur du anger säkerhetsbehörigheter för en modell finns i BDC-modellhantering. Mer information om hur du anger säkerhetsbehörigheter för en extern innehållstyp finns i Hantering av extern innehållstyp.

Återkalla modeller som blir korrupta

Första gången du startar felsökningsprogrammet distribuerar Visual Studio hela modellen till SharePoint. För varje gång därefter uppdaterar Visual Studio modellen i SharePoint med eventuella ändringar som du gör mellan distributionerna.

Det kan finnas situationer där du vill att Visual Studio ska återkalla modellen helt från SharePoint. En modell kan till exempel bli korrupt. Om du vill distribuera om modellen till SharePoint anger du modellens inkrementella uppdateringsegenskap till False och startar sedan felsökningsprogrammet. Egenskapen Inkrementell uppdatering visas i fönstret Egenskaper när du väljer den nod som representerar modellen i BDC Explorer. Som standard är namnet på modellen BdcModel1.

Ändra identifierarnamn för entiteter i modellen

Om du ändrar namnet på en identifierare när du har distribuerat modellen kan du få ett distributionsfel. Du kan inte lösa det här felet genom att ange egenskapen Inkrementell uppdatering för modellen till False. Du måste dra tillbaka modellen manuellt och sedan distribuera lösningen igen. Mer information finns i Felsöka SharePoint-lösningar. Du kan undvika det här felet genom att ange egenskapen Inkrementell uppdatering till False innan du först distribuerar modellen.

Leta upp dokumentation för BDC-modellelement

Visual Studio lägger till ett XML-element i modellen för varje entitet, metod eller annat objekt som du skapar. Elementattribut visas som egenskaper i fönstret Egenskaper . Information om de element och attribut som Visual Studio genererar när du utformar modellen finns i BDCMetadata Schema.

Relaterade ämnen