Értékütemező

Az eYssen Value Scheduler alkalmazás (value_scheduler) egyszerre sok rekordon módosítja egy mező értékét egy kétoszlopos CSV- vagy Excel-fájl alapján, akár azonnal, akár egy előre megadott időpontban. Tipikus példa az árlistacímkék átváltása egy akció kezdetén, vagy egy teljes beszállítói katalógus termékattribútumainak éjszakai frissítése.

Minden művelet egy előbeállításra (preset) épül, amelyet az adminisztrátor egyszer készít el, és amely meghatározza a frissítendő modellt és mezőt, valamint a rekordok megkeresésének módját. A felhasználóknak ezután csak egy fájlt kell feltölteniük.

Megjegyzés

Az alkalmazáshoz szükséges a Price List Validation by Tags modul (eyssen_product_pricelist_tag), amely vele együtt települ.

Hozzáférési jogok

A felhasználó hozzáférési jogai között a Value Scheduler kategóriának két szintje van:

  • Scheduler: megnyithatja az alkalmazást, és a meglévő előbeállításokkal importokat hozhat létre, dolgozhat fel, ütemezhet és vonhat vissza;

  • Administrator: ezen felül hozzáfér a Developer menühöz: a Preset Editor szerkesztőhöz és az All Scheduled Changes listához.

Fájl importálása

  1. Nyissa meg a Value Scheduler alkalmazást, és az Operations menüben kattintson az elvégzendő műveletre (pl. Pricelist Tag Update). Megjelenik a művelet korábbi importjainak listája.

  2. Kattintson az Új gombra, és töltse fel a fájlt a File mezőbe.

  3. Válassza ki a Run Mode (futtatási mód) értékét:

    • Timed: a módosítások a Scheduled Date időpontjában kerülnek alkalmazásra, amely ekkor kötelezővé válik;

    • Instant: a módosítások a fájl feldolgozásakor azonnal alkalmazásra kerülnek. Ez a mód importonként legfeljebb 25 módosításra korlátozódik.

  4. Válassza ki a Write Mode (írási mód) értékét:

    • Overwrite: a fájlban lévő érték felváltja a mező aktuális értékét. Címkemező esetén az üres második oszlop kiüríti a mezőt;

    • Extend: címkemező esetén a fájl értékei hozzáadódnak a meglévőkhöz;

    • Remove: címkemező esetén a fájl értékei eltávolításra kerülnek a meglévők közül. Jelölje be a Clear All lehetőséget, ha ehelyett a mezőt ki szeretné üríteni, függetlenül a második oszlop tartalmától. Minden más mező esetén a mező kiürül.

  5. Kattintson a Process gombra. A rendszer beolvassa a fájlt, soronként létrehoz egy ütemezett módosítást, és a fájlt csatolja az import üzenetfalához. Ha egy sor nem értelmezhető (pl. ismeretlen címkenév), a rendszer a teljes fájlt elutasítja, és az üzenet felsorolja a javítandó sorokat.

Timed módban az import és módosításai Scheduled állapotba kerülnek. Instant módban a módosítások azonnal végrehajtódnak, és az import Done állapotba kerül.

screenshot: general-value-scheduler-import-form
menu
Value Scheduler ‣ Operations ‣ Pricelist Tag Update ‣ New
shows
A draft import form with the Process button, the uploaded file, Run Mode "Timed" with a scheduled date, and Write Mode "Extend".
highlight
The "Run Mode" and "Write Mode" radio buttons (red frame).
data
File "promo_tags_week40.csv"; scheduled date next Monday 00:00.
module
value_scheduler
notes
English UI, light theme, 1440px width.

Fájlformátum

A fájl vagy CSV-fájl (; elválasztó, UTF-8 vagy Latin-1 kódolás), vagy Excel-munkafüzet (.xlsx), amelynek csak az első munkalapja kerül beolvasásra. Az első sor fejléc, amelyet a rendszer figyelmen kívül hagy. Minden további sor két oszlopból áll:

  1. a keresési érték, amely a frissítendő rekord(ok) megkeresésére szolgál. Azt, hogy mely mezővel kerül összehasonlításra, az előbeállítás határozza meg (pl. a termék belső hivatkozása). Az üres első oszlopú sorokat a rendszer kihagyja;

  2. az új érték. Értelmezése az előbeállítástól függ; a Pricelist Tag Update előbeállításnál ez az árlistacímkék nevének vesszővel elválasztott listája (a kis- és nagybetűk nem számítanak).

reference;tags
FURN_0096;Promo week 40, Wholesale
FURN_1118;Promo week 40

Figyelem

