Politique des nouveaux essais

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 4 minutes de lecture

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

    Fonctionnalités

    Les politiques de nouveaux essais peuvent être :
    • Créé 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 la politique des nouveaux essais pour définir :
    • Conditions qui doivent être remplies pour réessayer une étape.
    • Intervalle de temps à attendre avant de réessayer une étape.
    • Nombre maximal de tentatives que l’étape effectue 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 réseau ou une limite de taux de demande. Définissez une politique des nouveaux essais 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 Tout > Centre d'intégration > Politique des nouveaux essais > Créer.
    2. Renseignez les champs du formulaire.
      Tableau 1. Formulaire de la 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 de nouvelle tentative comprennent les opérateurs is, is not, contains et contains not (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 des tentatives suivantes. Le multiplicateur est égal à 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 Réessayer 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 Respecter « 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 temporisation exponentielle et de nouvelle tentative à intervalle fixe .
      Remarque :
      Si la stratégie de nouvelle tentative est une temporisationexponentielle, 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 temporisation exponentielle et de nouvelle tentative à 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 propriété système est de glide.fdih.retry.max_count 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 de nouvelles 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 temps maximal de nouvelle tentative est spécifié dans la glide.fdih.retry.max_time_in_seconds propriété, la valeur de propriété système prévaut 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é, consultez 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_time_in_seconds
      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 de nouvelle tentative
    Exemple de politique de nouvelle tentative lorsque la stratégie de nouvelle tentative est une 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 le délai de connexion
    • La méthode HTTP est GET et le code d’état est 429
    Lorsque la condition est remplie, les tentatives sont effectuées pour un nombre maximum 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 en tant que politique des nouveaux essais par défaut à l’alias de connexion et d’informations d’identification requis.
      Remarque :
      Une politique de nouvelle tentative par défaut est fournie et sélectionnée comme politique de nouvelle tentative par défaut. Si vous avez créé des politiques de nouvelle tentative, vous pouvez sélectionner la politique requise comme politique de nouvelle tentative 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.