SelectiveBindingImport (Beispiel für die Anwendungsbereitstellung)

  • Artikel

In diesem Thema wird die Verwendung des Beispiels SelectiveBindingImport erläutert. Mithilfe dieses Beispielskripts können Sie verschiedene Bindungen auf eine Anwendung anwenden, wenn Sie die Anwendung in unterschiedliche Zielumgebungen importieren. Sie können diesen Ansatz verwenden, wenn Sie die Bindungen aus Bindungsdateien importieren möchten, die auf einer Netzwerkfreigabe gespeichert werden.

Hinweis

Wenn Sie Bindungsdateien während des Anwendungsimports nicht automatisch von einer Netzwerkfreigabe importieren müssen, können Sie der Anwendung verschiedene Bindungsdateien hinzufügen, für die unterschiedliche Zielumgebungen angegeben sind. Wenn Sie die Anwendung importieren, können Sie die Umgebung angeben, woraufhin die Bindungen für diese Umgebung automatisch angewendet werden. Weitere Informationen finden Sie unter Bindungsdateien und Anwendungsbereitstellung.

BizTalk-Anwendungen werden normalerweise aus der Entwicklungsumgebung in die Testumgebung, dann weiter in die Stagingumgebung und anschließend in die Produktionsumgebungen verschoben. Die in den unterschiedlichen Umgebungen verwendeten Bindungen sind normalerweise verschieden. Mithilfe dieses Beispiels können Sie wie folgt Bindungen auf verschiedene Umgebungen anwenden:

  1. Positionieren aller zu verwendenden Bindungsdateien auf einer Netzwerkfreigabe.

  2. Hinzufügen eines nachträglich verarbeiteten Skripts zur Anwendung, die während des Anwendungsimports von diesem Speicherort die richtige Bindungsdatei für die bestimmte Zielumgebung importiert. Das Skript erkennt die Umgebung, indem eine Umgebungsvariable namens %ENVIRONMENT% gelesen wird, die Sie auf dem lokalen Computer festlegen.

Ziel des Beispiels

In diesem Beispiel wird veranschaulicht, wie Bindungsdateien selektiv von einer Netzwerkfreigabe importiert werden, indem ein nachträglich verarbeitetes Skript verwendet wird, das in einer BizTalk-Anwendungsdatei (MSI) enthalten ist.

Speicherort dieses Beispiels

Die folgenden Beispielordner und -dateien finden Sie unter <Beispielpfad>\Anwendungsbereitstellung\SelectiveBindingImport:

  • Develop (Ordner)

    • Dev.xml

  • Production (Ordner)

    • Production.xml

  • Staging (Ordner)

    • Staging.xml

  • Test (Ordner)

    • Test.xml

  • SelectiveBindings.bat

Verwenden dieses Beispiels

Gehen Sie zum Ausführen des Beispiels wie folgt vor:

So führen Sie das Beispiel aus

  1. Führen Sie Build.Bat aus dem <Verzeichnis Samples Path>\Application Deployment\CreateApp aus . Dadurch werden die folgenden Dateien im <Ordner Samples Path>\Application Deployment\CreateApp\Dlls erstellt: Schemas.dll, Maps.dll und Orchestrations.dll.

  2. Erstellen Sie die Anwendung. Erstellen Sie in der BizTalk Server-Verwaltungskonsole eine Anwendung, wie unter Erstellen einer Anwendung beschrieben.

  3. Fügen Sie der Anwendung die im ersten Schritt erstellten DLL-Dateien hinzu. Anweisungen finden Sie unter Hinzufügen einer BizTalk-Assembly zu einer Anwendung.

  4. Erstellen Sie die ENVIRONMENT-Variable wie folgt:

    1. Klicken Sie im Menü Start mit der rechten Maustaste auf Arbeitsplatz , und klicken Sie auf Eigenschaften.

    2. Klicken Sie auf der Registerkarte Erweitert auf Umgebungsvariablen.

    3. Klicken Sie im Abschnitt Benutzervariablen auf Neu.

    4. Geben Sie unter Variablenname den NamenENVIRONMENT ein.

    5. Geben Sie unter Variablenwert die folgenden Werte für die Umgebung ein: Develop, Production, Staging oder Test. Bei diesen Werten wird zwischen Groß-/Kleinschreibung unterschieden.

  5. Klicken Sie dreimal auf OK.

  6. Kopieren Sie die Bindungsdateien an einen Speicherort im Dateisystem. Kopieren Sie die Datei binding.xml aus den Ordnern Develop, Test, Staging und Production an einen Speicherort in Ihrem Dateisystem.

  7. Bearbeiten Sie das nachträglich verarbeitete Skript. Bearbeiten Sie die Datei SelectiveBindings.bat folgendermaßen:

    1. Geben Sie den Speicherort für die Bindungsdatei an. Löschen Sie in der BINDINGS_LOC enthaltenden Zeile die Zeichenfolge REM, und stellen Sie den Pfad zum Speicherort bereit, an den Sie die Bindungsdateien kopiert haben.

      Beispiel:

      BINDINGS_LOC=C:\EigeneBindungen

    2. Geben Sie den Anwendungsnamen an. Löschen Sie in der APPLICATION_NAME enthaltenden Zeile die Zeichenfolge REM, und stellen Sie den Namen der Anwendung bereit, in die Sie die Bindungsdateien importieren möchten.

      Beispiel:

      APPLICATION_Name=SelectiveBindingImport

  8. Fügen Sie das Skript als nachträglich verarbeitetes Skript zur Anwendung hinzu. Anweisungen finden Sie unter Hinzufügen eines Vor- oder Nachverarbeitungsskripts zu einer Anwendung.

  9. Exportieren Sie die Anwendung. Anweisungen finden Sie unter Exportieren einer BizTalk-Anwendung.

  10. Löschen Sie die Anwendung. Anweisungen finden Sie unter Löschen einer BizTalk-Anwendung aus der BizTalk-Gruppe.

  11. Importieren Sie die Anwendung. Anweisungen finden Sie unter Importieren einer BizTalk-Anwendung. Sie müssen keine Zielumgebung angeben.

  12. Überprüfen Sie, dass die richtige Bindungsdatei angewendet wurde. Dazu können Sie das Beschreibungsfeld der Empfangsspeicherorte wie folgt überprüfen:

    1. Klicken Sie auf Start, alle Programme, Microsoft BizTalk Server 20xx und dann auf BizTalk Server Verwaltung.

    2. Erweitern Sie in der Konsolenstruktur nacheinander die BizTalk-Gruppe und die BizTalk-Anwendung und dann den Ordner für den Empfangsspeicherort.

    3. Zeigen Sie im rechten Bereich die Beschreibung der Empfangsspeicherorte an.

  13. Installieren Sie die Anwendung. Anweisungen finden Sie unter Installieren einer BizTalk-Anwendung.

Weitere Informationen

Anwendungsbereitstellung (Ordner für BizTalk Server-Beispiele)
Bereitstellen von BizTalk-Anwendungen