Freigeben über

Importieren einer Richtlinie

  • Artikel

In diesem Thema wird beschrieben, wie Sie mithilfe der BizTalk Server-Verwaltungskonsole eine Richtlinie in eine BizTalk-Gruppe oder mithilfe des Befehlszeilentools BTSTask in eine BizTalk-Anwendung importieren.

Sie können eine Richtlinie mit dem Business Rule Composer erstellen, wie unter Erstellen von Geschäftsregeln mithilfe des Business Rule Composer beschrieben, und dann direkt importieren, oder Sie können eine Richtlinie aus einer anderen BizTalk-Gruppe exportieren, wie unter Exportieren einer Richtlinie und anschließendes Importieren einer Richtlinie beschrieben.

Durch das Importieren einer Richtlinie wird diese in der Regel-Engine-Datenbank der BizTalk-Gruppe registriert. Nachdem die Richtlinie importiert wurde, können Sie sie in der BizTalk Server-Verwaltungskonsole anzeigen. Wenn Sie die BizTalk Server-Verwaltungskonsole zum Importieren einer Richtlinie verwenden, wird sie im <Knoten Alle Artefakte> für die BizTalk-Gruppe angezeigt. Sie können sie dann veröffentlichen, um sie zur Verfügung zu stellen, um sie einer BizTalk-Anwendung hinzuzufügen, wie unter Veröffentlichen einer Richtlinie beschrieben. Wenn Sie eine Richtlinie mithilfe des Befehlszeilentools BTSTask importieren, wird die Richtlinie automatisch veröffentlicht und im Ordner Richtlinien der Anwendung, in die Sie importiert wurde, angezeigt.

Beachten Sie beim Importieren einer Richtlinie die folgenden wichtige Punkte:

  • Auch wenn Sie die Option zum Überschreiben einer vorhandenen Richtlinie mit einer importierten Richtlinie aktivieren, können Sie eine Richtlinie nicht importieren, wenn diese bereits in der Regel-Engine-Datenbank vorhanden ist und bereitgestellt wurde. Unter diesen Bedingungen schlägt der Importvorgang fehl.

  • Auch wenn die Richtlinie aus einer anderen BizTalk-Gruppe mit dem Status Bereitgestellt exportiert wurde, wird sie dennoch mit dem Status Bereitstellung zurückgenommen importiert.

  • BTSTask enthält keinen spezifischen Befehl für das Importieren von Richtlinien. Mit dem BTSTask-Befehl ExportAPP ist es jedoch möglich, ausschließlich die gewünschten Richtlinien – auch ohne zusätzliche Anwendungsargumente – in eine Anwendung exportieren. Anschließend können Sie mit dem Befehl ImportApp die MSI-Datei in eine Anwendung einer anderen BizTalk-Gruppe importieren. Diese Methode wird in diesem Thema erläutert. Dabei wird die Richtlinie automatisch in die BizTalk-Gruppe importiert, dort veröffentlicht und anschließend der angegebenen Anwendung hinzugefügt.

    Weitere Informationen zum Arbeiten mit Richtlinien finden Sie unter Verwalten von Richtlinien. Bewährte Methoden zum Hinzufügen von Richtlinien zu Anwendungen finden Sie unter Bewährte Methoden für die Bereitstellung einer BizTalk-Anwendung.

Hinweis

Der Lösungsentwickler kann Richtlinien erstellen und diese dann mithilfe des Regel-Engine-Bereitstellungs-Assistenten in die Regel-Engine-Datenbank importieren, wie unter Bereitstellen und Aufheben der Bereitstellung von Richtlinien und Vokabularen beschrieben.

Voraussetzungen

Zur Durchführung der Verfahren in diesem Thema müssen die folgenden Voraussetzungen erfüllt sein:

Importieren einer Richtlinie mit BizTalk Server-Verwaltung

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

  2. Erweitern Sie in der Konsolenstruktur BizTalk Server Verwaltung, erweitern Sie die BizTalk-Gruppe, in die Sie die Richtlinie importieren möchten, anwendungen und dann <Alle Artefakte>.

  3. Klicken Sie mit der rechten Maustaste auf Richtlinien, und klicken Sie dann auf Importieren.

  4. Navigieren Sie zur .xml-Datei, die die Richtlinie enthält, und klicken Sie auf Öffnen.

    Die Richtlinie wird in die Gruppe importiert und im Ordner Richtlinien unter <Alle Artefakte> angezeigt.

Importieren einer Richtlinie über die Befehlszeile

  1. Öffnen Sie eine Eingabeaufforderung wie folgt: Klicken Sie auf Start, klicken Sie auf Ausführen, geben Sie ein cmd, und klicken Sie dann auf OK.

  2. Geben Sie den folgenden Befehl ein, und ersetzen Sie die entsprechenden Werte, wie in der folgenden Tabelle beschrieben:

    BTSTask ImportApp /Package:value [/ApplicationName:value] [/Overwrite] [/Server:value] [/Database:value]

    Beispiel:

    BTSTask ImportApp /Package:"C:\MSI Files\MyApplication.msi" /Environment:Test /ApplicationName:MyApplication /Overwrite

    Parameter Wert
    /Paket Der vollständige Pfad der MSI-Datei, die die zu importierende Richtlinie enthält. Wenn der Pfad Leerzeichen enthält, müssen Sie ihn in Anführungszeichen (") setzen.
    /Applicationname Der Name der BizTalk-Anwendung, in die die Richtlinie importiert werden soll. Wenn der Name nicht angegeben ist, wird der Anwendungsname verwendet, der beim Exportieren der MSI-Datei angegeben wurde. Wenn die angegebene Anwendung nicht vorhanden ist, wird sie erstellt. Anwendungsnamen, die Leerzeichen enthalten, müssen in doppelte Anführungszeichen (") gesetzt werden.
    /Überschreiben Option zum Überschreiben von Richtlinien in der Anwendung mit Elementen der MSI-Datei, die denselben Namen und dieselbe Versionsnummer aufweisen. Wenn diese Option nicht festgelegt wird, und die Anwendung mindestens eine Richtlinie enthält, deren Name und Versionsnummer mit einer Richtlinie der MSI-Datei übereinstimmt, schlägt der Import fehl. Sie können den Namen und die Versionsnummer der Richtlinien in einer Anwendung anzeigen, indem Sie den ListApp-Befehl verwenden.
    /Server Der Name der SQL Server-Instanz, die als Host für die BizTalk-Verwaltungsdatenbank dient, im Format Servername\Instanzname,Port.

    Der Instanzname ist nur erforderlich, wenn sich der Instanzname vom Servernamen unterscheidet. Der Port ist nur erforderlich, wenn in SQL Server eine andere Portnummer als der Standardwert 1433 verwendet wird.

    Beispiele:

    Server=MyServer

    Server=MyServer\MySQLServer,1533

    Bei fehlender Angabe wird der Name der SQL Server-Instanz verwendet, die auf dem lokalen Computer ausgeführt wird.
    /Datenbank Der Name der BizTalk-Verwaltungsdatenbank. Bei fehlender Angabe wird die BizTalk-Verwaltungsdatenbank verwendet, die in der lokalen Instanz von SQL Server ausgeführt wird.

    Hinweis

    Auf einem System, das Unterstützung für die Benutzerkontensteuerung (User Account Control, UAC) bietet, müssen Sie das Tool möglicherweise mit Administratorrechten ausführen. Klicken Sie hierzu mit der rechten Maustaste auf die Anwendung, und wählen Sie dann Als Administrator ausführen aus.

Weitere Informationen

Importieren von BizTalk-Anwendungen, -Bindungen und -Richtlinien
Exportieren von BizTalk-Anwendungen, -Bindungen und -Richtlinien
Verwalten von Richtlinien