Konfiguration

Die Datei appsettings.json im Applikationsverzeichnis auf dem Web-Server enthält diverse Parameter, mit denen das Aussehen und die Funktionsweise der WiBe Anwendung angepasst werden können.

Anhänge von Notizen

Dateianhänge zu Notizen werden in Form von .dat Dateien mit eindeutigen Identifikationsnummern im ‚uploads‘ Verzeichnis gespeichert. Durch Ändern der Parameter AllowedExtentions in der Datei appsettings.json im Applikationsverzeichnis auf dem Web-Server können die erlaubten Dateierweiterungen eingeschränkt werden.

"AllowedExtentions": "xls,doc,xlsx,docx",

Notwendige Zugriffe auf das Internet

Eine Intranet-Installation der WiBe Software kommt prinzipiell ohne Internetzugriffe aus. Wenn Sie die Berechnungsart mit Zinsstrukturkurve verwenden, benötigt der Server (nicht die Clients) Zugriff auf das Internet, da die Parameter der Bundesbank täglich mehrfach neu abgeholt werden müssen.

Dazu macht der Server einen HTTP-Zugriff auf die Webadresse zsk.wibe-software.eu (derzeit die IP Adresse 85.214.222.10).

Ist dieser Zugriff nicht möglich, wird bei Projekten mit Berechnungsart ZSK (Zinsstrukturkurve) immer FALSCH mit einem Zinssatz von 0 gerechnet.

Ist der HTTP-Zugriff auf das Internet nur über einen Proxyserver möglich, muss in der Datei appsettings.config im Hauptverzeichnis der Anwendung eine Zeile ergänzt werden. Suchen Sie dort eine Zeile

"ZSKProxy": “https://Servername“,

und kontrollieren Sie, ob die Angabe hinter dem Doppelpunkt mit Ihrem Proxyserver identisch ist. Ansonsten fügen Sie diese Zeile vor der schließenden Klammer hinzu.

Benutzt Ihr Proxyserver einen anderen Port als 80, so muss der Eintrag in der Schreibweise

Servername:Portnummer

erfolgen.

Kontrolle der Parameter für die Zinsstrukturkurve

Im Support-Bildschirm (Support-Symbol in der Symbolleiste innerhalb der Software) befindet sich ein Bildschirm ‚ZSK-Parameter‘. Sie gelangen damit in eine Liste der aktuell gespeicherten ZSK Parameter. Außerdem kann über eine Eingabezeile am oberen Rand des Bildschirms die Tabelle der ZSK-Parameter manuell ergänzt werden. Dies ist nur notwendig, wenn der Internet-Zugriff für ein automatisches Update nicht möglich ist.

In einem solchen Fall sollte in der Datei appsettings.json im Applikationsverzeichnis des Web-Servers die folgende Änderung vorgenommen werden:

"UpdateZSKParameter": "false"

Damit wird das automatische Update unterbunden und vor allem beim Starten der Applikation die gespeicherte Liste nicht teilweise geleert, damit immer die aktuellsten Parameter abgefragt werden.

Ausschalten der Auswahl der Trennung von haushaltswirksam/nicht haushaltswirksam

Soll beim Neuanlegen von Projekten der Projektleiter nicht die Option haben, die Trennung in „haushaltswirksame Beträge“ und „nicht haushaltswirksame Beträge“ zu deaktivieren, kann dies über diesen Parameter unterbunden werden.

In einem solchen Fall sollte in der Datei appsettings.config im Applikationsverzeichnis des Web-Servers die folgende Änderung vorgenommen werden:

"HWNHDisable": "true"

Das Kontrollkästchen wird dann zwar noch angezeigt, ist aber deaktiviert.

Dieser Parameter ist nur für WiBe Professional und WiBe Enterprise Installationen wirksam.

Der Parameter ist für die WiBe Bau Anwendung nicht relevant.

Ausschalten der Abzinsung mit Zinsstrukturkurve

Soll beim Neuanlegen von Projekten der Projektleiter keine Möglichkeit haben, die Verzinsung mit der Zinsstrukturkurve durchzuführen, kann dies mit diesem Parameter gesteuert werden.

