Altova MobileTogether Designer

Editierbare und schreibgeschützte Daten

Je nachdem, ob es sich bei der Struktur um eine editierbare oder eine schreibgeschützte Seitenquelle handelt, können Daten in Struktur-Nodes editierbar oder nicht editierbar (schreibgeschützt) sein. Ob eine Seitenquelle editierbar oder schreibgeschützt ist, wird definiert, wenn die Seitenquelle hinzugefügt wird. Wenn Sie die Definition editierbar/schreibgeschützt ändern möchten, löschen Sie die Seitenquelle und erstellen Sie sie mit der neuen Definition neu.

Client-Aktionen können den Inhalt von editierbaren Nodes ändern. Wenn eine Auswahlliste z.B. mit einem Node einer editierbaren Seitenquelle verknüpft wird, wird der vom Endbenutzer in der Auswahl gewählte Eintrag an den damit verknüpften Node übergeben und zu dessen geändertem Wert. Bei schreibgeschützten Seitenquellen wird der Inhalt von verknüpften Nodes nur für Anzeigezwecke verwendet. Diese verknüpften Nodes werden als Seitenquellen-Links bezeichnet. Ein Quell-Node-Link wird durch Ziehen des Struktur-Node auf das Steuerelement hinzugefügt.

Zuweisen von Daten zu Seitenquellen

Daten werden Nodes (sowohl in editierbaren als auch in schreibgeschützten Datenquellstrukturen) auf folgende Arten zugewiesen:

•Zuweisen einer Standarddatei: Die Daten in der Standarddatei werden an die Nodes der Struktur übergeben und werden zum Inhalt der Nodes. Die Struktur der Standarddatei muss mit der der Seitenquelle übereinstimmen.

•Manuelles Hinzufügen von Node-Inhalt: Das Kontextmenü jedes Node enthält Befehle (die Befehle Auf Vorhandensein überprüfen), mit denen Sie den Inhalt des Node definieren können. Wenn dem Node bereits mit einer anderen Methode (z.B. über eine Standarddatei) Inhalt zugewiesen wurde, so setzt der manuell hinzugefügte Node-Inhalt den zuvor zugewiesenen Inhalt außer Kraft.

Zuweisen einer Standarddatei

Einer XML-Seitenquelle kann eine Standarddatei zugewiesen werden. Die Daten in der Standarddatei werden an die Seitenquelle als Datenstruktur übergeben. Um eine Standarddatei zuzuweisen, gehen Sie folgendermaßen vor: Direkt unterhalb des Root Node-Namen der Seitenquelle befindet sich ein Eintrag für die Standarddatei (siehe Abbildung unten).

Klicken Sie auf die Schaltfläche Zusätzliches Dialogfeld, um das Dialogfeld "Datei definieren" aufzurufen (Abbildung unten), wählen Sie die gewünschte Datei aus und klicken Sie auf OK. Die Zuweisung wurde nun vorgenommen und im Eintrag Standarddatei wird der Dateipfad angezeigt. Nachdem eine Standarddatei zugewiesen wurde, können Sie diese Zuweisung durch Doppelklick auf den Eintrag Standarddatei und Navigieren zur neuen Standarddatei ändern.

Die Daten aus der Standarddatei werden als die Daten der Seitenquelle verwendet. Damit die Daten jedoch verwendet werden können, muss die Standarddatei dieselbe Struktur wie die Seitenquelle haben. Beachten Sie, dass die Struktur einer Standarddatei nicht automatisch importiert wird, wenn die Standarddatei einer Seitenquelle zugewiesen wird. Um die Struktur der XML-Datei zu importieren, verwenden Sie den Kontextmenübefehl Struktur von XML importieren. Sie können die Struktur der Seitenquelle auch manuell gemäß der Struktur der Standarddatei erstellen.

Die Datei befindet sich auf dem Server

