<%NOJS_WARNING%>

KISTERS Logo KISTERS logo

Dokumentation der Administrator-Einstellungen

Scroll PDF

Diese Einstellungen können über verschiedene Konfigurationsdateien im VisShare-Repository vorgenommen werden:

Datei

Beschreibung

server/config/settings.json

Die Datei enthält Einstellungen zu den VisShare-Serverkonfigurationen, die in die Datenbank geschrieben werden

server/datasources.json

Die Datei enthält die Verbindungsinformationen für die Datenbank, die Dateiablage und den Mailserver

client/assets/settings/settings.js

Die Datei enthält Einstellungen zum Anpassen der VisShare-Benutzeroberfläche

Server-seitige Settings.json

Die Datei settings.json wird einmalig mit der bei der Einrichtung festgelegten Konfiguration geschrieben. Diese Datei sollte sich mit einem nachgestellten Unterstrich (settings.json_) innerhalb des Verzeichnisses befinden. Durch Entfernen des Unterstrichs wird der Inhalt dieser Datei beim nächsten Neustart des VisShare-Dienstes in die Datenbank geschrieben. Dadurch wird auch der Unterstrich nach erfolgreicher Übernahme wieder eingefügt.

Name

Beschreibung

Standardwert

Laufwerksname

Der Pfad zur Dateiablage des WebViewers (vom VisShare-Dienst aus gesehen)

/VisShare_Models/

(innerhalb des VisShare Installations-Repository)

WVDriveName

Der Pfad zur Dateiablage des WebViewers (vom WebViewer-Dienst aus gesehen)

/VisShare_Models/

LDAPUrl

URL zum LDAP-Server

nichts

LDAPBaseDN

Die BaseDN zum Starten der LDAP-Verbindung

nichts

LDAPBindDN

Zusätzliche Suche der LDAP-Verbindung

nichts

UseLDAP

Option, ob LDAP verwendet wird

false

LDAPOnly

Option, die das Anmeldungen nur über LDAP erlaubt (keine lokalen Benutzer)

false

AdminVerification

Option, die festlegt, ob Benutzer von einem Administrator verifiziert werden müssen, bevor sie VisShare nutzen können

true

AllowGuests

Option, die festlegt, ob Gäste erlaubt sind, wenn AdminVerification aktiviert ist (ein Gast ist eine eingeschränkte Rolle)

true

RemotePublic

Option, die festlegt, ob öffentliche Projekte ohne Anmeldung erreichbar sind

false

SendingMail

Die Mailadresse, die zum Versenden von Mails verwendet wird

Bei der Installation festgelegt

SendMailsOnConfirm

Option, die festlegt, ob Mails an bestimmte E-Mail-Adressen gesendet werden, wenn ein neuer Benutzer über die Benutzer-Mail bestätigt wird

false

ConfirmMailRecipients

Ein Array mit den Empfangsadressen (kommagetrennt) für die bestätigten Benutzer

nichts

Konvertieren

Option, die festlegt, ob hochgeladene Dateien in 3DVS konvertiert werden

true

DeleteNative

Option, die festlegt, ob die hochgeladenen nativen Dateien nach der Konvertierung in 3DVS gelöscht werden

false

SingleSession

Option, die festlegt, ob ein Benutzer nur eine Sitzung starten kann (eine Datei ansehen). Falls gesetzt, wird beim Versuch, eine zweite Sitzung zu öffnen, ein Fehler ausgegeben, bevor die WebViewer-Sitzung initialisiert wird

false

UseTenants

Option, die festlegt, ob Benutzer-Pools verwendet werden

true

InviteOnly

Option, die festlegt, ob neue Benutzer nur registriert werden können, wenn sie von bestehenden Benutzern eingeladen werden

false

AdminCreationOnly

Option, die festlegt, ob neue Benutzer nur von Admins erstellt werden können (keine Registrierung)

false

AdminVerificationLDAP

Option, die festlegt, ob auch LDAP-Benutzer zunächst von einem Administrator überprüft werden müssen

false

AllowDownloads

Option, die festlegt, ob Downloads generell erlaubt sind

false

OnlyAdminProjects

Option, die festlegt, ob Projekte nur von Admins erstellt werden können

false

IgnoreOnConvert

Eine Liste mit Dateierweiterungen, die beim Hochladen nicht konvertiert werden sollen. Diese Dateien sind in der Benutzeroberfläche gekennzeichnet und werden nicht im WebViewer geöffnet. Stattdessen wird beim Klicken ein Fehler ausgegeben

leer