In einem solchen Fall sollte in der Datei appsettings.json im Applikationsverzeichnis des Web-Servers die folgende Änderung vorgenommen werden:

"ZSKDisable": "true"

Die Möglichkeit der Zinsstrukturkurve wird zwar noch angezeigt, ist aber deaktiviert. Die Verzinsung ist auf einen Fixzinssatz eingeschränkt.

Automatische Aktualisierungsperiode für ZSK Parameter

Normalerweise holt die WiBe ZSK Parameter von der Bundesbank nicht nur für den aktuellen Tag, sondern für eine größere Zeitspanne, damit fehlgeschlagene Übertragungen (bei denen 0 übertragen wurde) nicht in der Datenbank stehen bleiben. Normalerweise wird ein Zeitraum von einer Woche (7 Tage) immer wieder neu verarbeitet. Dieser Zeitraum kann geändert werden.

In einem solchen Fall sollte in der Datei appsettings.json im Applikationsverzeichnis des Web-Servers eine Änderung an folgender Stelle vorgenommen werden:

"ZSKUpdateDays": "7"

Soll dieses Verhalten gänzlich abgeschaltet werden, kann der Wert auf 0 gesetzt werden.

Aktivieren der Abfrage vor Deaktivieren eines Kriteriums

Soll beim Deaktivieren eines Kriteriums innerhalb eines Projekts vor dem tatsächlichen Deaktivieren eine Warnseite zwischengeschaltet werden, so kann dies mit diesem Parameter gesteuert werden.

In einem solchen Fall sollte in der Datei appsettings.json im Applikationsverzeichnis des Web-Servers die folgende Änderung vorgenommen werden:

"DisableCriterionAsk": "true"

Nach Wegklicken des Kriteriums erscheint normalerweise ein Zwischenschirm, in dem das Deaktivieren des Kriteriums nochmals bestätigt werden muss. Wird nicht bestätigt, bleiben das Kriterium und alle dafür erfassten Beträge, Notizen, Rechenblätter, etc. weiterhin im Projekt. Ist der Parameter auf true gesetzt, wird das Kriterium sofort ausgeschaltet; es kann nur über Rückgängig wiederhergestellt werden.

Dokumentieren von Änderungen in einem Projekt

Soll bei Änderungen im Projekt ein Eintrag ins Sicherheitsprotokoll erfolgen, kann dies durch diesen Parameter aktiviert werden. Normalerweise wird ansonsten nur das Aufrufen des Projekts dokumentiert.

In einem solchen Fall sollte in der Datei appsettings.json im Applikationsverzeichnis des Web-Servers die folgende Änderung vorgenommen werden:

"EnableModificationLog": "true"

Nach dem Setzen des Parameters wird im Sicherheitsprotokoll bei erfolgten Änderungen ein Zusatz „mit Änderung“ neben dem Namen des zugreifenden Benutzers angezeigt. Es wird nicht dokumentiert, was geändert wurde.

Vollständige Notiz unterhalb der Betragseingabe anzeigen

Sollen bei der Eingabe von Beträgen bereits vorhandene Notizen vollständig angezeigt werden, kann dies über diesen Parameter gesteuert werden.

In einem solchen Fall sollte in der Datei appsettings.json im Applikationsverzeichnis des Web-Servers die folgende Änderung vorgenommen werden:

"EnableFullNote":"true"

Nach dem Setzen des Parameters wird die Notiz als vollständiger Text angezeigt. Ansonsten wird nur der Anfang der Notiz unterhalb der Betragseingabe angezeigt.

Länge der Notiz unterhalb der Betragseingabe festlegen

Soll die Länge der Vorschau von vorhandenen Notizen bei der Eingabe von Beträgen geändert werden, kann dies über diesen Parameter gesteuert werden.

In einem solchen Fall sollte in der Datei appsettings.json im Applikationsverzeichnis des Web-Servers die folgende Änderung vorgenommen werden (ersetzen Sie den Wert 500 durch den gewünschten Wert):

"MaxNoteLength": "500"

Rechenblattdruck in neuem Fenster

Dieser Parameter wird in WiBe 2025 nicht mehr unterstützt.

Supportmeldungen