Wenn sich die Standarddatei auf dem Server befindet, aktivieren Sie das Optionsfeld Server (siehe Abbildung unten). Sie können nun zu einer Datei navigieren (Absoluter/Relativer Pfad) oder die Datei über eine globale Ressource (Datei-Alias oder Ordner-Alias) festlegen. Wählen Sie die gewünschte Option aus.

•Absoluter/Relativer Pfad: Sie können einen Pfad eingeben, mit "Durchsuchen" zu einer Datei navigieren oder einen XPath-Ausdruck zur Generierung des Dateipfads eingeben. Durch Drücken der Schaltfläche Zurücksetzen können Sie den aktuellen Eintrag entfernen. Beim Pfad kann es sich um einen relativen Pfad zur Designdatei oder um einen absoluten Pfad handeln. Wenn die Datei zusammen mit der Designdatei auf dem Server bereitgestellt wird, so wird intern (in der Datenbank des Servers) der im Dialogfeld definierte relative/absolute Pfad verwendet, um die Datei aufzurufen. Wenn die Datei nicht mit bereitgestellt wird, muss sie in einem Verzeichnis auf dem Server gespeichert werden. In diesem Fall gilt: (i) Wenn im Dialogfeld "Aus Datei laden" oder "Datei speichern/definieren" ein relativer Pfad ausgewählt ist, so wird dieser relative Pfad zur Laufzeit relativ zum (in den MobileTogether Server-Einstellungen definierten) Arbeitsverzeichnis aufgelöst; (ii)Wenn der Pfad im Dialogfeld "Aus Datei laden" oder "Datei speichern/definieren" absolut ist, muss der Ordner auf dem Server, der die Datei enthält, ein Nachfahre des Arbeitsverzeichnisses sein. Nähere Informationen finden Sie im Abschnitt Speicherort von Projektdateien. Außerdem können Sie auswählen, ob nicht vertrauenswürdige SSL-Verbindungen beim Aufrufen oder Speichern der Datei als vertrauenswürdig oder nicht vertrauenswürdig behandelt werden sollen. Wenn es sich beim Feld Absoluter/Relativer Pfad um ein Feld in einem Dialogfeld zum Speichern einer Datei - und nicht zum Laden einer Datei - handelt, können Sie optional eine Standarddateierweiterung definieren, die verwendet werden soll, wenn mit dem Dateinamen keine Erweiterung definiert wird.

•beim Speichern der Datei automatisch Unterordner erstellen: Wenn auf dem Client-Gerät Ordner im Dateipfad fehlen, werden diese beim Speichern der Datei erstellt. Diese Option ist nur beim Speichern relevant; wenn die Aktion auf das reine Laden von Dateien eingeschränkt ist, fehlt diese Option.

•Nicht vertrauenswürdige SSL-Verbindungen zulassen: Ein mit einer URL verknüpftes Zertifikat gilt als nicht vertrauenswürdig, wenn es nicht durch ein vertrauenswürdiges Root-Zertifikat signiert ist oder wenn keine Verknüpfung zu einem vertrauenswürdigen Root-Zertifikat erstellt werden kann. Wenn das Zertifikat von einer bekannten Zertifizierungsstelle signiert wurde, bedeutet das lediglich, dass eine der Zertifikat-Chain-Dateien zwischen Ihrem Zertifikat und dem Root-Zertifikat auf dem Webserver nicht installiert ist. Wenn ein vertrauenswürdiges Zertifikat erwartet wird (z.B. weil das HTTPS-Protokoll definiert wurde), so werden bei Auswahl dieser Option auch Verbindungen mit URLs zugelassen, die ein nicht vertrauenswürdiges Zertifikat haben.

•Alias der Datei für globale Ressourcen: Wählen Sie einen Dateialias aus den in der Auswahlliste verfügbaren aus. Die verfügbaren Dateialiasse sind diejenigen, die derzeit in der Definitionsdatei für globale Ressourcen definiert sind. Jeder Dateialias wird je nach der gerade aktiven Konfiguration in MobileTogether Designer (die mit dem Befehl Extras | Aktive Konfiguration ausgewählt wird) auf andere Dateiressourcen gemappt. Nähere Informationen dazu finden Sie im Abschnitt Globale Altova-Ressourcen.

