Šajā rakstā ir piegādātāja formas cilne **Datu plūsmas konfigurācija**: iestatījumu tabula un kā
tajā pievieno atslēgas, kā Integrāciju centrāle saprot, kādā formātā fails ir, lapošana, kursors un tas, cik
bieži plūsma tiek atjaunota. Kā uzrakstīt plūsmas adresi, faila nosaukumu un pieejas datus,
aprakstīts pirmajā daļā:
[Datu plūsma — kur atrodas fails un pieejas dati](/hc/help2/articles/ecomlink-datu-plusma-kur-atrodas-fails).

Cilni atver **Integrāciju centrāle → Piegādātāji →** zīmuļa poga vajadzīgajā rindā **→ Datu plūsmas
konfigurācija**. Jaunam, vēl nesaglabātam piegādātājam tajā konfigurējama nav nekā.

Divi vārdi, kas rakstā atkārtojas:

- **Parsētājs** ir lasītājs, kas tieši šī vairumtirgotāja failu pārvērš precēs. Piegādātājam to
  piesprauž sistēmas administrators ekrānā **Integrācija** — sk.
  [Atbalstītie formāti un parsētāja izvēle](/hc/help2/articles/ecomlink-atbalstitie-formati-un-parseri).
- **Pavadošie faili** ir papildu faili blakus galvenajam: **Cenu lapa**, **Krājumu fails**,
  **Kategoriju koks**, **Vērtību apzīmējumi**, **Attēlu saraksts**. Tos norāda tieši šajā cilnē.
  Piegādātājam, kura plūsma ir viens fails, tādu nav.

Abas piegādātāja formas datu plūsmas cilnes saglabā **viena un tā pati disketes poga** panelī augšā —
tā iesniedz visu formu neatkarīgi no tā, kura cilne ir atvērta.

## Cilne «Datu plūsmas konfigurācija»

Tā ir divu kolonnu tabula: **Iestatījums** un **Vērtība**, ar pogām **Pievienot iestatījumu**,
**Noņemt iestatījumu** (atkritnes ikona rindas galā) un **Atjaunot noklusējumus**.

Cilne var rādīt arī paziņojumus — tie ir dažādās vietās un var parādīties kopā:

| Ko redz | Kur | Ko tas nozīmē |
|---|---|---|
| «Vispirms saglabājiet piegādātāju…» | virs tabulas | Piegādātājs vēl nav izveidots — konfigurējamais kļūst zināms tikai pēc saglabāšanas |
| «Šī piegādātāja datu plūsma vēl nav sagatavota importam…» | virs tabulas | Nav piesprausts parsētājs. To dara sistēmas administrators ekrānā **Integrācija** |
| «Šeit nav nekā, ko konfigurēt katram piegādātājam atsevišķi…» | **tabulas vietā** (tabula vispār netiek zīmēta) | Plūsma tiek lasīta kā viens fails ar cilnē **Datu plūsma** norādītajiem pieejas datiem. Tā ir norma standarta CSV plūsmai un piegādātājam bez piesprausta parsētāja. Standarta XML, XLSX un JSON piedāvā pa vienai vai vairākām atslēgām (`record_element`, `sheet`, `records_key`), tāpēc tiem šis ziņojums neparādās |
| «Nav iestatījumu — šis piegādātājs visur izmanto iebūvētos noklusējumus.» | **zem tabulas** | Iestatījumi ir pieejami, bet neviens nav uzstādīts |

Pirmie divi ziņojumi viens otru izslēdz: jauna piegādātāja formā rādās tikai pirmais, jau
saglabātam piegādātājam bez parsētāja — tikai otrais. Tiem blakus parasti ir arī trešais: kamēr
parsētāja nav, piedāvājamu iestatījumu nav — izņemot gadījumu, kad piegādātājam kādas rindas jau
ir saglabātas, un tad to vietā zīmējas tabula.

**Parsētāja nosaukums šajā formā netiek rādīts nekur** — ne kā etiķete, ne kā slēpts lauks. Tas ir
apzināti: to izvēlas ekrānā, kas pieejams tikai sistēmas administratoram.

> 📷 **Ekrānattēls:** ecomlink/vendor — cilne «Datu plūsmas konfigurācija» ar dažām aizpildītām rindām un pogām apakšā

### Kā izvēlas iestatījumu

