20. peatükk · 20.1
Rea automaatne teisaldamine arhiivilehele, kui olek on „Klaar”
Tellimuste, ülesannete või arvete loend kasvab iga nädalaga. Valmis asju ei taha sa ära visata, aga ka mitte enam pooleliolevate tööde vahel näha. Excelis tegid paljud seda VBA-makro või Google Sheetsi skriptiga: kõik olekuga „valmis” read lähevad arhiivilehele. Euro-Office'is teed sama JavaScripti makroga. Üks klõps ja loend on taas ülevaatlik.
Näitena kasutame WebOké kliendi Bloemisterij Het Zonnetje tellimuste loendit. Töölehel Orders on veergudes A kuni E tellimuse number, klient, tellimus, summa ja olek. Teisel töölehel Archief on samad veerupealkirjad. Näidisfail on hollandi keeles: olek Klaar tähendab „valmis” ja Archief „arhiivi”. Oma failis võid kasutada oma nimesid, vaata allpool jaotist oma loendi kohta.

Kõigepealt: aken Macros
Makrod on sinu WebOké Nextcloudis sisse lülitatud, midagi pole vaja lubada. Leiad need arvutustabelis ja tekstidokumendis vahekaardil View (vaade) nupu Macros (makrod) alt. Aknas on vasakul kaks loendit, Macros ja Custom functions (kohandatud funktsioonid, vt Exceli valemid LET või LAMBDA abil: mida Euro-Office'is selle asemel teha), ja paremal kood. Koodi kohal on nupud Run (käivita, kolmnurk), Debug, Copy, Rename, Delete ja märkeruut Autostart.
Makro kuulub failile, milles selle lood. See salvestatakse xlsx-faili ja liigub kaasa, kui faili kopeerid või jagad.
1. samm: tööleht Archief
- Klõpsa all plussmärki, et lisada uus tööleht, ja nimeta see täpselt Archief (paremklõps vahekaardil, Rename).
- Kopeeri lehe Orders päiserida lehe Archief 1. reale. Makro hakkab täitma alates 2. reast.
2. samm: makro loomine
- Mine tagasi töölehele Orders. See on oluline: makro töötab parajasti avatud töölehel.
- Klõpsa vahekaardil View nuppu Macros.
- Klõpsa Macros kõrval plussmärki (1). Ilmub tühi makro mõne koodireaga.
- Klõpsa Rename ja nimeta makro Naar archief (2).
- Kustuta paremal olev kood ja kleebi selle asemele see kood:
(function () {
// Olekuga Klaar read teisaldatakse töölehele Archief.
const bron = Api.GetActiveSheet();
const doel = Api.GetSheet("Archief");
if (!doel) { return; }
// Otsi lehel Archief esimene tühi rida (veerg A).
let doelRij = 2;
while (doel.GetRange("A" + doelRij).GetValue() !== "") { doelRij++; }
// 1. Ülevalt alla: kopeeri lõpetatud read õiges järjekorras.
const laatste = bron.GetUsedRange().GetRowsCount();
const weg = [];
for (let r = 2; r <= laatste; r++) {
const status = String(bron.GetRange("E" + r).GetValue()).trim().toLowerCase();
if (status === "klaar") {
bron.GetRange("A" + r + ":E" + r).Copy(doel.GetRange("A" + doelRij));
doelRij++;
weg.push(r);
}
}
// 2. Kustuta alt üles, et reanumbrid jääksid õigeks.
for (let i = weg.length - 1; i >= 0; i--) {
bron.GetRows(weg[i]).Delete("up");
}
})();

3. samm: käivitamine ja salvestamine
- Klõpsa Run, see on kolmnurk (3). Makro teeb oma töö kohe ära, aken jääb avatuks.
- Klõpsa Save. Nii salvestad makro faili. Kui klõpsad Cancel, kaob makro, aga see, mida see juba tegi, jääb alles.


Kuidas kood töötab
- Api.GetActiveSheet() on avatud tööleht, Api.GetSheet("Archief") on arhiiv. Kui sellist töölehte pole, lõpetab makro midagi tegemata.
- Rida while otsib lehel Archief esimese tühja rea. Nii saad makrot igal nädalal uuesti käivitada: uued lõpetatud tellimused lisanduvad vanade alla.
- GetUsedRange().GetRowsCount() loeb kokku, mitu rida on täidetud.
- Iga rea olek loetakse läbi. trim() eemaldab tühikud ja toLowerCase() teeb kõik tähed väikseks. Seetõttu lähevad arvesse ka „klaar” ja „Klaar ” tühikuga, nagu meie näites tellimuste B-106 ja B-108 puhul.
- Copy kopeerib rea koos vorminguga, näiteks summa eurovorminguga.
- Read kustutatakse alles lõpus, alt üles. Kui kustutad kõigepealt 2. rea, nihkub kõik ühe koha võrra üles ja üks rida jääb vahele.
Kohanda oma loendi järgi
- Muu olekuveerg: asenda "E" osas GetRange("E" + r) oma veeru tähega.
- Rohkem veerge: kui sinu loend ulatub veeruni H, asenda ":E" väärtusega ":H".
- Muu sõna: asenda "klaar" näiteks sõnaga "valmis" või "makstud", alati väiketähtedega.
- Muu arhiiv: asenda "Archief" oma töölehe nimega, täpselt nii, nagu see vahekaardil kirjas on, näiteks "Arhiiv".
Nõuanne: lisa töölehele nupp, mis selle makro käivitab, siis ei pea su kolleegid akent Macros kunagi avama. Vt Nupp arvutustabelis, mis käivitab makro.
Lõksud
- Testi kõigepealt koopial. Makro teeb korraga väga palju. Meie testis ei võtnud Undo (võta tagasi) makro tööd tagasi, isegi mitte pärast kahte klõpsu. Tee enne faili koopia või kasuta tagasiminekuks versiooniajalugu (vt Versiooniajalugu: varasema versiooni taastamine).
- Vale tööleht avatud? Kui käivitad makro ajal, mil avatud on Archief, otsib see olekut Klaar arhiivist. Siis ei juhtu midagi või juhtub midagi kummalist. Mine alati kõigepealt lehele Orders.
- Tabel ei alga 1. realt? GetRowsCount loeb alates esimesest täidetud reast. Kui tabeli kohal on pealkiri ja tühi rida, liida need read muutujale laatste juurde.
- Reas on valemid? Copy võtab valemid kaasa. Kui valem viitab lehe Orders mõnele teisele reale, ei pruugi see arhiivis enam õige olla.
- Failis töötab mitu inimest korraga? Lase makrot käivitada ainult ühel inimesel. Vt ka Makrode turvaline kasutamine: makrosätted, Autostart kolleegide juures ja taaskasutus.
Mida teha ei saa
- Automaatne teisaldamine kohe, kui keegi valib Klaar: põhimõtteliselt saab seda teha makroga, mis jälgib muudatusi (vt Kuupäev ja kellaaeg automaatselt lahtrisse, kui keegi lahtrit muudab), aga rea eemaldamine ajal, mil keegi veel kirjutab, on segav ja vigaderohke. Nupp on töökindlam.
- Teisaldamine teise faili: makro saab töötada ainult oma failis. Kui soovid iga aasta arhiivi eraldi faili, kopeeri tööleht Archief aasta lõpus käsitsi.
- Salvestamine programmeerimise asemel: Record macro (salvesta makro) ei salvesta kopeerimist ja kleepimist. Selle makro pead seega tõesti koodina kleepima. Makrode salvestamisest lähemalt: VBA-makro ise JavaScripti teisendamine: tõlketabel.
