Configuration Explorer

Der Barthauer Configuration Explorer dient der einheitlichen und zentralen Verwaltung aller Voreinstellungen des Systems in der BaSYS Masterdatenbank. Damit werden die Voreinstellungen datenbankübergreifend in Form standardisierter XML-Dokumente vorgehalten. Die Voreinstellungen können innerhalb einer vorgegebenen Gruppeneinteilung nach Fachbereichen und Komponenten in Form einer frei definierbaren hierarchischen Ordnerstruktur verwaltet werden. Innerhalb dieser Strukturen können Voreinstellungsdokumente erstellt, bearbeitet und gelöscht werden. Der Configuration Explorer besitzt eine integrierte Schnittstelle für den Import und / oder Export aller XML-Dokumente. Aufruf aus Gruppe Allgemein der klassischen Barthauer Management Console.

Abschnitte der Hilfe

In der Hilfe werden folgende Abschnitte beschrieben:

Gruppen des Configuration Explorer

So geht's

In diesem Abschnitt der Hilfe werden empfohlene Arbeitsweisen beschrieben.

Systemdokument --> Anwenderdokument

Über die im Folgenden beschriebenen Arbeitsweisen kann ein Systemdokument in ein Anwenderdokument umgewandelt werden:

Dokument duplizieren

Um ein Dokument geringfügig an abweichende Anforderungen anzupassen, kann ein in Frage kommendes Dokument dupliziert und dann bearbeitet werden.

So geht's:

Neues Dokument

Um ein Dokument neu zu konzipieren, ist es sinnvoller, eine Vorlage zu nutzen.

So geht's:

Vorlagen einblenden

Die Vorlagen können auch eingeblendet werden, um sie bei Bedarf in Dokumente umzuwandeln.

So geht's:

Verwendung der BCE-Dateien

Jedes Dokument des Barthauer Configuration Explorers kann als sogenannte BCE Datei exportiert und / oder importiert werden.

• Die konfigurierten Zugriffsrechte der BCE-Dokumente können mit exportiert und importiert werden, wenn der Benutzer das Recht zur Vergabe dieser Rechte hat (also "Administrator" ist).

• Die BCE Datei ist eine gepackte XML Datei, die auf der Verzeichnisstruktur des Rechners oder Netzwerks abgelegt ist.

• Die automatische Benennung erfolgt über die Konvention "{Dokumentname}.bce".

• Der Speicherplatz einer BCE Datei ist gegenüber der darin gepackten XML Datei erheblich reduziert.

• Die gepackten XML Dateien werden über ein Komprimierungsprogramm, beispielsweise WinRar, geöffnet und / oder entpackt.

Export von BCE-Objekten

Für die Daten des Configuration Explorers werden drei verschiedene Exportfunktionen genutzt.

Dokument exportieren:

Exportfunktion:

• Das gewählte Dokument wird als separate BCE-Datei exportiert.

Ordner exportieren:

Exportfunktion:

• Der gewählte Ordner wird mitsamt der untergeordneten Verzeichnisstruktur exportiert.

• Alle zugehörigen Dokumente werden in Form von XML-Dateien abgelegt.

Auto-Update der Masterdatenbank:

Exportfunktion:

• Die gesamte Verzeichnisstruktur aller BCE-Gruppen wird exportiert.

• Alle zugehörigen Dokumente werden in Form von XML-Dateien abgelegt.

• Der gesamte Exportumfang wird in eine ZIP-Datei gepackt.

BCE-Rechte exportieren / importieren

Die konfigurierten Zugriffsrechte der BCE-Dokumente können mit exportiert und importiert werden, wenn der Benutzer Administrator-Rechte hat.

Dies betrifft den Export/Import von Ordnern und Einzeldokumenten.

• Beim Export eines Ordners, wird dabei eine Datei metadata.xml pro Ordner exportiert, die die Rechte enthält.

• Beim Export von Einzeldokumenten wird diese metadata-Datei in das BCE-Dokument mit eingepackt.
  Exportiert man das Dokument als XML_Datei , wird eine zweite XML-Datei mit dem Suffix _metadata.xml exportiert.

• Es werden nur "direkte" Rechte exportiert, also nur wenn konkret auf einem zu exportierenden Objekt Rechte festgelegt wurden. Eine Vererbung der Rechte wird nicht beachtet!
   

• Import-Dokumente werden immer neu angelegt, daher werden auch die konkreten Rechte importiert.

