Scriptmappen en scripts creëren en bewerken

In een Vectorworksdocument kunt u scripts creëren, bewaren en uitvoeren. Scripts moeten altijd in een scriptmap zijn ondergebracht. Gebruik het Hulpbronnenbeheer om uw scriptmappen en uw individuele scripts te beheren.

Scripts creëren

1. Klik in het Hulpbronnenbeheer op de knop Nieuwe hulpbron, selecteer Script en klik op Creëer. Of: selecteer in de filter van het Hulpbronnenbeheer ‘Scripts’ als type hulpbron en klik op de knop Nieuw Script.

2. Scripts moeten altijd in een scriptmap zijn ondergebracht. Volg een van onderstaande werkwijzen:

● Als er meerdere scriptmappen bestaan die nog niet geopend zijn, verschijnt het dialoogvenster ‘Selecteer scriptmap’. Selecteer de map waarin u het script wenst toe te voegen en klik op OK.

● Als er nog geen scriptmap in het document bestaat, dient u een scriptmap te creëren om het script in te bewaren.

3. Het dialoogvenster ‘Naam’ wordt geopend. Geef de naam op voor het script.

4. Het dialoogvenster ‘Bewerk script’ wordt geopend. Dit bewerkvenster (scripteditor) biedt een eenvoudige werkomgeving voor scriptontwikkeling en -onderhoud. U kunt er scripts creëren, bewerken en compileren, de beschikbare functies doorbladeren, fouten bekijken en andere taken uitvoeren. Selecteer de scripttaal voor het script: Python Script of VectorScript. Scripts zijn beperkt tot 32.001 tekens. Meer informatie (in het Engels) over Python en VectorScript vindt u onder developer.vectorworks.net.

Veld	Omschrijving
Editormenu
Procedures	Opent een dialoogvenster met een lijst van alle beschikbare functies per categorie en toont een prototype van de functie alsook een korte omschrijving van wat de functie doet. De lijst dient zowel ter referentie als om de code van de desbetreffende procedure in de editor te plakken. Selecteer de procedure of de functie en klik op OK om het toe te voegen aan de actuele lijn van de scripteditor.
Stel criteria in	Bepaal automatische selectiecriteria voor een script (zie Scripts voor selectie op maat creëren).
Kenmerken op maat	Bewaar de huidige kenmerken in het script (zie Scripts voor Kenmerken op maat creëren).
Parameters	Geeft toegang tot de parameters van parametrische objecten zodat u deze kunt wijzigen wanneer u werkt in het script van een insteekmodule (zie Definitie insteekmodule).
Importeer tekstbestand	Importeer de broncode van een script uit een extern tekstbestand.
Compileer script	Klik op deze knop om het script rechtstreeks in de scripteditor te compileren zonder het script uit te voeren. Als er fouten zijn in het script waardoor u niet kunt compileren, zullen deze worden weergegeven en kunt u deze fouten oplossen zonder dat u de scripteditor hoeft af te sluiten. Wanneer u VectorScripts compileert, worden alle fouten in de scriptcode vermeld. Wanneer u Python scripts compileert, worden alleen de syntaxisfouten vermeld. Een ongedefinieerde variabele bijvoorbeeld wordt niet gerapporteerd als een fout voor Python scripts, omdat dit soort fouten alleen wordt vastgesteld tijdens uitvoering van het script. Bijgevolg worden bij Python scripts de meeste fouten gerapporteerd bij uitvoering.
Taal	Selecteer Python script of VectorScript als scripttaal.
Script instellingen (alleen voor Python scripts)	In het dialoogvenster ‘Script - instellingen’ vindt u een lijst van omgevingspaden (mappen) waar geïmporteerde modules te vinden zijn voor Python scripts die externe bibliotheken nodig hebben. U kunt dit dialoogvenster ook openen via het menu Extra > Insteekmodules > Script instellingen. ● Voeg toe: Selecteer een maplocatie om het aan de lijst toe te voegen. ● Verwijder: Verwijder de geselecteerde map. ● Open map in OS: Klik op deze knop om de geselecteerde werkgroep- of projectmap te openen.

Vanuit het Hulpbronnenbeheer kunt u scripts bewerken, hernoemen, verwijderen, exporteren, importeren, verplaatsen en uitvoeren.

Scripts bewerken

1. Of: klik rechts in het Hulpbronnenbeheer met de rechtermuisknop op een hulpbron en selecteer het commando Bewerk in het contextmenu. Scripts zitten altijd in een scriptmap.

Scripts coderen

Een script kan worden gecodeerd en vergrendeld om te voorkomen dat het wordt bewerkt.

4. Geef het script een Bestandsnaam en selecteer een locatie om het bestand te bewaren.

Commando	Locatie
Codeer script	Extra > Insteekmodules