Bei der Internet Version kann mit dem Support Button unser WiBe Technik-Team kontaktiert werden. Im Intranet muss stattdessen ein interner Helpdesk kontaktiert werden. Die Kontaktdaten dazu werden als Text innerhalb des Supportbildschirms angezeigt. Der Text kann über diesen Parameter gesetzt werden.

In einem solchen Fall sollte in der Datei appsettings.json im Applikationsverzeichnis des Web-Servers die folgende Änderung vorgenommen werden:

"SupportMessage": "…"

Ist der Parameter gesetzt, wird der Text im Supportbildschirm angezeigt.

Zugriffsrechte beim Suchen prüfen

Standardmäßig werden beim Suchen nach Projekten alle passenden Projekte angezeigt und erst beim Öffnen werden die Zugriffsrechte des Benutzers geprüft. Alternativ kann bereits vor der Suche eine Prüfung erfolgen: es werden dann nur solche Projekte angezeigt, auf die der Benutzer Zugriff hat.

In einem solchen Fall sollte in der Datei appsettings.json im Applikationsverzeichnis des Web-Servers die folgende Änderung vorgenommen werden:

"CheckAccessWhileSearching": "true"

Ist der Parameter gesetzt, wird die Liste der gefundenen Projekte auf diejenigen Projekte reduziert, auf die der Benutzer Zugriff hat (Ausnahme ist die Liste der zuletzt benutzten Projekte).

Berechnungsbasis Monatsanfang

Standardmäßig geht WiBe Bau davon aus, dass der Stichtag (Starttag) einer Maßnahme grundsätzlich der erste Tag eines Monats ist. WiBe Bau berechnet deshalb Zeitdifferenzen bei monatlicher und jährlicher Zahlungsweise und für die Indexierung standardmäßig ab dem Monatsanfang, in dem die Zahlung beginnt. Dafür werden Beginn-/Enddaten bis zum 15. des Monats auf den Monatsanfang und Beginn-/Enddaten nach dem 15. auf den Monatsbeginn des Folgemonats umgerechnet.

Falls Maßnahmen dagegen beliebige Stichtage aufweisen können (wie im Leitfaden WU Hochbau), muss folgende Option gesetzt werden:

" datecorrection": "false"

Dieser Parameter ist nur bei WiBe Bau Installationen wirksam.

Dynamische Menüs

Dieser Parameter wird in WiBe 2025 nicht mehr unterstützt.

WiBe mit Active Directory Security betreiben

Normalerweise verwendet die WiBe Installation ein eigenes Sicherheitssystem mit einer eigenen Sicherheitsdatenbank, eigener Sessionverwaltung, etc. Im Intranet kann die WiBe mit einigen funktionellen Abstrichen (keine Verwendung von Gruppen, keine Auswahldialoge für Benutzer) auch mit der Sicherheit des Active Directories betrieben werden (automatisches Login mit dem aktuellen Windows Benutzer, keine Anlage von eigenen WiBe Benutzern notwendig).

Für einen solchen Betrieb ist die Umkonfiguration des virtuellen Webservers, in dessen Kontext die WiBe läuft, auf Windows Sicherheit notwendig.

In einem solchen Fall muss in der Datei appsettings.json im Applikationsverzeichnis des Web-Servers die folgende Änderung vorgenommen werden:

"security": "AD"

Damit erhält die WiBe die Anweisung für bestimmte Funktionen nicht auf das interne Sicherheitssystem zuzugreifen, sondern Ersatzlösungen zu benutzen.

Intranet-Warnung für IE einschalten

Dieser Parameter wird in WiBe 2025 nicht mehr unterstützt.

Automatische Notizen

Die WiBe Software kann bestimmte Änderungen in einem Projekt (derzeit die Änderung des Zinssatzes) automatisch in den Projektnotizen dokumentieren.

In einem solchen Fall kann in der Datei appsettings.json im Applikationsverzeichnis des Web-Servers die folgende Änderung vorgenommen werden:

"autonote": "true"

Wird der Wert von true auf false gesetzt, werden diese automatischen Einträge in die Notizen unterdrückt.

Namen für importierte WiBe21 Projekte

Beim Importieren wird die importierte Projektdatei normalerweise mit dem Projektnamen inklusive dem Importdatum benannt. Alternativ kann auch der Kurzident aus der WiBe21 verwendet werden.