Nospiežot **Pievienot iestatījumu**, parādās jauna rinda ar nolaižamo sarakstu. Saraksts ir sagrupēts:

| Grupa | Kas tur ir |
|---|---|
| **Faili un pieejas dati** | katra pavadošā faila atrašanās vieta un, ja parsētājs to atļauj, tā pieejas dati |
| **Datu plūsmas opcijas** | parsētāja paša slēdži (kura kolonna ir cena, kura — krājumi utt.) |
| **Attēlu resursdatori (pagaidām netiek izmantoti)** | praksē neparādās vispār |

Katra izvēle izskatās kā **«Apraksts (atslēga)»**, piemēram «Krājumu fails atrašanās vieta
(stock.location)». Atslēga seko aprakstam, jo tieši to nosauc saglabātais dokuments un katrs kļūdas
ziņojums.

> 📷 **Ekrānattēls:** ecomlink/vendor — cilne «Datu plūsmas konfigurācija», atvērts «Pievienot iestatījumu» saraksts ar redzamām grupām «Faili un pieejas dati» un «Datu plūsmas opcijas»

Divas lietas, kas pārsteidz:

- **Galvenā faila atrašanās vietu (`main.location`) saraksts nepiedāvā nekad.** Galvenā faila adrese
  dzīvo cilnē **Datu plūsma** (**Faila nosaukums** zem resursdatora), un otrs tās pieraksts šeit būtu
  slazds — atslēga, kas klusi zaudē kolonnai.
- **Katru atslēgu var lietot tikai vienu reizi.** Rindas cita citai izvēles «atņem», un, kad brīvu
  vairs nav, poga **Pievienot iestatījumu** kļūst neaktīva.

Daļai iestatījumu vērtība ir **nolaižamais saraksts**, nevis teksta lauks — tie ir slēdži ar
noteiktu vērtību kopu. Paroles tipa vērtības tiek rādītas maskēti.

**Daļa apzīmējumu ir angliski.** Latviski ir avotu nosaukumi (Galvenā datu plūsma, Cenu lapa,
Krājumu fails, Kategoriju koks, Vērtību apzīmējumi, Attēlu saraksts) un lauki («… atrašanās vieta»,
«… lietotājvārds», «… parole», «… autorizācijas galvene», «… ieslēgts»). Pārējie — `Record element`,
`Records key`, `Worksheet`, lapošanas lauki — parādās **angliski**, jo nāk no pašas integrācijas
apraksta. Rakstot atbalstam, tos var citēt tieši tā, kā tie ir ekrānā.

### Rindas, kuras nevar rediģēt

Rinda, kas rādās kā `kods` bez nolaižamā saraksta un ar **pelēku piezīmi ar brīdinājuma trijstūra
ikonu** zem atslēgas, ir **saglabāta, bet pašlaik neizmantota**. Piezīme pasaka, kāpēc:

| Piezīme | Ko darīt |
|---|---|
| «Šis iestatījums neattiecas uz to, kā šobrīd tiek lasīta šī piegādātāja datu plūsma…» | Palieka no parsētāja maiņas. Vērtība tiek saglabāta gadījumam, ja parsētājs mainītos atpakaļ. Ja to vairs nevajag, noņemiet rindu ar atkritnes pogu **Noņemt iestatījumu** (ekrāna tekstā rakstīts «notīriet rindu» — ar to domāta tieši rindas noņemšana, nevis vērtības izdzēšana) |
| «Šo iestatījumu nolasa tikai pilnais imports…» | Nekas. Vērtība paliek nemainīga |
| «Šis iestatījums pieder funkcijai, kas vēl nav ieslēgta.» | Nekas |

> 📷 **Ekrānattēls:** ecomlink/vendor — tikai lasāma rinda: atslēga kā kods un zem tās pelēkā piezīme ar brīdinājuma trijstūri

Par otro rindu: pilnie importi strādā, bet palaist tos drīkst **tikai sistēmas administrators**
(vadības panelī poga **Pilnais imports** ir redzama tikai viņam). Šī cilne pagaidām nepiedāvā
rediģēt iestatījumus, ko nolasa vienīgi pilnais imports; jau saglabātā vērtība paliek neskarta. Sk.
[Preču imports — palaišana un grafiks](/hc/help2/articles/ecomlink-precu-imports-palaisana).

Svarīgi: šīs rindas **netiek nodzēstas**, saglabājot kaut ko pavisam citu — tāpēc tās formā ir
redzamas.