• Beim Import von Ordnern verhält es sich anders. Hier ist es möglich zu "mergen", Ordner mit gleichem Namen auf gleicher Ebene werden demnach ineinander integriert (wie im Windows-Explorer). In diesem Fall werden die Rechte addiert: die Quelle die für einen Benutzer "höhere" Rechte hat, gewinnt.

Import von Duplikaten

Vor dem Import eines Dokumentes wird automatisch überprüft, ob auf dem gewählten Ordner der Dokumentenverwaltung ein gleichartiges Dokument (gleiche ID und / oder gleicher Name) vorhanden ist.

Identische ID

Es wird die Meldung "Ein Dokument mit gleicher ID wurde gefunden. ..." angezeigt.

• Bei Wahl von <Ja> behält das alte Dokument seine ID. Das importierte Dokument erhält eine neue ID.

• Bei Wahl von <Nein> erhält das alte Dokument eine neue ID. Das importierte Dokument behält die alte ID.

• Bei Wahl von <Abbrechen> wird das Dokument nicht importiert.

• Es erfolgt keine Meldung.

• Das gesperrte Dokument / Systemdokument mit der identischen ID bleibt unverändert erhalten.

• Das importierte Dokument wird in ein Anwenderdokument umgewandelt.

Identische Bezeichnung

1. Meldung: "Es existiert schon ein Dokument mit dem Namen {Name}. ...".

2. Namensvorschlag: [Importiert] {Name}.

3. Bestätigung des Namensvorschlags oder Eingabe eines eindeutigen neuen Namens.

Identische ID und Bezeichnung

Bei Dokumenten mit identischer ID und Bezeichnung wird zuerst die ID, dann die Bezeichnung angepasst.

Automatische Sicherung der Masterdatenbank (Auto-Update)

Diese Form der Datensicherung wird automatisch vom System angeboten, sobald im System Manager eine Masterdatenbank angemeldet wird, die eine veraltete Version besitzt.

Gesperrte Anwenderdokumente

Falls sich in der Masterdatenbank gesperrte benötigte Anwenderdokumente befinden, ist die automatische Sicherung unbedingt durchzuführen. Andernfalls gehen diese Dokumente unwiederbringlich verloren.

Automatischer Aufruf

Das Auto-Update der Masterdatenbank wird in folgenden Fällen automatisch aufgerufen:

• Ein Update von BaSYS 8 wurde installiert. BaSYS 8 wird danach das erste Mal gestartet.

• Eine Masterdatenbank älterer Version wird im System Manager auf aktuell gesetzt.

Auto-Update-Formular

Nach der Initialisierung des Auto-Updates öffnet sich automatisch das Auto-Update-Formular. Die wichtigsten Schritte sind:

1. Sicherung der Masterdatenbank über SQL Server oder Oracle Funktionalität (siehe Hilfe zum System Manager)

2. Die Aktualisierung der Masterdatenbank wird gestartet (siehe Hilfe zum System Manager)

3. Meldung:
   Vor dem automatischen Update der Master-Datenbank wird DRINGEND empfohlen, Ihre BCE-Dokumente durch einen Export zu sichern. Nach Bestätigung dieser Meldung haben Sie die Gelegenheit, diesen Export durchzuführen.

4. Per Klick auf <OK> wird der Explorer zur Ablage der Sicherungsdatei geöffnet.

5. Die Masterdatenbank wird aktualisiert und angemeldet (siehe Hilfe zum System Manager).

Die Sicherung kann alternativ manuell durchgeführt werden (siehe zugehörigen Abschnitt):

Gepackte Sicherungsdatei

Die gepackte Sicherungsdatei wird über das Auto-Update der Masterdatenbank generiert.

In der Sicherungsdatei werden alle Objekte des Barthauer Configuration Explorers (Ordner und Dokumente) automatisch gesichert. Dabei bleibt die gesamte Verzeichnisstruktur der bisherigen Masterdatenbank erhalten. Die Objekte werden als ZIP Datei gepackt.

Die gepackte Sicherungsdatei wird auf folgendem Pfad gespeichert:

• {Pfad}\Programme\Barthauer\BaSYS...\config\Updates\DatabaseFiles\Master\

Bezeichnung der Sicherungsdatei

Die automatische Bezeichnung der Update-Datei wird nach folgender Konvention generiert:

Konvention:	Backup_BCE_	JJJJ	MM	TT	hh	mm	.zip
Beispiel:	Backup_BCE_	2010	01	15	15	01	.zip

Import in die neue Masterdatenbank

Gesperrte Anwenderdokumente werden beim Auto-Update nicht in die neue Masterdatenbank übernommen.

Die Dokumente sind nach Abschluss des Auto-Updates manuell aus der Sicherungsdatei in die neue Masterdatenbank zu importieren.

Alle anderen Objekte (Ordner und Dokumente) werden beim Auto-Update automatisch in die neue Masterdatenbank übernommen.

Struktur nach dem Auto-Update

Das Auto-Update ändert die Struktur der Dokumentenverwaltung im Configuration Explorer gemäß der Nutzungsart der Ordner und Dokumente:

Alle Anwenderobjekte (Ordner und Dokumente) bleiben in der MDB erhalten.

Alle gleichnamigen Dokumente, die sich auf dem selben Ordner befinden, erhalten die Präfixe [Alt], [Alt 1], [Alt 2], ...

Alle gesperrten Anwenderobjekte (Ordner und Dokumente) sind gelöscht.

Gesperrte Anwenderdokumente, die während des Auto-Updates gesichert werden, können nach dem Auto-Update importiert werden.

Alle Systemobjekte (Ordner und Dokumente) sind gelöscht und durch die neuen System-Objekte ersetzt worden.

Manuelle Sicherung der Masterdatenbank (Start des BCE über Windows)

Folgende Schritte sind erforderlich:

1. Klick auf die Windows Schaltfläche <Start>. Aufruf der Funktion <Ausführen>.

2. Eingabe des Befehls:

   " + Pfad des BCE	BCE.exe + " + Leerzeichen	Parameter	Sicherungspfad
   "{Pfad}\Barthauer\BaSYS{Version}\bin\	BaSYS.Management.ConfigurationExplorer.exe"	ExportMDBFileTo=	{Pfad}
   "C:\Programme\Barthauer\...\bin\	BaSYS.Management.ConfigurationExplorer.exe"	ExportMDBFileTo=	C:\SicherungMDB\

   Beispiel

3. Nach Klick auf <OK> wird die gepackte Sicherungsdatei <DocumentData.zip> automatisch auf dem Sicherungspfad gespeichert.

4. Benennung der Sicherungsdatei sollte gemäß der Konvention für automatisch generierte Sicherungsdateien.  

5. Der Configuration Explorer startet.

Wichtige Hinweise

Die an dieser Stelle beschriebenen Hinweise sollten unbedingt beachtet werden.

Dokumente

Jedes Dokument repräsentiert eine Abfrage, einen Bericht, ein Modell und Ähnliches.

• Dokumente werden in der Masterdatenbank gespeichert und werden von dort aus automatisch in die gerade aktuelle BaSYS Datenbank übertragen.

Eindeutigkeit

Anwenderobjekte können unter Einhaltung der Eindeutigkeit beliebig bezeichnet werden. Bei folgenden Aktionen ist auf die Eindeutigkeit der Bezeichnung zu achten:

• Umbenennen von Objekten.

• Anlegen neuer Objekte (Ordner / Dokumente).

• Verschieben von Objekten per Drag & Drop.

