Excel priedas ir Power Query

TS 2.12. MacroLens turi sąsają su Microsoft Excel programa, veikiančia Windows 11 operacinėje sistemoje. Yra du būdai gauti duomenis į Excel:

Be to, bet kurią lentelę galite tiesiog atsisiųsti XLSX formatu.

Visą diegimo rinkinį (priedo manifesto failą, Power Query šablonus ir nuorodas) rasite MacroLens puslapyje Excel.

1 žingsnis. Prisijungimas

Priedas: MacroLens srityje spustelėkite Prisijungti su MacroLens paskyra. Atsivers MacroLens prisijungimo langas – įveskite el. pašto adresą, slaptažodį ir dviejų veiksnių (MFA) kodą taip pat, kaip žiniatinklio programoje. Paspaudus Susieti langas užsidarys, o srityje bus rodomas jūsų vardas. Tada priedas gauna asmeninį prieigos raktą tik šiam Excel diegimui (galioja 90 dienų ir pratęsiamas, kol naudojamas); jis saugomas šiame kompiuteryje, niekada – darbaknygėje. Srityje paspaudus Atsijungti raktas iškart atšaukiamas.

Power Query (ir priedo alternatyva Prisijungti asmeniniu prieigos raktu, pvz., kai prisijungimo langas neatsiveria) naudoja asmeninį prieigos raktą, kurį susikuriate patys:

1. MacroLens puslapyje Excel (arba Mano paskyra → API prieigos raktai) sukurkite naują raktą (pvz., pavadinimu „Excel – darbo kompiuteris“) ir pasirinkite jo galiojimo laiką.
2. Raktas parodomas tik vieną kartą – nukopijuokite jį ir įklijuokite į Power Query (arba priedą). Neišsaugokite rakto bendrai prieinamose vietose ir neperduokite kitiems.
3. Raktą bet kada galite atšaukti puslapyje Mano paskyra → API prieigos raktai (pvz., pakeitę kompiuterį). Atšauktas ar nebegaliojantis raktas nebeveikia – tuomet sukurkite naują.

Raktas suteikia tokią pačią prieigą kaip jūsų paskyra, todėl saugokite jį kaip slaptažodį.

2 žingsnis. Priedo naudojimas

Kai priedas įdiegtas, Excel skirtuke Pagrindinis (Home) atsiras mygtukas MacroLens (jei jo nėra – Pagrindinis → Papildiniai (Add-ins) ir pasirinkite MacroLens).

1. Prisijungimas. Spustelėkite Prisijungti su MacroLens paskyra ir prisijunkite MacroLens lange (el. paštas, slaptažodis ir dviejų veiksnių kodas – žr. 1 žingsnį). Prisijungimas įsimenamas šiame kompiuteryje, kol atsijungsite ar raktas bus atšauktas.
2. Paieška. Įveskite raktinius žodžius ar frazę ir, jei reikia, pasirinkite filtrus (šaltinis, regionas, dažnis, sritis). Sintaksė tokia pati kaip MacroLens paieškoje. Rezultatuose matysite pavadinimą, šaltinį, dažnį, vienetą, laikotarpį ir paskutinio atnaujinimo datą.
3. Įkėlimas. Pažymėkite reikiamas eilutes, pasirinkite laikotarpį ir kitus parametrus, pažymėkite darbaknygės langelį ir įkelkite. Reikšmės įrašomos kaip skaičiai kartu su eilučių metaduomenimis (pavadinimu, raktu, vienetu, šaltiniu). Jei pasirinktų laiko eilučių dažniai skiriasi (pvz., mėnesinis, ketvirtinis ir metinis), o dažnis paliktas Pradinis dažnis, priedas paklausia, kaip jas įkelti: atskira lentelė kiekvienam dažniui (lentelės greta viena kitos; numatytasis pasirinkimas) arba visos laiko eilutės perskaičiuojamos į mažiausią dažnį – skirtingo dažnio eilutės vienoje lentelėje niekada nesumaišomos. Dieninėms laiko eilutėms įrašomos tik dienos su stebiniais (be tuščių savaitgalio eilučių), o Paskutiniai N laikotarpių skaičiuoja šias dienas.
4. Atnaujinimas. Priedas įsimena, kurie duomenys įkelti iš MacroLens. Atnaujinkite pasirinktą bloką arba visus darbaknygės blokus – bus įrašytos naujausios reikšmės, įskaitant naujus laikotarpius ir patikslinimus.

Darbaknygė lieka įprastu .xlsx failu be makrokomandų. Kolegos be priedo matys paskutines įrašytas reikšmes.

Power Query

Power Query leidžia sukurti atnaujinamą duomenų užklausą be jokio diegimo:

1. MacroLens puslapyje Excel atsisiųskite paruoštą atnaujinamą darbaknygę arba nukopijuokite duomenų nuorodą.
2. Jei kuriate užklausą patys: Excel pasirinkite Duomenys → Gauti duomenis → Iš kitų šaltinių → Iš žiniatinklio (Data → Get Data → From Other Sources → From Web) ir įklijuokite nuorodą.
3. Kai Excel paprašys prisijungimo duomenų, pasirinkite Pagrindinis (Basic) autentifikavimą (ne Anoniminis, Windows ar Organizacijos paskyra): vartotojo vardas – jūsų MacroLens el. pašto adresas, slaptažodis – asmeninis prieigos raktas (žr. 1 žingsnį); lygį nustatykite MacroLens adresui https://macrolens.sixtyfour.ee. Power Query negali parodyti dviejų veiksnių prisijungimo lango, todėl jam naudojamas raktas.
4. Duomenis atnaujinsite Duomenys → Atnaujinti viską (Data → Refresh All). Užklausos ypatybėse galite nustatyti automatinį atnaujinimą atveriant failą.

Prisijungimo duomenys saugomi jūsų kompiuterio Power Query nustatymuose, ne pačiame faile, todėl failą galima siųsti kolegoms – kiekvienas prisijungs savo raktu. Prisijungimo duomenis pakeisite: Duomenys → Gauti duomenis → Duomenų šaltinio parametrai (Data Source Settings).

Duomenų šaltinių licencijos reikalauja, kad su kiekviena duomenų kopija būtų pateikta nuoroda į šaltinį. JSON duomenų sraute ji pateikiama kiekvienai laiko eilutei (series[].attribution), atnaujinamoje darbaknygėje – atskirame lape „Šaltiniai“. CSV variante (data.csv) ji yra paskutiniame stulpelyje „Šaltinis ir licencija“ – po vieną nuorodą eilutėje, nuo pirmos duomenų eilutės (ECB pranešimas, kad duomenis nemokamai galima gauti ECB svetainėje, Eurostato citata, perskaičiuotiems duomenims – „Apskaičiuota MacroLens pagal…“ ir kt.). Tai įprastas teksto stulpelis, todėl reikšmių stulpeliai ir lentelės eilutės lieka švarūs; skelbdami ar perduodami duomenis šias nuorodas palikite.

Informacija IT administratoriams

Reikalavimai:

• Microsoft Excel Windows 11 kompiuteryje: Microsoft 365 programos (bet kuris palaikomas kanalas) arba Office LTSC 2024 / 2021. Jei jūsų organizacijoje naudojama kita versija, suderinamumą patikrinsime kartu su jumis.
• Tinklas: HTTPS (443 prievadas) prieiga prie macrolens.sixtyfour.ee ir prie „Microsoft“ Office.js bibliotekos adreso appsforoffice.microsoft.com.
• Priedas yra „Office“ žiniatinklio priedas (Office Add-in): kompiuteriuose nediegiamas jokis vykdomasis kodas, nereikia kodo pasirašymo sertifikatų, o priedo atnaujinimai pasiekia naudotojus automatiškai.

Diegimo būdai (priedo manifesto failą atsisiųskite iš puslapio Excel):

1. Rekomenduojama – centralizuotas diegimas: Microsoft 365 administravimo centras → Settings → Integrated apps → Upload custom apps → pasirinkite „Office Add-in“ ir įkelkite manifesto failą → priskirkite naudotojams ar grupei → Deploy. Priedas naudotojams pasirodo per kelias valandas (iki 24 val.); naudotojai turi iš naujo paleisti Excel.
2. SharePoint programų katalogas – įkelkite manifestą į organizacijos „Apps for Office“ katalogą; naudotojai priedą pridės per Pagrindinis → Papildiniai → Mano organizacija.
3. Bendras tinklo aplankas (patikimas katalogas) – manifestas patalpinamas tinklo aplanke, kuris per grupės strategiją nurodomas kaip patikimas priedų katalogas.
4. Excel žiniatinklyje – bandymams: Pagrindinis → Papildiniai → Daugiau parametrų → Nusiųsti mano papildinį ir pasirinkite manifesto failą.

Metaduomenų lapas: įkeltus blokus priedas aprašo lape MacroLens_info, kuris yra visiškai paslėptas. Tūrinio licencijavimo Office 2016 ir 2019 leidimuose (paprastasis režimas, ExcelApi 1.1) Excel neleidžia priedams slėpti lapų, todėl ten šis lapas lieka matomas – jo nekeiskite, priedui jo reikia blokams atnaujinti.

Pašalinimas: centralizuoto diegimo atveju – „Integrated apps“ sąraše pašalinkite MacroLens diegimą. Naudotojų prieigos raktai atšaukiami MacroLens paskyroje (Mano paskyra → API prieigos raktai); priede paspaudus Atsijungti atšaukiamas priedo raktas.

Dažniausios problemos

Jei problema neišsisprendžia, praneškite pagalbos tarnybai – nurodykite Excel versiją (Failas → Paskyra → Apie Excel).