Stránkování záznamů pro export

Základní vlastností XML komunikace pro export dat je, že exportuje všechny záznamy z programu POHODA do XML.

Výsledkem je robustní, strukturovaný XML dokument, který věrně replikuje data z programu POHODA.

Jednou ze základních funkcí exportu dat je stránkování záznamů.

Stránkování umožňuje rozdělit velké množství záznamů na menší bloky, které lze postupně exportovat do XML.

Díky tomu se můžete rozhodnout, zda chcete exportovat všechny záznamy najednou, nebo je exportovat po částech opakovaně.

Vlastnosti stránkování záznamů

V XML požadavku na export lze zapnout stránkování záznamů.

Při jeho aktivaci je nutné nastavit:

• počáteční záznam (idFrom)
• velikost stránky (count) – tedy počet záznamů, které budou exportovány

Program POHODA seřadí záznamy podle unikátního ID, vyhledá počáteční záznam a následně vyexportuje požadovaný počet záznamů dle nastaveného limitu.

Pro nastavení stránkování je nutné v XML požadavku použít blok: limit

Možnosti stránkování záznamů

XML export dat z programu POHODA má nastaven maximální limit na počet záznamů na 70 000 na jeden XML požadavek (výstupní soubor).

Tento limit souvisí s velikostí výstupního XML dokumentu.

Stránkování podporuje nastavení velikosti stránky od minimálně 1 záznamu až po maximálně 10 000 záznamů.

Definice stránkování záznamů v XML

Stránkování záznamů je definováno ve schématech:

• list.xsd
• list_addBook.xsd
• list_stock.xsd
• list_contract.xsd
• list_centre.xsd
• list_activity.xsd

Tato schémata obsahují definice stránkování pro jednotlivé agendy, jako jsou Adresář, Zásoby, Faktury, Objednávky atd.

Každá agenda v programu POHODA podporuje stránkování záznamů v rámci exportu dat.

      xsd:element name="limit" type="ftr:limitType"
        xsd:annotation
           xsd:documentationOmezení počtu exportovaných záznamů./xsd:documentation
        /xsd:annotation

      xsd:complexType name="limitType"
        xsd:all
           xsd:element name="idFrom"  type="xsd:integer" minOccurs="0"
             xsd:annotation
               xsd:documentationMinimální hodnota ID záznamu, od kterého se provede export./xsd:documentation
             /xsd:annotation
           /xsd:element
           xsd:element name="count" minOccurs="0"
             xsd:annotation
               xsd:documentationPočet záznamů v daném exportu./xsd:documentation
             /xsd:annotation
             xsd:simpleType
                xsd:restriction base="xsd:integer"
                  xsd:minInclusive value="1"/
                  xsd:maxInclusive value="10000"/
                /xsd:restriction
             /xsd:simpleType
           /xsd:element
        /xsd:all
      /xsd:complexType

      lStk:listStockRequest
      
        lStk:limit
          ftr:idFrom1/ftr:idFrom
           ftr:count10/ftr:count
        /lStk:limit
        
        lStk:requestStock
          ftr:filter
          /ftr:filter
        /lStk:requestStock
      /lStk:listStockRequest