Projektowanie modelu łączności danych biznesowych

Możesz opracować model dla usługi Połączenie ivity danych biznesowych (BDC), dodając jednostki i metody do pliku modelu. Jednostka opisuje kolekcję pól danych. Na przykład jednostka może reprezentować tabelę w bazie danych. Metoda wykonuje zadanie, takie jak dodawanie, usuwanie lub aktualizowanie danych reprezentowanych przez jednostki. Aby uzyskać więcej informacji, zobacz Integrowanie danych biznesowych z programem SharePoint.

Dodawanie jednostek

Jednostkę można dodać, przeciągając lub kopiując jednostkę z przybornika programu Visual Studio do Projektant usługi BDC. Aby uzyskać więcej informacji, zobacz How to: Add an entity to a model (Instrukcje: dodawanie jednostki do modelu).

Zdefiniuj pola jednostki w klasie. Możesz na przykład dodać pole o nazwie Address do Customer klasy. Możesz dodać nową klasę do projektu lub użyć istniejącej klasy utworzonej przy użyciu innych narzędzi, takich jak Projektant relacyjne obiekty (O/R Projektant). Nazwa jednostki i nazwa klasy reprezentującej jednostkę nie muszą być zgodne. Klasę należy powiązać z jednostką podczas definiowania metod w modelu.

Dodawanie metod

Usługa BDC wywołuje metody w modelu, gdy użytkownicy wyświetlają, dodają, aktualizują lub usuwają informacje na liście lub składniku Web Part opartym na modelu. Musisz dodać metodę do modelu dla każdego zadania, które może wykonać użytkownik. Utwórz metody, wybierając dowolny z pięciu podstawowych typów metod w oknie Szczegóły metody usługi BDC. W poniższej tabeli opisano pięć podstawowych metod modelu usługi BDC.

Metoda	opis
Finder	Zwraca kolekcję wystąpień jednostek. Wywoływana po otwarciu listy lub składnika Web Part przez użytkownika. Aby uzyskać więcej informacji, zobacz How to: Add a Finder method (Instrukcje: Dodawanie metody wyszukiwania).
Specific Finder	Zwraca określone wystąpienie jednostki. Wywoływana, gdy użytkownik wyświetla szczegóły określonego elementu na liście. Aby uzyskać więcej informacji, zobacz How to: Add a specific Finder method (Instrukcje: dodawanie określonej metody wyszukiwania).
Twórca	Dodaje nowe dane do źródła danych jednostki. Wywoływane , gdy użytkownicy wybierają przycisk Nowy element na wstążce listy opartej na modelu. Aby uzyskać więcej informacji, zobacz How to: Add a Creator method (Instrukcje: Dodawanie metody Creator).
Updater	Modyfikuje dane na liście. Wywoływane, gdy użytkownicy aktualizują informacje na liście. Aby uzyskać więcej informacji, zobacz How to: Add an Updater method (Instrukcje: dodawanie metody aktualizatora).
Deleter	Usuwa dane. Wywoływana, gdy użytkownicy usuwają element z listy. Aby uzyskać więcej informacji, zobacz How to: Add a Deleter method (Instrukcje: dodawanie metody usuwania).

Definiowanie parametrów metody

Podczas tworzenia metody program Visual Studio dodaje parametry wejściowe i wyjściowe odpowiednie dla typu metody. Te parametry są tylko symbolami zastępczymi. W większości przypadków należy zmodyfikować parametry, aby przekazywać lub zwracać poprawny typ danych. Na przykład metoda wyszukiwania domyślnie zwraca ciąg. W większości przypadków chcesz zmodyfikować parametr zwracany przez metodę Finder, tak aby zwracała kolekcję jednostek. Można to osiągnąć, modyfikując deskryptor typów parametru. Deskryptor typu to kolekcja atrybutów opisujących typ danych parametru. Aby uzyskać więcej informacji, zobacz How to: Define the type descriptor of a parameter (Instrukcje: definiowanie deskryptora typu parametru).

Program Visual Studio umożliwia kopiowanie deskryptorów typów między parametrami w modelu. Można na przykład zdefiniować deskryptor typu o nazwie CustomerTD dla parametru zwracanego GetCustomer metody. Deskryptor typów można skopiować CustomerTD w Eksploratorze usługi BDC, a następnie wkleić ten deskryptor typów do parametru wejściowego CreateCustomer metody. Zapobiega to konieczności definiowania tego samego deskryptora typu więcej niż raz.

