/
Installation der Extension

Installation der Extension

Owned by Merve Yurdakul, created
Last updated: Jan. 10, 2025 by Dennis Balzuweit
2 min read

Installation

Installieren Sie die CLARC VSCode Extension direkt aus dem Microsoft Marketplace aus der Entwicklungsumgebung heraus (Suche nach “clarc”).

Einrichtung

Nach erfolgreicher Installation der Extension über den VSCode Marketplace erscheint in der Activity Bar auf der linken Seite das CLARC Icon.

Der View-Container kann per Drag&Drop in beliebige Sidebars und Panels verschoben werden.

image-20241030-140820.png

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. 

image-20241030-140928.png

Konfigurationsoptionen 

In den VSCode Einstellungen lassen sich unter Extensions - CLARC Infinity Development folgende Einstellungen konfigurieren: 

ID

Beschreibung 

Standardwert 

clarc-infinity-development.Theme.Colorful 

Aktiviert den farbenfrohen Modus der Extension. Alle Icons der Tree-Views werden in blau und lila anstatt weiß angezeigt. 

Aktiviert 

clarc-infinity-development.Login.AskToStorePassword 

Der User wird nach erfolgreicher Anmeldung gefragt, ob das Password für diesen Account gespeichert werden soll. 

Aktiviert 

clarc-infinity-development.Config.ApiVersion 

Definiert die API Version. 

"v1" 

Die Konfiguration der Server-URL sollte nicht manuell in den VSCode Einstellungen geändert werden, sondern ausschließlich über die Settings in der Tree-View.