### Poga «Atjaunot noklusējumus»

Tā aizpilda tabulu ar **visiem** iestatījumiem, ko šī plūsma piedāvā, katru ar tā iebūvēto
noklusējumu — **izņemot paroles tipa atslēgas**. Trīs būtiski sīkumi:

1. **Nekas netiek saglabāts, kamēr nesaglabājat** — tā ir tikai skata darbība.
2. Jau ierakstītās vērtības paliek tām atslēgām, kas joprojām tiek piedāvātas, bet **iepriekšējā
   sadaļā aprakstītās tikai lasāmās rindas tiek izmestas**. Tā ir pogas jēga: sakopt piegādātāju pēc
   parsētāja maiņas.
3. **Paroļu rindas tabula pēc šīs pogas nospiešanas pazūd** — parole netiek «atjaunota uz
   noklusējumu», to vienkārši neviens neuzraksta tukšā laukā. Ja paroles rinda bija, pēc
   **Atjaunot noklusējumus** tā jāpievieno un jāievada no jauna.

### Ko pārbauda saglabāšana

| Kļūda | Kad |
|---|---|
| «Katrs iestatījums drīkst parādīties tikai vienu reizi: …» | viena atslēga divās rindās |
| «Šī piegādātāja datu plūsma tādu iestatījumu nepiedāvā: …» | atslēga, ko šis parsētājs nepazīst |
| *«Not one of the values this setting allows…»* (angliski) | vērtība ārpus atļautā saraksta |

**Tukša vērtība netiek pārbaudīta** — parasti tā nozīmē «nav uzstādīts» un atgriež parsētāja
noklusējumu.

🔴 **Izņēmums, kas maksā dārgi.** Dažām atslēgām apzināti tukša vērtība nozīmē **«funkcija
izslēgta»**, nevis «noklusējums». Šodien tādas ir **četras**: DUELL `skip_restricted`
(noklusējums `lv`), `nonlocal_if_empty` (noklusējums `VAASA`) un `updates_dir` (noklusējums
`Data/Products/`), kā arī ALSOLT `exclude_classes` (noklusējums `X19`).
Iztukšojot šādu lauku, tas, ko tas vada, klusi izslēdzas — ALSO gadījumā katalogā ieplūst
garantijas un CarePack pozīcijas, DUELL gadījumā vairs netiek ņemti kataloga papildinājumi.
**Lai atgrieztos noklusējums, rinda ir jāNOŅEM** ar atkritnes pogu **Noņemt iestatījumu**, nevis
jāiztukšo.

## Kā Integrāciju centrāle saprot, kādā formātā fails ir

Lauks **Importa formāts** cilnē **Vispārējie** (XML / XLSX / CSV / PIM / PIM2 / CUST) **neietekmē
neko** — to drīkst atstāt, kā ir. Vienīgās sekas: tas pats apzīmējums parādās piegādātāju saraksta
kolonnā **«Formāts»** (vadības panelī tā nav), tāpēc jaunam piegādātājam tur rādīsies
PIM arī tad, ja patiesībā tā ir XML plūsma. Ja gribat, lai saraksti ir salasāmi, ielieciet tur īsto
formātu — importam tas neko nemaina.

Faktiski lasīšanu nosaka **piegādātājam piespraustais parsētājs** (ekrāns **Integrācija**, tikai
sistēmas administratoram), bet, ja tāda nav, — **automātiskā noteikšana** pēc faila satura un
paplašinājuma.

Automātiskā noteikšana **nekad neizvēlas konkrēta vairumtirgotāja parsētāju**. Tāpēc piegādātājam,
kuram ir savs parsētājs, tas ir jāpiesprauž ar roku — citādi imports vai nu nesagatavo neko, vai
(sliktākajā gadījumā) nolasa nepareizo krājumu lauku bez vienas kļūdas. Precīza atpazīšanas kārtība
un tās robežas aprakstītas rakstā
[Atbalstītie formāti un parsētāja izvēle](/hc/help2/articles/ecomlink-atbalstitie-formati-un-parseri).

## Lapošana — kad plūsma nāk pa lapām