In einem solchen Fall kann in der Datei appsettings.json im Applikationsverzeichnis des Web-Servers die folgende Änderung vorgenommen werden:

" ImportName": "KurzIdent"

Dieser Parameter ist nur für WiBe Professional und WiBe Enterprise Installationen wirksam.

Zugriffsprotokoll mit Modifikationskennzeichnung

Neben dem Namen und dem Zeitpunkt des Zugriffs eines Benutzers kann die WiBe auch die Unterscheidung mitschreiben, ob lesend oder schreibend auf ein Projekt zugegriffen wird. Während das Protokollieren beim normalen Zugriff nur beim Öffnen des Projekts erfolgt, muss bei der Protokollierung mit Modifikationskennzeichnung auch später noch geschrieben werden, was eine geringfügig schlechtere Performance bedeutet.

In einem solchen Fall kann in der Datei appsettings.json im Applikationsverzeichnis des Web-Servers die folgende Änderung vorgenommen werden:

" EnableModificationLog": "true"

Dieser Parameter ist nur für WiBe Professional und WiBe Enterprise Installationen wirksam.

Sperren der WiBe bei Wartungsarbeiten

Durch einen Parameter kann der Benutzer auf der Anmeldeseite der WiBe darüber informiert werden, dass die Applikation derzeit nicht benutzt werden kann. Zeitgleich werden die Textfelder für Benutzername und Kennwort ausgeblendet.

In einem solchen Fall kann in der Datei appsettings.json der Hinweistext für die Anmeldeseite festgelegt werden:

"ServiceMessage": "Derzeit Update-Arbeiten"

Mitschreiben der Dateneingaben

Durch diesen Parameter kann die Applikation die Kriterienauswahl und die Betragseingaben gemeinsam mit Benutzernamen und Datum/Zeit fortlaufend in einem Protokoll speichern. Das Protokoll kann in dieser Version nur vom WiBe Support verwendet werden, um Eingaben wiederherzustellen. In einem solchen Fall kann in der Datei appsettings.json die Tiefe des Protokolls festgelegt werden:

"LogLevel": "1"

Der Wert 1 legt fest, dass nur die Kriterienauswahl bzw. das Abwählen von Kriterien protokolliert werden. Wert 2 legt fest, dass auch die Betragseingaben für ein Kriterium protokolliert werden.

Dieser Parameter ist nur für WiBe Professional und WiBe Enterprise Installationen wirksam.

Löschen von Protokollen für Dateneingaben

Durch diesen Parameter kann eine maximale Anzahl an Tagen definiert werden, nach denen das Protokoll für die Kriterienauswahl und die Betragseingaben automatisch gelöscht werden. Wird der Parameter nicht festgelegt oder auf 0 gesetzt, wird keine automatische Löschung vorgenommen.

In einem solchen Fall kann in der Datei appsettings.json die Tiefe des Protokolls festgelegt werden:

"CleanLog": "90"

"90" entspricht hierbei der Aufbewahrungsfrist in Kalendertagen.

Dieser Parameter ist nur für WiBe Professional und WiBe Enterprise Installationen wirksam.

Löschen von Kriterien bei Neuauswahl

Durch diesen Parameter kann gewählt werden, ob beim Auswählen eines Kriteriums ("Haken setzen" vor dem Kriterium) alle bisherigen Eingaben gelöscht werden oder ob zuvor das Vorhandensein von Eingaben geprüft wird und diese erhalten werden sollen.

Dies ist vor allem wichtig, wenn zuerst ein Einzelkriterium und später dann die ganze Kriteriengruppe selektiert wird. Beim Wählen der Kriteriengruppe werden auch alle darunter befindlichen Einzelkriterien automatisch ausgewählt und dabei dort eventuell bereits vorhandene Eingaben gelöscht. Wird die Prüfung eingeschaltet, bleiben die zuvor gemachte Eingaben bei den Einzelkriterien erhalten.

Um die Prüfung einzuschalten (empfohlen), legen Sie in der Datei appsettings.json den folgenden Parameter fest:

"EnableCheck": "true"

Dieser Parameter ist nur für WiBe Professional und WiBe Enterprise Installationen wirksam.

