Kā ievadīt skaitītāju rādījumus?

[#1]

Rādījumu ielāde izmantojot Horizon REST notiek pa vienam rādījumam. Horizon iespējami dažādi rādījumu veidi.

• Kontrolskaitītāju rādījumi - Kontrolskaitītāji ir skaitītāji, kuri nav tieši piesaistīti konkrētam līgumam, piemēram, daudzdzīvokļu mājas ievadskaitītājs, ja rēķini tiek izrakstīti katram dzīvoklim.

Līgumu skaitītāju rādījumu reģistrēšanai iespeājams izvēlēties vienu no šiem variantiem:

• Līgumu skaitītāju rādījumi - rādījums tiek reģistrēts uzreiz konkrētam līgumam par periodu
• Nolasītie rādījumi - rādījums tiek reģistrēts tikai uz skaitītāja eksemplāru, konkrētā datumā. Pēc tam sistēmas lietotājs veiks pārlasīšanu uz līguma rādījumiem, kur rādījums tiks piesaistīts līgumam un periodam.

Lai reģistrētu rādījumu nepieciešams zināt skaitītāja eksemplāra sistēmas ID. Par to, kas Horizon ir skaitītāja eksemplārs skatiet šeit.

Lai atrastu visus skaitītāja eksemplārus, kas ir derīgi konkrētā datumā, iespējams izmantot vaicājumu /rest/TdmPNSSkaEksSL/query?columns=PSKR_NUMURS,PSKR_SPEKA_NO,PSKR_SPEKA_LIDZ&criteria=CRT_INPER&PerLidz=2017-04-13&PerNo=2017-04-13

Parasti skaitītāju rādījumi tiek pievienoti sagataves statusā un tos pēc tam apstiprina Horizon lietotājs. Ja nepieciešams rādījumu plūsmu veidot savādāk, tad var izmantot <STAD>, lai norādītu rādījuma stadiju.

Līgumu skaitītāju rādījumi

POST <REST server>/rest/TdmPNSSkaLigRadBL ar sekojošu body:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<resource>
  <entity>
    <RAD>12</RAD>
    <PK_DATAV>
      <href>/rest/TdmPNSDatAvBL/3</href>
    </PK_DATAV>
    <PK_SKAR>
      <href>/rest/TdmPNSSkaRBL/104</href>
    </PK_SKAR>
    <DAUDZ_TIPS>2</DAUDZ_TIPS>
    <PIEZIM />
    <PER_NO>2019-03-01</PER_NO>
    <PER_LIDZ>2019-03-31</PER_LIDZ>
    <PK_LIGR>405</PK_LIGR>
  </entity>
</resource>

Kur:

• RAD – rādījums
• PK_DATAV – datu avots (TdmPNSDatAvSL)
• PK_SKAR – skaitītāja eksemplāra sistēmas ID
• DAUDZ_TIPS - 2 (Importēts daudzums)
• PIEZIM – piezīmes
• PER_NO, PER_LIDZ – rādījuma periods
• PK_LIGR – līguma "otrās daļas" ID. To var iegūt resursa /rest/TdmPNSLigSL laukā KNLIG.PK_LIGR.

Lai uzzinātu kurā līgumā ir iekļauts skaitītājs konkrētā datumā, iespējams izmantot šādu vaicājumu - /rest/TdmPNSLigAprSkaSL/query?columns= KLIG_NUMURS,KNLIG_PK_LIG,LAPRSKA_SPEKA_NO,LAPRSKA_SPEKA_LIDZ,PSKR_PK_SKAR,PSKR_NUMURS&filter=PSKR_PK_SKAR eq '30' and LAPRSKA_SPEKA_NO le 2022-08-31 and (isnull(LAPRSKA_SPEKA_LIDZ) or LAPRSKA_SPEKA_LIDZ ge 2022-08-31)

Viens skaitītāja eksemplārs var būt piesaistīts līgumam vairākas reizes, ja nodrošina vairāku pakalpojumu aprēķinu. Viens skaitītāja eksemplārs var būt piesaistīts vairākiem līgumiem, ja tā nepieciešams pēc aprēķina nosacījumiem.

Lai iegūtu līguma "otrās daļas" ID atrasto KNLIG_PK_LIG nepieciešams izmantot šādā vaicājumā -/rest/TdmPNSLigSL/query?columns= KLIG_PK_LIG,KNLIG_PK_LIGR&filter=KLIG_PK_LIG eq '221'

Nolasītie rādījumi

POST <REST server>/rest/TdmPNSSkaNolRadBL ar sekojošu body:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<resource>
  <entity>     
    <DATUMS>2022-03-01</DATUMS>
    <RAD>12</RAD>
    <PK_DATAV>
      <href>/rest/TdmPNSDatAvBL/3</href>
    </PK_DATAV>
    <PK_SKAR>
      <href>/rest/TdmPNSSkaRBL/104</href>
    </PK_SKAR>
    <DAUDZ_TIPS>2</DAUDZ_TIPS>
    <PIEZIM />
  </entity>
</resource>

Kur:

• DATUMS – rādījuma nolasīšanas datums
• RAD – rādījums
• PK_DATAV – datu avots (TdmPNSDatAvSL)
• PK_SKAR – skaitītāja eksemplāra sistēmas ID
• DAUDZ_TIPS - 2 (Importēts daudzums)
• PIEZIM – piezīmes

Kontrolskaitītāju rādījumi

POST <REST server>/rest/TdmPNSSkaKontrSkaRadBL

<resource>
<description>Jauna ieraksta sagatave</description>
  <entity>
    <RAD>20</RAD>
    <PK_DATAV/>
    <PK_SKAR>42</PK_SKAR>
    <DAUDZ_TIPS>2</DAUDZ_TIPS>
    <PIEZIM/>
    <PER_NO>2020-02-01</PER_NO>
    <PER_LIDZ>2020-02-29</PER_LIDZ>
  </entity>
</resource>

Kur:

• RAD – rādījums
• PK_DATAV – datu avots (TdmPNSDatAvSL)
• PK_SKAR – skaitītāja eksemplāra sistēmas ID
• DAUDZ_TIPS - 2 (Importēts daudzums)
• PIEZIM – piezīmes
• PER_NO, PER_LIDZ – rādījuma periods

[Andrejs_R]

Labdien!

Jautājums par "Rādījumu ielāde izmantojot Horizon REST notiek pa vienam rādījumam." - kādā veidā būtu iespējams ielādēt rādījumus nevis pa vienam, bet pa 10 vai piem. 100 reizē? Tas būtu optimāli un samazinātu serveru noslodzi.

Paldies!

[Ilga Andersone]

@Andrejs_R Šobrīd pieejama tikai iespēja ielādēt rādījumus pa vienam. Tuvākajā laikā arī uzlabojumi nav paredzēti.

[#4]

Integrācijām ar Horizon tiek izmantoti WEB lietotāji. Tas ir lietotāja paveids Horizon, ko izmanto pieslēgšanai WEB aplikācijām, t.sk. REST integrācijām.

Veidojot WEB lietotāju, tam obligāti jānorāda Horizon lietotājs, jo pēc šī Horizon lietotāja tiek noteikta WEB lietotāja loma un tiesības, kas nosaka pieejamās funkcionālās sadaļas un tiesības apstrādāt vai skatīt datus.

Tātad vispirms nepieciešams izveidot lomu ar atbilstošām pieejas tiesībām. Vairāk par lomu veidošanu lasīt šeit.

Sistēma - Administrēt - Lomas

Nākamais solis ir izveidot Horizon lietotāju.

Sistēma - Administrēt - Lietotāji

Šādam lietotājam norāda konta veidu Sistēmkonts.

Lappusē Tiesības norāda, kuras firmas datiem būs pieeja un ar kādu lomu.

Visbeidzot var veidot WEB lietotāju.

Sistēma - Administrēt - WEB lietotāji

Lappusa Pamatinformācija

Arī šeit konta veids jānorāda Sistēmkonts, kā arī WEB lietotājs jāsasaista ar Horizon lietotāju.

Lappusē Firmas un objekti norāda, kura šim pieslēgumam būs noklusētā firma.

Lappusē Atļautās saskarnes atzīmē "piešķirtās" un norāda saskarni "Vispārējā integrācija", ja vien nav izveidota atsevišķa saskarne topošajai integrācijai.

Vairāk par saskarnēm lasīt šeit.