RPA-verktyg – Wiki

goto Gå till URL

• url – adressen att navigera till

wait Vänta (sekunder)

• seconds – fast paus

wait_for_load Vänta på sidladdning

Väntar på domcontentloaded. Inga fält.

go_back Gå tillbaka

Webbläsarens "bakåt" (historik). Inga fält. Praktiskt efter att ha klickat in på en post från en lista (t.ex. för att öppna en detaljvy), för att komma tillbaka till listan och fortsätta en loop.

wait_for_login Vänta på inloggning

• timeout – sekunder (default 180)

Pollar sidan tills någon text i config.LOGGED_IN_INDICATORS syns (eller ger upp). Fungerar för BankID, 2FA eller annan manuell inloggning – verktyget bryr sig bara om att en inloggad-indikator dyker upp, inte om hur du loggade in.

wait_for_selector Vänta på element

• by, value, role?, scope?, nth?
• timeout – sekunder (default 15)

click Klicka

• by, value, role?, scope?, nth?

type Skriv i textfält

• by, value, role?, scope?, nth?
• text – texten som skrivs (stödjer {variabel})

press_key Tryck tangent

• key – t.ex. Enter, Tab, Escape
• value tomt → tangenten trycks mot hela sidan. Annars by/value/role/scope/nth för att trycka på ett specifikt element.

select_option Välj i dropdown

• by, value, role?, scope?, nth?
• option – synlig text på alternativet

check Kryssa checkbox/radio

• by, value, role?, scope?, nth?
• checked – true (kryssa i, default) eller false (kryssa ur)

download Ladda ner

• by, value, role?, scope?, nth?

Klickar och sparar den nedladdade filen i data/downloads/. Misslyckad nedladdning loggas men avbryter inte flödet.

save_attachment Ladda ner bilaga

• by, value, role?, scope?, nth? – pekar ut länken (eller ett element som innehåller en <a>). I en loop över bilagerader: by=css, scope=item, value=a[href].
• filename? – filnamn i data/downloads/ (tomt = tas från filens URL; stödjer {variabel}). Krock döps om till namn (2).ext.
• var? – lägger den sparade sökvägen i en listvariabel (så flera bilagor samlas i en lista)
• timeout? – sekunder (default 15)

Hittar en <a> och: har den en riktig href (t.ex. PDF-bilagor) hämtas filen direkt via webbläsarens session (behåller inloggningen, ingen ny flik/skrivardialog). Är det en javascript:-länk (t.ex. bild­bilagor) klickas den i stället – öppnas då en popup med en nedladdningslänk följer steget den och hämtar filen därifrån (popupens URL, en fil-/nedladdningslänk i den, eller ett klick som startar nedladdningen). 0 bilagor → list ger antal 0 och loopen kör inga varv. Misslyckad hämtning loggas men avbryter inte flödet.

Olika hantering för PDF vs. bild: lägg ett if i loopen med villkoret element_exists, by=css, scope=item, value .ids-icon-file-pdf (eller a[href$=".pdf"]) för PDF-grenen och else för bild. Behövs oftast inte – ett enda save_attachment klarar båda – men gör det möjligt att t.ex. bara spara PDF:er, eller döpa dem olika.

list            value "etj-file-attachment-link", var "bilaga_element"
loop over "bilaga_element":
  save_attachment  by=css  scope=item  value="a[href]"  var="bilagor"
save_var        var "bilagor", filename "bilagor.json"
run_script      scripts/merge_and_print.py
                --files-from bilagor.json --out data/downloads/klar.pdf --print

capture_pdf Fånga PDF (skriv ut-knapp)

• by, value, role?, scope?, nth? – triggern att klicka (t.ex. "SKRIV UT"). Lämna value tomt för att fånga sidan som redan visas.
• filename? – filnamn i data/downloads/ (default utskrift.pdf, stödjer {variabel})
• var? – variabel att lägga den sparade sökvägen i (praktiskt för ett efterföljande run_script-steg)
• timeout? – sekunder att vänta på ett PDF-nätverkssvar (default 15)

