Politique des nouveaux essais

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 4 minutes de lecture

    • Relancez automatiquement les demandes ayant échoué lorsqu’une étape rencontre un problème intermittent, tel qu’une défaillance du réseau ou une limite de taux de demande. Définissez une politique de nouvelle tentative pour éviter d’avoir à déclencher à nouveau manuellement l’étape.

    Fonctionnalités

    Les politiques de nouveaux essais peuvent être :
    • Créée pour prendre en charge les délais de connexion ou les demandes ayant échoué en fonction de l’en-tête, de l’état, du corps de la réponse, de l’erreur et de la méthode HTTP.
    • Appliqué à toutes les actions qui utilisent un alias de connexion donné.
    • Appliqué directement à une étape d’action.
    Utilisez les stratégies des nouveaux essais pour définir :
    • Conditions qui doivent être remplies pour relancer une étape.
    • Intervalle de temps à attendre avant de réessayer une étape.
    • Nombre maximal de tentatives effectuées par l’étape avant de s’arrêter.
    Associez une politique de nouvelle tentative par défaut à un alias de connexion et d’informations d’identification et appliquez la politique de nouvelle tentative à toutes les connexions HTTP.
    Remarque :
    Vous ne pouvez créer des politiques de nouvelle tentative que pour les étapes JDBC, REST et SOAP.

    Créer une politique des nouveaux essais

    Relancez automatiquement les demandes ayant échoué lorsqu’une étape rencontre un problème intermittent, tel qu’une défaillance du réseau ou une limite de taux de demande. Définissez une politique de nouvelle tentative pour éviter d’avoir à déclencher à nouveau manuellement l’étape.

    Avant de commencer

    • Rôle requis : connection_admin ou credential_admin

    Procédure

    1. Accédez à la Tous > Centre d'intégration > Politique des nouveaux essais > Créer.
    2. Renseignez les champs du formulaire.
      Tableau 1. Formulaire Politique des nouveaux essais
      Champ Description
      Nom Nom permettant d’identifier de façon unique la politique des nouveaux essais.
      Type de connexion Protocole HTTP
      Condition Conditions qui doivent être remplies pour déclencher la politique des nouveaux essais. Les conditions qui déclenchent une politique des nouveaux essais comprennent les opérateurs est, n’est pas, contient et ne contient pas .
      Stratégie de nouvelle tentative
      • Temporisation exponentielle : option permettant d’augmenter de façon exponentielle l’intervalle de temps pour les tentatives suivantes. Le multiplicateur est de 2.
      • Intervalle fixe : option permettant de spécifier un intervalle de temps fixe après lequel une nouvelle tentative doit être effectuée.
      • Respecter l’en-tête « Réessayer-après » : option permettant de spécifier une nouvelle tentative en fonction de la valeur de date et d’heure renvoyée dans la valeur d’en-tête Recommencer après de la demande HTTP. Pour plus d’informations sur l’en-tête, consultez RFC 7231, section 7.1.3 : Réessayer après.
        Remarque :
        L’en-tête Honor « Réessayer-après » prend uniquement en charge les étapes REST et SOAP.
      Intervalle (en secondes) Intervalle de temps, en secondes, après lequel une nouvelle tentative doit être effectuée. Ce champ s’applique uniquement aux stratégies de nouvelle tentative de temporisation exponentielle et d’intervalle fixe .
      Remarque :
      Si la stratégie de nouvelle tentative est Temporisation exponentielle, l’intervalle de temps augmente de façon exponentielle après chaque nouvelle tentative jusqu’à ce que le nombre maximal de tentatives soit atteint.
      Nombre Nombre maximal de nouvelles tentatives. Ce champ s’applique uniquement aux stratégies de nouvelle tentative de temporisation exponentielle et d’intervalle fixe . Si aucune valeur n’est spécifiée, le nombre maximal de tentatives est basé sur la valeur fournie dans la glide.fdih.retry.max_count propriété système. La valeur par défaut de la glide.fdih.retry.max_count propriété système est 0. Pour plus d’informations sur les propriétés système, consultez Propriétés système disponibles.
      Temps écoulé maximal (en secondes) Temps cumulé maximal, en secondes, après lequel les tentatives sont arrêtées. Ce champ s’affiche uniquement lorsque l’en-tête Respecter « Réessayer-Après » est sélectionné dans la stratégie de nouvelle tentative.
      Remarque :
      Si le délai maximal de nouvelle tentative est spécifié dans la glide.fdih.retry.max_time_in_seconds propriété, la valeur de la propriété système a priorité sur la valeur de ce champ. Assurez-vous également que le temps écoulé maximal est égal ou supérieur à la valeur de la propriété système.
    3. Facultatif : Créez une propriété système globale avec les attributs suivants.
      Pour plus d’informations sur la création d’une propriété, reportez-vous à la rubrique Ajouter une propriété système. Vous pouvez utiliser cette propriété système pour spécifier la durée maximale, en secondes, d’une politique de nouvelle tentative.
      Champ Valeur
      Nom glide.fdih.retry.max_durée_en_secondes
      Type entier
      Valeur Valeur par défaut : 86 400 (secondes) Durée maximale prise en charge : 604 800 (secondes)
    4. Cliquez sur Envoyer.

    Politique des nouveaux essais avec stratégie des nouveaux essais comme temporisation exponentielle

    Figure 1. Exemple de politique des nouveaux essais
    Exemple de politique de nouvelle tentative lorsque la stratégie de nouvelle tentative est Temporisation exponentielle
    Dans cet exemple, la politique est définie pour tenter une nouvelle tentative lorsque l’une des conditions suivantes est remplie :
    • La méthode HTTP est GET et l’erreur est Délai de connexion
    • La méthode HTTP est GET et le code d’état est 429
    Lorsque la condition est remplie, les nouvelles tentatives sont effectuées un nombre maximal de trois fois. L’intervalle de temps entre les tentatives augmente de façon exponentielle. Dans cet exemple, les intervalles de temps sont de 10 secondes, 20 secondes et 40 secondes.

    Que faire ensuite

    • Créez un alias de connexion et d’informations d’identification, si vous n’avez pas l’alias requis.
    • Affecter la politique des nouveaux essais comme politique des nouveaux essais par défaut à l’alias de connexion et d’informations d’identification requis.
      Remarque :
      Une politique de nouveaux essais par défaut est fournie et sélectionnée comme politique de nouveaux essais par défaut. Si vous avez créé des politiques de nouveaux essais, vous pouvez sélectionner celle requise en tant que politique de nouveaux essais par défaut.
    • Créez une connexion HTTP(s) dans la liste connexe Connexions pour l’alias de connexion et d’informations d’identification. Pour plus d’informations, consultez Connexions et informations d’identification.
    • Vérifiez et affichez les détails des tentatives en accédant à Journaux système > Demandes HTTP sortantes.