Wystąpienia metody

Podczas tworzenia metody program Visual Studio dodaje domyślne wystąpienie metody. Wystąpienie metody jest odwołaniem do metody oraz wartościami domyślnymi parametrów. Pojedyncza metoda może mieć wiele wystąpień metody. Każde wystąpienie jest kombinacją sygnatury metody i zestawu wartości domyślnych. Aby uzyskać więcej informacji, zobacz How to: Define the type descriptor of a parameter (Instrukcje: definiowanie deskryptora typu parametru).

Po uruchomieniu projektu wystąpienia metody są wyświetlane na liście rozwijanej powyżej listy programu SharePoint. Użytkownicy mogą wybrać wystąpienia metod, aby wyświetlić dane.

Aby dodać wartości domyślne do wystąpienia metody, należy bezpośrednio zmodyfikować kod XML modelu. Aby uzyskać więcej informacji, zobacz DefaultValue.

Dodawanie deskryptorów filtrów

Konsumenci modelu mogą chcieć pobrać wystąpienia jednostki, które spełniają pewne kryteria. Aby włączyć tę funkcję, możesz dodać deskryptor filtru do metody. Deskryptory filtrów umożliwiają konsumentom modelu filtrowanie zestawów wyników metod, przekazując wartości do metod przed ich wykonaniem. Aby uzyskać więcej informacji, zobacz How to: Add Filter Parameters to Operations to Limit Instances from the External System (Instrukcje: dodawanie parametrów filtru do operacji w celu ograniczenia wystąpień z systemu zewnętrznego).

Program SharePoint udostępnia kilka funkcji, które umożliwiają użytkownikom udostępnianie wartości filtru. Na przykład dane biznesowe składniki Web Part zawierają pole tekstowe filtru. Użytkownicy mogą ograniczyć dane na liście, wprowadzając wartość w polu tekstowym. Aby uzyskać więcej informacji na temat dodawania deskryptora filtru do metody, zobacz How to: Add a filter descriptor to a Finder method (Instrukcje: dodawanie deskryptora filtru do metody wyszukiwania).

Właściwości deskryptora filtru

Należy ustawić wartość skojarzonego deskryptora typów, nazwy i właściwości typu deskryptora filtru. Wszystkie inne właściwości są opcjonalne.

Właściwość Deskryptora skojarzonego typu wiąże deskryptor filtru z parametrem wejściowym. Gdy użytkownik udostępnia wartość filtru, usługa BDC przekazuje tę wartość do metody przy użyciu parametru wejściowego.

Właściwość Type opisuje wzorzec filtrowania, którego chcesz użyć. W programie SharePoint wybrany wzorzec filtrowania wpływa na tekst wyświetlany w interfejsie użytkownika. Na przykład w przypadku wzorca filtrowania comparator tekst jest równy kontrolce powyżej składnika Web Part danych biznesowych. Aby uzyskać więcej informacji na temat każdego wzorca filtrowania, zobacz Typy filtrów obsługiwanych przez usługę BDC.

Aby uzyskać więcej informacji na temat właściwości deskryptora filtru, zobacz FilterDescriptor.

Podaj wartości domyślne

W niektórych przypadkach użytkownik może nie podać wartości filtru. Możesz podać wartość domyślną, dodając wartość domyślną do wystąpienia metody lub ustawiając wartość domyślną w kodzie metody. Aby uzyskać więcej informacji na temat dodawania wartości domyślnej do wystąpienia metody, zobacz MethodInstance. Aby zapoznać się z przykładem ustawiania domyślnej wartości parametru wejściowego w kodzie metody, zobacz How to: Add a filter descriptor to a Finder method (Instrukcje: dodawanie deskryptora filtru do metody wyszukiwania).

Walidacja modelu

Model można zweryfikować podczas opracowywania. Program Visual Studio identyfikuje problemy, które mogą uniemożliwić zachowanie modelu zgodnie z oczekiwaniami. Te problemy są wyświetlane na liście błędów programu Visual Studio.