•Alias des Ordners für globale Ressourcen mit Pfadfragment: Wählen Sie einen Ordneralias aus der Auswahlliste aus (siehe Abbildung unten).
 

 

Die verfügbaren Ordneraliasse sind diejenigen, die derzeit in der Definitionsdatei für globale Ressourcen definiert sind. Jeder Ordneralias wird je nach der gerade aktiven Konfiguration in MobileTogether Designer (die mit dem Befehl Extras | Aktive Konfiguration ausgewählt wird) auf andere Ordnerressourcen gemappt. Das Pfadfragment definiert den Rest des Pfads zur Dateiressource. Nähere Informationen dazu finden Sie im Abschnitt Globale Altova-Ressourcen.

Die Datei befindet sich auf dem Client

Wenn sich die Standarddatei auf dem Client befindet, so definieren Sie den Pfad zur Datei durch Eingabe/Auswahl des Pfads oder durch Generierung des Pfads mit Hilfe eines XPath-Ausdrucks. Durch Drücken der Schaltfläche Zurücksetzen können Sie den aktuellen Eintrag entfernen.

Die zu ladende/speichernde Datei kann von Ihnen, dem Designer, oder vom Endbenutzer definiert werden. Wenn Sie die Datei definieren, werden diese Informationen in der Lösung gespeichert und die Datei wird beim Auslösen der Aktion geladen/gespeichert. Wenn Sie festlegen, dass der Endbenutzer auswählen kann, welche Datei geladen/gespeichert werden soll, so wird bei Auslösung der Aktion auf dem Client-Gerät ein Navigationsdialogfeld geöffnet, in dem der Endbenutzer die zu landende/speichernde Datei eingeben/auswählen kann.

Dateiname wird (vom Designer der Lösung) unten definiert

•Standarddateierweiterung beim Speichern von Dateien: Sie können beim Speichern von Dateien optional eine Standarddateierweiterung definieren, die verwendet werden soll, wenn mit dem Dateinamen keine Erweiterung definiert wird.

•beim Speichern der Datei automatisch Unterordner erstellen: Wenn auf dem Client-Gerät Ordner im Dateipfad fehlen, werden diese beim Speichern der Datei erstellt. Diese Option ist nur beim Speichern relevant. Sie fehlt, wenn es sich bei der Aktion um eine Dateiladeaktion handelt.

•Geräteabhängige Verzeichnisse: Wählen Sie das Geräteverzeichnis aus der Dropdown-Liste aus. Auf Windows Phone/RT und iOS sind die zulässigen Verzeichnisse vordefiniert. Auf Android-Geräten können Sie zusätzlich zu den Verzeichnissen in der Dropdown-Liste der Auswahlliste Android auch jeden beliebigen anderen Ordner eingeben. Wenn Sie auf Android und Windows die Standardauswahl Default wählen, wird das Sandbox-Verzeichnis der MobileTogether App ausgewählt. Auf iOS-Geräten erstellt MobileTogether zwei Verzeichnisse: (i) ein Gesichertes Verzeichnis für Dateien, die in der iCloud gespeichert und später erneut heruntergeladen werden können; (ii) ein Nicht gesichertes Verzeichnis für Dateien, die nicht gesichert werden müssen. Wählen Sie je nach Bedarf das benötigte Verzeichnis aus. In Webbrowsern werden Dateien relativ zur Sandbox des Browsers gespeichert.

•Dateipfade für Simulationen: Da auf dem Client gespeicherte Dateien bei Simulationen nicht zur Verfügung stehen, können Sie einen Ordner definieren, der bei Simulationen anstelle des Client-Ordners verwendet werden soll. Die Dateien in diesem Ersatzordner müssen natürlich dieselben Namen wie die im Design definierten Dateien haben. Dieser Ordner wird im Dialogfeld "Optionen" auf dem Register "Simulation" (Extras | Optionen) definiert.

