Izdruku iegūšana
Izdrukas, ja tādas ir izveidotas Horizon, ir pieejamas caur REST gan entītei, gan entīšu kolekcijai (sarakstam).
Katrai entītes klasei un kolekcijai pieejamās izdrukas uzskaitītas attiecīgā entītes un kolekcijas resursa apakšresursā print
.
Izdrukas ir sagrupētas pa grupām, tāpat kā Horizon aplikācijā. Katrā grupā ir viena atskaite - oriģināls, no kuras lietotājs var būt izveidojis vairākas modificētas atskaites.
Oriģinālu var atšķirt pēc to aprakstošā link
elementa apakšelementa href
- šim apakšelementam ir atribūts rel
ar vērtību original
.
Entītes izdruka
GET http://localhost:81/rest/TNdmNom/99143/print HTTP/1.1
<resource xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <description>Izdrukas</description> <group> <description>Nomenklatūras svītrkods</description> <link> <href rel="original">/rest/TNdmNom/99143/print/rtQRRepDoc/1/0</href> <description>Nomenklatūras svītrkods</description> </link> <link> <href>/rest/TNdmNom/99143/print/rtQRRepDoc/1/1779</href> <description>a4</description> </link> <link> <href>/rest/TNdmNom/99143/print/rtQRRepDoc/1/2714</href> <description>ssdfa</description> <link> <href>/rest/TNdmNom/99143/print/rtQRRepDoc/1/-1</href> <description>Nomenklatūras svītrkods (LVL)</description> </link> </group> </resource>
Entīšu kolekcijas izdrukas
GET http://localhost:81/rest/TNdmNomIzvSar/print HTTP/1.1
<resource xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <description>Izdrukas</description> <group> <description>Ātrā saraksta izdruka</description> <link> <href rel="original">/rest/TNdmNomIzvSar/print/rtQRFastRep/1/0</href> <description>Ātrā saraksta izdruka</description> </link> </group> <group> <description>Cenas lapa</description> <link> <href rel="original">/rest/TNdmNomIzvSar/print/rtQRRepSar/1/0</href> <description>Cenas lapa</description> </link> <link> <href>/rest/TNdmNomIzvSar/print/rtQRRepSar/1/2283</href> <description>Spec Test</description> </link> <link> <href>/rest/TNdmNomIzvSar/print/rtQRRepSar/1/2403</href> <description>Cenas lapa ar papgr</description> </link> <link> <href>/rest/TNdmNomIzvSar/print/rtQRRepSar/1/3649</href> <description>koko</description> </link> </group> </resource>
Konkrēto izdruku iegūst, veicot GET pieprasījumu uz izdrukas resursu. Pieprasījuma galvenē jānorāda izdrukas izvades formāts (eksporta veids) parametrā Accept.
GET http://localhost:81/rest/TNdmNom/99143/print/rtQRRepDoc/1/2947 HTTP/1.1 Accept: application/pdf
Izdrukas parametri
Ja nepieciešams, pieprasījumā var norādīt izdrukas parametrus.
Parametrs | Veids | Skaidrojums | Noklusētā vērtība |
---|---|---|---|
copyCount | URL parametrs | Izdrukas kopiju skaits | 1 |
fromPage | URL parametrs | Lapas numurs, no kuras sākt izdruku | 1 |
toPage | URL parametrs | Lapas numurs, līdz kurai turpināt izdruku | Pēdējā izdrukas lapa |
Zemāk redzamajā pieprasījuma piemērā ir norādīts, ka atgrieztajai izdrukai jāsatur dati no otrās līdz desmitajai lapai un jāatgriež divas kopijas. Izdrukai jābūt PDF formātā (galvenē Accept
vērtība application/pdf
).
GET http://localhost:81/rest/TNdmNom/99143/print/rtQRRepDoc/1/2947?fromPage=2&toPage=10©Count=2 HTTP/1.1 Accept: application/pdf
Izdrukas atbalstītos izvades formātus un izdrukas parametrus var iegūt no entītes WADL
resursa.
Zemāk redzamajā WADL fragmentā redzams, ka konkrētajai izdrukai tiek atbalstīti četri izvades formāti: PDF, HTML, Excel un RTF un četri izdrukas parametri: copyCount,fromPage,toPage unAccept.
<resource path="rtQRRepSar/1/2283"> <method name="GET" id="get"> <request> <param name="copyCount" type="xsd:integer" style="query" required="false"/> <param name="fromPage" type="xsd:integer" style="query" required="false"/> <param name="toPage" type="xsd:integer" style="query" required="false"/> <param name="Accept" type="xsd:string" style="header" required="true"/> </request> <response status="200"> <representation mediaType="application/pdf"/> <representation mediaType="text/html"/> <representation mediaType="application/vnd.ms-excel"/> <representation mediaType="application/rtf"/> </response> </method> </resource>