För "Skriv ut"-knappar som öppnar webbläsarens skrivardialog i stället för att ladda ner en fil. Steget neutraliserar window.print, klickar ev. triggern och fångar PDF:en i tur och ordning via: (1) ett PDF-nätverkssvar, (2) en inbäddad PDF i sidan (embed/iframe/object/a med .pdf), (3) Chrome printToPDF av sidan som den ser ut (fungerar även i icke-headless läge). Misslyckad fångst loggas men avbryter inte flödet.

screenshot Ta skärmdump

• name? – filnamn utan .png (default screenshot)

Sparas i data/screenshots/.

set_var Sätt variabel

• var, text (stödjer {variabel})

increment Öka variabel

• var – variabeln att öka
• by? – steg (default 1, negativt värde minskar)

Saknad eller icke-numerisk variabel behandlas som 0. Lägg ett sådant steg sist i en loop så blir {var} 1, 2, 3 … och kan användas för att särskilja filnamn (capture_pdf filename stödjer {variabel}). Behöver du bara varvnumret räcker loopens inbyggda index_var (default {index}).

clear_var Nollställ variabel

• var – variabeln att ta bort

Nästa list_append / save_attachment / extract_row skapar den på nytt som tom lista. Lägg först i en loop för att nollställa en samlar-lista per varv (t.ex. bilagor per ärende).

extract_text Läs text till variabel

• by, value, role?, scope?, nth?, var

Läser ett elements text till en variabel (skalärt textvärde).

extract_row Extrahera rad (flera kolumner)

• var – listvariabel att lägga raden i
• scope? – normalt item (körs inuti en loop)
• fields – lista av {name, by, value, role?}, ett per kolumn

Läser flera namngivna fält (celler) från aktuell post i ett svep och lägger dem som en rad-post (dict) i listvariabeln – motsvarar Power Automates "Extract data from table". Ger strukturerade kolumner istället för en textklump, vilket gör att save_var skriver riktiga kolumnrubriker i CSV (fältnamnen) och att en enskild kolumn kan refereras senare med {item.Kolumnnamn} (se interpolering).

{
  "type": "extract_row",
  "var": "Tabell_lista",
  "scope": "item",
  "fields": [
    { "name": "Uppdaterat", "by": "css", "value": "td:nth-child(1)" },
    { "name": "Ärendetyp",  "by": "css", "value": "td:nth-child(2)" },
    { "name": "Status",     "by": "css", "value": "td:nth-child(6)" }
  ]
}

list_append Lägg till i lista

• var – listvariabel (skapas automatiskt)
• Antingen by/value/role/scope/nth (läser elementets text) eller text (literalt värde, stödjer {variabel}) om value lämnas tomt

Lägger till ett textvärde per anrop – jämför med extract_row som lägger till en hel namngiven rad i ett anrop.

save_var Spara variabel (JSON/CSV)

• var – variabeln att spara
• filename – i data/exports/, inga sökvägar tillåtna
• format? – json/csv, gissas från filändelsen om tomt
• mode? – overwrite (default) eller append

CSV: en lista av dicts (t.ex. från extract_row) ger riktiga kolumnrubriker från dict-nycklarna. En lista av vanliga textvärden (t.ex. från list_append med literalt värde) får en enda kolumn med rubriken value – det är inte en bugg, CSV kräver en kolumnrubrik och "value" är namnet på den enda kolumnen när posterna saknar egna fältnamn. Använd extract_row om du vill ha meningsfulla kolumnnamn istället.

load_var Läs in variabel (JSON/CSV)

• var, filename (samma regler som save_var)

CSV med en enda kolumn "value" läses tillbaka som en lista av textvärden; CSV med flera kolumner läses tillbaka som en lista av dicts (samma struktur som extract_row producerar) – round-trip fungerar alltså sömlöst i båda riktningarna.

run_script Kör Python-script

• path – relativ mot projektroten, eller absolut
• args? – mellanslagsseparerade argument
• timeout? – sekunder (default 60)
• var? – sparar scriptets stdout (JSON-tolkat om möjligt, annars text)

Loggar stdout/stderr rad för rad. Flödet stoppas om scriptet avslutar med en felkod.

list Lista poster

• value – CSS-selector som matchar flera element
• var – variabeln att spara resultatet i

Sparar {selector, count, preview} i variabeln – preview är textinnehållet i de tre första träffarna, bara för att kunna sanity-checka selectorn i variabelpanelen innan man bygger en hel loop kring den. Loop bryr sig bara om selector/count.

