Scripts de Webhooks

Publicación en Webhooks

La tabla siguiente describe todos los parámetros que puedes usar con el script Publish-Webhooks.ps1.

Parámetro	Descripción
`-action`	Indica el escenario que se ejecuta, las opciones disponibles son: `Deploy` - especifica que se trata de una instalación limpia; `Update`: especifica que estás actualizando tu instancia de servicio de Webhook.
`-azureAccountApplicationId`	El ID principal del servicio de Azure. Nota: el principal servicio indicado debe asignarse el rol de Colaborador al servicio de aplicaciones en el ámbito de la suscripción.
`-azureAccountPassword`	La contraseña de token de Azure para el ID principal de servicio.
`-azureSubscriptionId`	El ID de suscripción de Azure para el Servicio de aplicaciones correspondiente.
`-azureAccountTenantId`	El ID de tenant de Azure.
`-appServiceName`	El nombre del servicio de aplicaciones de Azure de Webhook. Nota: este debe ser distinto a tu nombre del Servicio de aplicaciones de Orchestrator.
`-orchestratorUrl`	Obligatorio. La URL de la instancia de Orchestrator.
`-resourceGroupName`	El nombre del grupo de recursos de Azure que contiene el Servicio de aplicaciones de Webhook.
`-package`	Indica la ruta completa o relativa del archivo `UiPath.WebhookService.zip`.
`-stopApplicationBeforePublish`	Cuando está presente, detiene la aplicación antes de iniciar la implementación y luego la reinicia una vez que la implementación finaliza.
`-azureUSGovernmentLogin`	Opcional. Este parámetro solo se utiliza para las implementaciones del gobierno de los Estados Unidos.

En tu instalación del servicio de aplicaciones de Azure de Orchestrator, también deberás realizar estos pasos para instalar el servicio Webhooks:

Desde tu portal de Azure, crea una nueva aplicación web con un nombre personalizado, por ejemplo: UiPathWebhookService.
En el campo Publicar, selecciona Código.
Para Pila de tiempo de ejecución selecciona .NET Core 3.1.
Abre tu nueva aplicación web y ve a Ajustes > Configuración.
Desde la pestaña Configuración general, selecciona 64 bits para la Plataforma.
Selecciona Guardar.

Importante: Si no has creado previamente una aplicación y un servicio principal de Azure AD desde la instalación de Orchestrator en Azure, hazlo ahora.Tienes que configurarlos para poder acceder a tu UiPathWebhookService y a tu grupo de recursos.
Abre una ventana de Powershell y ejecuta el script Publish-Webhooks.ps1. Por ejemplo:
```
.\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>"
```
Importante: Después de una implementación inicial, también debes ejecutar el script MigrateTo-Webhooks.ps1.

Migrar a Webhooks

La tabla siguiente describe todos los parámetros que puedes usar con el script MigrateTo-Webhooks.ps1.

Parámetros	Descripción
`-cliPackage`	Indica la ruta al archivo `UiPath.WebhookService.Migrate.Cli.zip`.
`-azureDetails`	Una tabla hash con los siguientes valores: `azureAccountApplicationId`: el ID principal del servicio de Azure. `azureAccountPassword`: la contraseña de token de Azure para el ID principal de servicio. `azureSubscriptionId`- El ID de suscripción de Azure para el servicio de aplicaciones respectivo. `azureAccountTenantId`: el ID de tenant de Azure.
`-orchDetails`	Una tabla hash con los siguientes valores: `resourceGroupName` - El nombre del grupo de recursos de Azure que contiene el Servicio de aplicaciones de Orchestrator. `appServiceName`- El nombre del servicio de aplicaciones de Orchestrator. `targetSlot` - La ranura del servicio de aplicaciones de destino establecida por Azure.
`-webhooksDetails`	Una tabla hash con los siguientes valores: `resourceGroupName` - El nombre del grupo de recursos de Azure que contiene Orchestrator App Service. `appServiceName` - el nombre del servicio de aplicaciones de Webhook. `targetSlot` - La ranura del servicio de aplicaciones de destino establecida por Azure.

Este script MigrateTo-Webhooks.ps1 se utiliza para migrar los datos desde una instancia de Orchestrator existente a un nuevo servicio de aplicaciones de Webhooks y establecer las configuraciones para ambas. El script da por supuesto que Orchestrator y los Webhooks ya han sido publicados.

.\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" }