Edmund AI Dokumentace
/NÁVODY

Čá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é.

FrekvenceZmě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ěrJednosměrně. Nic, co Edmund udělá, se do SharePointu nezapisuje
RozsahJen 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á seK čemu
Jméno a plná cesta v knihovněIdentifikace souboru a projektu, do kterého patří
VelikostReporting
Datum vytvoření a poslední změnyDetekce změny
Hash obsahuDetekce 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

  1. Nahrajte soubor do namapované složky projektu, do kterého patří.
  2. 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.
  3. 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:

  1. Zkopírujte novou adresu složky

    Otevřete složku v SharePointu a zkopírujte její adresu z prohlížeče.

  2. 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ů.

  3. 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:

  1. Vytvořte složku ve sledované knihovně.
  2. Vytvořte projekt v Edmundovi — Nový projekt, jméno a štítky.
  3. Namapujte složku na projekt (kapitola 11).
  4. 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.

  1. Zkopírujte adresu složky v SharePointu

    Otevřete složku v knihovně dokumentů a zkopírujte její adresu z prohlížeče.

  2. Vložte ji do projektu

    Vložte ji do řádku složky. Edmund adresu přeloží na složku, na kterou ukazuje.

  3. 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í.

  4. 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/
PravidloDůvod
Jedna složka na projektMapová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 nicSoubory 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.

  1. V Entra ID otevřete aplikaci a vytvořte nový client secret (Certificates & secrets → New client secret). Zkopírujte hodnotu.
  2. 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ý.
  3. 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.

ÚkonKdeKapitola
Zadání nebo změna připojení — tenant, aplikace, secret, knihovnaNastavení → Připojení → SharePointČást A, 6
Výměna expirujícího client secretuNastavení → Připojení → SharePoint13
Mapování složek na projekty, napříč všemi projektyNastavení → Připojení → SharePoint11
Mapování složky pro jeden projektKarta Integrace u projektu11
Zjištění, jestli se složka pořád synchronizujeKterékoli z obou míst9
Přemapování přejmenované složkyKterékoli z obou míst9
Deaktivace integraceNastavení → 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í
1Ukazuje některá složka zastavenou synchronizaci?Nejspíš byla přejmenovaná nebo přesunutá — přemapujte ji, kapitola 9
2Expiroval client secret?Vyměňte ho, kapitola 13
3Byl smazaný grant na site, nebo odebraný souhlas?Zopakujte kroky 3 a 4 části A
4Je formát souboru takový, jaký Edmund čte (příloha)?Převeďte soubor, nebo se na formát zeptejte Edmunda
5Byl 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:

KategoriePřípony
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
Texttxt 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.

Note

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.