Veicot Preču un pakalpojumu kartīšu (preču nomenklatūra ar cenu katalogu) importu, izmantojot REST API savienojumu, XML pieprasījums JSON formātā, kurš norādāms parametrā "XMLrequest", izskatīsies šādi:
"<?xml version=\"1.0\" encoding=\"utf-8\" ?>
<dataroot>
<tjDocument Version=\"TJ5.5.101\"/>
<tjResponse Name=\"Product\" Operation=\"Insert\" Version=\"TJ5.5.101\" Structure=\"Tree\">
<Product>
...
</Product>
</tjResponse>
</dataroot>"
Pieprasījuma struktūra:
| <?xml version=\"1.0\" encoding=\"utf-8\" ?> | XML galviņa |
| <dataroot> | XML struktūras pamatelements (nemainīt) |
| <tjDocument Version=\"TJ5.5.101\"/> | XML dokumenta kopējais apraksts (šobrīd tikai versija) |
| <tjResponse> | Satur vienu importa pieprasījumu |
| Name=\"Product\" | Datu bloka nosaukums |
| Operation=\"Insert\" | Pieprasījuma veids: Insert – jaunu datu pievienošana |
| Version=\"TJ5.5.101\" | Pieprasījuma formāta versija. Sākotnēji versija tiek balstīta uz sistēmas Tildes Jumis versiju, bet tā dinamiski mainās katram blokam atsevišķi. |
| Structure=\"Tree\" | Ievietojamie dati ir padoti (insert) saraksta (tabulārā) veidā vai kokveida struktūrā Tree – kokveida struktūrā Sheet – saraksta veidā Pēc noklusēšanas: Tree Brīdinājums: pārnesot datus no vienas Jumja datubāzes uz citu, ieteicams izmantot kokveida struktūru. Brīdinājums: atskaites formē datus tikai Sheet režīmā. |
| <Product> ... </Product> |
Satur datu laukus un ievietojamo informāciju. Daudzpunktu vietā jāievieto nepieciešamie lauki. |
Lauku nosaukumi, paskaidrojumi, datu tipi un pazīme vai pēc lauka var atlasīt informāciju (filtrēt) un atlases iespējas:
* - izmantojot XML laukus var tikai nolasīt no sistēmas, bet nevar ierakstīt (insert)
*** - papildus atlases nosacījums
| Lauks | Paskaidrojums | Datu tips | Filtrs |
|---|---|---|---|
| <Product> | Prece | ||
| <ProductID> | Preces ID | int | Integer |
| <ProductExpiryDay> | Preces derīguma termiņš (dienas) | tinyint | |
| <ProductExpiryMonth> | Preces derīguma termiņš (mēneši) | tinyint | |
| <ProductExpiryHour> | Preces derīguma termiņš (stundas) | tinyint | |
| <ProductOriginCountryID> | Preces izcelsmes valsts ID | int | |
| <ProductOriginCountryCode> | Preces izcelsmes valsts kods | varchar(3) | |
| <ProductOriginCountryName> | Preces izcelsmes valsts nosaukums | varchar(50) | |
| <ProductCnCode> | Preces KN kods | varchar(20) | |
| <ProductCode> | Preces kods | varchar(20) | String |
| <ProductUnit> | Preces mērvienība | varchar(50) | String |
| <ProductUnitID> | Preces mērvienības ID | int | |
| <ProductName> | Preces nosaukums | varchar(100) | String (like) |
| <ProductNick> | Preces nosaukums (īsais) | varchar(20) | |
| <ProductComments> | Preces piezīmes | varchar(255) | |
| <ProductCertificate> | Preces sertifikāts | varchar(100) | String (like) |
| <ProductBarCode> | Preces svītrkods | varchar(20) | String |
| <ProductTypeID> | Preces tipa ID | int | |
| <ProductTypeCode> | Preces tipa kods | varchar(20) | Tree |
| <ProductTypeName> | Preces tipa nosaukums | varchar(50) | String |
| <ProductClassName> | Preces uzskaites grupa | varchar(50) | |
| <ProductClassAbbreviation> | Preces uzskaites grupa (saīsinājums) | varchar(20) | String (like) |
| <ProductClassID> | Preces uzskaites grupas ID | tinyint | |
| <ProductPrice> | Preces cena | ||
| <ProductPriceID> | Preces cenas ID | int | |
| <Price> | Cena | money | |
| <PriceTypeID> | Cenas tipa ID | int | |
| <PriceTypeName> | Cenas tips | varchar(50) | String (like) |
| <PriceCurrency> | Cenas valūta | varchar(3) | String |
| <PriceCurrencyID> | Cenas valūtas ID | int | |
| <ProductWarehouse> | Preces noliktava | ||
| <ProductWarehouseID> | Preces noliktavas ID | int | Integer |
| <WarehouseID> | Noliktavas ID | int | |
| <WarehouseUtmostQuantity> | Noliktavas maksimālais daudzums | money | |
| <WarehouseQuantityUnit> | Noliktavas mērvienība | varchar(50) | |
| <WarehouseQuantityUnitID> | Noliktavas mērvienības ID | int | |
| <WarehouseNecessaryQuantity> | Noliktavas minimālais daudzums | money | |
| <WarehouseName> | Noliktavas nosaukums | varchar(409) | String |
| <ProductDimension> | Preces dimensija | ||
| <DimensionLinkID> | Preces dimensijas piesaistes ID | int | |
| <DimensionID> | Dimensijas ID | int | Integer |
| <DimensionCode> | Dimensijas kods | varchar(10) | |
| <DimensionName> | Dimensijas nosaukums | varchar(255) | |
| <DimensionTypeID> | Dimensijas veida ID * | Integer | |
| <DimensionTypeCode> | Dimensijas veida kods * | ||
| <DimensionTypeName> | Dimensijas veida nosaukums * | ||
| <ProductExtraInfo> | Preces papildinformācija | ||
| <ExtraInfoLinkID> | Preces papildinformācijas piesaistes ID | int | |
| <ExtraInfo> | Papildinformācija | varchar(1000) | |
| <ExtraInfoFormatID> | Papildinformācijas formāta ID | int | |
| <ExtraInfoID> | Papildinformācijas ID | int | |
| <ExtraInfoName> | Papildinformācijas nosaukums | varchar(255) | |
| *** <Dimension> | Dimensija | Dimension |
Plašāka informācija par XML lauku aprakstiem ir pieejama šeit: Jumis XML apraksts
Komentāri
0 comments
Komentāri šim rakstam ir slēgti.