BaSYS Mobile Konfigurationen

Die vollständige Konfiguration der BaSYS Mobile - Arbeitsabläufe wird im Configuration Explorer mit Hilfe von BCE-Dokumenten verwaltet. Die Konfigurationen betreffen sowohl BaSYS Mobile als auch die zugehörigen Import- und Export-Schnittstellen. Die für die genannten Schnittstellen erforderlichen Vorkonfigurationen werden durch die zentrale Verwaltung der Konfigurationen erheblich erleichtert. Zusätzlich zu den relevanten Export- und Importkonfigurationen können die Einstellungen der Assistenten definiert werden. Auf diese Weise werden im Hinblick auf die Schnittstellen Einstellungsfehler vermieden.

In der Hilfe werden folgende Abschnitte beschrieben:

So geht's

Der Export und Import für BaSYS Mobile lässt sich vollständig automatisieren: Durch eine entsprechende Konfiguration können Mobilgeräte in Ruhezeiten (beispielsweise über Nacht) mit dem neusten Datenstand im Büro versorgt werden, während parallel die vor Ort erfassten Daten rückimportiert werden. Diese automatische Synchronisation kann über beliebig lange Zeiträume während der Bearbeitung des zu Grunde liegenden Auftrags erfolgen und stellt einen stets aktuellen Datenbestand auf den beteiligten Systemen sicher.

Die BaSYS Mobile Konfigurationen sollten ausschließlich bei entsprechender Erfahrung vom Anwender vorbereitet werden. Andernfalls wird die Erstellung über die Consulting-Abteilung der Barthauer Software GmbH empfohlen. Ziel des BCE-Dokuments ist die automatische Verwaltung der Ordner und Dateien, die für das Mobilgerät benötigt werden.

So geht's:

Dokumentstruktur

Die Dokumentstruktur der BaSYS Mobile Konfigurationen legt die Datenverwaltung für den Austausch der relevanten Informationen mit dem Mobilgerät fest. Die Dokumentstruktur enthält die folgenden XML-Elemente:

Die gesamte Datenverwaltung für den Datenaustausch zwischen BaSYS und dem Mobilgerät muss im BCE-Dokument 1:1 abgebildet sein. Alle Zieldaten sowie einige Quelldaten werden dann unter Zugriff auf das relevante BCE-Dokument automatisch vom BaSYS-Mobile-Export erzeugt beziehungsweise überschrieben. Nach Bearbeitung der Zieldaten auf dem Mobilgerät gleicht der BaSYS-Mobile-Import die Ergebnisse mit den Quelldaten ab.

Das folgende Beispiel zeigt einen schematischen Blick in den Explorer des Betriebssystems. Alle Ordner und Dateien werden hier über den Hauptordner Mobile verwaltet. Der Unterordner Data enthält die erforderlichen Quelldaten. Die Zieldaten für das Mobilgerät befinden sich im Unterordner Projects:

Bezogen auf das Beispiel wird der Unterordner Projects einschließlich der zugehörigen Ordner und Dateien automatisch über die Einstellungen des BCE-Dokuments generiert. Alle relevanten Mobile-Konfigurationen werden dabei über die XML-Elemente MobileConfiguration gesetzt:

• Das Attribut sourcePath verweist auf den jeweiligen Pfad der Quelldaten.

• Das Attribut targetPath bezieht sich auf die vorhandenen oder zu generierenden Pfade der Zieldaten.

Die Mobile-Konfigurationen beschreiben die Datenverwaltung im Explorer des Betriebssystems. Dabei entspricht die jeweilige Mobil-Konfiguration einem MobileConfiguration-XML-Element. Für die XML-Elemente gibt es keinen zusammenfassenden Container. Es werden zwei Konfigurationstypen verwendet:

• Pfadkonfigurationen mit dem Attribut type="link".

• Dateikonfigurationen mit dem Attribut type="xml".

Die Tabelle zeigt eine Übersicht auf die standardmäßigen Mobile-Konfigurationen.

Die Mobile-Konfigurationen werden für die BaSYS-Mobile-Schnittstelle genutzt. Dort muss die Art des Exports aus BaSYS beziehungsweise die Art des Imports nach BaSYS entsprechend gesetzt sein.

Über eine Pfadkonfiguration werden Dateien in das Mobilgerät übernommen, die sich nicht direkt im BCE-Dokument speichern lassen.  

• Der Inhalt der Dateien ist nicht im BCE-Dokument gespeichert.

• Die Angabe des Quellpfades auf die Dateien ist zwingend erforderlich.

Die relevanten XML-Elemente des BCE-Dokumentes besitzen außerdem folgende Kenndaten:

• Das Attribut type steht auf link.

• Da keine Unterelemente verwaltet werden, existiert jeweils nur ein Knoten <MobileConfiguration ... \>.