AllowIgnoredFileTypeDownload

Eine Liste mit Dateierweiterungen als Teilmenge der Einstellungen für IgnoreOnConvert. Diese Dateien werden durch Anklicken heruntergeladen (anstatt einen Fehler zu erzeugen)

Beachten Sie: Damit können Sie "browser-native" Dateien wie PDFs im Browser selbst (durch den Download) anzeigen, anstatt sie in einer WebViewer-Sitzung zu betrachten

leer

UserCount

LIC-Einstellung, die die Anzahl der registrierten Benutzer auf dem VisShare begrenzt (um den Wert der Lizenz bei Bedarf weiter zu reduzieren)

0 (entspricht deaktiviert)

SessionsPerUser

LIC-Einstellung zur Begrenzung der Sitzungen, die ein Benutzer öffnen kann (um den Wert der Lizenz bei Bedarf weiter zu reduzieren)

0 (entspricht deaktiviert)

RemoteSessionCount

LIC-Einstellung, die die Anzahl der Sitzungen begrenzt, die aus der Ferne geöffnet werden können (durch öffentliche Remote-Projekte, um den Wert der Lizenz bei Bedarf weiter zu reduzieren)

0 (entspricht deaktiviert)

LinkSessionCount

LIC-Einstellung, die die Anzahl der Sitzungen begrenzt, die aus der Ferne geöffnet werden können (durch Remote-Links, um den Wert der Lizenz bei Bedarf weiter zu reduzieren)

0 (entspricht deaktiviert)

Nicht dokumentierte Einstellungen

Beachten Sie: Diese Einstellungen sollten vom Administrator nicht ohne unsere Anleitung geändert werden:

Name

Beschreibung

Standardwert

ServerUrl

Die vollständige URL des Servers

Bei der Installation festgelegt

WebViewerBackendUrl

Die WebSocket-URL für die Backend-Verbindung VisShare <> WebViewer

Hinweis: Sollte lokal sein, um Angriffe von außen zu verhindern.

ws://localhost:9999

WebViewerClientUrl

Die vollständige URL für den HTTP-Aufruf des WebViewer-Endpunkts

<ServerUrl, die beim Setup angegeben wurde>/visshare_webviewer

WebViewerClientWebSocketUrl

Die WebSocket-URL für den WebViewer-Client

ws(s)://<ServerUrl, die beim Setup angegeben wurde, ohne http(s)>/visshare_webviewer/ws

ConfirmationUrl

Die URL eines neuen Benutzers wird in der Bestätigungsmail angezeigt

Bei der Installation festgelegt (= ServerUrl)

ConfirmationRedirectUrl

Die URL, die in automatisierten Mails verwendet wird, um auf die Seiten von VisShare weiterzuleiten

Bei der Installation festgelegt (= ServerUrl)

KASKey

Ein gemeinsamer Schlüssel zwischen der VisShare Backend-Anwendung und dem KAS-Konverterdienst, der Aufträge authentifiziert

vs-kas-key

KASTimeout

Ein Timeout für Jobs, nach Überschreiten dieser Dauer werden Jobs entfernt

600000

UseAdvancedRegister

Eine Markierung, die anzeigt, dass eine spezielle Seite mit zusätzlichen Registrierungsdaten von einem neuen Benutzer angefordert wird, bevor die Registrierung abgeschlossen wird

Beachten Sie: Wird für das interne VisShare verwendet, um weitere Kundeninformationen zu erhalten

false

AdvancedRegisterMail

Die Empfänger-Mails für die auf der erweiterten Registrierungsseite erfassten Kundendaten (kommagetrennt)

leer

Color1

Einstellung der Hauptfarbe (sollte über das Programm geändert werden)

#d67c1c

Color2

Einstellung der Sekundärfarbe (sollte über das Programm geändert werden)

#ffc662

Color3

Einstellung der Tertiärfarbe (sollte über das Programm geändert werden)

#fcd797

Banner

Der Name des SVG-Banners (sollte über das Programm geändert werden)

Kisters_banner.svg

Logo

Der Name der Logo-SVG (sollte über das Programm geändert werden)

Kisters_logo.svg

Server-seitige datasources.json

Die datasource-Datei enthält die Verbindungsparameter für die Datenbank und den SMTP-Server sowie den Speicherort für die Dateien. Die Erstkonfiguration erfolgt über das Setup. VisShare liest diese Datei bei jedem Start des Dienstes. Sie müssen sie also nicht umbenennen, aber der Dienst muss neu gestartet werden, um die Änderungen zu übernehmen.