ocr_read OCR – läs text ur bild/PDF

• source – pdf (fil i data/downloads/), window (fönstertitel-regex), region (x/y/w/h skärmkoordinater) eller image (fil)
• var – variabeln att spara texten i
• pattern? – regex; namngiven grupp (?P<value>…) annars hela träffen
• near? / near_mode? – returnera värdet same_line (efter en etikett) eller below (raden under)
• lang? – OCR-språk, default sv-SE

Windows-only (winocr = Windows.Media.Ocr + pymupdf för PDF). Kräver att OCR-språket är installerat i Windows – annars ett fel med exakt DISM-kommandot. En PDF med textlager läses direkt utan OCR.

lookup Slå upp i tabell

• from_var – en variabel som håller en JSON-map (från Läs in variabel); punktnotation cfg.elvis.tabell går bra
• file – …eller en JSON-fil i data/exports/
• key – nyckel att slå upp, stödjer {variabel} (t.ex. {grupp}|{spec})
• var – resultatet (kan vara ett objekt → {var.fält} funkar sen)
• ci? – skiftlägesokänsligt (default på); on_missing? – error / empty / ett defaultvärde

merge_json Skriv nyckel till JSON-fil

• file – JSON-fil i data/exports/ (skapas om den saknas)
• key / value – data[key] = value, båda stödjer {variabel}

För kom-ihåg-tabeller: fråga användaren om ett värde med prompt och spara det här, så finns det nästa körning (läs tillbaka med Läs in variabel + lookup).

read_url Läs aktuell URL

• var – aktuell sidas URL
• pattern? – regex-utplock, t.ex. ett ärende-id ur adressen

prompt Fråga användaren (paus)

• mode – confirm (OK/Avbryt; Avbryt stoppar flödet), input (ett textfält → var), fields (visa de angivna variablerna redigerbara)
• message – text, stödjer {variabel}
• fields? – komma-separerade variabelnamn (för mode=fields)

Pausar körningen och visar en ruta på skärmen (egen process). fields är till för att låta användaren rätta OCR-fel innan värdena skrivs vidare.

stop Stoppa flödet

• message – felmeddelande, stödjer {variabel}

Avbryter körningen (t.ex. när ett ärende inte kan hanteras mekaniskt).

loop Loop (för varje post)

• over – variabelnamn att loopa över
• item_var? – variabelnamn för aktuellt värde vid loop över en lista (default item)
• index_var? – variabelnamn för varvräknaren 1, 2, 3 … (default index); sätts oavsett looptyp och kan användas som {index} i t.ex. filnamn

Utgångar: each (körs en gång per post, sätter item/index) och done (efter sista varvet). Kroppens sista nod måste ha en kant tillbaka till loop-nodens in – annars körs varv 0 en gång och done nås aldrig. Se Loop: DOM vs. lista för de två over-lägena.

if Om / annars om / annars

• branches – lista av {condition}, i ordning (första sanna vinner)

Utgångar: case0, case1, … (en per gren) samt else (ingen gren matchade). Koppla varje grens noder till respektive utgång. Matchar ingen gren och det saknas en else-kant tar den vägen slut. Se Villkor.

call_flow Anropa subflöde

• target – ett externt sparat flödesnamn, ELLER #<subflow-id> för en lokal subgraf i samma fil
• in – lista av {name, value}; name = subflödets indata, value stödjer {variabel}
• out – lista av {from, to}; kopierar subflödets slutvariabel from till anroparens variabel to

Kör ett annat flöde som ett steg (vanliga handtag in/out). Subflödet får en egen tom variabel-namnrymd som seedas ur in (och subflödets deklarerade inputs-default); bara det du listar i out följer med tillbaka. Samma webbläsare/ flik och inställningar som anroparen. Cirkulära anrop (A→B→A) och för djup kedja avbryts med FlowError. Se Subflöden & flikar.

Universella fält (alla noder)

• enabled – false hoppar över noden (kryssruta i UI:t); körningen fortsätter via out.
• label – valfritt namn på noden (visas i körloggen).
• on_error – "stop" (default) avbryter körningen om noden misslyckas/får timeout; "continue" loggar felet och går vidare. Väljs i listan bredvid etikettfältet.

jump_to_label finns inte längre – rita en kant i stället.