Składniki Web Part — informacje

Składnik Web Part jest modularną jednostką informacji o wyraźnie określonym celu, stanowiącą podstawowy element budulcowy strony składników Web Part. Składnik Web Part składa się z dwóch podstawowych plików i często wymaga dodatkowych plików zasobów, a wartości jego właściwości są przechowywane w tabelach bazy danych. Zrozumienie działania składników Web Part może pomóc w ich współużytkowaniu w bardziej kreatywny i interesujący sposób oraz w unikaniu niepotrzebnych problemów.

Poniższy diagram przedstawia budowę składnika Web Part na przykładzie składnika Web Part Obraz.

Omówienie architektury składnika Web Part

1 Plik opisu składnika Web Part Obraz (.dwp) to przenośny pojemnik domyślnych i spersonalizowanych wartości właściwości składnika Web Part Obraz.

2 Plik zestawu składnika Web Part Obraz (.dll) zawiera logikę i kod składnika Web Part Obraz i jest instalowany na serwerze witryny.

3 Pliki zasobów pomocniczych składnika Web Part Obraz są również przechowywane na serwerze witryny.

4 Tabele z bazy danych programu Windows SharePoint Services są używane do przechowywania bieżących wartości właściwości Web Part Obraz.

Budowa składnika Web Part opiera się na dwóch koncepcjach, które należy rozumieć:

Istnieje tylko jeden plik zestawu składnika Web Part, ale może być wiele wystąpień składników Web Part używanych w witrynie (czy nawet w innych witrynach). Każde wystąpienie określonego składnika Web Part może mieć podobny lub różny wygląd i działanie, ale opiera się na tym samym pliku zestawu zainstalowanym na serwerze witryny. W pliku zestawu składnika Web Part może się znajdować kod wielu składników Web Part.
Aby składnik Web Part działał prawidłowo, muszą istnieć oba pliki, a także ewentualne dodatkowe pliki zasobów, dostępne w witrynie. Nie stanowi to raczej problemu w przypadku składników Web Part wbudowanych w program Microsoft Windows SharePoint Services, ale może być utrudnieniem w przypadku składników Web Part uzyskiwanych z innego źródła.

Plik opisu składnika Web Part to plik tekstowy XML z rozszerzeniem .dwp. Może on zawierać następujące elementy:

Nazwy i ustawienia właściwości wystąpienia tego składnika Web Part.
Odwołanie do towarzyszącego mu pliku zestawu składnika Web Part (.dll).
Zmiany wprowadzone do ustawień właściwości niestandardowych w sytuacji, gdy jakiś użytkownik spersonalizował składnik Web Part.

Oto plik opisu składnika Web Part dla składnika Web Part Obraz:

<?xml version="1.0" encoding="utf-8"?>
<WebPart xmlns:xsd="http://www.w3.org/2001/XMLSchema"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xmlns="http://schemas.microsoft.com/WebPart/v2"> (1)
  <Title>Image Web Part</Title>
  <FrameType>Default</FrameType>
  <Description>Use to display pictures and photos.</Description>
  <IsIncluded>true</IsIncluded>
  <ZoneID>LeftColumn</ZoneID>
  <PartOrder>1</PartOrder>
  <FrameState>Normal</FrameState>
  <Height /> (2)
  <Width />
  <AllowRemove>true</AllowRemove>
  <AllowZoneChange>true</AllowZoneChange>
  <AllowMinimize>true</AllowMinimize>
  <IsVisible>true</IsVisible>
  <DetailLink />
  <HelpLink />
  <Dir>Default</Dir>
  <PartImageSmall />
  <MissingAssembly />
  <PartImageLarge>/_layouts/images/msimagel.gif</PartImageLarge> (3)
  <IsIncludedFilter />
  <Assembly>Microsoft.SharePoint, Version=11.0.0.0, Culture=neutral, 
     PublicKeyToken=71e9bce111e9429c</Assembly>
</WebPart> (1)

1 Element WebPart identyfikuje ten kod XML jako plik opisu składnika Web Part i zawiera wszystkie pozostałe elementy pliku.

2 Jeśli wartość jakiejś właściwości jest pusta, składnik Web Part używa wartości domyślnych przechowywanych w tabelach bazy danych.

3 Jeśli wartość właściwości nie jest pusta, składnik Web Part zastępuje wartość domyślną i używa nowej wartości dla tego wystąpienia składnika Web Part.

