Verbindung herstellen und Skripte herunterladen

Die documentsOS-Extension bietet einen Wizard (documentsOS: Wizard: Download / Create Project). Damit nehmen wir die komplette Konfiguration vor: Verbindung zum System, Einstellungen des Workspaces und Download der Skripte.

Kommandopalette öffnen und documentsOS: Wizard: Download / Create Project ausführen.
- Liegen im Ordner schon Dateien (auch versteckte), warnt der Wizard. Mit „Continue“ bestätigen. Eine vorhandene Konfiguration wird dabei überschrieben.
Startdialog mit „Continue“ bestätigen.
Verbindungsdaten eingeben (siehe Tabelle unten).
Passwort in der launch.json speichern?
Skripte herunterladen? Mit Continue bestätigen. Später jederzeit auch mit documentsOs: Download Scripts ... möglich.
Unterordner nach Skriptkategorien anlegen? Bei vielen Skripten Yes empfohlen.
Skripte auswählen: oberste Checkbox wählt alle aus, über die Filterzeile lässt sich nach Namen eingrenzen.
Fertig: VS Code zeigt unten rechts eine Benachrichtigung.

Eingabe	Wert / Standard	Hinweis
Host	Hostname oder IP	z. B. `192.168.178.71` (lokales Testsystem)
Manager-Port	`11000`	Standardport
Encryption (TLS)	`No`	in der Regel
Mandant (Principal)	`relations`	laut DOCUMENTS-Lizenz; `relations` = Demo-Mandant
Benutzer	`admin`	Standard
Passwort	Admin-Passwort

Hinweis Passwort: Gespeichert liegt es in .vscode/launch.json. Wird der Workspace-Ordner weitergegeben oder kopiert, geht das Passwort mit. Bei Kundensystemen daher nicht speichern.

Ergebnis im Workspace

Ordner / Datei	Inhalt
`.vscode/`	Einstellungen der Extension für diesen Workspace (u. a. `launch.json`)
`src/`	Heruntergeladene Skripte; Unterordner mit Endung `.cat` = Skriptkategorien
`typings/`	Typings von otris für IntelliSense
`jsconfig.json`	JavaScript-Projektkonfiguration für VS Code

Befehlsreferenz

Befehl (Kommandopalette)	Wofür	Hinweis
`documentsOS: Wizard: Download / Create Project`	Verbindung einrichten und Skripte herunterladen
`documentsOS: …`	[ergänzen]
`documentsOS: …`	[ergänzen]

Als nächstes besteht die Option die Skripte des Mandanten, zu dem sich verbunden werden soll herunterzuladen. Bestätigt man dies, wird das entsprechend berücksichtigt und man bekommt im Verlauf die Möglichkeit selektierte Skripte herunterzuladen. Ich bestätige es hier mit "Continue". Die Skripte lassen sich jederzeit auch später mit dem Befehl "" herunterladen.

Der nächste Dialog gibt einem die Option, ob mit dem Download der Skripte Unterordner anhand der Skriptkategorien erstellt werden soll. Abhängig davon, was in dem Workspace gemacht werden soll und wie viele Skripte man verwaltet, empfiehlt sich das mit "Yes" zu bestätigen.

Anschließend folgt der Dialog zur Auswahl der zu herunterladenen Skripte. Klickt man die oberste Checkbox werden alle Skripte ausgewählt. In der Zeile kann man die Skripte namentlich filtern und so sich eine Auswahl zusammenstellen.

Weiterhin wurde durch den Wizard bereits die Ordner ".vscode" und "src" sowie die jsconfig.json angelegt. Der Ordner ".vscode" enthält dabei die Einstellungen der Extension für diesen Workspace.

Damit ist der Wizard beendet und es gibt eine Benachrichtigung im VSCode-Fenster in der unteren rechten Ecke.

Der Ordner "src" enthält die Unterordner abhängig von den Skriptkategorien sowie heruntergeladenen Skripte. Unterordner die Skriptkategorien widerspiegeln haben die Endung ".cat" im Namen.

Neben den heruntergeladenen Skripten, werden auch die Typings von Otris in einem neuen Ordner "typings" mit angelegt: