Sdílené soubory

Sdílené soubory jsou centrální úložiště souborů, které se používají napříč celým TASem – loga, manuály, obecné dokumenty, obrázky do tiskových sestav nebo podklady pro AI asistenta. Sekce Administrace → Sdílené soubory je dostupná od verze 5.17 a nahrazuje dřívější ukládání assetů na frontend server.

K čemu sdílené soubory slouží

Do sdílených souborů patří obsah, který je společný pro celé prostředí a není vázaný na konkrétní případ – tedy soubory, které chcete spravovat na jednom místě a používat opakovaně ve více šablonách.

Soubory jsou rozdělené do záložek podle účelu. Každá záložka odpovídá jedné složce na backendu:

Fyzicky se soubory ukládají do /app/tas/storage/assets/<root>/ uvnitř backendového kontejneru. Loga schémat se při migraci ukládají do rootu visual-identity.

Nahrání a správa souborů

1. Otevřete Administrace → Sdílené soubory.
2. Vyberte záložku podle typu obsahu (například Documents pro obchodní podmínky).
3. Nahrajte soubor, případně ho vložte do podsložky, pokud chcete obsah dále členit.
4. Zkopírujte si přesný název souboru – používá se jako identifikátor ve výpočtech i v tiscích.

Práce se sdílenými soubory ve výpočtech (backend)

Ve výpočtu se sdílený soubor načte z absolutní cesty pomocí lib.getFileContents() a uloží se do DMS případu pomocí lib.storeAttachment().

Následující ukázka přiloží obchodní podmínky ze záložky Documents jako přílohu k aktuálnímu případu:

// Sdílený soubor: Administrace → Sdílené soubory → Documents
const SHARED_ROOT = '/app/tas/storage/assets/documents';
const SOURCE_FILE = `${SHARED_ROOT}/obchodni-podminky.pdf`;
const TARGET_NAME = 'Obchodní podmínky.pdf';

try {
  const content = lib.getFileContents(SOURCE_FILE, 'base64');
  const dmsId = lib.storeAttachment(TARGET_NAME, content, false);
  proc.info('Shared file attached to case', { caseId: lib.iprocId(), dmsId });
} catch (err) {
  proc.error('Failed to attach shared file', { file: SOURCE_FILE, err: err.message });
  debug.error('Nepodařilo se přiložit dokument k případu.');
}

Co je v ukázce podstatné:

• lib.getFileContents(pathToFile, encoding) – vrací obsah souboru z absolutní cesty. Výchozí kódování je base64.
• lib.storeAttachment(fileName, content, convertToBase64) – uloží soubor do DMS případu a vrací jeho DMS ID. Třetí parametr je false, protože obsah je už v base64 – při true by došlo k dvojímu zakódování a soubor by nešel otevřít.
• Název přílohy (TARGET_NAME) je nezávislý na názvu zdrojového souboru – uživatel v případu uvidí čitelný název včetně diakritiky.
• Cesta k rootu je v konstantě, ne roztroušená v kódu – při změně umístění se upravuje na jednom místě.
• proc.info a proc.error slouží pro logování, debug.error zobrazí chybu uživateli a zablokuje dokončení úkolu. Pokud má proces pokračovat i bez přílohy, debug.error vynechte.

Práce se sdílenými soubory na frontendu

React tisky a Case Overview – funkce getAsset()

V React tiscích a v Case Overview se odkaz na sdílený soubor sestavuje funkcí getAsset(). Přímý odkaz na cestu /assets/... od verze 5.17 nefunguje.

getAsset(root: 'manuals' | 'logos' | 'org' | 'schema', path: string)

Příklad použití:

// Before – v5.7
<PrintFooter logoURL="/assets/logos/logo_element_horizontal.png" />
// After – v5.17
<PrintFooter logoURL={getAsset('logos', 'logo_element_horizontal.png')} />

// Before – v5.7
<img alt="someImg" src="/assets/logos/logo_element_horizontal.png" />
// After – v5.17
<img alt="someImg" src={getAsset('logos', 'logo_element_horizontal.png')} />

Pokud je název souboru uložený v proměnné (typicky logo dohledané z dynamické tabulky), vloží se do getAsset() jako druhý parametr:

// Before – v5.7
<img id="top-logo" src={getVar('_logo')} alt="Logo" />
// After – v5.17
<img id="top-logo" src={getAsset('logos', getVar('_logo'))} alt="Logo" />

Staré HTML tisky – přímá URL služby

Ve starých HTML tiscích není funkce getAsset() dostupná. Odkaz se zadává přímo na službu pro stažení assetu:

// Soubor uložený přímo v rootu logos
<img alt="someImg" src="https://<backendUrl>/api/assets/download?root=logos&path=workflow.png" />

// Soubor zanořený v podsložce
<img alt="someImg" src="https://<backendUrl>/api/assets/download?root=logos&path=folder/workflow.png" />

Typické use case

Na co si dát pozor

• Sdílené soubory nejsou dokumenty případu. Data vázaná na konkrétní případ patří do DMS případu, ne do sdílených souborů.
• Změna se projeví okamžitě všude. Nahrazením souboru stejného názvu se změna promítne do všech tisků a šablon, které ho používají – u log a hlaviček to je žádoucí, u dokumentů s právní platností nahrávejte novou verzi pod novým názvem.
• Citlivé hodnoty do sdílených souborů nepatří. API klíče, hesla, tokeny a certifikáty patří do Administrace → Trezor a načítají se přes vault.get().
• Kontrolujte velikost a formát. Loga a obrázky v tiscích udržujte v rozumném rozlišení – velké soubory zpomalují generování PDF.