B-1 Složky replikátoru

Pracovní umístění Replikátoru a tvořeného serveru pro tuto aplikaci: vstupy a výstupy tvorby i systémová umístění. „Složka“ je zde obecný název: může jít o místní nebo mapovaný disk, FTP, HTTP předání souborů tam, kde jej protistrana Flexideo podporuje, s3:// nebo budoucí podporovaný provider.

Místní a síťové cesty zadávejte bez lomítka na konci. URI vzdáleného uložiště má vlastní normalizační pravidla; pro Remote Version Store se doporučuje kanonický tvar zakončený /.

Kořenová složka dokumentace aplikace

Úplný popis výstupu, formát indexů, DAD vazeb a manifestu i postup dohledání segmentu najdete na stránce Generovaná referenční dokumentace struktury aplikace.

Volitelné pole „Kořenová složka dokumentace aplikace“ určuje jediné umístění pro generovanou referenci struktury aplikace. Zadejte například C:\flexideo\aplikace\moje-aplikace\DEV\dokumentace, bez koncového \fdt. Podsložky vytváří Replikátor automaticky; další nastavení se nezadává. Prázdná hodnota generování i distribuci vypíná. Cíl se při přípravě verze přebírá do její konfigurace, takže změna aplikace sama neopraví starší snapshot.

dokumentace/
  manifest.json
  index.md
  fdt/
    index.md
    uzivatel.md
  indexes/fdt/
    segments.jsonl
    by-xds-id.json

Markdowny obsahují dokumentové typy, oblasti a prvky výsledné role 1. Nadpisy používají systémové cesty, například uzivatel/x_common/label; popisek zůstává samostatnou vlastností. Kromě datových typů a podmínek zahrnují nápovědu, dokumentaci a databázové vazby. Osmimístné XDS ID lze přesně dohledat v indexes/fdt/by-xds-id.json. Hodnota pod daným ID je seznam odkazů na soubor, kotvu a systémovou cestu; počáteční nuly se zachovávají.

segments.jsonl obsahuje jeden záznam pro každý segment a všechny dohledané DAD vazby. dad-id identifikuje DAD array a není totéž co XDS ID. Jeden segment může mít více databázových polí; pomocná pole bez obecné logické cesty mají uvedenou přesnou fyzickou cestu místo vymyšleného dad-path.

Sada vzniká až při tvorbě stránek, po dokončení role 1, a instalace ji přenese do nastaveného kořene. I light-update obnovuje úplnou referenci. Markdowny vybrané update podmínkou se přegenerují, nezměněné se mohou převzít z ověřené předchozí sady; indexy a manifest zahrnují všechny aktuální typy. Bez použitelného základu, též při prvním běhu po starším formátu, se Markdowny vytvoří celé. Místní instalace stejné soubory nepřepisuje. Samotné zopakování instalace chybějící referenci nevygeneruje.

Podporovaný je diskový cíl, FTP a HTTP přes stávající Flexideo transport. s3:// tento dokumentační výstup zatím nepodporuje. Manifest určuje aktuální verzi, roli, seznam souborů a kontrolní součty. Zapisuje se poslední; agent má ověřit integritu sady před jejím použitím. Na disku se zastaralé výstupy odstraňují jen podle předchozího manifestu. Vzdálené starší soubory mohou zůstat, ale nejsou součástí nové reference. Ostatní obsah mimo rezervované výstupní cesty se zachovává.

Remote Version Store

Pole „Vzdálené úložiště historie verzí“ v B-1 přijímá absolutní diskovou cestu, například C:\flexideo\web-backup\versions-store\ERP\CODE, nebo podporované provider URI. Disková cesta znamená lokální file store a zachovává se v běžném Windows tvaru, bez převodu na file://. Po uzavření verze do něj Replikátor publikuje ZIP celé vyčištěné version-folder struktury, manifest a externí registr updatelist.xml; lokální updates-list.mxl zůstává beze změny. Při porovnání XDS Replikátor na vyžádání obnoví chybějící vybranou historickou verzi z jejího ZIPu. s3://flexideo-replications/renomia-rdo/PROD/ je zatím návrh budoucího S3 provideru a neobsahuje přístupové údaje. Podrobnosti popisuje Remote Version Store.

Význam kolonek:

Systémová složka replikátoru

Pracovní složka programu replikátor, kde se vyskytuje replicator.exe a další pomocné soubory a složky potřebné pro práci replikátoru. Tato složka může být společnápro více aplikací (a většinou tomu tak i je)

Složka aplikace (XDS, uživatelé, role atd.)

Složka, kde je uložen soubor aplikačníchnastavení a zejména soubor(y) XDS definic.

Složka pro tvorbu verzí aplikace (výstup replikátoru)

Nejlépe místní složka s rychlýmpřístupem, kam se budou ukládat soubory verze a připravovat programové soubory verze pro fungování verze na serveru. Většina souborů je ve složce verze pouze dočasně.

Složka se soubory akcí prokontrolu s navrženým XDS

Soubory pro definici akcí a generování kontrolních pravidel bývá dobré ukládat v samostatné složce.

Vesměs by tyto složky měly být na místním počítači či místnísíťi.