Der Abschnitt PostgreSQL behandelt die Datenbankverbindung. Während VisShare den URL-Parameter für die Verbindung verwendet, können/sollten die anderen Parameter für eine bessere Übersicht ebenfalls angepasst werden.

Der Abschnitt filestorage umfasst den Speicherort des Dateispeichers. Hier sollte nur der Parameter root geändert werden, wenn der Speicherort geändert werden muss. Das anfängliche Repository ist das Standardverzeichnis VisShare/VisShare_Models.

Beachten Sie: Ändern Sie immer die Laufwerkseinstellungen aus der settings.json (siehe oben) und den WebViewer-Renderer (CRendererInstance.ini) ModelRepo-Konfigurationen entsprechend zu diesem Root-Repository. Der KAS-Konvertierungsdienst erhält den Pfad von VisShare, es ist keine Änderung erforderlich.

Der E-Mail-Abschnitt behandelt die Verbindungsparameter des SMTP-Servers. Dies hängt stark von dem SMTP-Server ab, mit dem sich VisShare verbinden soll, und auch die Parameter können sich von Fall zu Fall ändern. Die Voreinstellung sollte die „grundlegendsten“ SMTP-Server-Anforderungen abdecken. Zusätzliche Informationen finden Sie in der Nodemailer-Dokumentation (das Loopback-Framework verwendet Nodemailer als Mailing-Modul): https://www.nodemailer.com/about/

Client-seitige settings.js

Diese Datei enthält Einstellungen für die Benutzeroberfläche und das Verhalten der VisShare-Anwendung. Änderungen können ohne Neustart des Dienstes vorgenommen werden. Beachten Sie jedoch, dass der Browser-Cache geleert werden muss, um die Änderungen zu sehen.

Name

Beschreibung

Standardwert

VSShareBackendUrl

Die URL für die HTTP-Aufrufe der API

Wurde während der Installation auf die VisShare-Server-URL eingestellt

UseAdvancedRegister        

Option, die festlegt, ob der Client nach der Registrierungsanfrage auf die erweiterte Registrierungsseite umgeleitet werden soll

false

AdminCreationOnly

Falls eingestellt, wird die Schaltfläche zum Registrieren ausgeblendet

false

VisShareDisclaimerUrl

Die URL des VisShare-Haftungsausschlusses

https://viewer.kisters.de/datenschutz.html

VisShareImprintUrl

Die URL des VisShare-Impressums

https://viewer.kisters.de/impressum.html

ShowTermsAfterRegister

Wenn diese Option aktiviert ist, wird einem neuen Benutzer nach der Registrierung die Seite mit den Allgemeinen Geschäftsbedingungen angezeigt

false

HidePrivate

Wenn diese Option aktiviert ist, wird der gesamte private Abschnitt verborgen (privates Projekt, freigegebene Dateien, mit mir geteilt)

false

HideMailLinks

Wenn diese Option aktiviert ist, werden die Optionen zum Senden von Freigabelinks ausgeblendet

false

HidePasswordReset

Wenn diese Option aktiviert ist, werden die Optionen zum Ändern und Vergessen des Passworts ausgeblendet

false

HideResendMail

Wenn diese Option aktiviert ist, wird die Option zum erneuten Senden von E-Mails ausgeblendet

false

OnlyAdminProjectTypeChanges

Wenn diese Option aktiviert ist, können nur VisShare-Administratoren die Option im Kontextmenü sehen, mit der Sie den Projekttyp in „Showcase /Öffentlich“ ändern können

false

Zusätzliche Anpassungen/Konfiguration

Es gibt ein paar zusätzliche Dateien, die vom Administrator geändert werden können, um die Anwendung weiter anzupassen:

Pfad

Beschreibung

Client-Seite

client/assets/info-pages/info-page-auth.html

Die Informationsseite, die angezeigt wird, wenn ein angemeldeter und bestätigter Benutzer auf das Fragezeichen-Symbol klickt

client/assets/info-pages/info-page-guest.html

Die Informationsseite, die angezeigt wird, wenn ein Gast oder ein nicht angemeldeter Benutzer auf das Fragezeichen-Symbol klickt

Server-seitige Mail-Vorlagen

server/views/account-creation.html

Die Vorlage der E-Mail, die ein Administrator bei der Kontoerstellung an Benutzer sendet

server/views/advanced-register-mail.html

Die Vorlage der E-Mail, die an die Empfänger der erweiterten Registrierungsdaten gesendet wird

server/views/invite-mail.html

