Schritt 1: Hinzufügen des BizTalk Server-Anwendungsprojekts in Visual Studio

2025-06-05

Wenn Sie Ihre Anwendungen mit Visual Studio Team Services erstellen, wird eine neue BizTalk-Projektdatei erstellt – btaproj. Dieses neue Projekt enthält alle BizTalk-Anwendungen, die Sie mithilfe der Azure DevOps-Build- und Releasefeatures erstellen und bereitstellen.

Das BizTalk Application Project enthält die BizTalkServerInventory.json Datei. Fügen Sie in dieser Datei Ihre BizTalk-Assemblys hinzu, fügen Sie die Bindungsdateien für Ihre BizTalk-Anwendung hinzu, und legen Sie dann eine Bereitstellungssequenz fest.

Bevor Sie anfangen

Erstellen Sie ein einfaches BizTalk-Projekt mit Orchestrierung.
Lassen Sie den Pfad zur XML-Bindungsdatei zu Ihrem BizTalk-Projekt bereit. Diese XML-Datei erstellt Ihren Sende- und Empfangsport.
Kennen Sie Ihr Azure DevOps-Konto, Ihre Sammlung und Ihre Teamprojektdetails.
Machen Sie sich mit Git-Konzepten vertraut, einschließlich Klonen und Arbeiten mit Repositorys.

Hinzufügen des Anwendungsprojekts

Öffnen Sie auf dem BizTalk Server Ihre Projektdatei (ProjectName.sln) in Visual Studio. Wählen Sie Visual Studio Blend nicht aus.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt und wählen Sie >Erstellen. Stellen Sie sicher, dass Ihr Build erfolgreich ist. Klicken Sie mit der rechten Maustaste auf Ihr Projekt >Bereitstellen. Stellen Sie sicher, dass die Bereitstellung Erfolg hat.
Klicken Sie mit der rechten Maustaste auf Ihre Lösung >Hinzufügen>Neues Projekt hinzufügen.
Wählen Sie "BizTalk Server Application Project>Next" aus. Geben Sie einen Projektnamen ein, zappProjectHelloWorld>. B. "Erstellen".
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das neu hinzugefügte Anwendungsprojekt (.btaproj) >Hinzufügen>Verweis. Erweitern Sie die Registerkarte "Projekte ", und überprüfen Sie Ihr BizTalk-Projekt (das Projekt, das Sie mit Azure DevOps bereitstellen). Wählen Sie OK aus.

Erweitern Sie nach dem Hinzufügen Verweise unter Ihrem Anwendungsprojekt (z. B. appProjectHelloWorld), um das soeben hinzugefügte BizTalk-Projekt anzuzeigen.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihr Anwendungsprojekt (.btaproj) >Hinzufügen>Vorhandenes Element>, um Ihre XML-Bindungsdatei hinzuzufügen.
Wahlfrei. Klicken Sie mit der rechten Maustaste auf die neu hinzugefügten Anwendungsprojekteigenschaften>. Passen Sie den gewünschten Anwendungsnamen in der BizTalk-Verwaltung an:

Konfigurieren der JSON-Vorlage

Öffnen Sie in Visual Studio in Ihrem Anwendungsprojekt (.btaproj) die BizTalkServerInventory.json Datei.
Die Vorlage besteht aus den folgenden Abschnitten:
- BizTalkAssemblies: Die Assemblies, die in Ihren Anwendungen verwendet werden.
- BindingFiles: Die Bindungsdateien, auf die Sie verweisen.
- DeploymentSequence: Die Sequenz für die zu installierenden Elemente.
Beispielvorlage:

Von Bedeutung

Je nach Komplexität Ihrer Lösung müssen die gewünschten Elemente im Build in dieser JSON-Vorlagendatei referenziert werden.

Fügen Sie in BizTalkAssemblies die Assemblys hinzu, die von Ihrem BizTalk-Projekt verwendet werden:

"BizTalkAssemblies": [
    {
        "Name": "AssemblyName",
        "Path": "PathToAssembly
    }
]