Daļa piegādātāju nedod lejupielādējamu failu, bet API, kas katrā pieprasījumā atdod vienu lapu.
Šādai plūsmai grupā **Faili un pieejas dati** parādās pieci iestatījumi (apzīmējumi angliski).
Atslēgu nosaukumos priekšā ir **avota nosaukums** — galvenajai plūsmai tas ir `main`, un tieši šādā
pierakstā tie parādās kļūdu ziņojumos:

| Atslēga | Nozīme | Noklusējums |
|---|---|---|
| `main.page_param` | lapas numura parametra nosaukums — **tas ir slēdzis**, bez tā lapošana nenotiek | — |
| `main.page_size_param` | lapas izmēra parametra nosaukums | — |
| `main.page_size` | lapas izmērs; tiek sūtīts tikai tad, ja aizpildīti **abi** izmēra lauki. Ja tukšs, spēkā paliek piegādātāja paša lapas izmērs | — |
| `main.page_count_path` | punktēts ceļš 1. lapā, kur meklēt kopējo lapu skaitu, piem. `resource.paging.totalPages` | — |
| `main.page_max` | maksimālais lapu skaits vienā palaidienā | 500 |

**Vērtības nosaka piegādātājs, nevis Integrāciju centrāle.** Parametru nosaukumus pajautājiet vairumtirgotājam
vai atrodiet viņa API dokumentācijā; ceļu uz lapu skaitu var nolasīt, atverot 1. lapu pārlūkā un
paskatoties, kurā vietā atbildē ir lapu skaits.

Piemērs. Ja piegādātāja 1. lapas atbilde sākas ar
`{"resource": {"paging": {"page": 1, "totalPages": 37}, "products": [ … ]}}`, tad cilnē **Datu
plūsmas konfigurācija**:

1. **Pievienot iestatījumu →** «Main feed - Page parameter (`main.page_param`)», vērtība `page`
   (tas, kā parametru sauc piegādātājs). Bez šīs rindas lapošana nenotiek, tāpēc to pievieno pirmo.
2. **Pievienot iestatījumu →** «Main feed - Page count path (`main.page_count_path`)», vērtība
   `resource.paging.totalPages`.
3. Ja piegādātājs atļauj izvēlēties lapas izmēru — vēl divas rindas: `main.page_size_param`
   (piem. `limit`) un `main.page_size` (piem. `500`).
4. Saglabājiet ar disketes pogu un palaidiet **Krājumu importu** — kā nolasīt rezultātu, aprakstīts
   rakstā [Datu plūsma — kur atrodas fails un pieejas dati](/hc/help2/articles/ecomlink-datu-plusma-kur-atrodas-fails),
   sadaļā «Kā pārbaudīt, vai plūsma strādā».

Darbība: nolasa 1. lapu, izlasa no tās kopējo lapu skaitu, tad paņem 2…N. Visu lapu saturs nonāk
**vienā keša failā**, salikts cits aiz cita. Divi apzināti lēmumi, kas jāzina:

- ja `main.page_count_path` neatrisinās vai 1. lapa nav JSON, **lejupielāde apstājas pēc pirmās
  lapas** un žurnālā parādās brīdinājums;
- ja plūsma paziņo vairāk lapu nekā `main.page_max`, skaits tiek ierobežots un tas arī tiek
  ierakstīts žurnālā.

Lapošanas iestatījumi tiek piedāvāti **tikai tām plūsmām, kuru lasītājs prot lasīt sakonkatenētas
lapas** (praksē — Standard JSON). XML lasītājs apstātos pie pirmā saknes taga un klusi importētu
vienu lapu, tāpēc XML plūsmai šo lauku nav.

## Kursors — kad plūsmu iet ar nobīdi

Daļa piegādātāju datus atdod pa gabaliem, ko Integrāciju centrāle paņem automātiski — **te nav nekā, ko
iestatīt**, un nav nevienas atslēgas, ko sabojāt.

Vienīgais, kas šeit var gadīties: ja pirmā atbilde neatnes nevienu ierakstu, palaišana krīt ar
kļūdu. Tas gandrīz vienmēr nozīmē, ka piegādātājs pieprasījumu noraidīja (pieejas dati vai IP
adrese), nevis ka katalogs ir tukšs. Kļūdas tekstu meklējiet ekrānā **Žurnāli** — sk. [Žurnāli — ekrāns un izpilžu rindas](/hc/help2/articles/ecomlink-zurnali-un-diagnostika).

## Cik bieži datu plūsma tiek atjaunota