Die Vorlage der E-Mail, die an eine Mail-Adresse gesendet wird, die von einem VisShare-Benutzer eingeladen wurde

server/views/password-reset.html

Die Vorlage der E-Mail, die an einen Benutzer gesendet wird, der ein Zurücksetzen des Passworts beantragt hat

server/views/share-mail.html

Die Vorlage der E-Mail, die an eine Mailadresse gesendet wird, wenn eine automatisierte Mail bei der Erstellung eines Freigabelinks gesendet werden soll

server/views/user-confirmed.html

Die Vorlage der E-Mail, die an die Empfänger von Mails gesendet wird, wenn ein neuer Benutzer sein Konto über die Mail verifiziert hat

server/views/verify.ejs

Die Vorlage der E-Mail, die an neue Benutzer gesendet wird, um sie zu bitten, ihr Konto zu verifizieren

Dienstskripte, die beim Start des Dienstes ausgeführt werden, wenn der abschließende Unterstrich entfernt wird – Der Inhalt wird beim Start des Servers verarbeitet und die Datei wird dann geleert und umbenannt

server/config/adminCreation.json

Dieses Skript erstellt beim Start ein Admin-Konto mit der angegebenen Login-Mail und dem Passwort

server/config/projectDefaultsManagement.json

Dieses Skript wird verwendet, um einen Standard-Projekteigentümer und einen Standard-Projektadministrator bereitzustellen. Diese Datei hat keine „Unterstrich-Logik“, da sie bei jedem Start des Dienstes gelesen und in den Laufzeitspeicher der Anwendung geschrieben wird

ProjectDefaultOwnerEmail

EIN Eigentümer, der für alle Projekte verwendet wird, anstatt des Projekt-Erstellers selbst

ProjectDefaultAdminEmails

Mehrere Admins (durch Komma getrennte Mails), die zu jedem erstellten Projekt hinzugefügt werden

server/config/syncCreation.json

Dieses Skript erstellt ein neues Projekt und wendet eine Synchronisierung darauf an, indem es die folgenden Parameter übergibt:

Directory

Der Pfad zu dem Repository, das für die Synchronisierung verwendet wird

OwnerMail

Die E-Mail (= Anmeldename) des Eigentümers, unter dem das Projekt erstellt werden soll

CreateBackup

Option, die festlegt, ob die Synchronisierung mit der Backup-Option erfolgen soll

ProjectName

Der Name, mit dem das Projekt initialisiert wird

UserPoolId

Die ID des Benutzer-Pools, der diesem Projekt zugeordnet werden soll

server/config/syncDeletion.json

Dieses Skript löscht Synchronisierungen, indem es den Pfad des Sync-Verzeichnisses in einer kommagetrennten Liste übergibt

LDAP-Verbindung

Die letzte Datei, die vom Benutzer geändert werden soll, ist die LDAP-Verbindungsdatei (server/scripts/ldapAuth.js).

Diese Datei enthält den JS-Code für die Verbindung zu einem LDAP-Server über das Modul ldap.js. Ein Administrator muss die Verbindungsmethode ändern, damit VisShare einen Benutzer mit einer E-Mail/Passwort-Authentifizierung an diesen LDAP-Server binden kann. Die Voreinstellung in dieser Datei kann als Beispielcode verwendet werden, wie eine solche Verbindung hergestellt werden kann, aber es ist sehr wahrscheinlich, dass Änderungen vorgenommen werden.

Die Parameter für den Verbindungsaufruf, die dynamisch gefüllt werden und vom Administrator für den Code gegen den LDAP-Server verwendet werden können, sind:

email

Die Login-Mail, die der Benutzer bei der Anmeldung angegeben hat

password

Das Passwort, das der Benutzer bei der Anmeldung angegeben hat

serverURL

Die URL des LDAP-Servers, die in den Datenbank-Einstellungen angegeben ist

baseDN

Die Basis-DN wird über die Datenbank-Einstellungen bereitgestellt

bindDN

Die zusätzlichen Suchparameter für die LDAP-Verbindung werden über die Einstellungen der Datenbank bereitgestellt

callback(error, response)

Diese Methode sollte aufgerufen werden, nachdem die LDAP-Verbindung hergestellt wurde

Bei Erfolg: Aufruf mit der positiven Authentifizierungsantwort aus dem LDAP -> cb(undefined, response);

Bei Fehler: Aufruf mit Fehlerantwort von LDAP ->  cb(error, undefined);

English Version German Version Japanese Version Italian Version French Version Spanish Version Chinese Version File Format list-PDF Admin-PDF