Tema 4 · Aplinka ir ERP UI

Saugi aplinka ir kas vyksta ERP sąsajoje kuriant automatizavimą

Po Temoje 3 aptartų ERP objektų išvedimo būdų (Custom Reports, rql, failai) ir šaltinių lentelės einame į konkrečią darbo vietą sąsajoje: kur sistemoje randate automatizacijas, kaip kuriate naują, kokie būna tipai, kaip perduodami pradiniai duomenys ir kur matote rezultatą bei vykdymo žurnalą. Techninę JSON / scriptContent sutartį — Tema 6.

1. Aplinka rašymui ir bandymams

  • Aplinka — diegimo / testavimo tenantas, kuriame leidžiama eksperimentuoti (ne gamybinis klientas be sutarties).
  • Versija — kad elgsena sutaptų su klientu, scenarijus tikrinu toje pačioje (ar artimiausioje) ERP versijoje.
  • Teisės — naudotojas, kuriuo testuoju, turi matyti tuos pačius meniu ir dokumentų tipus kaip galutinis vykdytojas.
  • Įrankis — scenarijų redaktorius Rivile ERP vartotojo sąsajoje; šalia naudojama IDE su šiuo mokymų paketu. Išvedimo keliai ir šaltiniai — Temoje 3; redagavimo tvarka ir TypeScript kontekstas — Tema 5; JSON repo — Tema 6 ir scripts/readme.html .

Konkretūs meniu pavadinimai ir mygtukų eiliškumas priklauso nuo jūsų diegimo ir rolės — juos geriausia vieną kartą užfiksuoti ekrano nuotraukoje ar vidinėje žinyne, o čia laikau bendrą principą: pirmiau saugi aplinka, paskui kodas.

2. Automatizacijų sąrašas, naujas įrašas ir tipai (ERP UI)

Tiksli meniu vieta priklauso nuo versijos, modulių ir rolės — organizacijoje verta turėti vieną ekrano nuotrauką ar PDF su pažymėtu keliu. Žemiau — tipinė logika, kurią naujokas sutapatina su savo diegimu.

  1. Sąrašas — administracinės / integracijų / sistemos nustatymų sritis, kur matote visus automatizavimo apibrėžimus (aktyvius, juodraščius, suplanuotus). Užduotis: rasti tą sąrašą savo TEST ir įrašyti pavadinimus meniu lietuviškai.
  2. Naujas automatizavimas — mygtukas „Naujas“ / „Kurti“: gaunate tuščią apibrėžimą (pavadinimas, kodas, įmonė, trigeriai, tuščias scenarijaus kūnas arba šablonas). Išsaugojimas dažnai kuria juodraštį, kurį vėliau aktyvuojate atskirai.
  3. Tipai (kas nulemia paleidimą) — be gilinimosi į visus variantus: rankinis / kontekstinis iš sąrašo ar dokumento; įvykis sistemoje; laikmatis (CRON); išorinis kvietimas (webhook ir pan., jei įjungta). Išsamiau — Tema 8 · Konceptas ir trigeriai.

3. Pradiniai duomenys, atsakymas vartotojui ir vykdymo žurnalas

Kas Kur matote UI Siejimas su kodu
Įėjimas (initial) Kai paleidžiate iš sąrašo — pažymėti ID; iš dokumento — kontekstas; su forma — laukai, kuriuos aprašote parametruose. Scenarijuje skaitote initial.ids, initial.id, initial.filterString arba formos laukus — žr. Tema 6 ir repo aa260126.
Išėjimas (output) Po sėkmės ar klaidos — pranešimas dialoge / užduotyje / istorijos įraše (priklauso nuo paleidimo būdo). Kode užpildote output.message, executionStatus, struktūrizuotą santrauką — Tema 7 · output.
Vykdymo žurnalas Automatizavimo istorija / veiksmų žurnalas / vykdymo detalė (pavadinimas priklauso nuo versijos) — ten matote log.info / log.error eilutes ir techninę santrauką. Kode naudokite await log.info(…) prieš sunkius žingsnius ir log.error su kontekstu klaidoje — žr. Tema 7 · žurnalas.

Mini scenarijus „naujokui“ (conceptual): mygtukas sąraše → platforma suformuoja initial.ids → scenarijus tikrina if (!initial.ids?.length) throw new UserError("…") → vykdo mutate → output.message = "Apdorota: " + initial.ids.length → vartotojas mato žinutę; žurnale — log.info eilutės.

Teorijos santrauka

Praktika salėje

TEST: sukurkite juodraštinį automatizavimą be verslo logikos, paleiskite „bandymą“ su vienu log.info ir užfiksuokite, kur sąsajoje atsirado žurnalo eilutė.

Savarankiškas darbas

  1. Patikrinkite, ar jūsų komandos naudojama TEST versija atitinka bent vieną gamybinį klientą, su kuriuo dirbsite (major / patch).
  2. Įrašykite, kuriuo naudotoju testuojate scenarijus ir ar jo teisės sutampa su „tikruoju“ vykdytoju.