Scripts Webhooks

Publier sur des Webhooks

La table suivante décrit tous les paramètres pouvant être utilisés avec le script Publish-Webhooks.ps1.

Paramètre	Description
`-action`	Indiquez le scénario à exécuter, les options disponibles sont : `Deploy` : indique qu'il s'agit d'une nouvelle installation ; `Update` - indique que vous mettez à jour votre instance du service Webhook.
`-azureAccountApplicationId`	L'identifiant principal du service Azure. Remarque: l'identifiant principal du service indiqué doit se voir attribuer le rôle de contributeur au sein du service d'application dans le cadre de l'abonnement.
`-azureAccountPassword`	Mot de passe du jeton Azure pour l'ID de principal de service.
`-azureSubscriptionId`	ID d'abonnement Azure du service d'application respectif.
`-azureAccountTenantId`	Les identifiants du locataire Azure.
`-appServiceName`	Nom du service d'application Azure de Webhook. Remarque: il doit être différent du nom de votre service d’application Orchestrator.
`-orchestratorUrl`	Obligatoire. L'URL de l'instance Orchestrator.
`-resourceGroupName`	Nom du groupe de ressources Azure qui contient l'application Webhook App Service.
`-package`	Indiquez le chemin complet ou le chemin relatif de l'archive `UiPath.WebhookService.zip`.
`-stopApplicationBeforePublish`	Lorsqu'il est actif, il arrête l'application avant de commencer le déploiement et la redémarre une fois le déploiement terminé.
`-azureUSGovernmentLogin`	Facultatif. Ce paramètre est uniquement utilisé pour les déploiements du gouvernement américain.

Dans le cadre de votre installation d'Orchestrator sur Azure App service, vous devez également effectuer les étapes suivantes pour installer le service Webhooks :

Depuis votre portail Azure, créez une nouvelle application Web avec un nom personnalisé, par exemple : UiPathWebhookService.
Dans le champ Publier, sélectionnez Code.
Pour Pile d'exécution, sélectionnez .NET Core 3.1.
Ouvrez votre nouvelle application Web et naviguez vers Paramètres > Configuration.
Sous l’onglet Paramètres généraux, sélectionnez 64 bits pour la plate-forme.
Sélectionnez Enregistrer (Save).

Attention : si vous n'avez pas précédemment créé d'application Azure AD et de principal de service à partir de l'installation d'Orchestrator sur Azure, créez-les maintenant. Vous devez les configurer pour pouvoir accéder à votre UiPathWebhookService et à votre groupe de ressources.
Ouvrez une fenêtre Powershell et exécutez le script Publish-Webhooks.ps1. Par exemple :
```
.\Publish-Webhooks.ps1 `
-action deploy `
-package ".\UiPath.WebhookService.Web.zip" `
-azureAccountApplicationId "<AzureApplicationID>" `
-azureAccountPassword "<AzureAccountPassword>" `
-azureSubscriptionId "<SubscriptionID>" `
-azureAccountTenantId "<TenantID>" `
-resourceGroupName "<AzureResourceGroupYouPickedInStep1>" `
-appServiceName "<UiPathWebhookService>".\Publish-Webhooks.ps1 `
-action deploy `
-package ".\UiPath.WebhookService.Web.zip" `
-azureAccountApplicationId "<AzureApplicationID>" `
-azureAccountPassword "<AzureAccountPassword>" `
-azureSubscriptionId "<SubscriptionID>" `
-azureAccountTenantId "<TenantID>" `
-resourceGroupName "<AzureResourceGroupYouPickedInStep1>" `
-appServiceName "<UiPathWebhookService>"
```
Important : Après un premier déploiement, vous devez également exécuter le script MigrateTo-Webhooks.ps1.

Migrer vers Webhooks

La table suivante décrit tous les paramètres pouvant être utilisés avec le script MigrateTo-Webhooks.ps1.

Paramètres	Description
`-cliPackage`	Indiquez le chemin d'accès à l'archive `UiPath.WebhookService.Migrate.Cli.zip`.
`-azureDetails`	Une table de hachage avec les valeurs suivantes : `azureAccountApplicationId` - ID principal du service Azure. `azureAccountPassword` - Mot de passe du jeton Azure pour l'ID de principal de service. `azureSubscriptionId` - ID d'abonnement Azure du service d'application respectif. `azureAccountTenantId` - ID du locataire Azure.
`-orchDetails`	Une table de hachage avec les valeurs suivantes : `resourceGroupName` - Nom du groupe de ressources Azure qui contient l'application App Service d'Orchestrator. `appServiceName` - nom du service de l'application Orchestrator. `targetSlot` - créneau de service de l'application cible fixé par Azure.
`-webhooksDetails`	Une table de hachage avec les valeurs suivantes : `resourceGroupName` - nom du groupe de ressources Azure qui contient le service de l'application Webhook. `appServiceName` - nom du service de l'application Webhook. `targetSlot` - créneau de service de l'application cible fixé par Azure.

Ce script MigrateTo-Webhooks.ps1 est utilisé pour migrer les données d'une instance Orchestrator existante vers un nouveau service d'application Webhook et définir les configurations pour les deux. Le script suppose qu'Orchestrator et les Webhooks ont déjà été publiés.

.\MigrateTo-Webhooks.ps1 `
    -cliPackage "UiPath.WebhookService.Migrator.Cli.zip"`
    -azureDetails @{azureSubscriptionId = "<subscription_id>"; azureAccountTenantId = "<azure_tenant_id>"; azureAccountApplicationId = "<azure_application_id>"; azureAccountPassword = "<azure_account_password>" } `
    -orchDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>";  targetSlot = "Production" } `
    -webhookDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>"; targetSlot = "Production" }.\MigrateTo-Webhooks.ps1 `
    -cliPackage "UiPath.WebhookService.Migrator.Cli.zip"`
    -azureDetails @{azureSubscriptionId = "<subscription_id>"; azureAccountTenantId = "<azure_tenant_id>"; azureAccountApplicationId = "<azure_application_id>"; azureAccountPassword = "<azure_account_password>" } `
    -orchDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>";  targetSlot = "Production" } `
    -webhookDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>"; targetSlot = "Production" }