Handleiding Script Editor
Inleiding
De Script Editor is een geïntegreerde code-editor waarmee je export scripts kunt bewerken in ReflexBlue. De editor biedt geavanceerde functies zoals syntaxiscontrole, wijzigingen vergelijken en real-time validatie. Scripts worden geschreven in de programmeertaal C#.
De editor openen
Je opent de Script Editor met de volgende stappen:
- Open het Import/Export definities overzichtscherm.
- Selecteer en open een export definitie.
- Selecteer vervolgens Openen in script editor.
Schermindeling
Toolbar (bovenbalk)
Bovenaan de editor vind je drie knoppen:
- Save - slaat je wijzigingen op.
- View Changes - toont een vergelijking tussen het originele sjabloon en je wijzigingen.
- History - toont voorgaande revisies van het script en laat je vergelijkingen maken tussen de wijzigingen in de revisisies.
Editor venster
Het hoofdgedeelte van het scherm is de code-editor waar je je sjabloon kunt bewerken. De editor ondersteunt:
- Syntaxiskleuring
- Automatische inspringing
- Code-aanvulling (IntelliSense)
- Zoeken en vervangen (Ctrl+F / Ctrl+H)
- Hernoemen (F2)
- Definitie bekijken (F12)
Statusbalk (onderbalk)
De blauwe balk onderaan toont belangrijke informatie:
Links:
- Ln X, Col Y - huidige cursorpositie (regel en kolom)
- Selectie - selectie-informatie (verschijnt bij geselecteerde tekst)
- X lines - totaal aantal regels in het sjabloon
- Statusbericht - algemene statusmeldingen
- Validatiestatus - resultaat van de laatste validatiecontrole
Rechts:
- UTF-8 - tekstcodering
- CRLF - regeleindeteken (Windows-formaat)
Validatie sectie (onderkant)
Wanneer er validatiefouten zijn, verschijnt er een rode sectie onderaan met gedetailleerde foutmeldingen. Deze sectie is scrollbaar bij meerdere fouten.
Werken met de editor
Script bewerken
- Klik in de editor en begin met typen.
- Gebruik Tab voor inspringing en Shift+Tab om terug te springen.
- De editor valideert automatisch je code tijdens het typen.
- Eventuele fouten worden direct onderaan weergegeven.
Definities bekijken
Wanneer je met de muis over een functie of variabele zweeft, verschijnt er een popup met de definitie en eventuele documentatie.
Om de popup te sluiten:
- Klik ergens anders in de editor.
- Druk op Escape.
Volledige definitie bekijken
Met de knop F12 kun je in het geval van export classes of enums de volledige definitie in een popup bekijken. Dit kan helpen bij het begrijpen van de object structuur.
Om de popup te sluiten:
- Sluit de popup door Close te selecteren.
- Druk op Escape.
Wijzigingen opslaan
- Maak je wijzigingen in de editor.
- De Save knop wordt actief zodra er wijzigingen zijn.
- Selecteer Save om op te slaan.
- Een statusbericht bevestigt het opslaan.
Wijzigingen vergelijken
Om te zien wat je precies hebt gewijzigd voordat je opslaat:
- Selecteer View Changes.
- Er opent een vergelijkingsvenster met twee panelen:
- Links: originele versie
- Rechts: je gewijzigde versie
- Verschillen worden gemarkeerd
- Selecteer Close rechtsboven om terug te keren naar de editor.
Versiegeschiedenis bekijken
Met de knop History in de werkbalk kun je eerdere versies van een script terugvinden en vergelijken met de huidige versie.
Stap 1 — Geschiedenis openen
Selecteer History in de werkbalk bovenaan de editor.
Er verschijnt een paneel aan de rechterkant met een overzicht van alle opgeslagen versies van dit script.
Stap 2 — Het overzicht lezen
Elke regel in de lijst is één opgeslagen versie en toont:
- Revisienummer — bijvoorbeeld Revision 1, Revision 2, etc.
- Datum en tijd — wanneer deze versie is opgeslagen.
- Opgeslagen door — de naam van de gebruiker die de wijziging heeft opgeslagen.
Stap 3 — Een versie vergelijken met de huidige versie
Wil je zien wat er veranderd is ten opzichte van een eerdere versie?
- Selecteer de tekst van een versieregel (niet het vakje links ervan).
- Het historypaneel sluit automatisch.
- Er opent een vergelijkingsscherm met:
- Links: de oude versie
- Rechts: de huidige versie
- Wijzigingen zijn gemarkeerd
Stap 4 — Twee oude versies met elkaar vergelijken
Wil je twee eerdere versies onderling vergelijken?
- Zet een vinkje voor de eerste versie.
- Zet een vinkje voor de tweede versie. De knop Compare wordt actief.
- Selecteer Compare.
- Het vergelijkingsscherm toont de oudste versie links en de nieuwste rechts.
Je kunt maximaal 2 versies tegelijk aanvinken.
Paneel sluiten
Het historypaneel sluit je door:
- Close rechtsboven in het paneel te selecteren.
- Te drukken op de Escape-toets op je toetsenbord.
- Een versieregel te selecteren (het paneel sluit dan automatisch en de vergelijking opent).
Handige sneltoetsen
Navigatie
| Toetsencombinatie | Functie |
|---|---|
| Ctrl+F | Zoeken |
| Ctrl+H | Zoeken en vervangen |
| Ctrl+G | Ga naar regel |
| Ctrl+Home | Ga naar begin document |
| Ctrl+End | Ga naar einde document |
Bewerken
| Toetsencombinatie | Functie |
|---|---|
| Ctrl+Z | Ongedaan maken |
| Ctrl+Y | Opnieuw uitvoeren |
| Ctrl+X | Knippen |
| Ctrl+C | Kopiëren |
| Ctrl+V | Plakken |
| Ctrl+A | Alles selecteren |
| Tab | Inspringing toevoegen |
| Shift+Tab | Inspringing verwijderen |
Editor
| Toetsencombinatie | Functie |
|---|---|
| Ctrl+S | Opslaan (indien wijzigingen aanwezig) |
| F1 | Command Palette (geavanceerde commando’s) |
| Ctrl+Space | Code-aanvulling tonen |
| F2 | Symbool hernoemen |
| F12 | Definitie bekijken |
Validatiefouten oplossen
Wanneer er validatiefouten zijn:
- Lees de foutmelding in de rode sectie onderin.
- De foutmelding bevat vaak een regelnummer.
- Navigeer naar die regel in de editor.
- Corrigeer de fout.
- De validatie wordt automatisch opnieuw uitgevoerd.
- De rode sectie verdwijnt wanneer alle fouten zijn opgelost.
Tips
- Regelmatig opslaan: sla je werk regelmatig op om gegevensverlies te voorkomen.
- Gebruik View Changes: controleer altijd je wijzigingen voordat je opslaat.
- Let op de validatie: los alle validatiefouten op voordat je opslaat.
- Statusbalk: houd de statusbalk in de gaten voor belangrijke meldingen.
- Definitie popup: gebruik de hover-functie om meer te weten te komen over functies en variabelen.
Veelgestelde vragen
Kan je wijzigingen ongedaan maken?
Ja, gebruik Ctrl+Z om wijzigingen ongedaan te maken. De editor onthoudt je bewerkingsgeschiedenis.
Worden je wijzigingen automatisch opgeslagen?
Nee, je moet expliciet Save selecteren om wijzigingen op te slaan.
Wat gebeurt er als je de pagina per ongeluk sluit?
Niet-opgeslagen wijzigingen gaan verloren. Zorg ervoor dat je regelmatig opslaat.
Waarom kan je niet opslaan?
De Save knop is alleen actief wanneer er wijzigingen zijn aangebracht. Als de knop grijs is, zijn er geen wijzigingen om op te slaan.