Installation der Extension
- Merve Yurdakul
- Dennis Balzuweit
Installation
Für CLARC Infinity ist die Verwendung einer VS Code Extension vorgesehen.
Die bereitgestellte Extension befindet sich im Marketplace und kann entsprechend direkt aus der Entwicklungsumgebung heraus installiert werden.
Einrichtung
Nach erfolgreicher Installation der Extension über den VS Code Marketplace erscheint in der Activity Bar auf der linken Seite das CLARC Icon. Von dieser Sidebar aus sind bereits einige Funktionen erreichbar. Der View-Container kann per Drag&Drop in beliebige Sidebars und Panels verschoben werden.
Welcome-Page und der Anmeldeprozess
Für die Nutzung der Extension ist eine Anmeldung mit einem CLARC Infinity Account notwendig, sowie die Installation von Node.js.
Der Anmeldeprozess umfasst vier Schritte: Tenant, System Class, Username und Password. Jeder dieser Schritte wird durch ein einzelnes Eingabefeld abgefragt. Sind die Anmeldeinformationen korrekt, werden die Tree-Views aktualisiert und der Anmeldestatus in der Statusbar zeigt den aktuellen Tenant und die System Class an. Außerdem wird dem User die Möglichkeit gegeben das eben eingegebene Passwort im secret storage zu hinterlegen, um zukünftige Anmeldung zu erleichtern.
In den Einstellungen lässt sich das gespeicherte Passwort überschreiben und löschen. Der grüne Punkt signalisiert ein vorhandenes hinterlegtes Passwort für den aktuell angemeldeten Account. Ein roter Punkt signalisiert, dass aktuell kein Passwort hinterlegt ist.
Voraussetzung für einen erfolgreichen Anmeldeprozess ist ein gewähltes Root Directory und korrekte Server URL. Wurden diese nicht selbstständig eingetragen, wird der User vor Eingabe der Anmeldeinformationen dahingehend abgefragt. Das Root Directory sollte dabei zu Beginn ein leerer Ordner sein.
Nach der initialen Anmeldung wird im Root Directory die Grundstruktur erstellt und alle nötigen node modules installiert (insb. “@ctodev/cclibrary-types”). Die Installation der node modules (npm install) tritt ein, falls kein Ordner “node_modules” im Root Directory vorhanden ist. Außerdem wird nach jeder Anmeldung auf eine neuere Version von “@ctodev/cclibrary-types” überprüft und diese gegebenenfalls installiert.
Nach erfolgreicher Anmeldung werden die verfügbaren Informationen angezeigt.
Die einzelnen Tree-Views können individuell eingeklappt und angeordnet werden.
Die Sidebar besteht aus folgenden Elementen:
CLARC Infinity Tree-View, welche alle verfügbaren Projects, Resources, Business Objects und Libraries auflistet und nach Tenant und System-Class gruppiert
Einstellungen
Die Statusbar beinhaltet weitere Ansichten, welche den Anmeldestatus und Informationen über das aktuell geöffnete Skript anzeigen.
