Ressourcen
Globale Altova-Ressourcen sind Aliasse für Datei-, Ordner und Datenbankressourcen. Jeder Alias kann mehrere Konfigurationen haben, wobei jede Konfiguration genau einer Ressource zugeordnet wird. Wenn Sie daher eine globale Ressource verwenden, können Sie zwischen ihren Konfigurationen wechseln. So könnten Sie etwa eine Datenbank-Ressource mit zwei Konfigurationen erstellen: Entwicklung und Produktion. Je nachdem, was Sie bezwecken möchten, können Sie zwischen diesen Konfiguration wechseln. In FlowForce Server könnten Sie Daten entweder aus der Entwicklungs- oder der Produktionsdatenbank abrufen, indem Sie für die Mapping-Funktion die gewünschte Konfiguration bereitstellen.
Globale Ressourcen können applikationsübergreifend in verschiedenen Altova Applikationen verwendet werden (siehe Unterabschnitt weiter unten).
Globale Ressourcen in anderen Altova-Produkten
Wenn Datei-, Ordner- und Datenbankverbindungsinformationen als globale Ressourcen gespeichert werden, lassen sich diese in mehreren Altova-Applikationen wiederverwenden. Wenn Sie ein und dieselbe Datei z.B. häufig in verschiedenen Altova Desktop-Applikationen öffnen müssen, können Sie diese als globale Ressource definieren. Wenn Sie den Dateipfad ändern müssen, muss er nur an einer einzigen Stelle geändert werden. Derzeit können globale Ressourcen in den folgenden Altova-Produkten definiert und verwendet werden:
•RaptorXML Server/RaptorXML+XBRL Server
Nähere Informationen zur Erstellung von globalen Ressourcen finden Sie in der MapForce-Dokumentation im Kapitel "Globale Altova-Ressourcen".
Ressourcen in FlowForce Server
Globale Ressourcen werden in FlowForce Server nicht wie in Desktop-Applikationen in einer einzigen XML-Datei gespeichert. In FlowForce ist jede Ressource ein wiederverwendbares Objekt, das Datei- oder Ordnerpfade oder Datenbankverbindungsinformationen enthalten kann. Ressourcen können kopiert, exportiert und importiert werden und unterliegen denselben Zugriffsmechanismen wie andere FlowForce-Objekte. D.h. jeder beliebige FlowForce-Benutzer kann jede beliebige Ressource in seinen Mapping-Funktionen verwenden, wenn er die entsprechenden Berechtigungen hat.
Nachdem Sie in MapForce ein Mapping mit globalen Ressourcen erstellt haben, können Sie es auf FlowForce Server bereitstellen. Sie können bei der Bereitstellung auswählen, ob im Mapping globale Ressourcen verwendet werden sollen, indem Sie im Bereitstellungsdialogfeld das Kontrollkästchen Ressourcen verwenden aktivieren. Wenn Sie dieses Kontrollkästchen nicht aktivieren, werden alle im Mapping verwendeten globalen Ressourcen auf Basis der aktuell ausgewählten Konfiguration aufgelöst. Wenn Sie das Kontrollkästchen aktiviert haben, werden für die Mapping-Funktion auch in FlowForce Server Ressourcen benötigt. In der Abbildung unten sehen Sie ein Beispiel für eine auf FlowForce Server bereitgestellte Mapping-Funktion, für die zur Ausführung globale Ressourcen erforderlich sind. Beachten Sie, dass der erste Parameter den Standarddateipfad aus einer Ressource abruft.
In FlowForce Server werden die globalen Ressourcen von der Mapping-Funktion und nicht vom Auftrag verwendet. Die Mapping-Funktion liest den Pfad der ersten Input-Datei aus der Ressource aus. Das bedeutet, dass alle Aufträge, in denen diese Funktion verwendet wird, denselben Pfad verwenden, es sei denn, Sie setzen den Pfad über die Auftragskonfigurationsseite außer Kraft.
Sie können globale Ressourcen auch als eigenständige Objekte auf FlowForce Server bereitstellen, d.h. es muss nicht zuerst ein Mapping bereitgestellt werden, damit eine globale Ressource bereitgestellt werden kann. Nähere Informationen zur Bereitstellung von globalen Ressourcen auf FlowForce Server finden Sie in der MapForce-Dokumentation.
Struktur von Ressourcen
Globale Ressourcen werden in allen Altova Desktop-Applikationen in Form von XML-Dateien verwaltet. Die Standarddatei hat den Namen GlobalResources.xml; Sie befindet sich auf dem Rechner, auf dem MapForce installiert ist, im Verzeichnis C:\Benutzer\<Benutzername>\Dokumente\Altova. Eine globale Ressourcendatei kann mehrere Ressourcen, so genannte "Aliasse" enthalten. Ein Alias ist entweder ein Dateipfad oder ein Verzeichnispfad oder eine Gruppe von Datenbankverbindungsinformationen. Aliasse können wiederum mehrere Konfigurationen haben. Wie oben beschrieben, können Sie mit Hilfe von Aliassen Pfade oder Datenbanken wechseln. Am besten lässt sich dies anhand der Struktur der folgenden Beispieldatei für globale Ressourcen erklären (beachten Sie, dass aus Gründen der Übersichtlichkeit einige Daten weggelassen wurden):
<Resources> |
In der obigen Datei sind drei Ressourcen (Aliasse) definiert: ein Dateipfad namens "MyFile", ein Verzeichnispfad namens "MyDirectory" und eine SQList-Datenbank namens "MyDatabase". Jeder Alias hat zwei Konfigurationen: eine Standardkonfiguration für das Testen und eine Produktionskonfiguration.
Aufgrund der Besonderheiten der Multi-Server-Umgebung funktionieren Ressourcen in FlowForce Server etwas anders. So wird etwa eine XML-Ressourcendatei wie die oben gezeigte in FlowForce Server ein Ressourcenobjekt. Das Ressourcenobjekt kann wie in Desktop-Applikationen mehrere Aliasse enthalten, jedoch hat jeder Alias nur eine Konfiguration, nämlich die Konfiguration, die Sie bei der Bereitstellung der Ressourcen von MapForce auf FlowForce Server ausgewählt haben.
Bei der Bereitstellung globaler Ressourcen von MapForce auf FlowForce Server wird immer nur eine Konfiguration bereitgestellt. |
Wenn Sie z.B. die oben gezeigte globale Ressourcendatei bereitgestellt haben, wird auf dem Server entweder die Konfiguration "Default" oder "Production" (nicht aber beide) bereitgestellt. Wenn Sie die Konfiguration "Default" auswählen, sieht das Ressourcenobjekt in FlowForce Server folgendermaßen aus:
Für alle Mapping-Funktionen wird in FlowForce eine bestimmte Konfiguration einer globalen Ressource verwendet. Wenn Sie daher in diesem Beispiel auf dem Server die Konfiguration "Production" benötigen, sollten Sie dieselbe Ressourcendatei noch einmal bereitstellen und diesmal im Bereitstellungsdialogfeld in MapForce die Konfiguration "Production" auswählen. Alternativ dazu können Sie, wie weiter unten beschrieben, direkt auf dem Server eine Ressource erstellen und die Mapping-Funktionen ändern, sodass diese auf diese Ressourcen und nicht auf die Ressource "Default" verweisen. Beachten Sie jedoch, dass diese Alternativmethode nur bei Datei- und Verzeichnisressourcen, nicht aber bei Datenbanken möglich ist.
Ändern der Ressource einer Mapping-Funktion
Ressourcenobjekte werden in FlowForce durch das Symbol 
gekennzeichnet. Wenn Sie also sowohl die Konfiguration "Default" als auch "Production" aus dem obigen Beispiel bereitgestellt haben, werden die entsprechenden Ressourcen in FlowForce Server eventuell folgendermaßen angezeigt:
So ändern Sie die von einer Mapping-Funktion verwendete Ressource:
1.Gehen Sie zu dem Container, in dem die Mapping-Funktion bereitgestellt wurde und klicken Sie darauf, um die Funktion zu öffnen.
2.Wählen Sie unter "Ressourcen" einen neuen Ressourcenpfad aus. Die Auswahl von Ressourcen funktioniert auf dieselbe Art, wie bei anderen FlowForce-Objekten wie Funktionen, Anmeldeinformationen, usw.
Wenn die Mapping-Funktion keinen Abschnitt "Ressourcen" hat, wurde dieses Mapping in MapForce nicht für globale Ressourcen konfiguriert (oder das Kontrollkästchen Ressourcen verwenden wurde bei der Bereitstellung nicht aktiviert).
Jede Mapping-Funktion kann jede beliebige Ressource verwenden, wenn die folgenden Voraussetzungen erfüllt werden:
•Die Art der Ressource ist mit der Funktion kompatibel. So kann z.B. eine "Ordner"-Ressource nicht verwendet werden, wenn für die Mapping-Funktion eine "Datei"-Ressource benötigt wird.
•Der Aliasname der Ressource ist der von der Mapping-Funktion benötigte. Normalerweise wird der Aliasname zum Zeitpunkt des Mapping-Designs in MapForce ausgewählt, Sie können dies aber, wie weiter unten beschrieben, in FlowForce auch außer Kraft setzen.
Ressourcen und Auftragskonfiguration
Wie bereits erwähnt, werden Ressourcen auf Ebene von Mapping-Funktionen und nicht auf Ebene der Auftragskonfiguration verwendet. Wenn ein Auftrag ausgeführt wird, werden diejenigen globalen Ressourcen verwendet, die in der vom Auftrag aufgerufenen Funktion definiert sind. Wenn Sie einen Auftrag daher über die Auftragskonfigurationsseite bearbeiten, haben Sie hinsichtlich Ressourcen nur minimale Konfigurationsoptionen zur Verfügung wie z.B. das "Außerkraftsetzen des Ressourcen-Alias" (wie weiter unten beschrieben).
In manchen Fällen ist es eventuell möglich, eine Ressource (wie z.B. einen Ordner oder eine Datei) direkt von der Auftragskonfigurationsseite aus zu referenzieren. Beachten Sie, dass dies eventuell nicht in jedem Kontext funktioniert und im Allgemeinen vermieden werden sollte, es sei denn, Sie haben gute Gründe, solche Referenzen zu verwenden.
| Anmerkung: | Die Referenzierung einer Ressource über den Parameter "Arbeitsverzeichnis" eines Ausführungsschritts wird nicht unterstützt. Dies liegt daran, dass der MapForce Server-Prozess bereits laufen muss, damit Ressourcen verarbeitet werden können, während das Arbeitsverzeichnis noch vor dem Start von MapForce Server definiert sein muss. |
Außerkraftsetzen des Ressourcen-Alias
Selbst wenn eine Datei- oder Ordnerressource mehrere Aliasse hat, kann zum Zeitpunkt der Ausführung des Auftrags nur einer verwendet werden, nämlich derjenige, der zum Zeitpunkt des Mapping-Designs in MapForce ausgewählt war. So generiert etwa die folgende MapForce-Komponente output.csv-Daten in einem Verzeichnisalias namens "MyDirectory". Wenn Sie dieses Mapping auf FlowForce Server bereitstellen, muss auch die Mapping-Funktion auf dem Server auf eine Ressource verweisen, die den Alias "MyDirectory" enthält.
Anstatt das Mapping jedes Mal, wenn Sie den Alias ändern, in MapForce zu bearbeiten, können Sie den Alias in FlowForce Server über die Auftragskonfigurationsseite außer Kraft setzen. Um Datei- oder Ordneraliasse in einem Auftrag außer Kraft zu setzen, verwenden Sie die folgende Syntax, wobei Sie MyFile oder MyDirectory durch den gewünschten Aliasnamen ersetzen:
Ressourcenart | Beispiel |
|---|---|
Datei | altova://file_resource/MyFile |
Verzeichnis | altova://folder_resource/MyDirectory |
In der Auftragskonfiguration unten wird z.B. der Verzeichnisalias in "TestDir" geändert.
| Anmerkung: | Für Datenbankressourcen wird die oben gezeigte Außerkraftsetzung von Aliassen nicht unterstützt. Wenn Sie mehrere Datenbankaliasse haben, wechseln Sie den gewünschten Datenbankalias in MapForce, bevor Sie das Mapping auf FlowForce Server bereitstellen. |
Erstellen von Ressourcen
Sie können in FlowForce Server nur Datei- oder Ordnerressourcen erstellen. Um in FlowForce Server eine globale Ressource zu erstellen, öffnen Sie den gewünschten Container und klicken Sie auf Erstellen | Resourcen erstellen.
| Anmerkung: | Die Erstellung von Datenbankressourcen wird in einer Server-Umgebung nicht unterstützt. Um Datenbankressourcen zu erstellen, verwenden Sie den Globalen Ressourcen-Editor von MapForce oder einer anderen Altova Desktop Applikation, die globale Ressourcen unterstützt und stellen Sie die Ressourcen anschließend von MapForce auf FlowForce Server bereit. |
Der Ressourcenalias sollte mit dem der Mapping-Funktion, in der die Ressource verwendet werden soll, übereinstimmen. Andernfalls müssen Sie Aufträge, wie weiter oben unter "Außerkraftsetzen des Ressourcenalias" beschrieben, manuell anpassen, damit diese auf den korrekten Alias verweisen.
Sie können innerhalb desselben Ressourcenobjekts falls nötig mehrere Aliasse erstellen, indem Sie auf die Schaltflächen Neue Dateiressource oder Neure Ordnerressource klicken. Dies ist jedoch optional. Wenn Sie mehrere Aliasse erstellen, denken Sie daran, dass Sie Aufträge bearbeiten müssen, um anzugeben, welcher Alias darin verwendet werden soll.
Bearbeiten von Ressourcen
Anstatt Datei- oder Ordnerressourcen in MapForce zu bearbeiten und erneut bereitzustellen, können Sie diese direkt in FlowForce Server bearbeiten. Um eine Ressource zu bearbeiten, klicken Sie auf den entsprechenden Datensatz, aktualisieren Sie die Pfade (oder die Datenbankverbindungsinformationen) und klicken Sie anschließend auf Speichern.
| Anmerkung: | Im Fall von Datenbankressourcen können in FlowForce nur bestimmte Felder wie z.B. der Verbindungsstring oder die Standarddatenbank bearbeitet werden. Der Datenbankanbieter und die Verbindungsmethode können jedoch nicht geändert werden. |
Nachdem Sie eine Ressource aktualisiert haben, wirkt sich dies auf die folgenden Dinge aus:
•alle von dieser Ressource referenzierten Mapping-Funktionen •alle Aufträge, die die entsprechende(n) Mapping-Funktion(en) aufrufen |