Standardmäßig werden über die Pfadkonfigurationen drei Dateitypen nach BaSYS Mobile importiert. Die Werte der Attribute name und type müssen in der jeweiligen Konfiguration  beibehalten werden. In der folgenden Übersicht sind die Werte der editierbaren Attribute zur Verdeutlichung unbelegt:

Über eine Dateikonfiguration wird eine XML-Datei in das MobileConfiguration-Element eingebunden:

• Der Inhalt der XML-Datei ist dadurch vollständig im BCE-Dokument gespeichert.

• Die Angabe des Quellpfades auf die XML-Definitionsdatei ist nicht erforderlich.

Die relevanten XML-Elemente des BCE-Dokumentes besitzen außerdem folgende Kenndaten:

• Das Attribut type steht auf xml.

• Da Unterelemente verwaltet werden, existieren jeweils die zwei Knoten <MobileConfiguration ...> und </MobileConfiguration>.

Standardmäßig werden über die Dateikonfigurationen die Inhalte von vier Dateien nach BaSYS Mobile importiert. Die Werte der Attribute name und type müssen in der jeweiligen Konfiguration beibehalten werden. In der folgenden Übersicht sind die Werte der editierbaren Attribute zur Verdeutlichung unbelegt:

In den Mobile-Konfigurationen werden folgende Attribute verwendet:

• Name der Konfiguration

• Aliasname der Konfiguration

• Typ der Konfiguration

• Quellpfad

• Zielpfad

• Letzter Zielpfad

• Letzter Export

Alle wichtigen Informationen zu den Attributen werden in diesem Abschnitt erläutert.

Der Name der Konfiguration wird über das Attribut name festgelegt. Der Wert BaSYSDataFile für die Datendateien gehört zu den Standardeinstellungen und darf auf keinen Fall vom Anwender editiert werden. Der Name der Konfiguration wird für alle Pfad- und Dateikonfigurationen verwendet.

Konfigurationen können über das Attribut alias aufeinander verweisen. Der Aliasname der Konfiguration kann für alle Pfad- und Dateikonfigurationen verwendet werden. Dazu ein Beispiel:

Der Dateiname eines Layers verweist hier auf den Aliasnamen $BaSYSDataFile einer Pfadkonfiguration. Bei der Generierung der Mobile-Konfigurationen wird die Pfadkonfiguration mit dem genannten Aliasnamen gesucht. Der Zielpfad wird dann aus der gefundenen Pfadkonfiguration BaSYSDataFile für die erzeugten Layer verwendet.

Der Typ der Konfiguration wird über das Attribut type festgelegt. Der Typ gehört zu den Standardeinstellungen und sollte daher auf keinen Fall vom Anwender editiert werden. Der Typ entscheidet über die Art, mit der die Informationen zur Generierung der BaSYS Mobile - Dateien zusammengestellt werden:

Der Quellpfad wird über das Attribut sourcePath gesetzt. Die Angabe des Quellpfades ist ausschließlich für die Pfadkonfigurationen relevant, damit bei der Generierung der BaSYS-Mobile-Dateien die erforderlichen Quelldateien über die Datenverwaltung gefunden werden. Alle Quellpfade müssen physikalisch vorhanden sein.

Der Quellpfad der Datendateien bildet die Grundlage aller relativen Zielpfade. Die Vorgehensweise wird über das folgende Beispiel verdeutlicht:

In diesem Fall wird das Zielverzeichnis "C:\Mobile\Projects\Shapes" angelegt, falls es noch nicht existiert. Im Gegensatz zum Beispiel verweist der Quellpfad der Datendateien zusätzlich auf eine Quelldatei.

Die Zielpfade werden in der jeweiligen Konfiguration über das Attribut targetPath definiert. Alle Zielpfade, die noch nicht im Zielordner der Datenverwaltung vorhanden sind, werden bei der Generierung der BaSYS-Mobile-Dateien automatisch erstellt. Der Zielpfad wird für alle Pfad- und Dateikonfigurationen verwendet. Der zuletzt für die Datendateien gesetzte Zielpfad wird über das Attribut Letzter Zielpfad gespeichert.

Der Zielpfad bestimmt also je Mobile-Konfiguration, an welcher Stelle der Datenverwaltung die zugehörigen Dokumente generiert werden. Es können sowohl relative als auch absolute Zielpfade definiert werden. Das folgende Beispiel verdeutlicht die beiden Möglichkeiten:

Bei einem relativen Zielpfad wird der Quellpfad der Datendatei als Standardwert des Ausgabeordners verwendet! Die Zielpfade der Dateikonfigurationen verweisen jeweils auf die Zieldatei. Dazu gibt es das folgende Beispiel:

Die Zielpfade lauten dann:

• C:\Mobile\Projects\Beispiel.pro

• C:\Mobile\Projects\Config\ShapeFileTheme.xml