• Import von Objekten (siehe Abschnitt So geht's).

Sobald die Eindeutigkeit der Bezeichnung verletzt ist, wird eine Warnmeldung ausgegeben. Die gewünschte Aktion kann dann nicht durchgeführt werden.

Da die Bezeichnung der Systemobjekte (Ordner oder Dokumente) gesperrt ist, kann nur der Import gleichnamiger Objekte die Eindeutigkeit verletzen (siehe Abschnitt So geht's).

Beim Import in den Configuration Explorer kann außerdem die Eindeutigkeit der internen ID verletzt werden. Weitere Details werden im Abschnitt So geht's beschrieben.

Benutzeroberfläche

Die Benutzeroberfläche wird in der folgenden schematischen Übersicht zusammenfassend beschrieben. Von dort führen Links zu den einzelnen Elementen weiter:

Objekte

Die Objekte des Configuration Explorers werden im Bereich Dokumente der gewählten Gruppe verwaltet.

• Jedes Dokument wird als XML Datei gespeichert.

• Alle Anwenderobjekte können per Drag & Drop beliebig verschoben werden.

• Per Klick mit der rechten Maustaste auf ein Objekt wird dessen Kontextmenü angezeigt.

• Über den Filter können sehr schnell die gesuchten Dokumente gefunden werden.

Die verwalteten Objekte (Ordner und Dokumente) besitzen eine Objektart (siehe linke Tabelle) und eine Nutzungsart (siehe rechte Tabelle). Die Kombination dieser Attribute wird intuitiv über das Objektsymbol deutlich:

	Objektart	-	Nr.		Nutzungsart	1	2	3	4
	Ordner		1		Systemobjekt
	Standarddokument		2		Anwenderobjekt
	Aktualisierungsabfrage		3		Gesperrtes Objekt
	Vorlagedokument		4		Aktuell gesetztes Objekt			--

Aktualisierungsabfrage

Die Aktualisierungsabfrage verändert den Inhalt der Datenbank! Deshalb ist sie über ihr spezielles Symbol sofort erkennbar.

• Jede Tabellarische Ersetzung ist eine Aktualisierungsabfrage.

• Aktualisierungsabfragen der Gruppe Benutzerdefinierte Abfragen (Siehe zugehörige Hilfe) können über Bearbeiten in informative Abfragen umgewandelt werden.

Vorlagedokument

Zur Erstellung eines neuen Dokumentes muss auf ein Vorlagedokument zugegriffen werden.

• Die Vorlagedokumente werden in der Baumstruktur gemeinsam mit den Dokumenten verwaltet.

• Die Schaltfläche Vorlagen anzeigen / ausblenden wechselt zwischen der Anzeige der Vorlagen und Dokumente.

• Gesperrte Dokumente können in Vorlagedokumente umgewandelt werden, bleiben aber gesperrt.

• Vorlagedokumente können wieder in Dokumente umgewandelt werden.

Systemobjekt

Systemobjekte (Ordner, Dokument) werden durch das BaSYS Update automatisch in die Masterdatenbank übernommen.

• Ein Systemobjekt ist immer gesperrt.

• In Systemordnern können beliebige Objekte - auch Anwenderobjekte - verwaltet werden. Zum Systemordner gehörende Anwenderobjekte (Ordner / Dokumente) sind gut geschützt, da sie nicht versehentlich - durch das Löschen des Ordners - entfernt werden können.

• Systemdokumente können in Anwenderdokumente überführt werden.

Anwenderobjekt

Anwenderobjekte (Ordner, Dokument) und deren Inhalt können vom Benutzer beliebig verändert werden, falls er dazu die entsprechenden Berechtigungen besitzt.

• Anwenderobjekte können in der Baumstruktur beliebig per Drag & Drop verschoben werden. Beim Verschieben in einen anderen Ordner wird automatisch auf eine eindeutige Bezeichnung geprüft.

• Anwenderordner können nicht die Stelle des Hauptordners einnehmen. Hauptordner ist immer der Systemordner, beispielsweise <Modell-Dokumente>.

• Systemdokumente können in Anwenderdokumente überführt werden.

Gesperrtes Objekt

Das gesperrte Objekt (Ordner, Dokument) und sein Inhalt können nicht editiert werden.

• Systemobjekte (Ordner oder Dokumente) sind immer gesperrt.

• Anwenderobjekte können über Werkzeugleiste oder Kontextmenü gesperrt und entsperrt werden.

• Gesperrte Dokumente / Vorlagen können in gesperrte Vorlagen / Dokumente umgewandelt werden, ohne dass die Sperrung vorher zurückgenommen werden muss.

Aktuell gesetztes Objekt

Für bestimmte Anwendungen kann ein Objekt (Ordner, Dokument) auf aktuell gesetzt werden.

• Ordner werden automatisch auf aktuell gesetzt, wenn sie zum Pfad auf das aktuell gesetzte Dokument gehören. Ein direktes aktuell Setzen ist nicht möglich.

• Das Symbol unterscheidet nicht zwischen System-Objekt und Anwender-Objekt.

Verwaltungswerkzeuge

Die Werkzeuge zur Verwaltung befinden sich in der oberen Werkzeugleiste des Configuration Explorers. Die Werkzeuge werden für alle Gruppen genutzt.

• Die Werkzeuge entsprechen den Menüpunkten des Kontextmenüs.

• Je nach Status des gewählten Objekts (Ordner oder Dokument) stehen nur bestimmte Werkzeuge zur Verfügung. Die anderen Werkzeuge sind dann ausgegraut.

Folgende Werkzeuge sind einsetzbar:

●		Neues Dokument erstellen
●		Neuen Ordner erstellen
●		Zu Vorlagedokument umwandeln
●		Zu Dokument umwandeln
●		Verknüpfung erstellen
●		Objekt umbenennen
●		Objekt löschen
●		Dokument duplizieren
●		In Dokument kopieren
●		Datenbankzugriff aktualisieren
●		Anzeige der Vorlagedokumente ein- / ausschalten
●		Ausgeblendete Gruppen anzeigen
●		Dokumente importieren
●		Dokument exportieren
●		Ordner mit Objekten exportieren
●		Ordner mit Objekten importieren
●		Globale Sicherheit (Siehe separate Hilfe)
●		Objekt sperren / entsperren
●		Objektbeschreibung / Tooltipp
●		XML-Ansicht
●		Verknüpfung erstellen
●		Automatisches Ausführen von BCE-Dokumenten und Export
●		Aufruf dieser Hilfe

Neues Dokument erstellen

Auf dem gewählten Ordner wird ein neues Dokument angelegt. Über die Funktion wird ein Formular zum Anlegen des neuen Dokumentes geöffnet.

So geht's:

3. Wahl der gewünschten Vorlage.

6. Das Dokument kann per Drag & Drop innerhalb der Dokumentenverwaltung verschoben werden.

Neuen Ordner erstellen

Unter dem gewählten Ordner wird ein neuer Anwenderordner angelegt.

So geht's:

4. Der Ordner kann per Drag & Drop innerhalb der Dokumentenverwaltung verschoben werden.

Zu Vorlage umwandeln

Die gewählten Dokumente werden zu Vorlagedokumenten. Die Funktionalität hängt vom gewählten Objekt (Ordner oder Dokument) ab.

Ordner

Die Dokumente des gewählten Ordners werden zu Vorlagedokumenten umgewandelt.

Vorsicht! Die Dokumente aller Unterordner werden ebenfalls Vorlagen.

So geht's:

Dokument

Das gewählte Dokument wird zum Vorlagedokument umgewandelt.

So geht's:

Zu Dokument umwandeln

Die gewählten Vorlagedokumente werden zu Dokumenten. Die Funktionalität hängt vom gewählten Objekt (Ordner oder Dokument) ab.

Ordner

Die Vorlagen des gewählten Ordners werden zu Dokumenten umgewandelt.

Vorsicht! Die Vorlagen aller Unterordner werden ebenfalls Dokumenten.

So geht's:

Vorlage

Die gewählte Vorlage wird zum Dokument umgewandelt.

So geht's:

Dokument / Ordner umbenennen

Das gewählte Objekt (Ordner oder Dokument) kann umbenannt werden. Die Bezeichnung wird durch farbliche Hinterlegung als editierbar angezeigt. Die Funktionalität ist auch über <F2> verfügbar.

So geht's:

4. Per Klick auf <Enter> oder auf ein anderes Objekt wird die neue Bezeichnung gespeichert.
   Per Klick auf <Esc> wird die Umbenennung ohne Speichern abgebrochen.

Dokument / Ordner löschen

Das gewählte Anwenderobjekt (Ordner oder Dokument) wird gelöscht. Vor dem Löschen des Objekts wird eine Warnmeldung ausgegeben.

Vorsicht bei Ordnern! Es werden alle Unterordner und darin verwalteten Dokumente gelöscht.

So geht's:

Dokument duplizieren

Jedes Dokument innerhalb der Baumstruktur kann dupliziert werden.

So geht's:

3. Klick auf <OK>, um das duplizierte Dokument zu speichern.
   Bei Klick auf <Abbrechen> wird kein Duplikat erzeugt.

5. Das Duplikat kann per Drag & Drop innerhalb der Dokumentenverwaltung verschoben werden.

In Dokument kopieren

Zugehöriges Symbol

Zurück

Mit der Funktion "In Dokument kopieren" ist es möglich, den Inhalt eines Dokumentes mit dem Inhalt eines anderen Dokumentes zu überschreiben, wobei die Identität (Id) von beiden Dokumenten gleich bleibt. Dadurch können alle Dokument-Verweise in anderen Applikationen erhalten bleiben und der Inhalt trotzdem auf einfache Weise aktualisiert werden.

Datenbankzugriff aktualisieren

Der Datenbankbezug aller Dokumente wird aktualisiert. Über die Schaltfläche der Werkzeugleiste werden alle Informationen des Configuration Explorers neu aus der Masterdatenbank eingelesen. Die Anzeige wird gegebenenfalls aktualisiert.

Anzeige der Vorlagen ein- / ausschalten

Umschalten zwischen Anzeige der Vorlagen und Anzeige der Dokumente. Über die Schaltfläche der Werkzeugleiste wird in der Baumstruktur der Dokumentenverwaltung zwischen der Anzeige der Dokumente und Vorlagen gewechselt. Der aktuelle Status der Anzeige ist über die Hintergrundfarbe des Symbols erkennbar.  

Ausgeblendete Gruppen anzeigen

Standardmäßig sind die Gruppen des Configuration Explorers ausgeblendet, die in andere BaSYS-Module eingebunden sind - wie die Gruppe Dokumenten-Management in den System Manager. Das dargestellte Symbol ermöglicht den Zugriff auf die ausgeblendeten Gruppen.

So geht's:

Dokumente importieren

In den gewählten Ordner werden Dokumente aus BCE und / oder XML Dateien importiert. Die Funktionalität unterstützt den Import einer oder mehrerer Dateien.

So geht's:

3. Dadurch wird automatisch der Explorer zur Wahl der Importquelle geöffnet. Dabei ist das Layout des Explorer-Formulars vom eingerichteten Betriebssystem abhängig.

4. In der relevanten Auswahlliste des Explorer-Formulars ist standa rdmäßig der Dateityp BCE-Dateien (*.bce,*.xml) eingestellt. Über Alle Dateien (*.*) wird nicht nach Dateityp gefiltert.

5. Das Importdokument ist über die Explorer-Funktionalität zu wählen. Die Mehrfachwahl ist möglich. Das gewählte Dokument / die gewählten Dokumente werden automatisch im Feld <Dateiname> gelistet, das sich links neben der Dateityp-Auswahlliste befindet.

6. Der Import wird durch Klick auf <Öffnen> gestartet.
   Bei Klick auf <Abbrechen> wird kein Import durchgeführt.

7. Auf Duplikate (einem schon im Configuration Explorer vorhandenen Dokument) wird automatisch je Dokument durch eine Meldung hingewiesen. Weitere Details werden im zugehörigen Abschnitt dieser Hilfe beschrieben.

9. Die importierten Dokumente können per Drag & Drop innerhalb der Dokumentenverwaltung verschoben werden.

Dokument exportieren

Das gewählte Dokument wird standardmäßig als stark komprimierte BCE-Datei exportiert. Die Wahl anderer Dateitypen wie XML ist alternativ möglich.

So geht's:

3. Dadurch wird automatisch der Explorer zur Wahl des Exportziels geöffnet. Dabei ist das Layout des Explorer-Formulars vom eingerichteten Betriebssystem abhängig.

4. In der relevanten Auswahlliste des Explorer-Formulars ist standardmäßig der Dateityp BCE-Dateien (*.bce) eingestellt. Dieser Dateityp wird für den Export empfohlen, da die Datei automatisch erheblich komprimiert wird. Alternativ kann der Dateityp XML-Dateien (*.xml) oder Alle Dateien (*.*) über die Auswahlliste gesetzt werden.

5. Der Zielordner ist über die Explorer-Funktionalität zu wählen.

6. Der Dateiname wird automatisch im gleichnamigen Feld eingetragen und kann bei Bedarf editiert werden.

7. Der Export wird durch Klick auf <Speichern> gestartet.
   Bei Klick auf <Abbrechen> wird kein Export durchgeführt.

8. Die abschließende Meldung "Exportvorgang abgeschlossen" kann per Klick auf <OK> geschlossen werden.

Ordner mit Objekten exportieren

Der gewählte Ordner wird einschließlich aller Objekte (Ordner und Dokumente) exportiert. Dabei behalten die Dokumente ihr XML-Format, werden also nicht komprimiert.

So geht's:

3. Dadurch wird automatisch der Explorer zur Wahl des Exportziels geöffnet. Dabei ist das Layout des Explorer-Formulars vom eingerichteten Betriebssystem abhängig.

4. Bei Bedarf kann die Schaltfläche Neuen Ordner erstellen genutzt werden.

5. Das Exportziel ist über die Explorer-Funktionalität zu wählen.
   Vorsicht! Falls im Exportziel gleichnamige Objekte (Ordner und XML Dateien) existieren, erfolgt keine Warnung!

6. Der Export wird durch Klick auf <OK> gestartet.
   Bei Klick auf <Abbrechen> wird kein Export durchgeführt.

7. Die abschließende Meldung "Exportvorgang abgeschlossen" kann per Klick auf <OK> zu geschlossen werden.

Ordner mit Objekten importieren

Der gewählte Ordner wird einschließlich aller BCE-Objekte (Ordner und Dokumente) importiert.

So geht's:

3. Dadurch wird automatisch der Explorer zur Wahl der Importquelle geöffnet. Dabei ist das Layout des Explorer-Formulars vom eingerichteten Betriebssystem abhängig.

4. Um die Objekte vor dem Import benutzerdefiniert zu organisieren, kann die Schaltfläche Neuen Ordner erstellen genutzt werden.

5. Der Quellordner ist über die Explorer-Funktionalität zu wählen.
   Hinweis: Für den Import werden die Dateitypen *.bce und *.xml berücksichtigt.

6. Der Import wird durch Klick auf <OK> gestartet.
   Bei Klick auf <Abbrechen> wird kein Import durchgeführt.

7. Beim Import eines Ordners mit schon vorhandener Bezeichnung wird ein Formular zum Editieren / Bestätigen einer automatisch vorgeschlagenen Ersatzbezeichnung geöffnet.

8. Auf Duplikate (einem schon im Configuration Explorer vorhandenen Dokument) wird automatisch je Dokument durch eine Meldung hingewiesen. Weitere Details werden im zugehörigen Abschnitt dieser Hilfe beschrieben.

9. Die importierten Dokumente können per Drag & Drop innerhalb der Dokumentenverwaltung verschoben werden.

Objekt sperren / entsperren

Das gewählte Objekt (Ordner oder Dokument) wird je nach Status gesperrt oder entsperrt. Dadurch wird versehentliches Löschen verhindert.

So geht's:

Objektbeschreibung

Für das gewählte Anwenderobjekt (Ordner oder Dokument) kann eine Beschreibung eingegeben werden. Die Beschreibung wird gespeichert und beim Überfahren mit der Maus als Tooltipp angezeigt.

So geht's:

1. Wahl des Objektes (Ordner oder Dokument).

4. Jetzt wird der eingegebene Text als Tooltipp angezeigt, wenn das Objekt mit der Maus überstrichen wird. Dies ist auch dann möglich, wenn das Objekt nachträglich einen Schreibschutz erhält.

Verknüpfung erstellen

Über die Funktion Verknüpfung erstellen können Abfragen und Berichte automatisch ohne Benutzerinteraktion über eine BCE-Verknüpfung ausgeführt werden.

So geht's:

Automatisches Ausführen von BCE-Dokumenten und Export

Abfragen (DML-Abfragen werden nicht unterstützt) können über Verknüpfung erstellen automatisch ausgeführt und exportiert werden.

Dazu wird die Verknüpfungsdatei editiert und weitere Parameter eingefügt.

So geht's

Folgende Export-Formate werden unterstützt:

Beispiel:

"C:\Program Files (x86)\Barthauer\BaSYS\bin\Barthauer.Applications.BaSYS.Management.ConfigurationExplorer.exe" BCEDocumentId="df854603-33f6-4c63-954a-0c386d44e78b" ExportFormat="CSVWithoutHeaders" ExportFilePath="C:\Temp\MeinDateiname.csv"

XML-Ansicht

Über die XML-Ansicht kann der Aufbau jedes Benutzerdokuments kontrolliert werden.

So geht's:

Objektwerkzeuge

Die Objektwerkzeuge befinden sich in der unteren Werkzeugleiste des Configuration Explorers. Die Werkzeuge werden für das gewählte Objekt (Ordner, Dokument) genutzt.

• Die Werkzeuge gehören zum jeweiligen Dokument. Nur das Werkzeug Sicherheit kann auch für Ordner genutzt werden.

• Die Werkzeuge entsprechen den Menüpunkten des Kontextmenüs.

• Je nach Status des gewählten Objekts (Ordner oder Dokument) stehen nur bestimmte Werkzeuge zur Verfügung. Die anderen Werkzeuge sind dann ausgegraut.

Folgende Werkzeuge sind einsetzbar:

●

Be

Filter auf BCE-Dokumente

●		Dokumentfunktion ausführen
●		Dokument aktuell setzen / übernehmen
●		Dokument bearbeiten
●		Sicherheit (Siehe separate Hilfe)
●		Sicherheit
●		Sicherheit

Filter auf BCE-Dokumente

Filter auf gesuchte Dokumente. Der Filter besitzt folgende Funktionen:

• Die Ordner werden ausgeblendet.

• Es werden die Dokumente angezeigt, die den Filterkriterien genügen.

• Der Filter wird für alle Gruppen des Configuration Explorers aktiviert.

• Für die gewählte Gruppe wird die Zahl der gefilterten Dokumente auf der Gruppenschaltleiste ausgegeben. So kann bei der Navigation zwischen den Gruppen sofort gesehen werden, ob die jeweilige Gruppe mindestens ein gesuchtes Dokument enthält.

Filterkriterien

Der Filter nutzt folgende Filterkriterien:

• Keine Unterscheidung zwischen Groß- und Kleinschreibung.

• Die Bezeichnung des jeweiligen Dokumentes wird nach dem eingegebenen Begriff durchsucht. Der gesuchte Begriff kann sich also auch innerhalb der Dokumentbezeichnung befinden.

Setzen eines Filters

So geht's:

1. Klick in das Filterfeld.

2. Eingabe der Zeichenfolge, nach der gesucht wird. Auf Groß- und Kleinschreibung braucht dabei nicht geachtet werden.

3. Synchron zur Eingabe wird automatisch auf die Dokumente gefiltert, welche die gesuchte Zeichenfolge im Namen enthalten. Alle Ordner werden automatisch verborgen.

4. Die Zahl der gefundenen Objekte wird in der Gruppenleiste ausgegeben.

Löschen eines Filters

So geht's:

1. Klick in das Filterfeld.

2. Markieren des Suchtextes über die Taste <F2> oder die Tastenkombination <Strg> <a>.

3. Löschen des Suchtextes über die Taste <Entf> oder die Tastenkombination <Strg> <x>.

4. Jetzt sind wieder alle Ordner und Dokumente in ihrer hierarchischen Struktur zu sehen.

Dokumentfunktion ausführen

Die Abfrage der BaSYS Datenbank, die im gewählten Dokument definiert ist, wird ausgeführt. Die Funktionalität wird für folgende Gruppen des Barthauer Configuration Explorers genutzt:

• Berichtsmanager

• Benutzerdefinierte Abfragen

• Längsschnittdefinition

• Tabellarische Ersetzung

Die Dokumente der anderen Gruppen werden entweder aktuell gesetzt oder über Bearbeiten (Vermessungspunkte) ausgeführt.

Die Ergebnisse der ausgeführten Abfrage werden als Bericht, als Tabelle oder als Längsschnitt (BaSYS Plan) ausgegeben.

Dokument aktuell setzen / übernehmen

Das gewählte Dokument wird auf aktuell gesetzt. Die Funktionalität wird für die grafische Ausgabe der BaSYS Daten und für die Nutzung einer Abfrage als Filter gebraucht.

Aufruf im Configuration Explorer

In folgenden Gruppen des Barthauer Configuration Explorers muss genau ein Dokument auf aktuell gesetzt sein:

• Legendendefinition (von Längsschnitten)

• Modelle (BaSYS Plan oder Visor)

• Voreinstellung (BaSYS Plan oder Visor)

Die Dokumente der anderen Gruppen werden ausgeführt, bei Vermessungspunkten über Bearbeiten.

Aufruf aus anderen Applikationen

Der Barthauer Configuration Explorer kann aus anderen BaSYS Applikationen zur Definition eines Filters aufgerufen werden. Der Filter wird durch Klick auf das gezeigte Symbol aktiviert.

Dokument bearbeiten

Das gewählte Dokument wird für die Bearbeitung geöffnet. Die Funktionalität der zugehörigen Benutzeroberfläche hängt von der Art des Dokumentes (wie Abfrage oder Modell) ab.

• Die Funktionalität wird in der Hilfe zur relevanten Gruppe des BCE beschrieben.

• Gesperrte Dokumente können nicht bearbeitet werden. Die Sperrung kann durch Duplizieren oder Entsperren aufgehoben werden.

Kontextmenü

Das Kontextmenü ist für alle Gruppen des Barthauer Configuration Explorers einheitlich in die Dokumentenverwaltung integriert.

• Per Klick mit der rechten Maustaste auf ein Objekt (Ordner oder Dokument) wird das zugehörige Kontextmenü angezeigt.

• Die Menüpunkte des Kontextmenüs entsprechen den Werkzeugen der beiden Werkzeugleisten (Verwaltung / Dokument).

• Welche Menüpunkte genutzt werden können, hängt vom Zweck der jeweiligen Gruppe ab.

• Je nach Status des gewählten Objekts (Ordner oder Dokument) stehen nur bestimmte Menüpunkte des Kontextmenüs zur Verfügung. Die anderen Menüpunkte werden nicht angezeigt oder sind ausgegraut.

Gruppen

Die Dokumente des Configuration Explorers werden abhängig von ihrer Funktion in Gruppen verwaltet.

• Per Klick auf die relevante Gruppenleiste werden die Dokumente in der zugehörigen Baumstruktur sichtbar.

• Für das jeweilige Modul stehen je nach Gruppe andere Funktionen in Werkzeugleiste / Kontextmenü zur Verfügung.

• Für die Rechteverwaltung werden Administratoren-Rechte benötigt. Ansonsten ist das zugehörige Werkzeug nicht in Werkzeugleiste / Kontextmenü sichtbar.