Skip to main content

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.

  1. Kommandopalette öffnen und documentsOS: Wizard: Download / Create Project ausführen.
    Wizard starten
    • Liegen im Ordner schon Dateien (auch versteckte), warnt der Wizard. Mit „Continue“ bestätigen. Eine vorhandene Konfiguration wird dabei überschrieben.
      image.png
  2. Startdialog mit „Continue“ bestätigen.

    image.png
  3. Verbindungsdaten eingeben (siehe Tabelle unten).

    image.png


  4. Passwort in der launch.json speichern?

    image.png
  5. Skripte herunterladen? Mit Continue bestätigen. Später jederzeit auch mit documentsOs: Download Scripts ... möglich.
  6. Unterordner nach Skriptkategorien anlegen? Bei vielen Skripten Yes empfohlen.
  7. Skripte auswählen: oberste Checkbox wählt alle aus, über die Filterzeile lässt sich nach Namen eingrenzen.

    image.png



  8. Fertig: VS Code zeigt unten rechts eine Benachrichtigung.

    image.png

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

image.png

Befehlsreferenz

Befehl (Kommandopalette)

Wofür

Hinweis

documentsOS: Wizard: Download / Create Project

Verbindung einrichten und Skripte herunterladen

Überschreibt eine vorhandene Konfiguration

documentsOS: …Change connection

[ergänzen]Zwischen Verbindungen wechseln

 

documentsOS: Download Scripts …

[ergänzen]Skripte vom System herunterladen (Auswahl)

 

documentsOS: Get Typings

otris-Typings herunterladen

Für IntelliSense

documentsOS: Install Typings

Typings im Workspace installieren

[prüfen]

documentsOS: Get File Type Typings

Typings der Mappentypen des Systems laden

Für IntelliSense

documentsOS: Connect ServerConsole

Serverkonsole in VS Code verbinden

 

documentsOS: Disconnect ServerConsole

Serverkonsole trennen

 

documentsOS: Clear PortalScript Cache

PortalScript-Cache auf dem Server leeren

 

documentsOS: Set Property …

Property setzen

[prüfen]

documentsOS: XML Export …

XML-Export aus dem System

[prüfen]

documentsOS: Create Principal

Mandanten anlegen

[prüfen]

documentsOS: Attach to Running Script

Debugger an laufendes Skript anhängen

Nutzt den Debugport, bei Kundensystemen nicht verwenden

image.png

image.png

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.

image.png

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. 

image.png

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.

image.png

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.

image.png

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

image.png

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:


Back to top