Archi scripting: verschil tussen versies

Geen bewerkingssamenvatting
Geen bewerkingssamenvatting
 
(12 tussenliggende versies door dezelfde gebruiker niet weergegeven)
Regel 1: Regel 1:
{{Cocreatie
{{Publicatie
|Cocreatiepublicatie=Cocreatie
|Paginastatus=publiceren
|GEMMAOnlinebeheerder=Beheerder Architectuurtools
|Redactiestatus=Actueel
|Wikibeheerder=Beheerder Architectuurtools
}}
}}
[[Werken met VNGR architectuurmodellen|Overzichtpagina werken met VNGR architectuurmodellen]]
[[Category:Modelleren handleidingen]]
Met de jArchi-plugin is het mogelijk om met een script een architectuurmodel te lezen en te bewerken. Hiermee kun je Archi uitbreiden met je eigen functies. Zie [https://www.archimatetool.com/plugins/#jArchi jArchi – Scripting for Archi] voor verdere informatie


Op deze pagina vind je verwijzigen naar scripts die nuttig kunnen zijn bij het onderhouden van een architectuurmodel en het maken van views.  
Op deze pagina vind je verwijzigen naar scripts die nuttig kunnen zijn bij het onderhouden van een architectuurmodel en het maken van views.  
* extra features beschikbaar in open source scripts
* enkele specifieke scripts voor het beheer van het GEMMA architectuurmodel


Zowel door VNGR onderhouden scripts als publiek gedeelde scripts worden genoemd
== Installeren plugin jArchi ===
De scripting plug-in is alleen beschikbaar voor Archi donateurs. VNG Realisatie is Archi donateur.
 
GEMMA- en projectarchitecten kunnen de jArchi plugin downloaden vanuit het Team [https://vvng.sharepoint.com/:f:/r/sites/UnitArchitectuurenStandaarden/Gedeelde%20documenten/Tooling/Archi/Archi%20(actuele%20versie)?csf=1&web=1&e=SnuYfM Architectuurtooling, folder Archi (actuele versie)]
 
Configuratie voor scripting
* Ga naar [https://github.com/archimatetool/archi-scripting-plugin/wiki/jArchi-Quick-Start jArchi Quick Start]
* Edit > Preferences > Scripting (zie je geen tab scripting, dan moet je de plug-in jArchi eerst installeren)
** accepteer de default directory of configureer in Archi je <script directory>
*** advies, kies een directory met backup (bijvoorbeeld een dropbox directory)
** voorkeur editor, bijvoorbeeld Atom of Visual Studio Code (tip: zet script language op javascript)
** zet JavaScript Engine op GraalVM (default)


== Waar vind je scripts ==
== Waar vind je scripts ==
Regel 13: Regel 28:
De jArchi plug-in bevat enkele voorbeeld scripts. Maar er zijn nog veel meer scripts te vinden
De jArchi plug-in bevat enkele voorbeeld scripts. Maar er zijn nog veel meer scripts te vinden


<ul>
* Ga naar [https://github.com/archimatetool/archi-scripting-plugin/wiki/Community-shared-scripts Community shared scripts]
<li><p>Zie [[https://gist.github.com/search?utf8=✓&q=%23jarchi+extension%3Aajs&ref=searchresults|jArchi gist]] voor open source scripts die door de Archi community zijn gemaakt</p></li>
* Ook in het [https://forum.archimatetool.com/index.php?board=5.0 jArchi Forum] worden scripts gedeeld
<li><p>en ook [https://github.com/nasjonal-arkitektur/kode-archiscripts kode-archiscripts]. Deze repository bevat een heel raamwerk aan beheerfuncties, waaronder scripts voor </p>
* [https://www.tamebluelion.co.uk/archimate-documentation Documenting architecture models using ArchiMate] - Definieer in een view de structuur van de documentatie en genereer de documentatie in Markdown vervolgens met dit script.
<ul>
* ...
<li><p>wijzigen van objecttype</p></li>
<li><p>samenvoegen van 2 objecten tot één</p></li>
<li><p>en meer</p></li></ul>
</li>
<li><p>In het Archi forum is het script [https://forum.archimatetool.com/index.php?topic=639.0 jArchi - generate views using graphlib] gedeeld. Dit script is gemaakt door Hervé.</p>
<p>Erg handig voor het genereren van view met veel elementen. Een hiërarchie kan bijvoorbeeld embedded of als tree worden gemaakt.</p>
<pre class="">I'd like to share with you a script I developed under jArchi that  automates the view creation. My use case is simple: when I copy Archi elements in a view, the elements are placed one next to the other but I  miss an automatic placement that take in account the relationships between them (a kind of visualizer but in an Archimate view).
 
So  I've written some scripts that allow to do this automatic placement, based on a graph created using the Dagre library, based on Graphlib and  Lodash.</pre></li>
<li><p>[https://www.tamebluelion.co.uk/archimate-documentation Documenting architecture models using ArchiMate] - Definieer in een view de structuur van de documentatie en genereer de documentatie in Markdown vervolgens met dit script.</p></li></ul>
 
== VNGR scripts repository ==
 
Voor het beheren van de GEMMA met Archi zijn een aantal scripts gemaakt die dit ondersteunen. De scripts zijn te vinden in de map Architectuur &gt; Tools in de repository archi-scripts
 
Je kunt de scripts kopieëren uit GitLab, maar houdt er wel rekening mee dat enkele scripts naar elkaar verwijzen en dus in de juiste mappen moeten staan.
 
Het beste is om de archi-scripts repository te 'clonen' naar je lokale map met alle jArchi scripts. Zie voor de locatie van deze map Edit &gt; Preferences &gt; Scripting


<pre class="">cd &lt;jArchi scripts folder&gt;
== Scripts voor de GEMMA ==
git clone git@gitlab.com:vng-realisatie/architectuur/tools/archi-scripts.git</pre>
Ook is er de repository [https://github.com/VNG-Realisatie/archi-scripts archi-scripts]. Hier vind je de scripts die worden gebruikt voor het beheren van de van de GEMMA en projectarchitecturen. De repository is vooralsnog private.
== VNGR scripts ==


De repo bevat de volgende scripts:
De scripts maken onder water gebruik van scripts in de '_lib' folder. Om de scripts te kunnen draaien moet je een volledige kopie van de repository lokaal neerzetten. Manieren om dit te doen:
# open de in Archi geconfigureerd Scripts folder (Zie Edit > Preferences > Scripting)
# download de [https://github.com/VNG-Realisatie/archi-scripts archi-scripts] repository
## Zip file
##* groene Code button
##* kies Download ZIP
## met git clone
##* open een command prompt in je lokale Scripts folder
##* <code>git clone git@github.com:VNG-Realisatie/archi-scripts.git</code> (vereist SSH key)


* ObjectID_*
Welke scripts er zijn en hoe deze werken, wordt gedocumenteerd in de Readme van de repository (Work in progress)
** Scripts om te controleren of alle objecten in een model een uniek Object ID hebben.
* mergeElement
** Voeg 2 concepten (van hetzelfde type) samen tot één concept. Alle relaties, view-occurences en properties worden overgezet en blijven dus bewaard.
* deleteUnusedElements
** Verwijderd alle concepten die niet op een view voorkomen.
* Export en import - scripts voor het exporteren en weer importeren van elementen, relaties en views met alle hun properties
** Kopieer met een export en een import elementen en relaties van het ene model naar een ander model
** Bewerk de objecten en hun eigenschappen in een spreadsheet en importeer de wijzigingen vervolgens weer met het import script
** Status is beta, maar het gebruik is toch veilig
*** exporteren leest je architectuurmodel alleen
*** importeren kan in je model van alles overschrijven. Een simpel Ctrl-z zet alles weer terug...
* Appearance - scripts voor het in bulk wijzigen van views
** ChangeFigure - toggle alle figures in één of meerdere views
** ChangeFont - wijzig font van alle objecten in één of meerdere views. Wijzig het font van objecten van één geselecteerd type
** ColorByProperty - wijzige de kleur van objecten op basis van de waarde van een te kiezen property
<!-- Page revision date: 1580313786 -->

Huidige versie van 22 apr 2024 om 14:01

Met de jArchi-plugin is het mogelijk om met een script een architectuurmodel te lezen en te bewerken. Hiermee kun je Archi uitbreiden met je eigen functies. Zie jArchi – Scripting for Archi voor verdere informatie

Op deze pagina vind je verwijzigen naar scripts die nuttig kunnen zijn bij het onderhouden van een architectuurmodel en het maken van views.

  • extra features beschikbaar in open source scripts
  • enkele specifieke scripts voor het beheer van het GEMMA architectuurmodel

Installeren plugin jArchi =[bewerken]

De scripting plug-in is alleen beschikbaar voor Archi donateurs. VNG Realisatie is Archi donateur.

GEMMA- en projectarchitecten kunnen de jArchi plugin downloaden vanuit het Team Architectuurtooling, folder Archi (actuele versie)

Configuratie voor scripting

  • Ga naar jArchi Quick Start
  • Edit > Preferences > Scripting (zie je geen tab scripting, dan moet je de plug-in jArchi eerst installeren)
    • accepteer de default directory of configureer in Archi je <script directory>
      • advies, kies een directory met backup (bijvoorbeeld een dropbox directory)
    • voorkeur editor, bijvoorbeeld Atom of Visual Studio Code (tip: zet script language op javascript)
    • zet JavaScript Engine op GraalVM (default)

Waar vind je scripts[bewerken]

De jArchi plug-in bevat enkele voorbeeld scripts. Maar er zijn nog veel meer scripts te vinden

Scripts voor de GEMMA[bewerken]

Ook is er de repository archi-scripts. Hier vind je de scripts die worden gebruikt voor het beheren van de van de GEMMA en projectarchitecturen. De repository is vooralsnog private.

De scripts maken onder water gebruik van scripts in de '_lib' folder. Om de scripts te kunnen draaien moet je een volledige kopie van de repository lokaal neerzetten. Manieren om dit te doen:

  1. open de in Archi geconfigureerd Scripts folder (Zie Edit > Preferences > Scripting)
  2. download de archi-scripts repository
    1. Zip file
      • groene Code button
      • kies Download ZIP
    2. met git clone
      • open een command prompt in je lokale Scripts folder
      • git clone git@github.com:VNG-Realisatie/archi-scripts.git (vereist SSH key)

Welke scripts er zijn en hoe deze werken, wordt gedocumenteerd in de Readme van de repository (Work in progress)

Een weergave van een bepaald onderwerp. Een architectuurmodel geeft een kleinschalige, vereenvoudigde en/of abstracte weergave van het onderwerp.

Betekenisvolle gegevens.

De GEMeentelijke ModelArchitectuur met een verzameling samenhangende kaders, richtlijnen, referentiemodellen en standaarden die gemeenten helpt bij het inrichten van hun IT-omgeving en processen.

Overgenomen van "https://www.gemmaonline.nl/index.php?title=Archi_scripting&oldid=1062443"
Deze pagina is het laatst bewerkt op 22 apr 2024 om 14:01.