Anmerkung:  Auf Web Clients werden Dateien temporär auf dem Server gespeichert. Bei Beendung der Server-Sitzung werden sie dort gelöscht. Eine Server-Sitzung endet nach einer festgelegten Periode der Inaktivität, die im Bereich "Div". des Registers "Server-Einstellungen" in den Sitzungseinstellungen definiert ist (siehe Benutzerhandbuch zu MobileTogether Server).

Dateiname wird vom Endbenutzer (auf dem Client-Gerät) definiert

•Standarddateierweiterung beim Speichern von Dateien: Sie können beim Speichern von Dateien optional eine Standarddateierweiterung definieren, die verwendet werden soll, wenn mit dem Dateinamen keine Erweiterung definiert wird.

•Optionaler Dateifilter: Im Navigationsdialogfeld, das auf dem Client-Gerät geöffnet wird, werden die zu ladenden/speichernden Dateitypen gefiltert, so dass nur die von Ihnen definierten Dateierweiterungen zulässig sind. Sie können hier Folgendes eingeben: (i) eine durch Kommas oder Semikola getrennte Liste von Dateierweiterungen (z.B.: txt,html;xml) oder (ii) einen XPath-Ausdruck, der eine Sequenz von String-Elementen zurückgibt, wobei es sich bei jedem String-Element um eine Dateierweiterung handelt (hier z.B. eine Sequenz bestehend aus drei String-Elementen: 'txt','html,'xml').

•Optionale Standarddatei: Hier können Sie - entweder direkt oder über einen XPath-Ausdruck - als Hilfe für den Endbenutzer einen Standarddateinamen eingeben.

•Web-Meldungsfeld: Bevor das Dialogfeld "Datei öffnen/speichern" geöffnet wird, wird ein Meldungsfeld angezeigt. Sie können hier - entweder direkt oder über einen XPath-Ausdruck - Text eingeben, um den Standardtext des Meldungsfelds außer Kraft zu setzen.

•beim Speichern der Datei automatisch Unterordner erstellen: Wenn auf dem Client-Gerät Ordner im Dateipfad fehlen, werden diese beim Speichern der Datei erstellt. Diese Option ist nur beim Speichern relevant. Sie fehlt, wenn es sich bei der Aktion um eine Dateiladeaktion handelt.

Anmerkung:  Auf iOS-Geräten kann man die Auswahl der Datei auf dem Gerät nur als Import/Export aus/in die iCloud durch den Benutzer treffen lassen; Benutzern ist das Durchsuchen von gesicherten oder nicht gesicherten Ordnern nicht gestattet.

Manuelles Hinzufügen von Node-Inhalt

Sie können mit Hilfe von zwei Befehlen aus dem Kontextmenü des ausgewählten Node manuell Inhalt zu einzelnen Nodes hinzufügen:

•Beim Laden auf Vorhandensein überprüfen (Festgelegter Wert): Ein festgelegter String-Wert wird als Inhalt des Node hinzugefügt und in der Struktur angezeigt.

•Beim Laden auf Vorhandensein überprüfen (XPath-Wert): Der Inhalt des Node wird durch einen XPath-Ausdruck bereitgestellt. In der Struktur werden der XPath-Ausdruck und die Schaltfläche "XPath bearbeiten" angezeigt.

Der Inhalt des Node wird vor dem Laden der Seite generiert und die Seite wird mit diesem Node-Inhalt an den Client übergeben.

Beachten Sie, dass Inhalt, der manuell auf diese Art hinzugefügt wurde, Inhalt, der über eine Standarddatei oder mit dem Befehl Beim Laden auf Vorhandensein überprüfen hinzugefügt wurde, außer Kraft setzt.