Elements reference

Element editor: alle velden en filebeheer

Deze pagina beschrijft de volledige element-editor: basisvelden, dependencies, code/files, import/export en validatieregels.

Editorvelden File manager Codecontract Best practices

1. Editorvelden

Element editor met basisvelden, files en code editor.

Belangrijk

Element ID is alleen bij create bewerkbaar.
Entrypoint default is run.
Python version default is 3.12.
Requirements worden tijdens publish gebouwd.

Veld	Type	Required	Beschrijving
`id`	string	Yes	Unieke element-ID, bv. `el_orders_api`.
`name`	string	Yes	Leesbare naam.
`kind`	data/agent_node/agent_action	Yes	Elementtype voor data of agent flows.
`entrypoint`	string	No	Functienaam die runtime aanroept.
`description`	string	No	Functionele toelichting.
`requirements`	multiline text	No	Python dependencies per regel.
`pythonVersion`	string	No	Runtime python versie.

2. File manager en opslagregels

Actie	Beschrijving
New	Nieuw pad toevoegen met lege inhoud.
File	Een of meerdere bestanden uploaden.
ZIP	Complete zip importeren (mapstructuur behouden).
Export	Draftbestanden als zip exporteren.
Download	Geselecteerd bestand downloaden.
Remove	Bestand verwijderen (niet voor `main.py`).

Bestandsvalidatie

main.py en requirements.txt zijn gereserveerd.
Paden met .. of onveilige prefixen worden geweigerd.
Tekstbestanden kunnen inline bewerkt worden; binaire files niet.
Grote files worden extern opgeslagen en kunnen read-only in editor verschijnen.

3. Codecontract

Ondersteunde signatures

run(params)
run(context, params)

Bij twee argumenten bevat context minimaal tenant, element en versie-informatie.

Runtime helpers

getVar(name, default)
setVar(name, value)
getSecret(name, default)

def run(context, params):
    tenant = context.get("tenantId")
    country = params.get("country", "NL")
    return [{"tenant": tenant, "country": country}]

4. Best practices

Houd main.py klein en verplaats logica naar extra modules.
Pin dependency versions in requirements voor reproduceerbare publish builds.
Gebruik runtime vars/secrets voor credentials i.p.v. hardcoded waarden.
Test altijd execute na wijzigingen en controleer logs.