Model można zweryfikować, otwierając menu skrótów dla usługi BDC Projektant, a następnie wybierając pozycję Weryfikuj. Jeśli model zawiera jakiekolwiek błędy, są one wyświetlane na liście błędów. Możesz szybko przenieść kursor do kodu zawierającego błąd, klikając dwukrotnie błąd na liście. Alternatywnie możesz wybrać klawisze F8 lub Shift+F8 wielokrotnie, aby przejść do przodu lub do tyłu przez błędy na liście.

Błędy walidacji mogą wystąpić, gdy reguły modelu są w jakiś sposób naruszone. Jeśli na przykład właściwość IsCollection deskryptora typu jest ustawiona na wartość true, ale nie istnieją deskryptory typów podrzędnych, zostanie wyświetlony błąd walidacji. Może być konieczne odwołanie się do reguł modelu usługi BDC, aby zrozumieć niektóre błędy wyświetlane na liście błędów programu Visual Studio. Aby uzyskać więcej informacji na temat reguł modelu usługi BDC, zobacz BDCMetadata Schema (Schemat BDCMetadata).

Debugowanie rozwiązania zawierającego model

Możesz debugować kod tak, jak w przypadku debugowania dowolnego kodu w programie Visual Studio. Aby debugować kod, ustaw punkty przerwania w dowolnym miejscu w kodzie, a następnie uruchom debuger. Program Visual Studio otwiera witrynę programu SharePoint. W programie SharePoint utwórz listę lub składnik Web Part, który używa danych biznesowych. Następnie możesz przejść przez kod. Aby uzyskać więcej informacji na temat debugowania projektów programu SharePoint, zobacz Rozwiązywanie problemów z rozwiązaniami programu SharePoint.

Możesz również debugować kod w zestawach niestandardowych dodanych do projektu. Jednak aby debugować kod w zestawie niestandardowym, należy dodać zestaw do pakietu rozwiązania. Aby uzyskać więcej informacji, zobacz How to: Add and remove additional assemblies (Instrukcje: dodawanie i usuwanie dodatkowych zestawów).

Aby uzyskać więcej informacji na temat dodawania niestandardowego zestawu do projektu, zobacz Instrukcje: dołączanie zestawu niestandardowego do funkcji usługi BDC.

Konfigurowanie zabezpieczeń usługi BDC

Zanim będzie można debugować rozwiązanie, może być konieczne zmodyfikowanie ustawień zabezpieczeń w programie SharePoint. Aby zmodyfikować te ustawienia, otwórz aplikację usługi Połączenie ivity danych biznesowych w witrynie sieci Web programu SharePoint 2010 Central Administracja istration. W oknie dialogowym Ustawianie uprawnień magazynu metadanych dodaj konto użytkownika, a następnie wybierz dowolną z następujących opcji:

Zadanie	Opcja
Aby wdrożyć modele w usłudze BDC.	Edytuj
Aby utworzyć listy i składniki Web Part przy użyciu typów zawartości zewnętrznej (jednostek) w modelu.	Wybór w obszarze Klienci
Aby tworzyć, odczytywać, aktualizować i usuwać dane jednostki.	Wykonywanie

Aby uzyskać więcej informacji na temat tych ustawień, zobacz Zarządzanie usługami Połączenie ivity danych biznesowych.

Można również ustawić uprawnienia zabezpieczeń dla poszczególnych modeli lub typów zawartości zewnętrznej. Aby uzyskać więcej informacji na temat ustawiania uprawnień zabezpieczeń modelu, zobacz Zarządzanie modelami usługi BDC. Aby uzyskać więcej informacji na temat ustawiania uprawnień zabezpieczeń typu zawartości zewnętrznej, zobacz Zarządzanie typami zawartości zewnętrznej.

Uwaga

Użyj tych ustawień, aby debugować rozwiązanie w lokalnym programie SharePoint Server. Aby uzyskać więcej informacji na temat konfigurowania ustawień zabezpieczeń związanych z usługą BDC na produkcyjnym serwerze programu SharePoint, zobacz Omówienie zabezpieczeń usług Połączenie ivity Services dla danych biznesowych.

Wycofaj modele, które stają się uszkodzone

Przy pierwszym uruchomieniu debugera program Visual Studio wdraża cały model w programie SharePoint. Za każdym razem program Visual Studio aktualizuje model w programie SharePoint z wszelkimi zmianami wprowadzanymi między wdrożeniami.

