192 Chyba v dokumentaci ke službě DTInfo

karel.slany@nic.cz 17.02.2021 12:40

Dobrý den,

narazili jsme na problém s dokumentací v Provozním řádu.

Jedná se dokumentaci služby DTInfo,
soubor pril_2/WS_vyhledavani_datovych_schranek.pdf, kapitola 2.8.

Je zde mylně uveden jako vstup element "dbID", přičemž tam má zřejmě být "dbId".
(V souboru dbTypes.xsd je uveden správný název elementu.)

Máme problém s dokumentací hodnot elementů ActDTType a pravděpodobně i FutDTType.
Ve zmíněném PDF jsou vyčteny hodnoty 0, 1, 3, 4, 6.

Při zkoušení této služby v testovacím prostředí jsme ale narazili na hodnotu 2,
kterou jsme nebyli schopni v dokumentaci dohledat, a to ani ve verzi daného
PDF z 11.2.2021 k wsdl 2.32.

Na vstup

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <SOAP-ENV:Body>
    <DTInfo xmlns="http://isds.czechpoint.cz/v20">
      <dbId>qrdae26</dbId>
    </DTInfo>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

obdržíme v testovacím prostředí odpověď

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <SOAP-ENV:Body>
    <p:DTInfoResponse xmlns:p="http://isds.czechpoint.cz/v20" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <p:ActDTType>2</p:ActDTType>
      <p:ActDTCapacity>100</p:ActDTCapacity>
      <p:ActDTFrom>2012-04-30</p:ActDTFrom>
      <p:ActDTTo>2100-01-01</p:ActDTTo>
      <p:ActDTCapUsed>100</p:ActDTCapUsed>
      <p:FutDTType>0</p:FutDTType>
      <p:FutDTCapacity xsi:nil="true"></p:FutDTCapacity>
      <p:FutDTFrom xsi:nil="true"></p:FutDTFrom>
      <p:FutDTTo xsi:nil="true"></p:FutDTTo>
      <p:FutDTPaid>0</p:FutDTPaid>
      <p:dbStatus>
        <p:dbStatusCode>0000</p:dbStatusCode>
        <p:dbStatusMessage>Provedeno úspěšně.</p:dbStatusMessage>
      </p:dbStatus>
    </p:DTInfoResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

, ve které lze jasně vidět <p:ActDTType>2</p:ActDTType>.

Můžete prosím ve Vaší odpovědi napsat všechny hodnoty elementů ActDTType a
FutDTType a opravit nebo doplnit dokumentaci služby DTInfo?

Díky a přeji pěkný den,
Karel Slaný.

192.1 Re: Chyba v dokumentaci ke službě DTInfo

602jsima 17.02.2021 13:06

Dobrý den.

Překlep v dokumentaci opravíme, bude nová verze k březnové odstávce, děkuji za upozornění.

Trezory typu 2 se vytvářely do r. 2013, a služba DTInfo se zavedla v roce 2016, v té době již žádný takový neměl existovat, protože maximální délka DT byla 2 roky. Nicméně z vaší ukázky je vidět, že na Veřejném testu kdysi (ještě před rokem 2013) došlo k nestandardnímu prodloužení DT typu 2 u vaší schránky na skoro 100 let, a zapomnělo se na to. U té schránky není žádná informace o založení trezoru (nebylo to standardní cestou), to už zpětně nevypátrám, kdo a proč to tak udělal.

Na produkčním prostředí se s typem trezoru 2 a 5 již nesetkáte.

 

Jan Šíma

ISDS

192.2 Re: Chyba v dokumentaci ke službě DTInfo

karel.slany@nic.cz 17.02.2021 13:21

Díky za odpověď,

jen Vás tedy poprosím, aby u uvedené testovací schránky nebyl datový trezor zrušen.

Díky,
Karel Slaný.

192.2.1 Re: Re: Chyba v dokumentaci ke službě DTInfo

602jsima 17.02.2021 13:30

Dobrý den,

kdybyste chtěl ten stav nějak znormálnit nebo zvětšit kapacitu, napište. Trezor je naplněný na 100%, tedy už se do něj nové zprávy neukládají

 

Jan Šíma

ISDS