Podczas instalacji programu Windows SharePoint Services plik opisu składnika Web Part jest często zapisywany w galerii składników Web Part witryny. Z czasem są tworzone inne wystąpienia tego pliku opisu składnika Web Part, gdy użytkownicy eksportują składniki Web Part, a administrator witryny przekazuje i pobiera składniki Web Part.

Plik zestawu składnika Web Part jest plikiem biblioteki dynamicznej programu ASP.NET (.dll) zawierającym logikę i kod składnika Web Part. Jest to plik towarzyszący plikowi opisu składnika Web Part. Wszystkie wystąpienia określonego składnika Web Part w danej witrynie są oparte na tylko jednym pliku zestawu. Ten plik zestawu zawiera kod zarządzany odziedziczony po formancie formularza sieci Web programu ASP.NET (def). Kod zarządzany jest kluczowy dla działania składnika Web Part, ponieważ strona składników Web Part jest stroną sieci Web programu ASP.NET (.aspx).

Podczas instalowania programu Windows SharePoint Services dla każdego składnika Web Part na serwerze witryny jest instalowany jego plik zestawu. Z biegiem czasu na serwerze mogą się pojawiać dodatkowe niestandardowe składniki Web Part instalowane przez administratora witryny. Poza tym w folderach systemowych na serwerze witryny są instalowane wszystkie pliki zasobów wymagane przez składnik Web Part, na przykład obrazy, alternatywne pliki języków i inne pliki pomocnicze. Aby składnik Web Part był bezpieczny, musi zostać zarejestrowany przez administratora witryny jako formant bezpieczny.

Każdy składnik Web Part udostępnia zestaw właściwości wspólnych (zwanych także właściwościami klasy bazowej), umieszczonych w sekcjach w okienku zadań, które kontrolują jego wygląd (na przykład tytuł, wysokość i szerokość), układ (na przykład kolejność składników Web Part wewnątrz strefy i kierunek ułożenia elementów) oraz cechy zaawansowane (takie jak ikona obrazu i opis).

Wiele składników Web Part ma również właściwości niestandardowe, które są związane wyłącznie z jednym określonym składnikiem. Są one zwykle wyświetlane powyżej lub poniżej właściwości wspólnych składnika Web Part w okienku narzędzi. Na przykład składnik Web Part Obraz ma dodatkowe właściwości niestandardowe, takie jak łącze obrazu, jego wyrównanie w poziomie i pionie czy kolor tła.

Uwaga W zależności od tego, jak składnik Web Part został utworzony, w niektórych przypadkach właściwość niestandardowa składnika Web Part może być wyświetlana w domyślnej sekcji Różne poniżej właściwości wspólnych w okienku narzędzi.

Wystąpienie składnika Web Part może zostać sklasyfikowane jako jedno z trzech typów:

Udostępniony składnik Web Part Składnik Web Part dodany do strony składników Web Part przez użytkownika, który tworzy lub wprowadza zmiany do tej strony w widoku udostępnionym. Udostępnione składniki Web Part są dostępne dla wszystkich użytkowników strony składników Web Part, którzy dysponują odpowiednim uprawnieniem.

Spersonalizowany składnik Web Part Udostępniony składnik Web Part zawierający przynajmniej jedną właściwość zmodyfikowaną przez użytkownika, który wprowadził do niego zmiany w widoku osobistym. Zmiany wprowadzane do spersonalizowanego składnika Web Part są dostępne tylko dla użytkownika, który jest ich autorem. Inni użytkownicy, którzy nie wprowadzali zmian w widoku osobistym, widzą nadal udostępniony składnik Web Part.

Prywatny składnik Web Part Składnik Web Part, który został dodany przez użytkownika do strony składników Web Part z galerii składników Web Part lub zaimportowany z komputera podczas tworzenia strony składników Web Part lub wprowadzania na niej zmian w widoku osobistym. Prywatne składniki Web Part są dostępne tylko dla użytkownika, który je dodał lub zaimportował. Pozostali użytkownicy nie mogą widzieć prywatnych składników Web Part innych osób.

Typ używanego składnika Web Part może być istotny z następujących względów:

Użytkownik może mieć uprawnienia do modyfikowania tylko niektórych typów składników Web Part na jednych stronach składników Web Part, a na innych nie.
Użytkownik może tworzyć połączenia z jednymi typami składników Web Part na stronie składników Web Part, a z innymi typami na tej samej stronie nie.

Istnieje kilka istotnych zalet architektury składników Web Part i oddzielenia wystąpień plików opisu składnika Web Part (.dwp) od plików zestawu składnika Web Part (.dll).