Der letzte Zielpfad wird ausschließlich über die Pfadkonfiguration der Datendateien verwaltet. Das zugehörige Attribut heißt lastBaSYSDataExportPath. Der letzte Zielpfad stimmt im Regelfall mit dem Zielpfad der Datendateien überein. Bei Abweichungen sollte die Pfadkonfiguration geprüft und gegebenenfalls angepasst werden.

Das letzte Exportdatum wird ausschließlich über die Pfadkonfiguration der Datendateien verwaltet. Das zugehörige Attribut heißt lastBaSYSDataExportTime. Über das genannte Attribut werden Datzum und Uhrzeit des letzten Exports gespeichert. Dabei wird das folgende Format genutzt:

• DD.MM.YYYY hh:mm:ss

Die Dokumente der Exportkonfigurationen sind XML-Dateien, die für den BaSYS-Mobile-Export verwendet werden. Die Inhalte der XML-Dateien werden im BCE-Dokument unter dem jeweiligen Knoten Content gespeichert:

Die Dokumente der Importkonfigurationen sind XML-Dateien, die für den BaSYS-Mobile-Import verwendet werden. Die Inhalte der XML-Dateien werden im BCE-Dokument unter dem jeweiligen Knoten Content gespeichert:

Beim Generieren werden die Dateien der Export- und Importkonfigurationen aus dem gewählten BCE-Dokument ausgelesen und in das Benutzerverzeichnis exportiert. Beispielsweise werden dann folgende Pfade angelegt:

• C:\Users\{Benutzername}\AppData\Local\Barthauer\BaSYS8\config\Applications\Interfaces\Common\TabletEdit\Export\

• C:\Users\{Benutzername}\AppData\Local\Barthauer\BaSYS8\config\Applications\Interfaces\Common\TabletEdit\Import\

Über die Projektkonfigurationen und die Mobile-Konfiguration wird die Nutzung von BaSYS Mobile auf dem Mobilgerät eingestellt. Die Projektkonfiguration legt folgende Vorgaben fest:

• Pfad zur Projektliste, also zur Verwaltung der Projekte.

• Importeinstellungen mit der Möglichkeit, bestimmte Daten vom Import auszuschließen.

Der Pfad zur Projektliste ermöglicht es BaSYS Mobile, die auf das Mobilgerät importierten Projekte zu identifizieren. Nach dem erfolgreichen Generieren der Mobile-Dateien ist das neue Projekt in der Projektliste angelegt. Es kann dann vom Anwender in BaSYS Mobile direkt per Klick auf den gewünschten Listeneintrag geöffnet werden.

Bei unkorrekter Angabe des Pfades kann das Projekt vom Anwender nicht aufgerufen werden. Der Pfad zur Projektliste kann beispielsweise folgendermaßen gesetzt sein:

• projectConfigFilePath="C:\Mobile\Projects\Config\Projects.xml"

Über die Importeinstellungen wird festgelegt, welche Arbeitsergebnisse von BaSYS Mobile nach BaSYS importiert werden sollen:

• Die Daten zur Attributen mit dem Wert True werden importiert.

• Die Daten zur Attributen mit dem Wert False werden nicht importiert.

Folgende Attribute stehen zur Verfügung:

 

In der Konfigurationskategorie BaSYS.opera wird festgelegt, welche Layouts in BaSYS.opera für die Aktionen "Objekt bearbeiten" und "Neues Objekt erstellen" verwendet werden können.

Die BaSYS.opera.Konfiguration legt folgende Vorgaben fest:

• ArenaDefinitions-Dokument: Auswahl der gewünschten ArenaDefinition

• Objekttyp und ArenaLayout: Konfiguration , welche Objekttypen neu erstellt und bearbeitet werden können und welches ArenaLayout verwendet werden soll.

ArenaDefinitions-Dokument

Über die Schaltfläche wird der Configuration-Explorer mit den Arena Definitionen geöffnet und die gewünschte Arena Definition ausgewählt.

Konfiguration Objekttyp und ArenaLayout

Beim Laden einer neuen ArenaConfiguration wird eine Liste von Objekttypen der ArenaLayoutConfigurationen automatisch generiert, je nachdem welche Objekttypen und Layouts bereits in der ArenaConfiguration definiert sind.

Die Auswahl erfolgt über die Tabelle.

Validierung der ArenaDefinition

Die BaSYS Mobile-Konfiguration basiert auf einer ArenaDefinition, die selbst ein unabhängiges BCE-Dokument ist. Wird dieses BCE-Dokument geändert, z.B. wenn dort ein definiertes ArenaLayout nicht mehr vorhanden ist und entfernt wurde, so erscheint eine Warnmeldung bei der Editierung der Mobile-Configuration (Dieses ArenaLayout existiert nicht mehr in der ArenaDefinition!).