Typ save-file

Sdílený tvar atributů pro popis ukládaného souboru, používaný požadavky save-file a save-files (kořenový uzel i každý vnořený file).

  <save-file
   path="{string}"
   name="{string}"
   codepage="acp|utf8|utf16|{#number}"
   file-type="txt|xml|pdf|base64|hex|json"
   content-prefix="{string}"
   not-replace="{bool}"
   attach="{bool}"
   zip="{bool}"
   zipped-file="{string}"
   path-log="{bool}"
   from-url="{bool}"
   pdf-source="text|xml"
   title="{string}"
   jsdelay="{number}"
   >
   {obsah souboru}
  </save-file>

Atributy

• path - Podsložka cílového souboru (bez jména); neuvedena = výchozí uložiště. (typ: string; nepovinný)
• name - Jméno cílového souboru; u attach="true" se z něj použije jen přípona. (typ: string; nepovinný)
• codepage - acp|utf8|utf16|číslo kódové stránky. (typ: string; nepovinný; výchozí: acp)
• file-type - txt|xml|pdf|base64|hex|json; neznámá/chybějící hodnota ponechává výchozí. (typ: enum; nepovinný; výchozí: txt) – hodnota json v dosavadní dokumentaci chyběla.
• content-prefix - Text vložený před uložený obsah. (typ: string; nepovinný)
• not-replace - Neumožní přepsat existující soubor stejného jména. (typ: bool; nepovinný; výchozí: false)
• attach - Uloží jako přílohu čekající na připojení k dokumentu; jen na kořenovém save-file/save-files, ne na vnořeném file. (typ: bool; nepovinný; výchozí: false)
• zip - Uloží do jednoho ZIP archivu; jen na kořenovém save-file/save-files, ne na vnořeném file. (typ: bool; nepovinný; výchozí: false)
• zipped-file - Jméno souboru uvnitř ZIP archivu. (typ: string; nepovinný)
• path-log - Vrátit v odpovědi plnou vyřešenou cestu; účinné jen pro r_admin. (typ: bool; nepovinný; výchozí: false) – v dosavadní dokumentaci zcela chyběl.
• from-url - Obsah souboru se místo textu/potomků uzlu natáhne přes HTTP GET. (typ: bool; nepovinný; výchozí: false) – v dosavadní dokumentaci zcela chyběl.
• pdf-source, title, jsdelay - Řízení převodu do PDF (file-type="pdf").
• Další atributy řízení PDF konverze (pdf-engine, pdf-pagesize, pdf-orientation, pdf-margins, userid, password, a v sestaveních s podporou Qt PDF tisku i pdf-base-url, pdf-ignore-cert, pdf-print-background, pdf-mime, pdf-load-timeout, pdf-print-timeout) – v dosavadní dokumentaci zcela chyběly, podrobněji viz save-file.

Potomci

Obsah uzlu (text nebo vnořené XML) je vlastní obsah ukládaného souboru, není-li aktivní from-url. U save-files atributy kořenového uzlu slouží jako výchozí hodnoty zděděné vnořenými file, pokud je file sám nepřepíše.