Ne használjon aposztrófot (') a keresési értékekben: az ilyen sorok nem párosíthatók.

Import nyomon követése és visszavonása

Az ütemezett módosításokat a Value Scheduler: Process Timed Changes ütemezett művelet hajtja végre, amely ötpercenként fut, és az esedékes módosításokat 25-ös kötegekben dolgozza fel, amíg el nem fogynak. Egy módosítás ezért a Scheduled Date időpontját követő néhány percen belül kerül alkalmazásra.

Az importon a Changes intelligens gomb és a Scheduled Changes fül mutatja a módosításokat a keresési értékkel (Lookup), a fájlban szereplő értékkel (Modifier), valamint – végrehajtás után – a régi értékkel (Old Value) és az eredménnyel (Result). Kattintson egy sor ikonjára az egyező rekordok megnyitásához. Egy módosítás állapota a következők egyike lehet:

  • Draft: létrehozva, még nincs sorba állítva;

  • Scheduled: az időpontjára vár;

  • Done: az érték módosult;

  • Unchanged: a rekordok már a kért értékkel rendelkeztek;

  • Failed: a módosítást nem sikerült alkalmazni; az ok a módosítás Notes fülén olvasható (pl. a keresési értékre nem található rekord).

Egy import akkor Done, ha minden módosítása hiba nélkül feldolgozásra került, és Failed, ha legalább egy közülük sikertelen volt.

Az importon a következő gombok érhetők el:

  • Cancel: olyan Scheduled állapotú importon, amelynek még egyetlen módosítása sem lett végrehajtva, az importot Cancelled állapotba helyezi; módosításai visszakerülnek Draft állapotba, és nem kerülnek alkalmazásra;

  • Visszaállítás piszkozatba: az importot az ütemezett és a sikertelen módosításaival együtt visszaállítja Draft állapotba, például az ütemezett időpont módosításához;

  • Ütemezés: olyan piszkozat állapotú importon, amelynek már vannak módosításai, újra sorba állítja azokat, a fájl ismételt beolvasása nélkül.

Csak a piszkozat állapotú importok törölhetők.

Megjegyzés

Instant módban minden frissített rekord üzenetfalára egy Value Scheduler megjegyzés kerül a régi értékkel, a fájlban szereplő értékkel és az eredményül kapott értékkel. Az ütemezett művelet által alkalmazott módosítások nem hoznak létre ilyen megjegyzést, a szokásos mezőkövetés pedig mindkét módban ki van kapcsolva: ellenőrzési nyomvonalként az import Old Value és Result oszlopait használja.

Előbeállítások

Az előbeállításokat az alkalmazás adminisztrátorai kezelik a Value Scheduler ‣ Developer ‣ Preset Editor menüpontban. Egy előbeállítást a következők határoznak meg:

  • Name és Menu Name: az utóbbi az előbeállítás menüpontjának felirata az Operations menüben;

  • Target Model és Target Field: a frissítendő modell és mező;

  • Domain Lookup Field: a célmodell azon mezőjének technikai neve, amely a fájl első oszlopával kerül összehasonlításra;

  • Code: opcionálisan Python-kód, amely a fájl sorait módosításokká alakítja, például a címkeneveket rekordokká alakítja, és jelzi az ismeretlen neveket. Kód nélkül a második oszlop változatlan formában kerül beírásra, ami szöveges és számmezőkhöz megfelelő.

Kattintson az Install gombra az előbeállítás menüpontjának létrehozásához az Operations menüben, illetve az Uninstall gombra annak eltávolításához. Az Imports intelligens gomb felsorolja az előbeállítással készült importokat.

Az alkalmazás egy előbeállítással érkezik: a Pricelist Tag Update a termékek Pricelist Tags mezőjét frissíti.

Fontos

  • A Pricelist Tag Update előbeállítás master_article_number értékkel érkezik a Domain Lookup Field mezőben. Ez a mező nem része a szabványos termékűrlapnak: az előbeállítás telepítése előtt cserélje le arra a mezőre, amely a fájlban azonosítja a termékeit, pl. default_code (belső hivatkozás) vagy barcode (vonalkód).

  • Az előbeállítás kódja a kiszolgálón fut. Az Administrator szintet csak megbízható adminisztrátorok kaphatják meg.

A Value Scheduler ‣ Developer ‣ All Scheduled Changes menüpont az összes import módosításait felsorolja, állapot szerinti szűrőkkel, valamint import, modell és ütemezett dátum szerinti csoportosítással.

screenshot: general-value-scheduler-preset
menu
Value Scheduler ‣ Developer ‣ Preset Editor ‣ Pricelist Tag Update
shows
The preset form with the Install button, the Configuration group (name, menu name, sequence), the Target group (Target Model "Product", Target Field "Pricelist Tags", Domain Lookup Field) and the Row Processing Code editor.
highlight
The "Domain Lookup Field" (red frame).
data
Domain Lookup Field set to "default_code".
module
value_scheduler
notes
English UI, light theme, 1440px width.

Lásd még