SharePoint — część B: obsługa
Bieżąca praca z plikami i folderami, przypisanie ich do projektów oraz wymiana wygasającego sekretu.
Obsługę wykonuje klient samodzielnie. Pliki i foldery zmienia w SharePoint. Przypisania folderów i sekret klienta zmienia w Edmundzie osoba z rolą Administrator. Nie wymaga to udziału zespołu Edmunda.
7. Zakres monitorowania
Edmund odczytuje jedną bibliotekę dokumentów w jednej witrynie, a w niej wyłącznie foldery przypisane do projektów, łącznie z podfolderami.
| Zagadnienie | Działanie |
|---|---|
| Częstotliwość | Wykrycie zmiany w ciągu 10 minut. Przetwarzanie pojedynczego dokumentu trwa zwykle minuty, a pierwsze wczytanie setek plików może trwać godziny |
| Kierunek | Jednokierunkowy; Edmund niczego nie zapisuje w SharePoint |
| Zakres | Tylko przypisane foldery. Pliki poza nimi są niewidoczne niezależnie od formatu |
Nie są odczytywane pliki poza przypisanymi folderami ani formaty niewymienione w dodatku. Maksymalny obsługiwany rozmiar to 500 MB na plik. Większych plików nie umieszczaj w monitorowanych folderach. Duży skan można podzielić na części, co ułatwia także wyszukiwanie.
Rejestrowane dane pliku
| Dane | Zastosowanie |
|---|---|
| Nazwa i pełna ścieżka w bibliotece | Identyfikacja pliku i projektu |
| Rozmiar | Raportowanie |
| Data utworzenia i ostatniej modyfikacji | Wykrywanie zmian |
| Skrót zawartości | Wykrywanie zmian i identycznej zawartości |
Autor, ostatni edytor i kolumny niestandardowe biblioteki nie są odczytywane. Nie pojawiają się w metadanych Edmunda, a sama ich zmiana nie uruchamia przetwarzania.
8. Bieżąca praca z plikami
8.1 Dodanie pliku
- Prześlij plik do przypisanego folderu właściwego projektu.
- Otwórz projekt w Edmundzie. Plik pojawia się na liście już podczas przetwarzania, ze statusem indeksowania i źródłem SharePoint.
- Po pomyślnym indeksowaniu dokument staje się dostępny dla odpowiedzi na czacie.
Plik o identycznej zawartości, który już istnieje w Edmundzie z innego źródła, nie jest duplikowany. Pozostaje istniejący dokument, a jego źródło zmienia się na SharePoint. Można więc przenieść projekt z ręcznego przesyłania do synchronizacji, umieszczając te same pliki w monitorowanym folderze.
8.2 Aktualizacja pliku
Prześlij nową wersję do tego samego folderu pod tą samą nazwą. Edmund wykrywa zmianę i zastępuje dokument. Projekt zachowuje jeden wpis; ręczne usuwanie poprzedniego nie jest potrzebne.
Nowa zawartość odpowiada po pomyślnym indeksowaniu. Do tego momentu używana jest poprzednia wersja, więc dokument nie znika w trakcie aktualizacji.
Aktualizacja tworzy nowy rekord Edmunda. Nazwa na liście pozostaje, ale odnośnik do poprzedniego rekordu, np. ze starszego czatu, przestaje działać. Jest to skutek zastąpienia całego dokumentu.
Ponowne przesłanie pliku o niezmienionej nazwie, dacie i zawartości jest rozpoznawane i pomijane.
8.3 Historia wersji
SharePoint przechowuje historię wersji, ale Edmund jej nie odczytuje. Pobierana jest wyłącznie bieżąca wersja. Nie można pytać w Edmundzie o poprzednią wersję dokumentu.
Pozostaw wersjonowanie włączone w bibliotece. Aby wrócić do poprzedniej treści, przywróć wersję w SharePoint. Edmund pobierze ją przy kolejnej kontroli jak zwykłą zmianę.
8.4 Usunięcie i przywrócenie
Usunięcie pliku w SharePoint usuwa dokument z Edmunda. Nie trzeba usuwać go oddzielnie w aplikacji.
Po przywróceniu pliku z kosza SharePoint do przypisanego folderu Edmund odczyta go najpóźniej podczas nocnego uzgadniania, zwykle wcześniej. Nie przesyłaj go w międzyczasie ręcznie, ponieważ może powstać duplikat.
Usuwanie działa wyłącznie w tym kierunku. Edmund nigdy nie usuwa plików w SharePoint.
9. Zmiana nazwy i przenoszenie
Zmiana nazwy lub położenia pliku powoduje ponowny odczyt i zastąpienie dokumentu, ponieważ nazwa i ścieżka należą do jego identyfikacji. Projekt zachowuje jeden wpis pod nową nazwą. Przeniesienie poza wszystkie przypisane foldery usuwa dokument najpóźniej podczas nocnego uzgadniania.
Zmiana nazwy podfolderu wewnątrz przypisanego folderu nie zrywa przypisania, ale zmienia ścieżki wszystkich jego plików. Każdy jest ponownie odczytywany i indeksowany. Dla trzystu plików oznacza to trzysta ponownych indeksowań.
Zmiana nazwy przypisanego folderu
Zmiana nazwy lub przeniesienie samego przypisanego folderu zatrzymuje jego synchronizację. Przypisanie korzysta ze ścieżki. Gdy ścieżka przestaje istnieć, SharePoint nie zwraca folderu.
Dokumenty już zaindeksowane nie są usuwane i nadal służą do odpowiedzi. Edmund przerywa działanie przed porównaniem brakujących plików, aby niedostępny folder nie spowodował masowego usunięcia. Aktualizacje i nowe pliki przestają jednak docierać.
W Settings → Connections → SharePoint każdy folder ma stan i czas ostatniej udanej synchronizacji. Po zmianie nazwy stan zmienia się na zatrzymany, czas przestaje rosnąć i pojawia się informacja o nieodnalezieniu folderu pod zapisaną ścieżką.
Aby przywrócić synchronizację:
- Otwórz folder w SharePoint i skopiuj jego adres z przeglądarki.
- W projekcie zastąp poprzedni adres folderu i wybierz Validate. Edmund potwierdzi dostęp oraz liczbę znalezionych plików.
- Zapisz zmiany. Synchronizacja wróci przy następnym uruchomieniu, w ciągu 10 minut.
Nie trzeba ponownie przesyłać plików. Zachowują tożsamość w SharePoint. Zmienione ścieżki powodują jednak ponowny odczyt wszystkich plików, więc pierwsze uruchomienie może trwać dłużej.
Aby zmienić strukturę bez zatrzymania: utwórz nowy folder, przypisz go do projektu, przenieś pliki i dopiero potem usuń stare przypisanie.
Ten sam plik w dwóch przypisanych folderach jest odczytywany dwukrotnie, raz dla każdego folderu. Jeśli foldery należą do różnych projektów, dokument pojawia się w obu. W ten sposób można współdzielić dokumenty pomiędzy projektami. Kopia pozostawiona po przeniesieniu wyjaśnia również podwójny wpis.
10. Struktura dla nowej maszyny
Zalecana organizacja to jeden folder na projekt i jeden projekt na maszynę lub stanowisko. Wąski zakres poprawia trafność odpowiedzi. Umieszczenie wszystkiego w jednym projekcie wydłuża przetwarzanie i pogarsza wyniki.
Nazwy folderów powinny odzwierciedlać zakład, linię, operację i maszynę. Nadaj projektowi tę samą nazwę co folderowi.
Ścieżka folderu może mieć maksymalnie 512 znaków. Dozwolone są znaki diakrytyczne, spacje i symbole, np. &; Edmund koduje adres. Wybieraj stabilne nazwy: zmiana nazwy wymaga ponownego przypisania i odczytu wszystkich plików.
Kolejność:
- Utwórz folder w monitorowanej bibliotece.
- Utwórz projekt w Edmundzie przez New project, podając nazwę i etykiety.
- Przypisz folder zgodnie z rozdziałem 11.
- Prześlij dokumenty.
Można przesłać pliki przed przypisaniem. Zostaną odczytane przy pierwszym uruchomieniu po jego utworzeniu. Projekt bez przypisanego folderu nie jest odpytywany i nie powoduje błędu synchronizacji.
11. Przypisanie folderu do projektu
Administrator wykonuje je na karcie Integrations w ustawieniach projektu albo w Settings → Connections → SharePoint. Drugi widok obejmuje wszystkie projekty, ma wyszukiwanie i filtrowanie etykietami; jest wygodny przy wielu maszynach.
Używany jest adres folderu SharePoint, bez ręcznego budowania składni ścieżki:
- Otwórz folder w bibliotece i skopiuj adres z przeglądarki.
- Wklej adres w wierszu folderu projektu. Edmund rozpozna wskazany folder.
- Wybierz Validate. Edmund pokaże liczbę i próbkę plików. Pusty wynik jest prawidłowy: folder jest dostępny, ale nie ma obsługiwanych plików. W tej liczbie nie są liczone podfoldery.
- Zapisz. Przypisanie zadziała przy następnym uruchomieniu synchronizacji.
Projekt może mieć do 20 przypisanych folderów. Jeden folder można przypisać do kilku projektów; koszt takiego współdzielenia opisuje rozdział 12.
Adres z innego hosta, witryny lub biblioteki jest odrzucany, ponieważ konektor odczytuje jedną bibliotekę. Przypisanie nie zmienia rejestracji aplikacji ani dostępu do witryny i nie wymaga pracy w Entra ID.
Nie jest to drzewo folderów do przeglądania: należy wkleić adres i go potwierdzić. Przypisanie wykonuje się po utworzeniu projektu; nie jest polem w formularzu nowego projektu.
12. Zalecana struktura folderów
Documents/
global_documents/
Project_A/
Project_B/
| Zasada | Powód |
|---|---|
| Jeden folder na projekt | Przypisanie wskazuje folder |
| Mały folder wspólny dla dokumentów ogólnych | Plik dodawany raz jest przetwarzany oddzielnie w każdym przypisanym projekcie |
| Brak plików w katalogu głównym biblioteki | Nie należą do żadnego projektu i nie są odczytywane |
| Dowolna struktura wewnątrz przypisanego folderu | Podfoldery są odczytywane |
Koszt folderu wspólnego
Dokumenty są przechowywane oddzielnie dla projektu. Folder przypisany do dwudziestu projektów jest więc przetwarzany i przechowywany dwadzieścia razy. Pięć norm zwykle nie stanowi problemu, ale pięćset plików oznacza pięćset dodatkowych indeksowań na projekt i długie pierwsze wczytanie.
Utrzymuj folder wspólny mały i przypisuj go tylko tam, gdzie jest potrzebny. Jeden globalny projekt nie zastępuje tego mechanizmu: pytanie dotyczy jednego projektu, więc dokument potrzebny przy maszynie musi być dostępny w jej projekcie.
13. Wymiana sekretu klienta
Sekret wygasa w ustalonym terminie. Po wygaśnięciu dokumenty przestają docierać, bez gwarancji osobnego komunikatu błędu. Wymień go wcześniej:
- W Entra ID otwórz aplikację, utwórz sekret przez Certificates & secrets → New client secret i skopiuj wartość.
- Administrator wprowadza nową wartość w Settings → Connections → SharePoint. Edmund sprawdza ją przed zapisem. Błędna wartość jest odrzucana, a działające połączenie pozostaje bez zmian. Zapisany sekret nie jest ponownie wyświetlany.
- Dopiero po udanym zapisie usuń stary sekret w Entra ID.
Oba sekrety działają do usunięcia starego, więc taka kolejność zachowuje synchronizację. Zapisz nowy termin wygaśnięcia.
14. Miejsca konfiguracji
Wszystkie poniższe czynności wykonuje Administrator samodzielnie. Nie zmieniają jednorazowej rejestracji ani dostępu do witryny z części A.
| Czynność | Miejsce | Rozdział |
|---|---|---|
| Wprowadzenie lub zmiana tenant, client, secret i drive | Settings → Connections → SharePoint | Część A, 6 |
| Wymiana sekretu | Settings → Connections → SharePoint | 13 |
| Przypisania folderów dla wielu projektów | Settings → Connections → SharePoint | 11 |
| Przypisanie folderu w jednym projekcie | Karta Integrations projektu | 11 |
| Sprawdzenie stanu synchronizacji folderu | Oba powyższe widoki | 9 |
| Zmiana przypisania po zmianie nazwy | Oba powyższe widoki | 9 |
| Wyłączenie integracji | Settings → Connections → SharePoint | — |
Wyłączenie zachowuje dane uwierzytelniające i przypisania folderów, ale zatrzymuje synchronizację. Ponowne włączenie wznawia ją od poprzedniego stanu.
15. Gdy synchronizacja się zatrzyma
Zacznij w Settings → Connections → SharePoint od stanu folderów i czasu ostatniego udanego uruchomienia. Następnie sprawdzaj:
| Nr | Kontrola | Rozwiązanie |
|---|---|---|
| 1 | Folder ma zatrzymaną synchronizację | Sprawdź zmianę nazwy lub przeniesienie; popraw przypisanie, rozdział 9 |
| 2 | Sekret wygasł | Wymień go, rozdział 13 |
| 3 | Usunięto dostęp do witryny lub wycofano zgodę | Powtórz kroki 3 i 4 części A |
| 4 | Format pliku nie jest obsługiwany | Przekonwertuj plik lub zapytaj Edmunda |
| 5 | Plik znajduje się poza przypisanym folderem | Przenieś go albo przypisz jego folder |
Brak pojedynczego pliku przy działających pozostałych zwykle wskazuje jego format, rozmiar lub położenie. Validate pokazuje liczbę widocznych plików i pomaga odróżnić taki przypadek od błędu połączenia. Dokument indeksowany znacznie dłużej od reszty partii zgłoś Edmundowi.
Do zgłoszenia dołącz nazwę pliku, pełną ścieżkę w bibliotece i czas przesłania. Bez ścieżki nie można odróżnić brakującego dokumentu od nieprzypisanego folderu.
16. Kontakt
Pytania i problemy synchronizacji kieruj na devops@edmundai.com.
Dodatek — obsługiwane formaty
| Kategoria | Rozszerzenia |
|---|---|
pdf | |
| Word | docx doc docm dot dotx dotm rtf odt |
| Excel | xlsx xls xlsm xlsb xlt xltx xltm ods csv |
| PowerPoint | pptx ppt pptm ppsx ppsm potx potm odp |
| Tekst | txt md yaml yml html htm |
Limit to 500 MB na plik. Nieobsługiwany plik pozostaje w SharePoint bez zmian, nie pojawia się w projekcie i nie generuje błędu. Nie wymaga sprzątania w Edmundzie.
Programy PLC nie są synchronizowane przez SharePoint. Stanowią oddzielne źródło danych importowane bezpośrednio z narzędzia inżynierskiego. Plik programu umieszczony w monitorowanym folderze może przejść walidację jako dokument, ale nie stanie się programem PLC. Importuj programy właściwą dla nich ścieżką.