Fügen Sie in BindingsFiles die Bindungsdateien für Ihr BizTalk-Projekt hinzu:

"BindingsFiles": [
    {
        "Name": "Binding File Name",
        "Path": "PathToBindingFile
    }
]

DeploymentSequenceFügen Sie in der Reihenfolge, in der sie bereitgestellt werden sollen, die Anwendungsnamen hinzu, und installieren Sie sie auf dem BizTalk Server:
```
"DeploymentSequence": [
    "NameOfFirst",
    "NameOfSecond",
    "NameOfThird"
]
```

Speichern Sie die Änderungen. Wenn Sie fertig sind, sieht ihre .json Datei wie folgt aus:

{
  "$schema": "http://json.schemastore.org/BizTalkServerApplicationSchema",
  "BizTalkAssemblies": [
    {
      "Name": "HelloWorld",
      "Path": "HelloWorld\\bin\\Release\\HelloWorld.dll"
    }
  ],
  "BindingsFiles": [
    {
      "Name": "HelloWorldBinding",
      "Path": "HelloWorld\\HelloWorldBinding.xml"
    }
  ],
  "DeploymentSequence": [
    "HelloWorld", "HelloWorldBinding"
  ]
}

Optional. Klicken Sie mit der rechten Maustaste auf Ihr Anwendungsprojekt (z. B. appProjectHelloWorld) >-Eigenschaften. Sie können die Debug- oder Releaseversion auf einen neuen Wert festlegen. Wir sind in diesen Schritten nicht dabei, wissen aber, dass Sie:
Klicken Sie mit der rechten Maustaste auf Ihr Anwendungsprojekt (z. B. appProjectHelloWorld) >Build. Wenn die Datei erfolgreich ist, wird eine ZIP-Datei im Ordner "ApplicationProject\bin\debug " erstellt:
Wählen Sie Ihre Projektmappe aus, und wählen Sie die Registerkarte "Team Explorer " aus. Wählen Sie unter Azure DevOps die Option "Verbinden" aus.
Wählen Sie Ihr Azure DevOps-Konto, Ihre Sammlung und Ihr Teamprojekt aus. Wählen Sie OK aus. Wenn Sie noch kein Azure DevOps-Konto erstellt haben, erstellen Sie ein Konto (Schritt 2: Erstellen des Azure DevOps-Tokens enthält einige Anleitungen). Sobald sie erstellt wurde, kehren Sie zu diesem Schritt zurück, und stellen Sie eine Verbindung her.
Wenn Sie eine Verbindung herstellen, erhalten Sie möglicherweise eine Eingabeaufforderung, um dieses Repository zu klonen. Wählen Sie den Clone this repository-Link aus.
Notieren Sie sich die URL und Pfade, und wählen Sie Klonieren aus:

Nach Abschluss berücksichtigt die Azure DevOps-Bereitstellungsaufgabe die erforderlichen Dateien und die Installationssequenz.

Tipp

Wenn Sie Änderungen am Projekt vornehmen, nachdem Sie git geklont haben, können Sie Ihre Änderungen stufen und dann in Visual Studio pushen.

Was Sie getan haben

In Ihrem BizTalk-Projekt haben Sie ein BizTalk Application-Projekt (.btaproj) hinzugefügt. Dieses Projekt wird verwendet, um Bereitstellungen Ihrer BizTalk Server-Projekte mithilfe von Azure DevOps zu automatisieren. Nachdem Sie das Anwendungsprojekt erstellt haben, haben Sie ihrem BizTalk-Projekt einen Verweis hinzugefügt. Anschließend haben Sie eine JSON-Datei aktualisiert, die die automatisierte Bereitstellung angibt, welche DLLs bereitgestellt werden sollen, welche Bindungsdatei verwendet werden soll, und die Reihenfolge zum Bereitstellen der Anwendungen.

Nächste Schritte

Schritt 2: Erstellen des Azure DevOps-Tokens
Schritt 3: Erstellen der Builddefinitionen
Schritt 4: Erstellen der Releasedefinition
Konfigurieren von Umgebungstoken und Variablen

Freigeben über