Testmodus exklusiv für Administratoren

Durch Setzen dieses Parameters wird eine Meldung auf dem Anmeldeschirm neben dem Login eingeblendet und das Anmelden für Nicht-Administratoren verhindert. Um diesen Modus einzuschalten, legen Sie in der Datei appsettings.json den folgenden Parameter fest:

"TestMessage": "Derzeit steht die WiBe nur
Administratoren zur Verfügung."

Deaktivieren des Sicherheitssystems

Soll das Sicherheitssystem nur den Zugang zur WiBe Software überwachen, aber allen Benutzern Zugriff auf alle Projekte gewähren, so können die untenstehenden Parameter gesetzt werden. Um diesen Modus einzuschalten, legen Sie in der Datei appsettings.json den folgenden Parameter fest:

"WiBe2011ReadCompatible": "true"

"WiBe2011WriteCompatible": "true"

Dieser Parameter ist nur für WiBe Professional und WiBe Enterprise Installationen wirksam.

Standardgröße für Notizen ohne Schriftgröße

Dieser Parameter wird in WiBe 2025 nicht mehr unterstützt.

Maximale Größe von Suchergebnissen

Um in großen WiBe Installationen die Antwortzeit von Suchen zu verbessern, liefern Auflistungen von Projekten und Maßnahmen nur eine limitierte Anzahl an Ergebnissen – standardmäßig die ersten 100 Projekte. Sollen weitere Projekte gefunden werden, muss durch weiter Eingaben die Suche zielgenauer formuliert werden. Alternativ kann der Administrator die Anzahl der standardmäßig angezeigten Projekte erhöhen.

"MaxResultCounter": "100"

Prüfen auf mehrfache Auswahl von Kriterien

Werden Kriterien in einem Projekt oder einer Maßnahme ausgewählt, werden für diese die Eingabefenster für Betragseingaben leer vorbereitet. Wird zuerst ein Kriterium ausgewählt, die Beträge eingegeben und dann später nochmals ein darüberliegender Gliederungspunkt ausgewählt (der zu einer neuerlichen Auswahl des Kriteriums führt), würden die bisherigen Betragseingaben verworfen werden. Dieses Verhalten kann verändert werden, in dem dieser Parameter in die appsettings.json eingesetzt wird.

"EnableCheck": "true"

Ausblenden 'Qualitative Kriterien' Bericht (Lang)

Standardmäßig ist ein Bericht zum Ausdrucken der qualitativen Kriterien im Drucken Bildschirm vorhanden, der auch Texte zur Erklärung der Kriterien enthält. Dieser Bericht kann ausgeblendet werden. Dieses Verhalten kann erzwungen werden, in dem dieser Parameter in die appsettings.json eingesetzt wird.

"quallang": "true"

Ausblenden 'Qualitative Kriterien' Bericht

Standardmäßig ist ein Bericht zum Ausdrucken der qualitativen Kriterien im Drucken Bildschirm vorhanden, der nur die Übersicht der Kriterien, aber keine Erklärung zu den Kriterien enthält. Dieser Bericht kann ausgeblendet werden. Dieses Verhalten kann erzwungen werden, in dem dieser Parameter in die appsettings.json eingesetzt wird.

"qualkurz": "false"

Zugriffsrechte

Die Software regelt in der Datei wibe.access im Anwendungsverzeichnis, auf welche Funktionen der Software eine Rolle Zugriff hat. Die Datei ist eine JSON Datei, die mit einem Texteditor geändert werden kann.

Geändert werden sollten nur die Einträge nach dem Eintrag <claims>. Dort ist für jede geschützte Funktion ein Knoten vorhanden z.B. für die Funktion Neues Projekt anlegen (die meisten Knoten sind selbsterklärend bezeichnet)

</MenuProjekteNeuesProjekt>

Zwischen dem öffnenden und schließenden Tag stehen die Rollen, die Zugriff auf diese Funktion erhalten dürfen. Die Schreibweise der Rollen im Attribut name muss exakt mit den Rollen im Sicherheitssystem übereinstimmen.

Werden neue Rollen angelegt, können diese ebenfalls verwendet werden. Sie sollten jedoch zuvor im Abschnitt Roles der wibe.access aufgelistet werden.