Grafiks ir cilnē **Vispārējie**, nevis datu plūsmas cilnēs — divi atsevišķi lauki: **Atjaunošanas
biežums** (cenas, krājumi, statuss) un **Pilnā importa biežums** (apraksti, attēli, atribūti,
opcijas, jaunas preces). Abiem noklusējums ir **Tikai manuāli**, un abos sarakstos šī izvēle ir
pirmā; automātiskās izvēles pārklājas vienīgi pie «Reizi dienā».

Grafiks strādā tikai tad, ja piegādātājam cilnē **Vispārējie** slēdzis **Imports** ir «Jā».
Neatkarīgi no grafika importu vienmēr var palaist ar roku. Pilns apraksts:
[Preču imports — palaišana un grafiks](/hc/help2/articles/ecomlink-precu-imports-palaisana) un
[Veikala atjaunošanas grafiks un komandas](/hc/help2/articles/ecomlink-veikala-atjaunosanas-grafiks).

## Ja kaut kas nestrādā

**Cilne «Datu plūsmas konfigurācija» ir tukša un raksta, ka plūsma vēl nav sagatavota importam.**
Piegādātājam nav piesprausts parsētājs. Kamēr tā nav, šeit nav ko rediģēt — arī tad, ja zināt, kura
atslēga jums vajadzīga. Palūdziet administratoram to piesaistīt ekrānā **Integrācija**.

**Imports pabeidzas «veiksmīgi», bet nesagatavo nevienu preci vai uzrāda nepareizus krājumus.**
Tipiskākais cēlonis — piegādātājam ar savu parsētāju tas nav piesaistīts, un plūsmu nolasīja
standarta parsētājs. Kļūdas nav, jo fails formāli nolasījās. Pārbaudiet ekrānu **Integrācija** un žurnālus — sk.
[Žurnāli — diagnostika un ziņojumu atšifrējums](/hc/help2/articles/ecomlink-zurnali-diagnostika-un-zinojumi).

**Iestatījums, ko nesen ierakstījāt, importā neko nemaina.**
Pirmais, ko pārbaudīt: **vai pēc izmaiņas imports ir palaists no jauna** — iestatījums stājas spēkā
tikai nākamajā lejupielādē. Otrs: atveriet cilni un paskatieties, vai rinda nav kļuvusi tikai
lasāma ar piezīmi, ka iestatījums neattiecas uz pašreizējo lasīšanas veidu (parsētājs pa vidu
mainīts) vai ka to nolasa tikai pilnais imports. Žurnāla brīdinājums par to, ka spēkā palicis
parsētāja noklusējums, ir rets: formā ievadītu vērtību ārpus atļautā saraksta saglabāšana atsaka
uzreiz, tāpēc tas iespējams tikai pēc parsētāja nomaiņas vai tad, ja vērtība ierakstīta apejot formu.

**Plūsma atdod tikai daļu kataloga.**
Ja piegādātājs dod datus pa lapām, pārbaudiet `main.page_count_path` un `main.page_max`. Žurnālā ir
redzams gan tas, cik lapu tika paņemts, gan brīdinājums, ja ceļš uz lapu skaitu neatrisinājās vai
skaits tika ierobežots.

**Kļūda ir par plūsmas adresi, pieejas datiem vai pašu lejupielādi.**
Resursdatora lauku atteikumi, 401/403, IP atļauto saraksts un lejupielādes limiti ir pirmajā daļā:
[Datu plūsma — kur atrodas fails un pieejas dati](/hc/help2/articles/ecomlink-datu-plusma-kur-atrodas-fails).

Saistītie raksti: [Piegādātāja pievienošana — sagatavošanās un pamatdati](/hc/help2/articles/ecomlink-piegadataja-pievienosana) — kā piegādātājs
tiek izveidots · [Atbalstītie formāti un parsētāja izvēle](/hc/help2/articles/ecomlink-atbalstitie-formati-un-parseri) — kā plūsmai
piesprauž vairumtirgotāja parsētāju · [Lauku pārsaiste — pārsaistīšana un sausā palaišana](/hc/help2/articles/ecomlink-lauku-parsaiste-parsaistisana) —
ja plūsmas lauks nonāk nepareizā preces īpašībā ·
[Žurnāli — ekrāns un izpilžu rindas](/hc/help2/articles/ecomlink-zurnali-un-diagnostika) — kur redzams, kas importā tiešām notika