Od czasu do czasu (zwłaszcza kiedy pracujemy jako support SharePointa) potrzebujemy na podstawie szablonu witryny stworzyć nową witrynę. Jest to przydatne zwłaszcza, kiedy zrobimy jakieś rozwiązanie i chcemy je przenieść do klienta albo kiedy klient ma problem i chce nam przesłać swoje rozwiązanie do debugowania. Samo przenoszenie jest proste, możemy jednak przy tworzeniu witryny dostać uciążliwy do zwalczenia błąd spowodowany brakiem funkcji na witrynie. Dotyczy to zarówno pełnego SharePoint Serwera jaki i SharePoint Foundation.

Żeby przenieść witrynę w szablonie wchodzimy w ustawienia witryny, w grupie "Akcje witryny" wybieramy "Zapisywanie witryny jako szablonu" (zaznaczając lub nie opcję zapisywania zawartości, co ma wpływ na to czy przeniosą się nam również wpisy na listach i biblioteki w dokumentach, ale również i przepływy) i po pomyślnym zapisaniu witryny przechodzimy do galerii rozwiązań za pomocą miłego linka ("galeria rozwiązań") dostarczonego przez twórców SP. Z galerii zapisujemy sobie nasz plik WSP (warto pamiętać, pod jaką nazwą go zapisujemy, zwłaszcza jak to robimy po raz 10 danego dnia) na dysku.
Następnie przechodzimy na środowisko docelowe - na główną witrynę kolekcji witryn (a nie np. podwitrynę pod którą chcemy stworzyć witrynę). Tam ponownie wchodzimy na ustawienia witryny i w grupie "Galerie" wybieramy "Rozwiązania" (niezbyt oczywiste miejsce do szukania szablonów witryn dla osób przechodzących z SP2007). Teraz musimy zrobić następujące kroki:

• Klikamy na zakładkę "Rozwiązania" (mimo iż wygląda jakby była już wybrana)
• Klikamy "Przekaż rozwiązanie"
• Wgrywamy plik WSP, który zapisaliśmy uprzednio na dysku
• Aktywujemy rozwiązanie

Teraz możemy stworzyć nową witrynę na podstawie wgranego szablonu. Wchodzimy na witrynę pod którą chcemy stworzyć nową witrynę i wybieramy z akcji witryny (menu w górnym lewym rogu) "Utwórz witrynę". W menu po lewej wybieramy kategorię "Puste i niestandardowe", wybieramy nasz szablon, wpisujemy tytuł i URL i klikamy "Utwórz".

I tu dochodzimy do "klu programu": jeżeli na środowisku były zainstalowane/włączone funkcje, które były włączone na środowisku źródłowym, które nie są dostępne na docelowym to dostaniemy piękny błąd "Szablon witryny wymaga aktywowania funkcji {długi GUID} w zbiorze witryn. Identyfikator korelacji: {kolejny GUID}" (ang: :The site template requires that the Feature {GUID} be installed in the farm or site collection. Corelation ID: {GUID}"). Rozwiązaniem tego błędu jest zainstalowanie/włączenie brakującej funkcji. Problem polega na tym, że mamy piękny GUID, który nam nie mówi którą funkcję powinniśmy włączyć. Możemy oczywiście otworzyć stronę zarządzania funkcjami na witrynie źródłowej i docelowej i posprawdzać, które funkcje były włączone na źródle i włączyć je na witrynie docelowej. Jeżeli jednak mamy dużo funkcji to może to być trudne i czasochłonne, ponadto czasami nie mamy dostępu do środowiska źródłowego. Dodatkowo są funkcje, których nie widać na stronie zarządzania funkcjami i konieczne jest włączenie ich z konsoli. Identyfikacja funkcji po GUIDzie jest żmudna, zwłaszcza, że zespół, który robił funkcjonalność tworzenia witryny uniemożliwił skopiowanie GUIDu brakujących funkcji zmuszając nas do przepisywania go ręcznie.

Wypracowałem metodę, która bardzo przyspieszy cały proces. Do jej wykonania potrzebujemy dostępu RDP do maszyny z SharePointem. Będziemy korzystali z PowerShella i narzędzia ULS Log viewer (darmowe, z CodePleksu).
Oto scenariusz:

1. Włączamy logowanie dla "Infrastruktura funkcji" ("Feature infrastructure") na poziom "Podlegający monitorowaniu" ("Monitorable").
2. Uruchamiamy LogViewera, włączamy logowanie na żywo i wpisujemy "szablon witryny wymaga" do okna filtrowania. W przypadku angielskich witryn wpisujemy "site template requires".
3. Próbujemy utworzyć witrynę.
4. Dostajemy błąd, który złapie LogViewer. W komunikacie błędu będzie GUID funkcji, który możemy skopiować.
5. Uruchamiamy konsolę PowerShella i wpisujemy komendę:
   Enable-SPFeature -url {adres witryny, pod którą tworzymy witrynę} -Identity {GUID funkcji} np. Enable-SPFeature -url http://intranet -Identity 861b0621-3ab9-46ec-859e-112c04535099
6. Powtarzamy punkty 3-5 aż uda nam się stworzyć witrynę. 2 porady przyspieszające pracę:
   1. po pierwszym otrzymaniu błędu, gdy zamkniemy okno z błędem guzik "utwórz" będzie wyszarzony. Jeżeli klikniemy "Więcej opcji" to będziemy mogli ponawiać tworzenie witryny
   2. Wciskając F3 w konsoli PowerShell otrzymujemy ostatnią komendę. Wystarczy usunąć GUIDa poprzedniej funkcji i wkleić kolejnej.

Czasami może się okazać, że funkcja nie jest zainstalowana/wdrożona na wyższym poziomie i nie da się jej włączyć. Wtedy z pomocą przyjdzie nam przetłumaczenie GUIDa na nazwę funkcji. Na dole tego postu znajduje się listę większości GUIDów standardowych funkcji SharePointa, ale możemy po prostu wpisać GUID funkcji w wyszukiwarkę WWW i prawdopodobnie znajdziemy nazwę brakującej funkcji.

Jeżeli GUIDu funkcji nie ma na tej stronie, to jest duża szansa, że jest to jakaś funkcja rozwiązania firmy trzeciej. Jeżeli po wpisaniu GUIDu w Googla (lub Binga) nie dowiemy się jakiej funkcji brakuje to musimy na środowisku źródłowym odpalić następujący kod PowerShella:
Get-SPFeature {GUID}
np. Get-SPFeature 00bfea71-7e6d-4186-9ba8-c047ac750105

Dzięki temu dowiemy się co musimy zainstalować/wdrożyć.

Tak na marginesie - wystarczyłoby, żeby przy tworzeniu witryny nastąpiło sprawdzenie jakie funkcje są potrzebne używanemu szablonowi (bo jest to wpisane w manifeście) i udostępniono guzik "Włącz brakujące funkcje". Może ktoś z deweloperów zrobi takie małe narzędzie?

Powodzenia i cierpliwości! Dużo cierpliwości!

Lista funkcji i ich GUIDy:

Autor:

Paweł Wróbel

Zajmuję się SharePointem od 2003 roku. Nie potrafię za bardzo programować, ale rozumiem jak działa SharePoint, wiem jak go skonfigurować i dostosować do moich potrzeb. Mimo, że na wizytówce mam "analityk", to często grzebię w bebechach SharePointa i konfiguruję go z każdej możliwej strony, która nie wymaga uruchomienia Visual Studio.
nocodesharepoint.blogspot.com