#acl TahitiAdminGroup:read,write All:read
#pragma title Organizace souborů DAMIS - klient
#pragma title-link FrontPage

Soubory jsou uloženy v adresáři DAMIS uvnitř repozitáře. 

||<#C0C0C0> '''Datum změny''' ||<#C0C0C0> '''Změna''' ||
|| 22.5.2024 || Rozšíření File a Version o extId ||
|| 16.5.2006 || Zavedení protection pro File ||
|| 4.10.2005 || Upřesnění významu origName ||
|| 10.4.2006 || zavedení možnosti zákazu mazání souborů ||

== Organizace spisů ==

Každý spis je uložen v samostatném adresáři. Název adresáře je ve formátu ''dpkg-IDENTIFIKACE-DAVKY''. 

=== Soubory popisující spis ===

Soubory a podadresáře v adresáři ''dkpg-....'' :
||<#C0C0C0> '''Položka''' ||<#C0C0C0> '''Význam''' ||
|| ''files'' || adresář obsahující datové soubory ||
|| Doc``Set``Id || soubor obsahující identifikaci spisu ||
|| Doc``Set``Server || soubor obsahující server odkud byl spis zaslán ||
|| Lock``Id || soubor obsahující zámek ze serveru ||
|| Allow``Reinsert || nepovinný soubor označující, že spis je v reklamačním režimu ||
|| docset.xml || xml soubor popisující jednotlivé dokumenty spisu ||

=== Popis spisu ===

Specifikace formátu souboru popisujícího spis je v následující tabulce:

||<#C0C0C0> '''Tag''' ||||||<(#C0C0C0> '''Popis''' ||
|| <Document``Set> ||||||<(> může obsahovat libovolné množství <Document> ||
|| <Document> ||||||<(> popisuje jeden dokument, obsahuje <Attributes> a <Files> ||
|| <Attributes> ||||||<(> popisuje atributy dokumentu, obsahuje libovolné množství <Attribute> ||
|| <Files> ||||||<(> popisuje jednu stránku, obsahuje libovolné množství <File> ||
|| ||<#E0E0E0> Atribut ||<#E0E0E0> Povinnost ||<#E0E0E0> Význam ||
|| || protection || ne || ochrana souboru pred smazanim 0|1 ||
|| <Attribute> ||||||<(> obsahuje popis jednoho atributu dokumentu ||
|| ||<#E0E0E0> Atribut ||<#E0E0E0> Povinnost ||<#E0E0E0> Význam ||
|| || name || ano || název atributu ||
|| || value || ano || hodnota atributu ||
|| || protection || ne || ochrana atributu pred zmenou 0|1|2 ||
|| <File> ||||||<(> obsahuje popis jedné stránky ||
|| ||<#E0E0E0> Atribut ||<#E0E0E0> Povinnost ||<#E0E0E0> Význam ||
|| || name || ano || název souboru s příslušnou stránkou ||
|| || mimeType || ne || mime typ stránky ( MIME/JPEG, MIME/TIFF). Atribut je nepovinný v případě, kdy je definován u příslušné verze ||
|| || protection || ne || ochrana souboru pred smazanim 0|1 ||
|| || extId || ne || identifikátor v externím systému pro stažení dat ||
|| <Version> ||||||<(> popis verze jedné stránky, pokud existuje ||
|| ||<#E0E0E0> Atribut ||<#E0E0E0> Povinnost ||<#E0E0E0> Význam ||
|| || name || ano || název souboru s příslušnou stránkou ||
|| || mimeType || ano || mime typ stránky ( MIME/JPEG, MIME/TIFF) ||
|| || origName || ne || název originálního souboru, pokud se name a origName neliší příslušný datový soubor se nezměnil, pokud je origName prázdný nebo neexistuje byl soubor pozměněn ||
|| || description || ne || popis souboru ||
|| || extId || ne || identifikátor v externím systému pro stažení dat ||


==== Ochrana souborů před změnou ====

Je možno uživateli zakázat mazání souborů ze spisu
|| 0 || Uživatel je oprávněn soubory mazat ||
|| 1 || Uživatel nesmí soubory mazat ||

==== Ochrana atributů před změnou ====

Atributy je možno zakázat měnit uživateli, dostupné hodnoty jsou:
|| 0 || Uživatel je oprávněn hodnotu atributu libovolně měnit ||
|| 1 || Uživatel je upozorněn, že mění hodnotu významného atributu. ||
|| 2 || Hodnotu atributu nelze měnit ||

Příklad souboru docset.xml:
{{{
<?xml version="1.0"?>
<DocumentSet>
 <Document>
  <Attributes>
   <Attribute name="Document.type" value="ZP006" /> 
   <Attribute name="CJ" value="12345678901234" /> 
  </Attributes>
  <Files>
   <File name="00000001.jpg" mimeType="IMAGE/JPEG"/>
  </Files>
 </Document>
</DocumentSet>
}}}


Příklad souboru v případě využití možností více verzí souboru:
{{{
<?xml version="1.0"?>
<DocumentSet>
 <Document>
  <Attributes>
   <Attribute name="Document.type" value="ZP006" /> 
   <Attribute name="CJ" value="12345678901234" /> 
  </Attributes>
  <Files>
   <File name="00000001.jpg">
    <Version name="00000001.jpg" mimeType="IMAGE/JPEG"
       description="originál" origName="00000001.jpg"/>
    <Version name="00000002.jpg" mimeType="IMAGE/JPEG"
       description="nižší rozlišení"/>
   </File>
  </Files>
 </Document>
</DocumentSet>
}}}