Integracja z SharePoint

Integracja z SharePoint umożliwia przechowywanie i współdzielenie dokumentów w firmowym repozytorium Microsoft.

Na czym polega integracja z SharePoint

Integracja z SharePoint oznacza połączenie aplikacji, systemu operacyjnego lub usługi z platformą Microsoft SharePoint w taki sposób, aby możliwe było korzystanie z dokumentów, bibliotek plików, list i wybranych mechanizmów współpracy bez ręcznego przenoszenia danych. SharePoint może działać jako usługa SharePoint w Microsoft 365 albo jako SharePoint Server instalowany w infrastrukturze organizacji. Sposób integracji zależy od używanej odmiany platformy, konfiguracji witryny oraz uprawnień przypisanych użytkownikowi.

Najczęściej połączenie obejmuje bibliotekę dokumentów, czyli miejsce przechowywania plików z metadanymi, historią wersji i kontrolą dostępu. Biblioteka może być dostępna przez przeglądarkę internetową, aplikacje Microsoft 365, synchronizację z komputerem za pomocą klienta OneDrive albo interfejs programistyczny. Sama integracja nie oznacza automatycznie pełnej synchronizacji wszystkich danych. Zakres operacji może obejmować tylko odczyt, tylko zapis, wyszukiwanie dokumentów, pobieranie metadanych lub wybrane procesy obiegu plików.

Biblioteki dokumentów, listy i metadane

SharePoint przechowuje dokumenty w bibliotekach, a informacje dodatkowe w kolumnach i metadanych. Dzięki temu plik może być wyszukiwany nie tylko po nazwie, lecz także według autora, daty modyfikacji, typu dokumentu, statusu lub innych pól zdefiniowanych w danej bibliotece. Integrująca się aplikacja musi poprawnie rozpoznawać, czy operuje na zawartości pliku, jego właściwościach, czy na elemencie listy SharePoint. Dokument i rekord listy są powiązanymi, ale odmiennymi obiektami.

Istotnym mechanizmem jest wersjonowanie. Jeżeli biblioteka ma włączoną historię wersji, kolejne zapisy mogą tworzyć nowe wersje zamiast bezpośrednio zastępować poprzednią zawartość. Aplikacja integracyjna powinna uwzględniać możliwość równoczesnej edycji oraz konfliktu wersji. W przypadku plików używanych przez kilka osób problem może powstać wtedy, gdy jeden proces pobierze starszą wersję, a następnie spróbuje zapisać ją po zmianie wykonanej przez innego użytkownika.

SharePoint pozwala również na stosowanie unikatowych uprawnień na poziomie witryny, biblioteki, folderu lub pojedynczego elementu. Z tego powodu poprawne zalogowanie do platformy nie gwarantuje dostępu do każdego dokumentu. Integracja powinna obsługiwać odpowiedzi informujące o braku uprawnień, nieistniejącym zasobie, przeniesionym pliku lub wymaganej dodatkowej autoryzacji, zamiast traktować każdy błąd jako uszkodzenie dokumentu.

Autoryzacja i komunikacja z platformą Microsoft

Współczesne integracje z SharePoint Online korzystają zwykle z tożsamości Microsoft Entra ID, wcześniej nazywanej Azure Active Directory, oraz protokołu OAuth 2.0. Aplikacja otrzymuje token dostępu wydany dla określonego zasobu i zakresu uprawnień. Token nie powinien być utożsamiany z hasłem użytkownika ani przechowywany w zwykłym pliku tekstowym. Jego ważność jest ograniczona, dlatego aplikacja musi przewidywać odnowienie sesji lub ponowne uwierzytelnienie.

Do komunikacji z SharePoint mogą być używane między innymi interfejsy Microsoft Graph oraz starsze interfejsy SharePoint REST. Microsoft Graph udostępnia zasoby związane z witrynami, dyskami i elementami, natomiast SharePoint REST odwołuje się bezpośrednio do funkcji platformy SharePoint. Nie można bez sprawdzenia zamieniać jednej składni na drugą, ponieważ różnią się adresami zasobów, nazwami parametrów, sposobem wyboru pól i obsługą uprawnień. W przypadku SharePoint Server dostępne możliwości zależą dodatkowo od wersji i konfiguracji instalacji.

Podczas diagnostyki połączenia sprawdza się kolejno rozwiązywanie nazwy witryny, dostęp do sieci, certyfikat TLS, moment wygaśnięcia tokenu, zakres przyznanych uprawnień oraz identyfikator biblioteki lub folderu. Warto odróżnić błąd uwierzytelnienia od błędu autoryzacji: pierwszy oznacza problem z potwierdzeniem tożsamości, a drugi sytuację, w której tożsamość jest znana, lecz nie ma prawa wykonać żądanej operacji. Przy dużej liczbie żądań może pojawić się ograniczenie częstotliwości, czyli throttling. Aplikacja powinna wtedy stosować ponowienie z opóźnieniem, respektując informacje zwrotne serwera.

Diagnostyka integracji na komputerze użytkownika

Na laptopie lub komputerze PC problemy z integracją mogą wynikać z uszkodzonego profilu przeglądarki, nieaktualnego klienta synchronizacji, błędnego konta Microsoft, niedostępności sieci albo zapisania nieprawidłowego adresu witryny. Pierwszym krokiem jest ustalenie, czy problem występuje wyłącznie w jednej aplikacji, czy również w przeglądarce. Jeżeli biblioteka otwiera się w przeglądarce, ale nie synchronizuje się lokalnie, zakres poszukiwań obejmuje klienta OneDrive, wybraną lokalizację synchronizacji i stan konta użytkownika.

Przy analizie należy sprawdzić dokładny komunikat błędu, adres witryny, nazwę biblioteki oraz moment wystąpienia problemu. Znaczenie ma także to, czy błąd dotyczy pojedynczego dokumentu, całej biblioteki, zapisu nowych plików czy tylko pobierania. Plik może być niedostępny z powodu blokady, konfliktu wersji, zbyt długiej ścieżki, niedozwolonego znaku w nazwie albo ograniczenia wynikającego z uprawnień. Usunięcie lokalnego pliku synchronizacji bez wcześniejszego sprawdzenia stanu w SharePoint może doprowadzić do pomieszania kopii, dlatego kolejność działań powinna wynikać z ustalonego przepływu danych.

Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC i ich podzespołów. W przypadku problemu z integracją z SharePoint możliwe jest sprawdzenie podstawowego środowiska na komputerze, w tym połączenia sieciowego, działania przeglądarki, klienta synchronizacji oraz konfiguracji systemu. Sama konfiguracja uprawnień witryny, polityk organizacji i zasobów po stronie platformy wymaga dostępu administracyjnego do właściwego środowiska Microsoft.