Mogą wystąpić sytuacje, w których program Visual Studio całkowicie wycofa model z programu SharePoint. Na przykład model może ulec uszkodzeniu. Aby ponownie wdrożyć model w programie SharePoint, ustaw właściwość Incremental Update modelu na False, a następnie uruchom debuger. Właściwość Aktualizacja przyrostowa jest wyświetlana w oknie Właściwości po wybraniu węzła reprezentującego model w Eksploratorze usługi BDC. Domyślnie nazwa modelu to BdcModel1.

Zmienianie nazw identyfikatorów jednostek w modelu

Jeśli zmienisz nazwę identyfikatora po wdrożeniu modelu, może zostać wyświetlony błąd wdrożenia. Nie można usunąć tego błędu, ustawiając właściwość Incremental Update modelu na False. Należy wycofać model ręcznie, a następnie ponownie wdrożyć rozwiązanie. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z rozwiązaniami programu SharePoint. Ten błąd można uniknąć, ustawiając właściwość Incremental Update na False przed początkowym wdrożeniem modelu.

Znajdowanie dokumentacji elementów modelu usługi BDC

Program Visual Studio dodaje element XML do modelu dla każdej utworzonej jednostki, metody lub innego elementu. Atrybuty elementu są wyświetlane jako właściwości w oknie Właściwości . Aby uzyskać informacje o elementach i atrybutach generowanych przez program Visual Studio podczas projektowania modelu, zobacz BDCMetadata Schema (Schemat BDCMetadata).

Powiązane tematy

Nazwa	opis
Omówienie narzędzi projektowych modelu usługi BDC	Opisuje narzędzia, których można użyć do wizualnego projektowania modelu dla usługi BDC.
Instrukcje: dodawanie jednostki do modelu	Przedstawia sposób dodawania do modelu typów zawartości zewnętrznej lub jednostek.
Instrukcje: Dodawanie metody wyszukiwania	Przedstawia sposób dodawania metody, która umożliwia użytkownikom wyświetlanie listy jednostek na liście lub składniku Web Part.
Instrukcje: Dodawanie określonej metody wyszukiwania	Przedstawia sposób dodawania metody, która umożliwia użytkownikom wyświetlanie szczegółów określonej jednostki.
Instrukcje: dodawanie metody Creator	Przedstawia sposób dodawania metody, która umożliwia użytkownikom dodawanie rekordów do źródła danych bezpośrednio z listy lub składnika Web Part.
Instrukcje: dodawanie metody Deleter	Przedstawia sposób dodawania metody, która umożliwia użytkownikom usuwanie danych ze źródła danych przy użyciu opcji w interfejsie użytkownika listy lub składnika Web Part.
Instrukcje: dodawanie metody aktualizatora	Przedstawia sposób dodawania metody, która umożliwia użytkownikom zmienianie rekordów danych w źródle danych bezpośrednio z listy lub składnika Web Part.
Instrukcje: dodawanie parametru do metody	Pokazuje, jak używać okna Szczegóły metody w programie Visual Studio do dodawania parametrów wejściowych i zwracania parametrów do metody.
Instrukcje: Definiowanie deskryptora typu parametru	Przedstawia sposób definiowania typów danych parametrów w modelu.
Instrukcje: definiowanie wystąpienia metody	Pokazuje, jak utworzyć wystąpienie metody wykonywanej przez usługę BDC.
Instrukcje: dodawanie deskryptora filtru do metody wyszukiwania	Pokazuje, jak umożliwić użytkownikom ograniczenie liczby wystąpień zwracanych przez metodę wyszukiwania.
Tworzenie skojarzenia między jednostkami	Opisuje sposób definiowania relacji między jednostkami w modelu. Dane biznesowe składniki Web Part, listy zewnętrzne i aplikacje niestandardowe mogą wyświetlać te relacje danych w interfejsie użytkownika.
Instrukcje: tworzenie skojarzenia między jednostkami	Przedstawia sposób definiowania relacji między jednostkami w modelu.
Przewodnik: tworzenie listy zewnętrznej w programie SharePoint przy użyciu danych biznesowych	Zawiera instrukcje krok po kroku, które pokazują, jak utworzyć i przetestować model, który wyświetla kontakty na liście zewnętrznej programu SharePoint.
Integrowanie danych biznesowych z programem SharePoint	Zawiera omówienie tworzenia i projektowania modeli dla usługi BDC.