Współużytkowanie Użytkownicy mogą bez trudu personalizować składniki Web Part, nie wpływając na wystąpienia tych samych składników należące do innych użytkowników. Użytkownicy i administratorzy witryn mogą łatwo udostępniać wystąpienia składników Web Part, wysyłając ich pliki opisu pocztą e-mail lub przekazując składniki Web Part do galerii w innych witrynach.

Transport Główną zaletą plików opisu składnika Web Part jest to, że są małe, a tym samym łatwe do transportowania i powielania. Podczas eksportowania, importowania, pobierania lub przekazywania składnika Web Part, plik opisu składnika Web Part jest tym, którym się rzeczywiście manipuluje.

Wydajność To, że plik zestawu składnika Web Part jest kodem wstępnie skompilowanym, przyspiesza wykonywanie strony składników Web Part. Strona ta nie wymaga interpretowania dużej ilości logiki i kodu. Ponieważ do zainstalowania jest tylko jeden plik zestawu, administratorzy witryn dysponują prostymi metodami „dławienia” i kontrolowania składników Web Part, umożliwiającymi im pilnowanie, aby żaden użytkownik i żadna strona składników Web Part nie angażowali zbyt wiele zasobów systemowych.

Skalowalność Ponieważ właściwości składników Web Part są przechowywane w tabelach baz danych, wielu użytkowników może współużytkować składniki Web Part i tworzyć wiele ich wystąpień, nie pogarszając ogólnej wydajności systemu. Można ponadto równoważyć obciążenie i upraszczać instalację składnika Web Part, przygotowując plik pakietu składników Web Part (.cab) i umieszczając składniki Web Part w galerii składników Web Part serwera wirtualnego.

Bezpieczeństwo Używając standardowych praw i grup lokacji w programie Microsoft Windows SharePoint Services, administrator witryny może kontrolować, kto może mieć dostęp do strony składników Web Part, przeglądać i modyfikować dane składnika Web Part Widok listy, personalizować stronę składników Web Part, dodawać i usuwać składniki Web Part oraz modyfikować właściwości składnika Web Part. Administrator witryny może także kontrolować, które składniki Web Part będą zainstalowane w witrynie i czy będą one mogły być uruchamiane w danej witrynie.

Utrzymanie Administrator witryny może łatwo kontrolować, które składniki Web Part działają w witrynie, kontrolując instalację pliku zestawu składnika Web Part. Poza tym, jeśli jakiś składnik Web Part wymaga zmian lub jeśli pojawi się jego nowa wersja z dodatkowymi funkcjami, wystarczy, że administrator witryny zainstaluje tylko jeden nowy plik zestawu (plus ewentualne nowe pliki zasobów) dla wszystkich wystąpień składnika Web Part, aby uaktywnić nowo wprowadzone zmiany i funkcje.

Składniki Web Part są dobrze przenośne i zostały zaprojektowane pod kątem łatwego eksportu, transportu i importu. Gdy jakiś użytkownik personalizuje składnik Web Part lub gdy administrator witryny wprowadza zmianę w stronie składników Web Part dotyczącą wszystkich użytkowników, użytkownik ten lub administrator może udostępnić składnik innym użytkownikom lub nawet innej witrynie. Oto przykład:

Składnik Web Part można wyeksportować ze strony składników Web Part, a następnie wysłać plik opisu składnika Web Part (.dwp) pocztą e-mail do innych użytkowników. Inni użytkownicy mogą następnie zaimportować składnik Web Part do strony składników Web Part. Ewentualnie administrator witryny może przekazać składnik Web Part bezpośrednio do galerii składników Web Part, aby wszyscy użytkownicy mogli mieć do tego składnika dostęp.
Administrator witryny może wyeksportować składnik Web Part z galerii składników Web Part, a następnie zapisać plik w publicznej lokalizacji. Inni użytkownicy mogą następnie importować składnik Web Part do stron składników Web Part. Ewentualnie administrator innej witryny może przekazać plik opisu składnika Web Part do galerii składników Web Part innej witryny.

W każdym przypadku należy zagwarantować, aby plik zestawu składnika Web Part został również zainstalowany w nowej witrynie, aby mógł w niej działać nowo utworzony składnik Web Part.

Uwaga Składnika Web Part Widok listy nie można eksportować. Listy są związane z określoną witryną i nie mogą być transportowane do innych witryn, tak jak inne składniki Web Part. Aby przenieść dane listy z jednej witryny do innej, można wyeksportować dane listy z jednej witryny, a następnie zaimportować je do listy znajdującej się w innej witrynie, co automatycznie spowoduje dodanie składnika Web Part Widok listy z nowymi danymi listy do galerii składników Web Part tej witryny.