Webhooks AppSettings.json

Le fichier appsetting.json (C:\Program Files (x86)\UiPath\Orchestrator\Webhooks) contient les paramètres prêts à l’emploi du service Webhook. Il est recommandé de configurer vos paramètres personnalisés dans appsetting.Production.json. Ce fichier remplace tous les paramètres préexistants dans appsetting.json après chaque processus d’installation.

Remarque : Il est recommandé que seuls les administrateurs modifient les valeurs de ces paramètres.

En outre, il est conseillé d'arrêter le serveur IIS afin de modifier les paramètres de appsetting.Production.json, en toute circonstance.

Les paramètres qui ne sont pas documentés dans cette page ne doivent pas être modifiés.

Tous les paramètres sont sensibles à la casse.

Priorité des paramètres

Les paramètres peuvent être configurés à plusieurs endroits. Voici les priorités utilisées par le service Webhook pour déterminer la valeur d'un paramètre, répertoriées de haute (1) à basse (3) :

1. Valeur dans le fichier appsettings.Production.json
2. Valeur dans le fichier appsettings.json
3. Réglage de la valeur par défaut dans le code. Utilisé uniquement si un paramètre spécifique ne peut être trouvé dans appsettings.Production.json ou appsettings.json.

Paramètres

Le fichier appsettings.json bénéficie d’une structure interne composée de plusieurs sections json séparées par une virgule.

Paramètres du client Orchestrator SQL

"OrchestratorSqlClientSettings": {
    "ConnectionString": "<OrchestratorConnectionString>",
    "Enabled": true
  },

ConnectionString

Chaîne de connexion générée par l’instance Orchestrator à laquelle vous souhaitez vous connecter.

Configuration du service Webhook

"WebhookServiceConfig": {
    "MaxWorkerCount": 10,
    "HttpClientUserAgent": "UiPath-WebhookService/Webhooks",
    "RequestTimeout": "0.00:01:00",
    "RetryAfter": [
      "0.00:00:0",
      "0.00:00:45",
      "0.00:02:30",
      "0.00:05:00"
    ],
    "MaxRetryRequests": 2    
    "SubscriberCircuitBreakerExpirationSeconds": 600
  },

RequestsTimeout

Le délai après lequel chaque demande HTTP est annulée. Notez que chaque requête qui expire est retentée, en fonction de la valeur RetryAfter. Par défaut, le délai d'expiration est défini à 1 minute.

RetryAfter

Le temps écoulé, en secondes, qui succède à chaque nouvelle tentative échouée. Par défaut, les quatre tentatives sont définies comme suit :

• La première nouvelle requête de nouvelle tentative est exécutée immédiatement après l’échec de la première.
• La deuxième nouvelle tentative est exécutée 45 secondes après l’échec de la première nouvelle tentative.
• la troisième nouvelle tentative est exécutée 2 minutes et 30 secondes après l’échec de la seconde.

• la quatrième nouvelle tentative est exécutée 5 minutes après l’échec de la troisième.

  Vous pouvez modifier le nombre de retards en répertoriant un nombre inférieur d’entrées ou si vous diminuez la valeur de MaxRetryRequests. Nous vous recommandons de toujours définir la première nouvelle tentative sur 0 et de ne jamais définir des durées supérieures à 300 secondes (5 minutes) entre chaque tentative.

MaxRetryRequests

Le nombre maximum de tentatives en cas d’échec d’une demande.

MaxWorkerCount

Le nombre maximum de Webhooks qui peuvent être activés par locataire. Par défaut, il est configuré à 10.

SecondesExpirationDisjoncteurAbonné

Le délai, en secondes, avant que les Webhooks arrêtent d’envoyer des messages à l’abonné ayant signalé une défaillance. Sa valeur est définie sur 600 par défaut. Si la valeur du paramètre est définie sur 0, la fonctionnalité est désactivée et les défaillances seront ignorées. Vous trouverez davantage d’informations sur le fonctionnement de ce modèle ici.

Configuration du grand livre

"LedgerConfiguration": {
    "Enabled": true,
    "Subscribers": [
      {
        "LedgerComponentType": 0,
        "ComponentId": "WebhookSubscriber",
        "Topics": null,
        "ConnectionString": "<OrchestratorConnectionString>",
        "EstablishNewConnection": false,
        "LedgerSubscriberDeliveryType": 1,
        "LedgerSubscriberReliability": 1,
        "Enabled": true,
        "LedgerComponentClassType": 2,
        "Context": "{\"BatchSize\": 500, \"DeliveriesBatchSize\": 500}"
      }
    ]
  },

Remarque : l’infrastructure de journalisation est identique à celle du service Orchestrator.

ConnectionString

Chaîne de connexion générée par l’instance Orchestrator à laquelle vous souhaitez vous connecter.

"ApplicationInsights": {
    "InstrumentationKey": "<AI_InstrumentationKey>"
  },

InstrumentationKey

Requis si vous utilisez l’application Insights.

Pour en savoir plus, consultez la documentation officielle Créer une ressource Application Insights.