Edmund AI Dokumentacja
/PRZEWODNIKI KONFIGURACJI

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.

ZagadnienieDział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
KierunekJednokierunkowy; Edmund niczego nie zapisuje w SharePoint
ZakresTylko 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

DaneZastosowanie
Nazwa i pełna ścieżka w biblioteceIdentyfikacja pliku i projektu
RozmiarRaportowanie
Data utworzenia i ostatniej modyfikacjiWykrywanie zmian
Skrót zawartościWykrywanie 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

  1. Prześlij plik do przypisanego folderu właściwego projektu.
  2. Otwórz projekt w Edmundzie. Plik pojawia się na liście już podczas przetwarzania, ze statusem indeksowania i źródłem SharePoint.
  3. 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ę:

  1. Otwórz folder w SharePoint i skopiuj jego adres z przeglądarki.
  2. W projekcie zastąp poprzedni adres folderu i wybierz Validate. Edmund potwierdzi dostęp oraz liczbę znalezionych plików.
  3. 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ść:

  1. Utwórz folder w monitorowanej bibliotece.
  2. Utwórz projekt w Edmundzie przez New project, podając nazwę i etykiety.
  3. Przypisz folder zgodnie z rozdziałem 11.
  4. 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:

  1. Otwórz folder w bibliotece i skopiuj adres z przeglądarki.
  2. Wklej adres w wierszu folderu projektu. Edmund rozpozna wskazany folder.
  3. 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.
  4. 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/
ZasadaPowód
Jeden folder na projektPrzypisanie wskazuje folder
Mały folder wspólny dla dokumentów ogólnychPlik dodawany raz jest przetwarzany oddzielnie w każdym przypisanym projekcie
Brak plików w katalogu głównym bibliotekiNie należą do żadnego projektu i nie są odczytywane
Dowolna struktura wewnątrz przypisanego folderuPodfoldery 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:

  1. W Entra ID otwórz aplikację, utwórz sekret przez Certificates & secrets → New client secret i skopiuj wartość.
  2. 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.
  3. 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śćMiejsceRozdział
Wprowadzenie lub zmiana tenant, client, secret i driveSettings → Connections → SharePointCzęść A, 6
Wymiana sekretuSettings → Connections → SharePoint13
Przypisania folderów dla wielu projektówSettings → Connections → SharePoint11
Przypisanie folderu w jednym projekcieKarta Integrations projektu11
Sprawdzenie stanu synchronizacji folderuOba powyższe widoki9
Zmiana przypisania po zmianie nazwyOba powyższe widoki9
Wyłączenie integracjiSettings → 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:

NrKontrolaRozwiązanie
1Folder ma zatrzymaną synchronizacjęSprawdź zmianę nazwy lub przeniesienie; popraw przypisanie, rozdział 9
2Sekret wygasłWymień go, rozdział 13
3Usunięto dostęp do witryny lub wycofano zgodęPowtórz kroki 3 i 4 części A
4Format pliku nie jest obsługiwanyPrzekonwertuj plik lub zapytaj Edmunda
5Plik znajduje się poza przypisanym folderemPrzenieś 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

KategoriaRozszerzenia
PDFpdf
Worddocx doc docm dot dotx dotm rtf odt
Excelxlsx xls xlsm xlsb xlt xltx xltm ods csv
PowerPointpptx ppt pptm ppsx ppsm potx potm odp
Teksttxt 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.

Uwaga

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ą.