DataPower Gateway (Classic) uniquement

Configuration de la règle Définir des variables pour DataPower Gateway (v5 compatible)

Procédez comme suit pour configurer la stratégie Définir une variable pour DataPower® Gateway (v5 compatible) dans l'interface utilisateur de l'assemblage.

A propos de cette tâche

Remarque: Cette rubrique décrit l'implémentation de la stratégie Définir une variable dans DataPower Gateway (v5 compatible). Si vous utilisez DataPower API Gateway, consultez la section « Configuration de la stratégie Set Variable » sur DataPower API Gateway. Pour plus d'informations sur les différents types de passerelle, voir Types de passerelleAPI Connect.

Pour plus d'informations sur la configuration de la règle dans votre source OpenAPI, consultez la section « set-variable ».

Procédure

  1. Dans le volet de navigation, cliquez Icône de développement dans le panneau de navigation sur « Développement », puis sélectionnez l'onglet « API ».
    La page Développement s'ouvre.
  2. Cliquez sur le titre de l'API que vous souhaitez utiliser ou créez une nouvelle API.
  3. Sélectionnez l'onglet Passerelle , puis cliquez sur Stratégies dans le panneau de navigation.
    Pour plus d'informations sur l'utilisation de l'éditeur d'assemblages pour une API, consultez la section « L'éditeur d'assemblages ».
  4. Recherchez la règle Définir une variable dans la palette et faites-la glisser sur votre canevas.
  5. Spécifiez les propriétés suivantes.
    Tableau 1. Définir les propriétés de la stratégie
    Libellé de la propriété Obligatoire Descriptif Type de données
    Titre Non Titre de la stratégie.

    La valeur par défaut est set-variable.

    chaîne
    Description Non Description de la stratégie. chaîne
    Action Oui Définit l'action à appliquer à une variable d'exécution.
    Choisissez l'une des valeurs suivantes :
    • Définir : indique que vous souhaitez définir une valeur de chaîne comme valeur d'une variable d'exécution. Peut être utilisée pour définir de nouveaux en-têtes ou remplacer des valeurs existantes.
    • Ajouter : indique que vous souhaitez ajouter une variable d'en-tête. Vous pouvez utiliser cette valeur pour définir de nouveaux en-têtes ou pour ajouter une nouvelle entrée avec le même nom d'en-tête.
    • Effacer : indique que vous souhaitez supprimer une variable d'exécution. Peut être utilisée pour supprimer un en-tête lorsque les données sont traitées dans un flux d'assemblage.

    La valeur par défaut est « Set ».

    chaîne
    Set, Addou Clear Oui Indique le nom de la variable que vous souhaitez définir, ajouter ou effacer en fonction de l'action sélectionnée. chaîne
    Type Oui Sélectionne le type de données de la variable.
    Choisissez l'une des valeurs suivantes :
    • Chaîne
    • number
    • Boolean

    La valeur est validée par rapport au type de données spécifié.

    chaîne
    Valeur Oui* Alloue la valeur à la variable spécifiée. Il peut s'agit d'une valeur littérale ou d'une autre variable.

    * Valeur n'est obligatoire que si Set ou Add est spécifié comme action.

    Par exemple, pour définir (set) une variable nommée billing-hostname par une valeur littérale, vous pouvez donner à Value la valeur acme.com.

    Autre exemple : pour définir (set) une variable nommée par la valeur de l'en-tête Content-Type dans une demande, vous pouvez affecter à Valeur la valeur $(request.headers.content-type).

    Si la valeur Type sélectionnée est boolean, cochez la case Valeur pour indiquer la valeur true.

    Remarque: Vous ne pouvez définir que des éléments de chaîne uniques. Les valeurs sont extraites sous forme de chaînes ; vous ne pouvez donc pas cloner la totalité d'un ensemble de noeuds.
    chaîne
  6. Spécifiez une version pour la politique en cliquant sur l'icône Source et en complétant la version section OpenAPI Icône Sourcecorrespondante du fichier YAML de la politique. Par exemple :
    execute:
      - set-variable:
          version: 1.0.0
          title: set-variable
      ...
    Vous devez spécifier une version pour la règle compatible avec la passerelle que vous utilisez. Lorsque l'API est publiée, si la version est incompatible avec la passerelle, une erreur de validation indiquant les versions disponibles est émise.
  7. Cliquez sur Sauvegarder.

Exemple

Pour des exemples, voir « set-variable ».