Část B — Provoz
Každodenní práce po zprovoznění konektoru: soubory, struktura složek, napojení složky na projekt a výměna client secretu.
Část B je práce na straně zákazníka. Soubory a složky se spravují v SharePointu; napojení složky na projekt a výměna client secretu se dělají v Edmundovi uživatelem s rolí Administrator. Ani jedno nevyžaduje součinnost Edmunda.
7. Co Edmund sleduje
Edmund čte jednu knihovnu dokumentů na jedné site a v ní jen složky namapované na projekt. Podsložky namapované složky se čtou také.
| Frekvence | Změna je detekována do 10 minut. Jak dlouho pak trvá zpracování, závisí na objemu — jeden přidaný dokument jsou minuty, první naplnění složky se stovkami souborů běží hodiny |
| Směr | Jednosměrně. Nic, co Edmund udělá, se do SharePointu nezapisuje |
| Rozsah | Jen namapované složky. Soubor mimo ně je pro Edmunda nevidět, ať je jakéhokoli typu |
Nečte se:
- soubory mimo namapovanou složku
- formáty mimo přílohu
500 MB na soubor je podporovaná hranice; větší soubory do monitorované složky neukládejte. U dokumentace strojů se na ni běžně nenarazí — pokud ano, jde většinou o sken, který se vyplatí rozdělit po celcích, protože se pak i lépe vyhledává.
Co si Edmund o souboru pamatuje
| Ukládá se | K čemu |
|---|---|
| Jméno a plná cesta v knihovně | Identifikace souboru a projektu, do kterého patří |
| Velikost | Reporting |
| Datum vytvoření a poslední změny | Detekce změny |
| Hash obsahu | Detekce změny a rozpoznání souboru, který už systém má |
Nic dalšího se ze SharePointu nečte: ani autor, ani osoba poslední změny, ani vlastní sloupce knihovny. Metadata dokumentu v Edmundovi je tedy neobsahují a jejich samotná změna nic nespustí.
8. Každodenní práce se soubory
8.1 Nahrání nového souboru
- Nahrajte soubor do namapované složky projektu, do kterého patří.
- Otevřete projekt v Edmundovi. Soubor se v seznamu dokumentů objeví ještě během zpracování, se svým stavem — indexing, dokud na něm Edmund pracuje, potom úspěšně zaindexováno — a se sloupcem Source, ve kterém je SharePoint.
- Jakmile stav ukazuje, že je dokument zaindexovaný, je dostupný odpovědím v chatu.
Dokument, který už v Edmundovi je z jiného zdroje, se objevením téhož souboru v SharePointu nezduplikuje: při shodném obsahu existující dokument zůstane a jeho zdroj se změní na SharePoint. Přechod projektu z ručního nahrávání na SharePoint je tedy bezpečný — tytéž dokumenty stačí uložit do monitorované složky a Edmund je převezme, místo aby je zdvojil.
8.2 Aktualizace souboru
Nahrajte novou verzi do stejné složky pod stejným názvem. Edmund změnu rozpozná, načte nový obsah a dokument nahradí: předchozí se odebere a projekt drží jednu položku na soubor. Není potřeba nic uklízet.
Nový obsah se v odpovědích použije, jakmile stav ukáže, že je dokument zaindexovaný. Do té doby odpovídá předchozí verze, takže nikdy nenastane okamžik, kdy dokument v projektu chybí.
Jedna věc, kterou je dobré vědět: aktualizovaný soubor je v Edmundovi nový záznam. Obsah se neztratí a dokument je v seznamu pod stejným názvem, ale odkaz na ten předchozí — třeba z dříve uložené konverzace — přestane vést. Plyne to z toho, že se dokument nahrazuje celý, a není to chyba.
Opakované nahrání souboru, který se nezměnil, neudělá nic — shodné jméno, datum a obsah se rozpozná a přeskočí.
8.3 Verzování
SharePoint drží u každého souboru v knihovně historii verzí. Edmund ji nečte. Vždy se stahuje jen aktuální verze souboru.
V Edmundovi proto žádná historie verzí nevzniká a na předchozí verzi dokumentu se nedá odkázat. Když se soubor změní, aktuální verze nahradí to, co bylo předtím.
Verzování v knihovně nechte zapnuté — je to vaše cesta zpátky. Když se potřebujete vrátit, obnovte starší verzi v SharePointu; Edmund ji při nejbližší kontrole převezme jako každou jinou změnu.
8.4 Mazání a obnova
Smazání souboru v SharePointu odebere dokument z Edmunda. Tímto způsobem se dokument stahuje z používání — v Edmundovi není potřeba mazat nic zvlášť.
Obnovíte-li soubor z koše SharePointu do namapované složky, Edmund ho převezme nejpozději při nočním přepočtu, obvykle dřív. Mezitím ho ručně nenahrávejte znovu — vznikla by duplicita, kterou pak musí někdo uklidit.
Mazání se propaguje jen v jednom směru, jako každá jiná změna: Edmund v SharePointu nikdy nic nemaže.
9. Přejmenování a přesouvání
Přejmenování nebo přesun souboru je změna jako každá jiná: Edmund ho načte znovu a dokument nahradí, protože jméno a cesta jsou součástí jeho identity. V projektu zůstane jedna položka pod novým jménem, stará se odebere. Přesunem souboru mimo všechny namapované složky jeho dokument zmizí, nejpozději při nočním přepočtu.
Přejmenování podsložky uvnitř namapované složky mapování nenaruší, ale všem souborům pod ní se změní cesta, takže se znovu načtou a zaindexují. U složky se třemi sty soubory je to tři sta indexací — není to chyba, ale nedělá se to bezmyšlenkovitě.
Přejmenování namapované složky
Přejmenováním nebo přesunem namapované složky se synchronizace té složky zastaví. Mapování ukazuje na jednu složku a hledá ji podle cesty; jakmile cesta neexistuje, SharePoint složku nevrátí a synchronizace skončí chybou.
Dvě věci se přitom nestanou: dokumenty se nesmažou a nepřestanou fungovat. Edmund záměrně skončí dřív, než začne počítat, co ze SharePointu zmizelo, takže z nedostupné složky nikdy neplyne hromadné mazání. Už zaindexované dokumenty dál odpovídají, jen se přestanou aktualizovat a nové soubory z té složky nepřicházejí.
Jak to poznáte. Každá namapovaná složka má svůj stav v Nastavení → Připojení → SharePoint. Dokud synchronizace běží, je u složky čas posledního úspěšného běhu. Po přejmenování se stav překlopí na zastavenou, tento čas zamrzne na okamžiku před přejmenováním a u složky se ukáže, že ji Edmund na uložené cestě nenašel. Nikdo nemusí přijít na to, že týden nedorazil žádný dokument.
Jak to opravíte, sami, do minuty:
- Zkopírujte novou adresu složky
Otevřete složku v SharePointu a zkopírujte její adresu z prohlížeče.
- Přepište jí tu starou
U projektu nahraďte řádek složky zkopírovanou adresou a zvolte Ověřit. Edmund potvrdí, že do složky vidí, a vypíše, kolik v ní našel souborů.
- Uložte
Synchronizace se rozjede při nejbližším běhu, tedy do 10 minut.
Nic se nenahrává znovu a nic se neztratí: soubory mají v SharePointu pořád stejnou identitu, takže Edmund naváže tam, kde přestal. Všem souborům se ale změnila cesta, takže první běh po přemapování je načte znovu a trvá déle než obvykle.
Reorganizace úplně bez výpadku: vytvořte novou složku, namapujte ji na projekt, přesuňte soubory a teprve pak odeberte mapování staré složky. V tomhle pořadí synchronizace neselže ani na okamžik.
Tentýž soubor ve dvou namapovaných složkách se čte dvakrát, jednou za každou složku. Pokud tyto složky patří různým projektům, objeví se dokument v obou — což je zamýšlený způsob, jak dokument sdílet mezi projekty, a zároveň důvod, proč se kopie zapomenutá po přesunu objeví dvakrát.
10. Zakládání struktury pro nový stroj
Jedna složka je jeden projekt a jeden projekt je jeden stroj nebo stanice. Úzce vymezené projekty drží odpovědi přesné; jediný projekt se vším zvyšuje dobu zpracování a zhoršuje výsledky.
Složky pojmenujte podle hierarchie, kterou je závod organizovaný — závod, linka, operace, stroj — a projektu v Edmundovi dejte stejné jméno jako složce, aby se ty dvě daly čít vedle sebe.
Pojmenování: jediné technické omezení je cesta ke složce do 512 znaků.
Diakritika, mezery i znaky jako & jsou v pořádku — Edmund si adresu zakóduje
sám. Jedno doporučení zůstává: volte jméno, které se nebude muset měnit,
protože přejmenování namapované složky synchronizaci zastaví, dokud ji
nepřemapujete (kapitola 9), a všechny soubory ve složce se pak načtou znovu.
Postup:
- Vytvořte složku ve sledované knihovně.
- Vytvořte projekt v Edmundovi — Nový projekt, jméno a štítky.
- Namapujte složku na projekt (kapitola 11).
- Nahrajte dokumenty.
Nahrávat před vytvořením mapování je bezpečné. Soubory se načtou v prvním běhu po jeho vytvoření.
Projekt bez namapované složky je pro synchronizaci neviditelný: nic se nestahuje a nic nechybuje. Projekty si tedy můžete připravit dopředu a mapování doplnit, až bude struktura v SharePointu hotová.
11. Napojení složky na projekt
Mapování dělá v Edmundovi uživatel s rolí Administrator, a to na dvou místech: na kartě Integrace v nastavení projektu, nebo v Nastavení → Připojení → SharePoint, kde jsou vypsané všechny projekty najednou a dá se v nich hledat a filtrovat podle štítků. Druhé místo je to, které se hodí při zakládání většího počtu strojů.
Nese adresu složky ze SharePointu, takže se nepracuje s žádnou syntaxí cest.
- Zkopírujte adresu složky v SharePointu
Otevřete složku v knihovně dokumentů a zkopírujte její adresu z prohlížeče.
- Vložte ji do projektu
Vložte ji do řádku složky. Edmund adresu přeloží na složku, na kterou ukazuje.
- Ověřte
Zvolte Ověřit. Edmund do složky nahlédne a vypíše, kolik v ní našel souborů, včetně ukázky. Prázdný výsledek je platná odpověď: složka je dostupná, jen v ní nejsou soubory podporovaného typu — podsložky se sem nepočítají.
- Uložte
Mapování se projeví od dalšího synchronizačního běhu.
Jeden projekt může nést až 20 namapovaných složek. Tutéž složku lze namapovat do více projektů, čímž se dokument platný všude založí jednou a čte ho každý projekt, který ho potřebuje — co to stojí, viz kapitola 12.
Adresa z jiného webu, jiné site nebo jiné knihovny se odmítne: Edmund čte jednu knihovnu dokumentů. Mapování nezasahuje do registrace aplikace ani do grantu na site a nevyžaduje žádnou práci v Entra ID.
Dvě věci, se kterými počítejte:
- Není to strom složek k procházení. Adresu vložíte a potvrdíte, místo abyste se proklikávali knihovnou.
- Mapování je krok po vzniku projektu, ne pole ve formuláři nového projektu. Nejdřív projekt, pak jeho složka.
12. Doporučená struktura složek
Documents/
global_documents/
Project_A/
Project_B/
| Pravidlo | Důvod |
|---|---|
| Jedna složka na projekt | Mapování ukazuje na složku |
| Společná složka pro dokumenty platné všude, držená malá | Namapovaná do několika projektů leží dokument jednou — ale zpracuje se pro každý projekt zvlášť |
| V rootu knihovny nic | Soubory v rootu nepatří žádnému projektu a nečtou se |
| Struktura uvnitř namapované složky je volná | Podsložky se čtou |
Co stojí společná složka
Dokumenty se vedou po projektech. Složka namapovaná do dvaceti projektů se proto zpracuje a uloží dvacetkrát, jednou pro každý. U pěti norem to nikdo nepozná; u složky s pěti sty soubory je to pět set indexací navíc na každý projekt a první naplnění běží dlouho.
Společnou složku držte malou a mapujte ji tam, kde je opravdu potřeba, ne preventivně do všech projektů. Jediný „globální” projekt se všemi normami to neřeší: odpovídá se vždy v rámci jednoho projektu, takže dokument, který má být k dispozici u stroje, musí být namapovaný v jeho projektu.
13. Výměna client secretu
Client secret expiruje k datu, které bylo nastaveno při jeho vytvoření. Expirovaný secret zastaví synchronizaci bez chyby; dokumenty přestanou přicházet. Vyměňte ho před tímto datem.
- V Entra ID otevřete aplikaci a vytvořte nový client secret (Certificates & secrets → New client secret). Zkopírujte hodnotu.
- V Edmundovi otevře uživatel s rolí Administrator Nastavení → Připojení → SharePoint a zadá novou hodnotu. Edmund ji před uložením ověří proti knihovně, takže chybná hodnota se rovnou odmítne a funkční připojení zůstane nedotčené. Uložený secret se nikdy nezobrazuje zpět — stránka jen ukazuje, že nějaký je uložený.
- Smažte starý secret v Entra ID.
Nový secret vytvořte dřív, než smažete starý; oba jsou platné, dokud se starý nesmaže, takže synchronizace mezitím běží dál. Zaznamenejte si nové datum expirace.
14. Kde si to administrátor nastaví
Všechno, co konektor potřebuje, je na jednom místě a dostane se tam uživatel s rolí Administrator. Nic z toho nevyžaduje účast Edmunda a nic z toho nezasahuje do registrace aplikace ani do grantu na site v Entra ID — to je část A a dělá se jednou.
| Úkon | Kde | Kapitola |
|---|---|---|
| Zadání nebo změna připojení — tenant, aplikace, secret, knihovna | Nastavení → Připojení → SharePoint | Část A, 6 |
| Výměna expirujícího client secretu | Nastavení → Připojení → SharePoint | 13 |
| Mapování složek na projekty, napříč všemi projekty | Nastavení → Připojení → SharePoint | 11 |
| Mapování složky pro jeden projekt | Karta Integrace u projektu | 11 |
| Zjištění, jestli se složka pořád synchronizuje | Kterékoli z obou míst | 9 |
| Přemapování přejmenované složky | Kterékoli z obou míst | 9 |
| Deaktivace integrace | Nastavení → Připojení → SharePoint | — |
Deaktivace nechá přihlašovací údaje i mapování složek na místě; jen zastaví synchronizaci. Po opětovném zapnutí naváže tam, kde skončila.
15. Když synchronizace přestane fungovat
Dokumenty přestanou přicházet, přičemž v SharePointu se zdánlivě nic nezměnilo. Kontrolujte v tomto pořadí:
Začněte v Nastavení → Připojení → SharePoint. Každá namapovaná složka tam ukazuje svůj stav a čas posledního úspěšného běhu, což většinu z následujícího zodpoví na pohled.
| # | Kontrola | Řešení |
|---|---|---|
| 1 | Ukazuje některá složka zastavenou synchronizaci? | Nejspíš byla přejmenovaná nebo přesunutá — přemapujte ji, kapitola 9 |
| 2 | Expiroval client secret? | Vyměňte ho, kapitola 13 |
| 3 | Byl smazaný grant na site, nebo odebraný souhlas? | Zopakujte kroky 3 a 4 části A |
| 4 | Je formát souboru takový, jaký Edmund čte (příloha)? | Převeďte soubor, nebo se na formát zeptejte Edmunda |
| 5 | Byl soubor uložen mimo namapovanou složku? | Přesuňte ho do namapované složky, nebo složku namapujte |
Když chybí jednotlivé soubory, zatímco ostatní přicházejí, problém je u souboru, ne u připojení — jeho formát, velikost, nebo složka, která není namapovaná. Ověření složky (kapitola 11) vypíše, kolik v ní Edmund vidí souborů, což ty dva případy rychle oddělí. Dokument, který zůstává ve stavu indexing výrazně déle než zbytek své dávky, je případ pro Edmunda.
Při hlášení Edmundovi uveďte jméno souboru, jeho plnou cestu v knihovně a čas nahrání. Bez cesty se chybějící dokument nedá odlišit od nenamapované složky.
16. Kontakt
S dotazy a s hlášením nefunkční synchronizace se obracejte na devops@edmundai.com.
Příloha — podporované typy souborů
Konektor čte tytéž formáty dokumentů, jaké Edmund přijímá i jinde:
| Kategorie | Přípony |
|---|---|
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 |
| Text | txt md yaml yml html htm |
Podporovaná hranice: 500 MB na soubor. Větší soubory do monitorované složky neukládejte.
Soubor, který konektor nečte, zůstane v SharePointu bez zásahu; jen se nikdy neobjeví v projektu. Není potřeba nic uklízet a nevzniká žádná chyba.
PLC programy se přes SharePoint nesynchronizují. Jsou samostatný datový zdroj, importovaný přímo z inženýrského nástroje. Soubory s PLC programem projdou validací platformy, takže z PLC programu položeného do sledované složky vznikne dokument, nikoli PLC program — do sledovaných složek je nedávejte a importujte je běžnou cestou.