Política AssignMessage

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X.
información

Qué

La política AssignMessage cambia o crea nuevos mensajes de solicitud y respuesta durante el flujo del proxy de API. La política te permite realizar las siguientes acciones en esos mensajes:

  • Agregar nuevos parámetros de formulario, encabezados o parámetros de búsqueda a un mensaje
  • Copiar las propiedades existentes de un mensaje a otro
  • Quitar encabezados, parámetros de consulta, parámetros de formulario o mensaje cargas útiles de un mensaje
  • Establecer el valor de las propiedades existentes en un mensaje

Con la política AssignMessage, por lo general, puedes agregar, cambiar o quitar propiedades del solicitud o respuesta. Sin embargo, también puedes usar la políticaAssignMessage para crear una de solicitud o respuesta y pasarlo a un destino alternativo, como se describe en Crea mensajes de solicitud personalizados.

La política AssignMessage puede crear o cambiar variables de flujo con los siguientes elementos secundarios:

Elemento <AssignMessage>

Define una política de AssignMessage.

Valor predeterminado Consulta la pestaña Política predeterminada, a continuación
¿Es obligatorio? Obligatorio
Tipo Objeto complejo
Elemento principal n/a
Elementos secundarios <Add>
<AssignTo>
<AssignVariable>
<Copy>
<DisplayName>
<IgnoreUnresolvedVariables>
<Remove>
<Set>

El elemento <AssignMessage> usa la siguiente sintaxis:

Sintaxis

El elemento <AssignMessage> usa la siguiente sintaxis:

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <!-- All AssignMessage child elements are optional -->
  <Add>
    <FormParams>
      <FormParam name="formparam_name">formparam_value</FormParam>
      ...
    </FormParams>
    <Headers>
      <Header name="header_name">header_value</Header>
      ...
    </Headers>
    <QueryParams>
      <QueryParam name="queryparam_name">queryparam_value</QueryParam>
      ...
    </QueryParams>
  </Add>

  <AssignTo createNew="[true|false]" transport="http"
    type="[request|response]">destination_variable_name</AssignTo>

  <AssignVariable>
    <Name>variable_name</Name>
    <Ref>source_variable</Ref>
    <Template>message_template</Template>
    or
    <Template ref='template_variable'></Template>
    <Value>variable_value</Value>
  </AssignVariable>

  <Copy source="[request|response]">
    <!-- Can also be an empty array (<FormParams/>) -->
    <FormParams>
      <FormParam name="formparam_name">formparam_value</FormParam>
      ...
    </FormParams>
    <!-- Can also be an empty array (<Headers/>) -->
    <Headers>
      <Header name="header_name">header_value</Header>
      ...
    </Headers>
    <Path>[false|true]</Path>
    <Payload>[false|true]</Payload>
    <!-- Can also be an empty array (<QueryParams/>) -->
    <QueryParams>
      <QueryParam name="queryparam_name">queryparam_value</QueryParam>
      ...
    </QueryParams>
    <ReasonPhrase>[false|true]</ReasonPhrase>
    <StatusCode>[false|true]</StatusCode>
    <Verb>[false|true]</Verb>
    <Version>[false|true]</Version>
  </Copy>

  <DisplayName>policy_display_name</DisplayName>

  <IgnoreUnresolvedVariables>[true|false]</IgnoreUnresolvedVariables>

  <Remove>
    <!-- Can also be an empty array (<FormParams/>) -->
    <FormParams>
      <FormParam name="formparam_name">formparam_value</FormParam>
      ...
    </FormParams>
    <!-- Can also be an empty array (<Headers/>) -->
    <Headers>
      <Header name="header_name">header_value</Header>
      ...
    </Headers>
    <Payload>[false|true]</Payload>
    <!-- Can also be an empty array (<QueryParams/>) -->
    <QueryParams>
      <QueryParam name="queryparam_name">queryparam_value</QueryParam>
      ...
    </QueryParams>
  </Remove>

  <Set>
    <FormParams>
      <FormParam name="formparam_name">formparam_value</FormParam>
      ...
    </FormParams>
    <Headers>
      <Header name="header_name">header_value</Header>
      ...
    </Headers>
    <Path>path</Path>
    <Payload contentType="content_type" variablePrefix="prefix"
        variableSuffix="suffix">new_payload</Payload>
    <QueryParams>
      <QueryParam name="queryparam_name">queryparam_value</QueryParam>
      ...
    </QueryParams>
    <ReasonPhrase>reason_for_error or {variable}</ReasonPhrase>
    <StatusCode>HTTP_status_code or {variable}</StatusCode>
    <Verb>[GET|POST|PUT|PATCH|DELETE|{variable}]</Verb>
    <Version>[1.0|1.1|{variable}]</Verb>
  </Set>

</AssignMessage>

Política predeterminada

En el siguiente ejemplo, se muestra la configuración predeterminada cuando se agrega una políticaAssignMessage a tu flujo en la IU de Edge:

<AssignMessage continueOnError="false" enabled="true" name="assign-message-default">
  <DisplayName>Assign Message-1</DisplayName>
  <Properties/>
  <Copy source="request">
    <Headers/>
    <QueryParams/>
    <FormParams/>
    <Payload/>
    <Verb/>
    <StatusCode/>
    <ReasonPhrase/>
    <Path/>
  </Copy>
  <Remove>
    <Headers>
      <Header name="h1"/>
    </Headers>
    <QueryParams>
      <QueryParam name="q1"/>
    </QueryParams>
    <FormParams>
      <FormParam name="f1"/>
    </FormParams>
    <Payload/>
  </Remove>
  <Add>
    <Headers/>
    <QueryParams/>
    <FormParams/>
  </Add>
  <Set>
    <Headers/>
    <QueryParams/>
    <FormParams/>
    <!-- <Verb>GET</Verb> -->
    <Path/>
  </Set>
  <AssignVariable>
    <Name>name</Name>
    <Value/>
    <Ref/>
  </AssignVariable>
  <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

Cuando insertas una nueva política deAssignMessage en la IU de Edge, la plantilla contiene stubs para todos posibles operaciones. Por lo general, tú seleccionas qué operaciones deseas realizar con esta política y quita el resto de los elementos secundarios. Por ejemplo, si deseas realizar una operación de copia, usa el elemento <Copy> y quita <Add>, <Remove> y otros elementos secundarios de la política para que sea más legible.

Este elemento tiene los siguientes atributos que son comunes a todas las políticas:

Atributo Predeterminada (obligatorio) Descripción
name N/A Obligatorio

El nombre interno de la política. El valor del atributo name puede contener letras, números, espacios, guiones, guiones bajos y puntos. Este valor no puede superar los 255 caracteres.

De forma opcional, usa el elemento <DisplayName> para etiquetar la política en el editor de proxy de la IU de administración con un nombre de lenguaje natural diferente.

continueOnError falso Opcional Si la estableces como "false", muestra un error cuando falla una política. Este es el comportamiento previsto para la mayoría de las políticas. Si su valor es "true", la ejecución del flujo continuará incluso después de que falle la política.
enabled true Opcional Si estableces la política como "true", la aplicarás. Si la estableces como "false", se desactivará la política. La política no se aplicará, incluso si permanece conectada a un flujo.
async   falso Funciones obsoletas Este atributo dejó de estar disponible.

En la siguiente tabla, se proporciona una descripción de alto nivel de los elementos secundarios de <AssignMessage>.

Elemento secundario ¿Es obligatorio? Descripción
Operaciones comunes
<Add> Opcional Agrega información al el objeto de mensaje que especifica el elemento <AssignTo>.

<Add> agrega encabezados o parámetros al mensaje que no existe en el mensaje original. Para reemplazar encabezados o parámetros existentes, usa el elemento <Set>.

<Copy> Opcional Copia información del mensaje especificado por el atributo source al objeto de mensaje especificado por el elemento <AssignTo>.
<Remove> Opcional Borra los elementos especificados de la variable de mensaje especificada en el elemento <AssignTo>.
<Set> Opcional Reemplaza los valores de las propiedades existentes en la solicitud o respuesta, que se especifica con el elemento <AssignTo>.

<Set> reemplaza los encabezados o parámetros que ya existen en el mensaje original. Para agregar encabezados o parámetros nuevos, usa el elemento <Add>.

Otros elementos secundarios
<AssignTo> Opcional Especifica en qué mensaje opera la política AssignMessage. Puede ser la solicitud o la respuesta estándar, o puede ser un mensaje personalizado nuevo.
<AssignVariable> Opcional Asigna un valor a una variable de flujo. Si la variable no existe, <AssignVariable> la crea.
<IgnoreUnresolvedVariables> Opcional Determina si el procesamiento se detiene cuando se encuentra una variable sin resolver.

Cada uno de estos elementos secundarios se describe en las siguientes secciones.

Ejemplos

En los siguientes ejemplos, se muestran algunas de las formas en las que puedes usar la políticaAssignMessage política:

1: Agrega encabezados

En el siguiente ejemplo, se agrega un encabezado a la solicitud con el elemento <Add>:

<AssignMessage continueOnError="false" enabled="true" name="add-headers-1">
  <Add>
    <Headers>
      <Header name="user-agent">{request.user.agent}</Header>
    </Headers>
  </Add>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

2: Quita la carga útil

En el siguiente ejemplo, se borra la carga útil de la respuesta con el elemento <Remove>:

<AssignMessage continueOnError="false" enabled="true" name="remove-1">
  <DisplayName>remove-1</DisplayName>
  <Remove>
    <Payload>true</Payload>
  </Remove>
  <AssignTo createNew="false" transport="http" type="response"/>
</AssignMessage>

3: Modifica la respuesta

En el siguiente ejemplo, se modifica un objeto de respuesta existente cuando se le agrega un encabezado:

<AssignMessage name="modify-response">
  <Set>
    <Headers>
      <Header name="Cache-Hit">{lookupcache.LookupCache-1.cachehit}</Header>
    </Headers>
  </Set>
  <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
  <AssignTo createNew="false" type="response"></AssignTo>
</AssignMessage>

En este ejemplo, no se crea un mensaje nuevo. En su lugar, modifica un mensaje de respuesta existente mediante la adición de un encabezado HTTP.

Debido a que este ejemplo omite un nombre de variable en el elemento <AssignTo> y especifica type como "respuesta", esta política modifica el objeto de respuesta que muestra el servidor de destino.

El encabezado HTTP que esta política agrega al mensaje de respuesta se deriva de una variable propagado por la política LookupCache. Por lo tanto, el mensaje de respuesta modificado por La política de asignación de mensajes contiene un encabezado HTTP que indica si los resultados se extraída de la caché o no. Configurar encabezados en la respuesta puede ser útil para depurar y y la solución de problemas.

4: Configura el contenido dinámico

Puedes usar la asignación de mensajes para incorporar contenido dinámico en la carga útil de los mensajes de respuesta y solicitud.

Para incorporar variables de flujo perimetral en una carga útil XML, encierra la variable designada entre llaves, como en este ejemplo: {prefix.name}.

En el siguiente ejemplo, se incorpora el valor de la variable de flujo del encabezado HTTP user-agent en un elemento XML llamado User-agent:

<AssignMessage name="set-dynamic-content">
  <AssignTo createNew="false" type="response"></AssignTo>
  <Set>
    <Payload contentType="text/xml">
      <User-agent>{request.header.user-agent}</User-agent>
    </Payload>
  </Set>
  <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
</AssignMessage>

Para las cargas útiles JSON, puedes insertar variables usando los atributos variablePrefix y variableSuffix con caracteres delimitadores, como se muestra en el siguiente ejemplo:

<AssignMessage name="set-payload">
  <Payload contentType="application/json" variablePrefix="@" variableSuffix="#">
  {
     "user-agent": "@request.header.user-agent#"
  }
  </Payload>
</AssignMessage>

Para obtener una lista completa de las variables de flujo, consulta Referencia de las variables de flujo.

A partir de la versión 16.08.17 de la nube, también puedes usar llaves para insertar variables.

5: Quita parámetros de búsqueda

En el siguiente ejemplo, se quita el parámetro de búsqueda apikey de la solicitud:

<AssignMessage name="remove-query-param">
  <Remove>
    <QueryParams>
      <QueryParam name="apikey"/>
    </QueryParams>
  </Remove>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

Se recomienda quitar el parámetro de consulta apikey de la solicitud cuando usas la política VerifyAPIKey para la autenticación de usuarios. Haces esto para evitar información de clave sensible para evitar que se pase al destino del backend.

6: Obtén o configura variables

En el siguiente ejemplo, se usan tres políticas de asignación de mensajes:

  1. Crea tres variables de flujo en la solicitud, con valores estáticos.
  2. Obtiene las variables de flujo de forma dinámica en una segunda política en el flujo de solicitudes.
  3. Los establece en la carga útil de la respuesta.
<!-- Policy #1: Set variables in the request -->
<AssignMessage continueOnError="false" enabled="true" name="set-variables">
    <!-- Create a variable named myAppSecret -->
    <AssignVariable>
        <Name>myAppSecret</Name>
        <Value>42</Value>
    </AssignVariable>
    <!-- Create a variable named config.environment -->
    <AssignVariable>
        <Name>config.environment</Name>
        <Value>test</Value>
    </AssignVariable>
    <!-- Create a variable named config.protocol -->
    <AssignVariable>
        <Name>config.protocol</Name>
        <Value>gopher</Value>
    </AssignVariable>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
    <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

En la primera política, el elemento <AssignVariable> crea y establece tres variables en la solicitud. Cada elemento <Name> especifica un nombre de variable, y <Value> especifica el valor.

La segunda política usa el elemento <AssignVariable> para leer los valores y crea tres variables nuevas:

<!-- Policy #2: Get variables from the request -->
<AssignMessage continueOnError="false" enabled="true" name="get-variables">
  <AssignTo createNew="false" transport="http" type="request"/>
  <!-- Get the value of myAppSecret and create a new variable, secret -->
  <AssignVariable>
    <Name>secret</Name>
    <Ref>myAppSecret</Ref>
    <Value>0</Value>
  </AssignVariable>
  <!-- Get the value of config.environment and create a new variable, environment -->
  <AssignVariable>
    <Name>environment</Name>
    <Ref>config.environment</Ref>
    <Value>default</Value>
  </AssignVariable>
  <!-- Get the value of config.protocol and create a new variable, protocol -->
  <AssignVariable>
    <Name>protocol</Name>
    <Ref>config.protocol</Ref>
    <Value>default</Value>
  </AssignVariable>
  <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
</AssignMessage>

En la segunda política, el elemento <Ref> hace referencia a la variable de origen y los elementos <Name> especifican los nombres de las variables nuevas. Si la variable a la que hace referencia el elemento <Ref> no es accesible, puedes usar el valor especificado por el elemento <Value>.

Para probar este conjunto de políticas, haga lo siguiente:

  1. Agrega las políticas número 1 y 2 al flujo de solicitud. Asegúrate de poner la política número 1 antes de la política número 2.
  2. Agrega la tercera política en el flujo de respuesta.
  3. La tercera política usa el elemento <Set> para agregar las variables a la respuesta. El En el siguiente ejemplo, se construye una carga útil de XML en la respuesta que Edge le muestra al cliente:
    <!-- Policy #3: Add variables to the response -->
    <AssignMessage continueOnError="false" enabled="true" name="put-em-in-the-payload">
      <DisplayName>put-em-in-the-payload</DisplayName>
      <Set>
        <Payload contentType="application/xml">
          <wrapper>
            <secret>{secret}</secret>
            <config>
              <environment>{environment}</environment>
              <protocol>{protocol}</protocol>
            </config>
          </wrapper>
        </Payload>
      </Set>
      <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
      <AssignTo createNew="false" transport="http" type="response"/>
    </AssignMessage>
    

    Ten en cuenta que la sintaxis para acceder a las variables de flujo en <Set> es colocarlas entre llaves.

    Asegúrate de configurar el atributo contentType del elemento <Payload> como "application/xml".

  4. Envía una solicitud a tu proxy de API. por ejemplo:
    curl -vL https://ahamilton-eval-test.apigee.net/myproxy

    De manera opcional, puedes canalizar los resultados a través de una utilidad como xmllint, de modo que el XML se muestre en una estructura con formato adecuado:

    curl -vL https://ahamilton-eval-test.apigee.net/myproxy | xmllint --format -

    El cuerpo de la respuesta debe verse de la siguiente manera:

    <wrapper>
      <secret>42</secret>
      <config>
        <environment>test</environment>
        <protocol>gopher</protocol>
      </config>
    </wrapper>

7: Obtén encabezados de respuesta de texto destacado de servicios

En el siguiente ejemplo, supongamos que una política ServiceCallout está en la solicitud del proxy de API y la respuesta de texto destacado contiene varios encabezados con el mismo nombre (Set-Cookie). Suponiendo que la variable de respuesta del texto destacado del servicio es la calloutResponse predeterminada, la siguiente política obtiene el segundo valor de encabezado Set-Cookie.

<AssignMessage continueOnError="false" enabled="true" name="get-header">
  <Set>
    <Payload contentType="application/json">
      {"Cookies from Service Callout":" {calloutResponse.header.Set-Cookie.2}"}
    </Payload>
  </Set>
  <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

Para enumerar todos los valores de encabezado, usa la siguiente variable en su lugar:

{calloutResponse.header.Set-Cookie.values}

Cada elemento secundario en esta referencia tiene ejemplos adicionales. Para obtener aún más ejemplos, consulta el ejemplo de AssignMessage en GitHub.

Referencia del elemento secundario

En esta sección, se describen los elementos secundarios de <AssignMessage>.

<Add>

Agrega información a la solicitud o respuesta, que se especifica mediante el elemento <AssignTo>.

El elemento <Add> agrega propiedades nuevas en el mensaje que no existe en el mensaje original. Para cambiar los valores de las propiedades existentes, usa el elemento <Set>.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo Tipo complejo
Elemento principal <AssignMessage>
Elementos secundarios <FormParams>
<Headers>
<QueryParams>

El elemento <Add> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Add>
    <FormParams>
      <FormParam name="formparam_name">formparam_value</FormParam>
      ...
    </FormParams>
    <Headers>
      <Header name="header_name">header_value</Header>
      ...
    </Headers>
    <QueryParams>
      <QueryParam name="queryparam_name">queryparam_value</QueryParam>
      ...
    </QueryParams>
  </Add>
</AssignMessage>

Ejemplo 1

En el ejemplo siguiente, se usa el elemento <FormParams> para obtener los valores de tres parámetros de string de consulta de la solicitud inicial y configurarlos como parámetros de forma en la solicitud de extremo de destino:

<AssignMessage continueOnError="false" enabled="true" name="add-formparams-3">
  <Add>
    <FormParams>
      <FormParam name="name">{request.queryparam.name}</FormParam>
      <FormParam name="zip">{request.queryparam.zipCode}</FormParam>
      <FormParam name="lang">{request.queryparam.lang}</FormParam>
    </FormParams>
  </Add>
  <AssignTo transport="http" type="request"/>
</AssignMessage>

Ejemplo 2

En el siguiente ejemplo, se usa el elemento <Headers> para agregar el encabezado User-Agent a la solicitud de extremo de destino:

<AssignMessage continueOnError="false" enabled="true" name="add-headers-1">
  <Add>
    <Headers>
      <Header name="user-agent">{request.user.agent}</Header>
    </Headers>
  </Add>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

Ejemplo 3

En el siguiente ejemplo, se usa el elemento <QueryParams> para agregar un solo parámetro de búsqueda con un valor estático a la solicitud:

<AssignMessage continueOnError="false" enabled="true" name="add-queryparams-1">
  <Add>
    <QueryParams>
      <QueryParam name="myParam">42</QueryParam>
    </QueryParams>
  </Add>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

En este ejemplo, se usa <Add> en el flujo previo de la solicitud. Si observas los resultados como la herramienta de seguimiento, la solicitud a "http://httpbin.org/get" se convierte en &quot;http://httpbin.org/get?myParam=42&quot;.

Los elementos secundarios de <Add> admiten la reemplazo de strings dinámicas, conocida como plantilla de mensajes.

<FormParams> (secundario de <Add>)

Agrega parámetros nuevos del formulario al mensaje de la solicitud. Este elemento no tiene efecto en un mensaje de respuesta.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo Arreglo de elementos <FormParam>
Elemento principal <Add>
Elementos secundarios <FormParam>

El elemento <FormParams> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Add>
    <FormParams>
      <FormParam name="formparam_name">formparam_value</FormParam>
      ...
    </FormParams>
  <AssignTo createNew="[true|false]" transport="http"
    type="[request|response]">destination_variable_name</AssignTo>
  </Add>
</AssignMessage>

Ejemplo 1

En el ejemplo siguiente se agrega un solo parámetro de forma (“respuesta”) y un valor estático (“42”) a la solicitud:

<AssignMessage continueOnError="false" enabled="true" name="add-formparams-1">
  <Add>
    <FormParams>
      <FormParam name="answer">42</FormParam>
    </FormParams>
  </Add>
  <AssignTo transport="http" type="request"></AssignTo>
</AssignMessage>

Ejemplo 2

En el siguiente ejemplo, se obtiene el valor del parámetro de string de consulta name y se agrega a la solicitud como un parámetro de formulario:

<AssignMessage continueOnError="false" enabled="true" name="add-formparams-2">
  <Add>
    <FormParam name="name">{request.queryparam.name}</FormParam>
  </Add>
</AssignMessage>

Ten en cuenta que en este ejemplo no se especifica un objetivo con <AssignTo>. Esta política solo agrega el parámetro a la solicitud.

Ejemplo 3

En el siguiente ejemplo, se agregan varios parámetros de formulario a la solicitud:

<AssignMessage continueOnError="false" enabled="true" name="add-formparams-3">
  <Add>
    <FormParams>
      <FormParam name="name">{request.queryparam.name}</FormParam>
      <FormParam name="zip">{request.queryparam.zipCode}</FormParam>
      <FormParam name="lang">{request.queryparam.lang}</FormParam>
    </FormParams>
  </Add>
  <AssignTo transport="http" type="request"/>
</AssignMessage>

En este ejemplo, se obtienen los parámetros de la string de consulta de la solicitud original y se los agrega como parámetros a la solicitud enviada al extremo de destino.

Puedes usar la herramienta de seguimiento para ver el flujo. Verás que el cuerpo de la solicitud contiene los datos del formulario con codificación URL, que se pasaron originalmente como parámetros de string de consulta:

%7Busername%7D=nick&%7Bzip_code%7D=90210&%7Bdefault_language%7D=en

Solo puedes usar <FormParams> cuando se cumplan los siguientes criterios:

  • Verbo HTTP: POST
  • Tipo de mensaje: solicitud
  • Uno (o ambos) de los siguientes elementos:
    • Datos del formulario: establecidos en algún valor o "" (la string está vacía). Por ejemplo, con curl, agrega -d "" a tu solicitud.
    • Encabezado Content-Length: Se establece en 0 (si no hay datos en la solicitud original; de lo contrario, la longitud actual, en bytes). Por ejemplo, con curl, agrega -H "Content-Length: 0" a tu solicitud.

Por ejemplo:

curl -vL -X POST -d "" -H "Content-Type: application/x-www-form-urlencoded"
  https://ahamilton-eval-test.apigee.net/am-test

Cuando agregas <FormParams>, Edge establece el encabezado Content-Type de la solicitud en &quot;application/x-www-form-urlencoded&quot; antes de enviar el mensaje al servicio de destino.

<Headers> (secundario de <Add>)

Agrega encabezados nuevos a la solicitud o respuesta especificadas, que se especifica mediante el elemento <AssignTo>.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo Arreglo de elementos <Header>
Elemento principal <Add>
Elementos secundarios <Header>

El elemento <Headers> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Add>
    <Headers>
      <Header name="header_name">header_value</Header>
      ...
    </Headers>
  </Add>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se agrega el encabezado user-agent al mensaje de solicitud y se asigna el valor de la variable de flujo request.user.agent a ese encabezado.

<AssignMessage continueOnError="false" enabled="true" name="add-headers-1">
  <Add>
    <Headers>
      <Header name="user-agent">{request.user.agent}</Header>
    </Headers>
  </Add>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

<QueryParams> (secundario de <Add>)

Agrega nuevos parámetros de búsqueda a la solicitud. Este elemento no tiene efecto en una respuesta.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo Arreglo de elementos <QueryParam>
Elemento principal <Add>
Elementos secundarios <QueryParam>

El elemento <QueryParams> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Add>
    <QueryParams>
      <QueryParam name="queryparam_name">queryparam_value</QueryParam>
      ...
    </QueryParams>
  </Add>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se agrega el parámetro de búsqueda "myParam" a la solicitud y se le asigna el valor "42":

<AssignMessage continueOnError="false" enabled="true" name="add-queryparams-1">
  <Add>
    <QueryParams>
      <QueryParam name="myParam">42</QueryParam>
    </QueryParams>
  </Add>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

Solo puedes usar <QueryParams> cuando se cumplan los siguientes criterios:

  • Verbo HTTP: GET
  • Tipo de mensaje: solicitud

Además, solo puedes establecer parámetros de búsqueda cuando el atributo type del elemento <AssignTo> es un mensaje de solicitud. Configurarlos en la respuesta no causa ningún efecto.

Si defines un arreglo vacío de parámetros de búsqueda en tu política (<Add><QueryParams/></Add>), la política no agrega ningún parámetro de búsqueda. Esto es lo mismo que omitir <QueryParams>.

<AssignTo>

Determina en qué objeto funciona la política de AssignMessage. Las opciones son las siguientes:

  • Mensaje de la solicitud: La request que recibe el proxy de API
  • Mensaje de respuesta: La response que muestra el servidor de destino
  • Mensaje personalizado: Un objeto de solicitud o respuesta personalizado

Ten en cuenta que, en algunos casos, no puedes cambiar el objeto en el que actúa la política de AssignMessage. Por ejemplo, no puedes usar <Add> o <Set> para agregar o cambiar parámetros de búsqueda (<QueryParams>) o parámetros de formulario (<FormParams>) en la respuesta. Solo puedes manipular parámetros de búsqueda y parámetros de formulario en la solicitud.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo String
Elemento principal <AssignMessage>
Elementos secundarios Ninguno

Si no especificas <AssignTo>, la política actúa en la solicitud o respuesta predeterminada, que se basa en la ubicación donde se ejecuta la política. Si la política se ejecuta en el flujo de la solicitud, afecta el mensaje de la solicitud. Si se ejecuta en el flujo de respuesta, la política afecta la respuesta de forma predeterminada.

El elemento <AssignTo> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <AssignTo createNew="[true|false]" transport="http"
    type="[request|response]">destination_variable_name</AssignTo>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se especifica que el destino es la solicitud original que se enviará al extremo de destino:

<AssignMessage name="assignto-1">
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

Al configurar createNew como "falso" (el valor predeterminado), este ejemplo no crea una solicitud nueva. Todas las operaciones de esta política afectan la solicitud original.

Ejemplo 2

En el siguiente ejemplo, se crea un objeto de solicitud nuevo:

<AssignMessage name="assignto-2">
  <AssignTo createNew="true" transport="http" type="request"/>
</AssignMessage>

Cuando creas una solicitud o un objeto de respuesta nuevos, los demás elementos de la políticaAssignMessage política (como <Add>, <Set> y <Set>) actuarán según ese nuevo request.

Puedes acceder al nuevo objeto de solicitud en otras políticas más adelante en el flujo o enviar el objeto de solicitud nuevo a un servicio externo con una política ServiceCallout.

Ejemplo 3

En el ejemplo siguiente, se crea un objeto de solicitud nuevo llamado "MyRequestObject":

<AssignMessage name="assignto-2">
  <AssignTo createNew="true" transport="http" type="request"&gt;MyRequestObject&lt;/AssignTo>
</AssignMessage>

Cuando creas una solicitud o un objeto de respuesta nuevos, los demás elementos de la políticaAssignMessage política (como <Add>, <Set> y <Set>) actuarán según ese nuevo request.

Puedes acceder al nuevo objeto de solicitud en otras políticas más adelante en el flujo o enviar el objeto de solicitud nuevo a un servicio externo con una política ServiceCallout.

En la siguiente tabla, se describen los atributos de <AssignTo>:

Atributo Descripción ¿Es obligatorio? Tipo
createNew

Determina si esta política crea un mensaje nuevo cuando asigna valores.

Si es "true", la política crea una nueva variable del tipo especificadas por type (ya sea "solicitud" o "respuesta"). Si no especificas el nombre de la nueva variable, la política crea un nuevo objeto de solicitud o respuesta, según el valor de type.

Si es "false", la política responde de dos maneras:

  • Si <AssignTo> puede resolver el nombre de la variable en una solicitud o respuesta, continúa con el procesamiento. Por ejemplo, si la política está en un flujo de solicitudes, la variable es el objeto de solicitud. Si la política está en una respuesta, la variable es el objeto de respuesta.
  • Si <AssignTo> no se puede resolver o se resuelve en un tipo que no es de mensaje, la política muestra un error.

Si no se especifica createNew, la política responde de dos maneras:

  • Si <AssignTo> se resuelve en un mensaje y, luego, procesa el paso siguiente.
  • Si <AssignTo> no se puede resolver o se resuelve en un tipo que no es de mensaje, se crea una nueva variable de tipo especificada en type.
Opcional Booleano
transport

Especifica el tipo de transporte del tipo de mensaje de solicitud o respuesta.

El valor predeterminado es "http" (el único valor admitido).

Opcional String
type Especifica el tipo de mensaje nuevo, cuando createNew es "true". Los valores válidos son “solicitud” o “respuesta”.

El valor predeterminado es "request". Si omites este atributo, Edge creará una solicitud o una respuesta, según en qué parte del flujo se ejecute esta política.

Opcional String

<AssignVariable>

Asigna un valor a una variable de flujo de destino (p.ej., una variable cuyo valor lo establece el la política deAssignMessage). Si la variable de flujo no existe, <AssignVariable> la crea.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo Tipo complejo
Elemento principal <AssignMessage>
Elementos secundarios <Name> (obligatorio)
<Ref>
<Template>
<Value>

El valor que asignes a la variable de flujo de destino puede ser uno de los siguientes:

  • String literal: usa el elemento secundario <Value> para especificar un valor de string literal para la variable de flujo de destino.
  • Variable de flujo: Usa el elemento secundario <Ref> a fin de especificar el valor de una variable de flujo existente para la variable de flujo de destino. Para obtener una lista completa de las variables de flujo que se pueden usar como fuente, consulta Referencia de variables de flujo.
  • Plantilla de mensaje: Usa el elemento secundario <Template> para especificar una plantilla de mensajes para la variable de flujo de destino.

El elemento <AssignVariable> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <AssignVariable>
    <Name>variable_name</Name>
    <Ref>source_variable</Ref>
    <Template>message_template</Template>
    or
    <Template ref='template_variable'></Template>
    <Value>variable_value</Value>
  </AssignVariable>
</AssignMessage>

Usa el elemento <Ref> para especificar la variable de origen. Si el botón No se puede acceder a la variable a la que hace referencia <Ref>, Edge usa el valor especificadas por el elemento <Value>. Si defines <Template>, tiene prioridad sobre los otros elementos secundarios.

Ejemplo 1

En el siguiente ejemplo, se establece el valor de una nueva variable, myvar, en el valor literal "42":

<AssignMessage name="assignvariable-1">
  <AssignVariable>
    <Name>myvar</Name>
    <Value>42</Value>
  </AssignVariable>
</AssignMessage>

Ejemplo 2

En el siguiente ejemplo, se asigna el valor de la variable de flujo request.header.user-agent a la variable de flujo de destino myvar y el valor del parámetro de búsqueda country a la variable de flujo de destino Country:

<AssignMessage name="assignvariable-2">
  <AssignVariable>
    <Name>myvar</Name>
    <Ref>request.header.user-agent</Ref>
    <Value>ErrorOnCopy</Value>
  </AssignVariable>
  <AssignVariable>
    <Name>Country</Name>
    <Ref>request.queryparam.country</Ref>
    <Value>ErrorOnCopy</Value>
  </AssignVariable>
</AssignMessage>

Si falla alguna de las asignaciones, Edge le asigna el valor "ErrorOnCopy" en su lugar. a la variable del flujo de destino.

Si las variables de flujo myvar o Country no existen, <AssignVariable> las crea.

Ejemplo 3

En el siguiente ejemplo, se usa el elemento secundario <Template> para concatenar dos variables de contexto con una string literal (un guion) entre ellas:

<AssignMessage name='template-1'>
  <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
  <AssignVariable>
    <Name>my_destination_variable</Name>
    <Value>BADDBEEF</Value>
    <Template>{system.uuid}-{messageid}</Template>
  </AssignVariable>
</AssignMessage>

Un uso común de <AssignVariable> es establecer un valor predeterminado para un parámetro de búsqueda, un encabezado o cualquier otro valor que se pueda pasar con la solicitud. Puedes hacerlo con una combinación de los elementos secundarios <Ref> y <Value>. Para obtener más información, consulta los ejemplos de <Ref>.

<Name> (secundario de <AssignVariable>)

Especifica el nombre de la variable de flujo de destino (p.ej., la variable cuyo valor lo establece la política deAssignMessage). Si la variable con un nombre asignado en <AssignVariable> no existe, la política crea una con ese nombre.

Valor predeterminado N/A
¿Es obligatorio? Obligatorio
Tipo String
Elemento principal <AssignVariable>
Elementos secundarios Ninguna

El elemento <Name> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <AssignVariable>
    <Name>variable_name</Name>
  </AssignVariable>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se especifica la variable de destino como myvar y se establece en el valor literal “42”:

<AssignMessage name="assignvariable-1">
  <AssignVariable>
    <Name>myvar</Name>
    <Value>42</Value>
  </AssignVariable>
</AssignMessage>

Si myvar no existe, <AssignVariable> lo crea.

<Ref> (secundario de <AssignVariable>)

Especifica el origen de la asignación como una variable de flujo. La variable de flujo puede ser una de las variables de flujo predefinidas (como se indica en la referencia de variables de flujo) o una variable de flujo personalizada que creaste.

El valor de <Ref> siempre se interpreta como una variable de flujo. No puedes especificar una string literal como valor. Para asignar un valor de string literal, usa el elemento <Value> en su lugar.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo String
Elemento principal <AssignVariable>
Elementos secundarios Ninguno

Cuando especificas una variable de flujo con <Ref>, omite los corchetes "{}" que normalmente usarías para hacer referencia a una variable de flujo. Por ejemplo, para configurar el valor de tu variable nueva con el valor de la variable de flujo client.host:

Do this (no brackets):
  <Ref>client.host</Ref>

Do NOT do this (brackets):
  <Ref>{client.host}</Ref>

Si quieres definir un valor predeterminado para la variable de flujo de destino, usa <Value> en combinación con <Ref>. Si la variable de flujo especificada por <Ref> no existe, no se puede leer o es nulo, por lo que Edge le asigna el valor. de <Value> a la variable del flujo de destino.

El elemento <Ref> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <AssignVariable>
    <Name>variable_name</Name>
    <Ref>source_variable</Ref>
  </AssignVariable>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se asigna el valor de la variable de flujo request.header.user-agent a la variable de flujo de destino myvar y el valor del parámetro de búsqueda country a la variable Country:

<AssignMessage name="assignvariable-4">
  <AssignVariable>
    <Name>myvar</Name>
    <Ref>request.header.user-agent</Ref>
  </AssignVariable>
  <AssignVariable>
    <Name>Country</Name>
    <Ref>request.queryparam.country</Ref>
  </AssignVariable>
</AssignMessage>

En este ejemplo, Edge no tiene un valor predeterminado (o de resguardo) especificado para asignación.

Ejemplo 2

En el siguiente ejemplo, se asigna el valor de la variable de flujo request.header.user-agent a la variable de flujo de destino myvar y el valor del parámetro de búsqueda country a la variable Country:

<AssignMessage name="assignvariable-2">
  <AssignVariable>
    <Name>myvar</Name>
    <Ref>request.header.user-agent</Ref>
    <Value>ErrorOnCopy</Value>
  </AssignVariable>
  <AssignVariable>
    <Name>Country</Name>
    <Ref>request.queryparam.country</Ref>
    <Value>ErrorOnCopy</Value>
  </AssignVariable>
</AssignMessage>

En este ejemplo, si los valores de la variable de flujo request.header.user-agent o los parámetros de consulta Country son nulos, ilegibles o tienen errores de formato, Edge asigna el valor "ErrorOnCopy" a las nuevas variables.

Ejemplo 3

Un caso de uso común para <AssignVariable> es establecer el valor predeterminado de un parámetro de consulta, un encabezado o cualquier otro valor que se pueda pasar con la solicitud. Por ejemplo, puedes crear un proxy de la API del clima en el que la solicitud toma un parámetro de consulta único llamado "w". Este parámetro contiene el ID de la ciudad para la que deseas obtener el clima. La URL de la solicitud tiene el siguiente formato:

http://myCO.com/v1/weather/forecastrss?w=city_ID

Para definir un valor predeterminado para "w", crea una política deAssignMessage como lo siguiente:

<AssignMessage continueOnError="false" enabled="true" name="assignvariable-3">
  <AssignTo createNew="false" transport="http" type="request"/>
  <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
  <AssignVariable>
    <Name>request.queryparam.w</Name>
    <Ref>request.queryparam.w</Ref>
    <Value>12797282</Value>
  </AssignVariable>
</AssignMessage>

En este ejemplo, <AssignVariable> obtiene el valor de request.queryparam.w y lo asigna a sí mismo. Si la variable de flujo es nula, es decir, la “w” el parámetro de consulta era omitido de la solicitud, en este ejemplo se usa el valor predeterminado de la elemento <Value>. Por lo tanto, puedes realizar una solicitud a esta API proxy que omite la "w" Parámetro de consulta:

http://myCO.com/v1/weather/forecastrss

…y aún el proxy de API mostrará un resultado válido.

A diferencia del uso del <Value>, el valor de<Ref> debe ser una variable de flujo, como una propiedad de un objeto request, response o target. El valor también puede ser una variable de flujo personalizada que creaste.

Si especificas una variable de flujo que no existe para el valor de <Ref>, Si el valor de <IgnoreUnresolvedVariables> es "true", Edge arroja un error.

<Template> (secundario de <AssignVariable>)

Especifica una plantilla de mensaje. Una plantilla de mensaje te permite realizar sustituciones de strings variables cuando se ejecuta la política y puedes combinar strings literales con nombres de variables entre llaves. Además, las plantillas de mensajes admiten funciones, como el escape y la conversión de casos.

Usa el atributo ref para especificar una variable de flujo en la que el valor de la variable sea una plantilla de mensaje. Por ejemplo, podrías almacenar una plantilla de mensaje como atributo personalizado en una app de desarrollador. Cuando Edge identifica la app de desarrollador después de verificar la clave de API o un token de seguridad (mediante una política adicional), el <AssignVariable> puede usar la plantilla de mensaje del atributo personalizado de la app, que está disponible como una variable de flujo de la política de seguridad. En el siguiente ejemplo, suponemos que la plantilla de mensaje está disponible en un atributo de cliente llamado message_template en la app para desarrolladores y realiza la llamada a la API, en el que la Política de VerifyAPIKey se usó para verificar la clave de API de la app:

<AssignVariable ref='verifyapikey.myVerifyAPIKeyPolicy.app.name.message_template'/>

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo String
Elemento principal <AssignVariable>
Elementos secundarios Ninguna

El elemento <Template> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <AssignVariable>
    <Template>message_template</Template>
    or
    <Template ref='template_variable'></Template>
  </AssignVariable>
</AssignMessage>

Ejemplo 1

En el ejemplo siguiente, se usa la sintaxis de plantillas de mensajes para concatenar dos variables de contexto con una string literal (un guion) entre ellas:

<AssignMessage name='template-1'>
  <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
  <AssignVariable>
    <Name>my_destination_variable</Name>
    <Value>BADDBEEF</Value>
    <Template>{system.uuid}-{messageid}</Template>
  </AssignVariable>
</AssignMessage>

Ejemplo 2

En el siguiente ejemplo, se especifica una variable de flujo, en la que el valor de la variable es una plantilla de mensaje predefinida. Usa esta opción si deseas incorporar una plantilla predefinida en el entorno de ejecución sin tener que modificar la política:

<AssignMessage name='template-2'>
  <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
  <AssignVariable>
    <Name>my_destination_variable</Name>
    <Value>BADDBEEF</Value>
    <Template ref='my_template_variable'/>

  </AssignVariable>
</AssignMessage>

Ejemplo 3

En el siguiente ejemplo, se especifica una variable de flujo y un valor de texto. En este caso, si la variable a la que se hace referencia no es nula, ese valor se usa como plantilla. Si el valor al que se hace referencia es nulo, se usa el valor de texto (en este caso, {system.uuid}-{messageid}) como plantilla. Este patrón es útil para proporcionar un valor de valor, en el que En algunos casos, es conveniente anular la plantilla predeterminada (la parte de texto) con valores que se configuran dinámicamente. Por ejemplo, una instrucción condicional puede obtener un valor de un mapa de clave-valor y establecer la variable a la que se hace referencia en ese valor:

<AssignMessage name='template-2'>
  <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
  <AssignVariable>
    <Name>my_destination_variable</Name>
    <Value>BADDBEEF</Value>
    <Template ref='my_variable'>{system.uuid}-{messageid}</Template>
  </AssignVariable>
</AssignMessage>

<Value> (secundario de <AssignVariable>)

Define el valor de la variable de flujo de destino establecida con <AssignVariable>. El valor siempre se interpreta como una string literal. No puedes usar una variable de flujo como valor, incluso si encierras el valor entre corchetes ("{}"). Para usar una variable de flujo, usa <Ref> en su lugar.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo String
Elemento principal <AssignVariable>
Elementos secundarios Ninguno

Cuando se usa en combinación con el elemento <Ref>, <Value> actúa como el valor predeterminado (o de resguardo). Si no se especifica <Ref>, no se puede resolver o es nulo, se usará el valor de <Value>.

El elemento <Value> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <AssignVariable>
    <Name>variable_name</Name>
    <Value>variable_value</Value>
  </AssignVariable>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se establece el valor de la variable del flujo de destino, myvar, al valor literal “42”:

<AssignMessage name="assignvariable-1">
  <AssignVariable>
    <Name>myvar</Name>
    <Value>42</Value>
  </AssignVariable>
</AssignMessage>

Ejemplo 2

En el siguiente ejemplo, se asigna el valor de la variable de flujo request.header.user-agent a la variable de flujo myvar y el valor del parámetro de búsqueda country a la variable Country:

<AssignMessage name="assignvariable-2">
  <AssignVariable>
    <Name>myvar</Name>
    <Ref>request.header.user-agent</Ref>
    <Value>ErrorOnCopy</Value>
  </AssignVariable>
  <AssignVariable>
    <Name>Country</Name>
    <Ref>request.queryparam.country</Ref>
    <Value>ErrorOnCopy</Value>
  </AssignVariable>
</AssignMessage>

Si alguna de las asignaciones falla, <AssignVariable> asigna el valor “ErrorOnCopy” a la variable de flujo de destino.

<Copy>

Copia valores desde el mensaje especificado por el atributo source en el mensaje especificado por el elemento <AssignTo>. Si no especificas un destino con <AssignTo>, esta política copia los valores en la solicitud o la respuesta, según en qué parte del flujo se ejecute esta política.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo String
Elemento principal <AssignMessage>
Elementos secundarios <FormParams>
<Headers>
<Path>
<Payload>
<QueryParams>
<ReasonPhrase>
<StatusCode>
<Verb>
<Version>

El elemento <Copy> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
    <Copy source="[request|response]">
    <!-- Can also be an empty array (<FormParams/>) -->
    <FormParams>
      <FormParam name="formparam_name">formparam_value</FormParam>
      ...
    </FormParams>
    <!-- Can also be an empty array (<Headers/>) -->
    <Headers>
      <Header name="header_name">header_value</Header>
      ...
    </Headers>
    <Path>[false|true]</Path>
    <Payload>[false|true]</Payload>
    <!-- Can also be an empty array (<QueryParams/>) -->
    <QueryParams>
      <QueryParam name="queryparam_name">queryparam_value</QueryParam>
      ...
    </QueryParams>
    <ReasonPhrase>[false|true]</ReasonPhrase>
    <StatusCode>[false|true]</StatusCode>
    <Verb>[false|true]</Verb>
    <Version>[false|true]</Version>
  </Copy>
  <!-- Used as the destination for the <Copy> values -->
  <AssignTo createNew="[true|false]" transport="http"
    type="[request|response]">destination_variable_name</AssignTo>
</AssignMessage>
  

Ejemplo 1

En el siguiente ejemplo, se copia un encabezado, tres parámetros de formulario, la ruta y todos los parámetros de búsqueda desde la solicitud a una nueva solicitud personalizada:

<AssignMessage continueOnError="false" enabled="true" name="copy-1">
  <Copy source="request">
    <Headers>
      <Header name="Header_Name_1">Header value 1</Header>
    </Headers>
    <FormParams>
      <FormParam name="Form_Param_Name_1">Form param value 1</FormParam>
      <FormParam name="Form_Param_Name_2">Form param value 1</FormParam>
      <FormParam name="Form_Param_Name_3">Form param value 1</FormParam>
    </FormParams>
    <Payload>false</Payload>
    <Path>true</Path>
    <QueryParams/>
    <ReasonPhrase>false</ReasonPhrase>
    <StatusCode>false</StatusCode>
    <Verb>false</Verb>
    <Version>false</Version>
  </Copy>
  <AssignTo createNew="true" transport="http" type="request"/>
</AssignMessage>

El elemento <Copy> tiene los siguientes atributos:

Atributo Descripción ¿Es obligatorio? Tipo
origen

Especifica el objeto de origen de la copia.

  • Si no se especifica source, se lo trata como un mensaje simple. Por ejemplo, si la política está en el flujo de solicitud, la fuente predeterminada tiene como configuración el objeto request. Si la política está en el flujo de respuesta, su valor predeterminado es el objeto response. Si omites source, puedes usar una referencia absoluta a una variable de flujo como la fuente de la copia. Por ejemplo, especifica el valor como {request.header.user-agent}.
  • Si la variable de origen no se puede resolver o se resuelve en un tipo que no es de mensaje, <Copy> no responderá.
Opcional String

<FormParams> (secundario de <Copy>)

Copia los parámetros del formulario de la solicitud especificada por el atributo source del elemento <Copy> en la solicitud especificada por el elemento <AssignTo>. Este elemento no causa ningún efecto en una respuesta.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo Arreglo de elementos <FormParam> o un arreglo vacío
Elemento principal <Copy>
Elementos secundarios <FormParam>

El elemento <FormParams> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Copy source="[request|response]">
    <!-- Can also be an empty array (<FormParams/>) -->
    <FormParams>
      <FormParam name="formparam_name">formparam_value</FormParam>
      ...
    </FormParams>
  </Copy>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se copia un solo parámetro de formulario de la solicitud en la solicitud personalizada "MyCustomRequest":

<AssignMessage name="copy-formparams-1">
  <Copy source="request">
    <FormParams>
      <FormParam name="paramName">Form param value 1</FormParam>
    </FormParams>
  </Copy>
  <AssignTo createNew="true" transport="http" type="request">MyCustomRequest</AssignTo>
</AssignMessage>

Ejemplo 2

En el siguiente ejemplo, se copian todos los parámetros del formulario en la solicitud personalizada “MyCustomRequest”:

<AssignMessage name="copy-formparams-2">
  <Copy source="request">
    <FormParams/>
  </Copy>
  <AssignTo createNew="true" transport="http" type="request">MyCustomRequest</AssignTo>
</AssignMessage>

Ejemplo 3

En el siguiente ejemplo, se copian tres parámetros de formulario en la solicitud personalizada “MyCustomRequest”:

<AssignMessage name="copy-formparams-3">
  <Copy source="request">
    <FormParams>
      <FormParam name="paramName1"/>
      <FormParam name="paramName2"/>
      <FormParam name="paramName3"/>
    </FormParams>
  </Copy>
  <AssignTo createNew="true" transport="http" type="request">MyCustomRequest</AssignTo>
</AssignMessage>

Ejemplo 4

Si hay varios parámetros de formulario con el mismo nombre, utiliza la siguiente sintaxis:

<AssignMessage name="copy-formparams-4">
  <Copy source="request">
    <FormParams>
      <FormParam name="f1"/>
      <FormParam name="f2"/>
      <FormParam name="f3.2"/>
    </FormParams>
  </Copy>
  <AssignTo createNew="true" transport="http" type="request">MyCustomRequest</AssignTo>
</AssignMessage>

En este ejemplo, se copia "f1", "f2" y el segundo valor de "f3". Si "f3" tiene un solo valor, no se copia.

Solo puedes usar <FormParams> cuando se cumplan los siguientes criterios:

  • Verbo HTTP: POST
  • Tipo de mensaje: Respuesta
  • Uno (o ambos) de los siguientes elementos:
    • Datos del formulario: establecidos en algún valor o "" (la string está vacía). Por ejemplo, con curl, agrega -d "" a tu solicitud.
    • Encabezado Content-Length: Se establece en 0 (si no hay datos en la solicitud original; de lo contrario, la longitud actual). Por ejemplo, con curl, agrega -H "Content-Length: 0" a tu solicitud.

Cuando copias <FormParams>, <Copy> establece el Content-Type del mensaje en "application/x-www-form-urlencoded" antes de enviar el mensaje al servicio de destino.

<Headers> (secundario de <Copy>)

Copia encabezados HTTP de del mensaje de respuesta o solicitud que especifica el atributo source del elemento <Copy> en el mensaje de respuesta o solicitud que especifica el elemento <AssignTo>.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo Un arreglo de elementos <Header> o un arreglo vacío
Elemento principal <Copy>
Elementos secundarios <Header>

El elemento <Headers> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Copy source="[request|response]">
    <!-- Can also be an empty array (<Headers/>) -->
    <Headers>
      <Header name="header_name">header_value</Header>
      ...
    </Headers>
  </Copy>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se copia el encabezado user-agent de la solicitud en el objeto de solicitud nuevo:

<AssignMessage name="copy-headers-1">
  <Copy source="request">
    <Headers>
      <Header name="user-agent"/>
    </Headers>
  </Copy>
  <AssignTo createNew="true" transport="http" type="request">MyCustomRequest</AssignTo>
</AssignMessage>

Ejemplo 2

Para copiar todos los encabezados, usa un elemento <Headers> vacío, como se muestra en el siguiente ejemplo:

<AssignMessage name="copy-headers-2">
  <Copy source="request">
    <Headers/>
  </Copy>
  <AssignTo createNew="true" transport="http" type="request">MyCustomRequest</AssignTo>
</AssignMessage>

Ejemplo 3

Si hay varios encabezados con el mismo nombre, usa la siguiente sintaxis:

<AssignMessage name="copy-headers-3">
  <Copy source="request">
    <Headers>
      <Header name="h1"/>
      <Header name="h2"/>
      <Header name="h3.2"/>
    </Headers>
  </Copy>
  <AssignTo createNew="true" transport="http" type="request">MyCustomRequest</AssignTo>
</AssignMessage>

En este ejemplo, se copia "h1", "h2" y el segundo valor de "h3". Si "h3" tiene solo un valor, no se copia.

<Path> (secundario de <Copy>)

Determina si la ruta se debe copiar desde la solicitud de origen a la solicitud de destino. Este elemento no tiene efecto en una respuesta.

Si se configura como "true", esta política copia la ruta de acceso desde el mensaje de solicitud especificado por el atributo source del elemento <Copy> en el mensaje de solicitud especificado por el elemento <AssignTo>.

Valor predeterminado Falso
¿Es obligatorio? Opcional
Tipo Booleano
Elemento principal <Copy>
Elementos secundarios Ninguna

El elemento <Path> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Copy source="[request|response]">
    <Path>[false|true]</Path>
  </Copy>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se indica que la políticaAssignMessage debe copiar la ruta de acceso desde la fuente solicitud al nuevo objeto de solicitud personalizado:

<AssignMessage name="copy-path-1">
  <Copy source="request">
    <Path>true</Path>
  </Copy>
  <AssignTo createNew="true" transport="http" type="request">MyCustomRequest</AssignTo>
</AssignMessage>

Solo puedes usar <Path> cuando se cumplan los siguientes criterios:

  • Tipo de mensaje: solicitud

<Payload> (secundario de <Copy>)

Determina si la carga útil se debe copiar de la fuente al destino. El origen y el destino pueden ser solicitudes o respuestas.

Si es "true", esta política copia la carga útil desde el mensaje especificado por el atributo source del elemento <Copy> al mensaje especificado por el elemento <AssignTo>.

Valor predeterminado Falso
¿Es obligatorio? Opcional
Tipo Booleano
Elemento principal <Copy>
Elementos secundarios Ninguna

El elemento <Payload> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Copy source="[request|response]">
    <Payload>[false|true]</Payload>
  </Copy>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se configura <Payload> como “verdadero”. para que la carga útil de la solicitud sea copiado de la solicitud a la respuesta:

<AssignMessage name="copy-payload-1">
  <Copy source="request">
    <Payload>true</Payload>
  </Copy>
  <AssignTo createNew="true" transport="http" type="response"/>
</AssignMessage>

<QueryParams> (secundario de <Copy>)

Copia los parámetros del formulario de la solicitud especificada por el atributo source del elemento <Copy> a la solicitud especificada por el elemento <AssignTo>. Este elemento no tiene efecto en una respuesta.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo Un arreglo de elementos <QueryParam> o un arreglo vacío
Elemento principal <QueryParam>
Elementos secundarios Ninguna

El elemento <QueryParams> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Copy source="[request|response]">
    <!-- Can also be an empty array (<QueryParams/>) -->
    <QueryParams>
      <QueryParam name="queryparam_name">queryparam_value</QueryParam>
      ...
    </QueryParams>
  </Copy>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se copia el parámetro de búsqueda "my_param" de la solicitud a un objeto de solicitud personalizado nuevo:

<AssignMessage name="copy-queryparams-1">
  <Copy source="request">
    <QueryParams>
      <QueryParam name="my_param"/>
    </QueryParams>
  </Copy>
  <AssignTo createNew="true" transport="http" type="request">MyCustomRequest</AssignTo>
</AssignMessage>

Ejemplo 2

En el siguiente ejemplo, se copian todos los parámetros de búsqueda de la solicitud en un nuevo objeto de solicitud personalizado:

<AssignMessage name="copy-queryparams-2">
  <Copy source="request">
    <QueryParams/>
  </Copy>
  <AssignTo createNew="true" transport="http" type="request">MyCustomRequest</AssignTo>
</AssignMessage>

Ejemplo 3

Si hay varios parámetros de búsqueda con el mismo nombre, usa la siguiente sintaxis:

<AssignMessage name="copy-queryparams-3">
  <Copy source="request">
    <QueryParams>
      <QueryParam name="qp1"/>
      <QueryParam name="qp2"/>
      <QueryParam name="qp3.2"/>
    </QueryParams>
  </Copy>
  <AssignTo createNew="true" transport="http" type="request">MyCustomRequest</AssignTo>
</AssignMessage>

En este ejemplo, se copia "qp1", "qp2" y el segundo valor de "qp3". Si "qp3" tiene un solo valor, no se copia.

Solo puedes usar <QueryParams> cuando se cumplan los siguientes criterios:

  • Verbo HTTP: GET
  • Tipo de mensaje: solicitud

<ReasonPhrase> (secundario de <Copy>)

Determina si la frase de motivo se debe copiar de la respuesta de origen a la respuesta de destino. Este elemento no causa ningún efecto en una solicitud.

Si es "true", esta política copia el ReasonPhrase de la respuesta especificada por el atributo source del elemento <Copy> en la respuesta especificada por el elemento <AssignTo>.

Valor predeterminado Falso
¿Es obligatorio? Opcional
Tipo Booleano
Elemento principal <Copy>
Elementos secundarios Ninguna

El elemento <ReasonPhrase> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Copy source="[request|response]">
    <ReasonPhrase>[false|true]</ReasonPhrase>
  </Copy>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se establece <ReasonPhrase> en “true”, lo que hace que <Copy> copie la frase de la razón de la respuesta predeterminada en un objeto de respuesta personalizado:

<AssignMessage name="copy-reasonphrase-1">
  <Copy source="response">
    <ReasonPhrase>true</ReasonPhrase>
  </Copy>
  <AssignTo createNew="trie" transport="http" type="response">MyCustomResponse</AssignTo>
</AssignMessage>

Solo puedes usar <ReasonPhrase> cuando se cumplan los siguientes criterios:

  • Tipo de mensaje: Respuesta

<StatusCode> (secundario de <Copy>)

Determina si el código de estado se copia de la respuesta de origen a la respuesta de destino. Este elemento no causa ningún efecto en una solicitud.

Si es "true", esta política copia el código de estado del mensaje de respuesta especificado por el atributo source del elemento <Copy> en el mensaje de respuesta especificado por el elemento <AssignTo>.

Valor predeterminado Falso
¿Es obligatorio? Opcional
Tipo Booleano
Elemento principal <Copy>
Elementos secundarios Ninguna

El elemento <StatusCode> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Copy source="[request|response]">
    <StatusCode>[false|true]</StatusCode>
  </Copy>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se configura <StatusCode> como “verdadero”, que copia el código de estado. del objeto de respuesta predeterminado a un nuevo objeto de respuesta personalizado:

<AssignMessage name="copy-statuscode-1">
  <Copy source="response">
    <StatusCode>true</StatusCode>
  </Copy>
  <AssignTo createNew="true" transport="http" type="response">MyCustomResponse</AssignTo>
</AssignMessage>

Solo puedes usar <StatusCode> cuando se cumplan los siguientes criterios:

  • Tipo de mensaje: Respuesta

Un uso común de <StatusCode> es garantizar que la respuesta del proxy tenga el mismo estado que la respuesta recibida del destino cuando el atributo createNew de <AssignTo> se establece en "true".

<Verb> (secundario de <Copy>)

Determina si el verbo HTTP se copia de la solicitud de origen a la solicitud de destino. Este elemento no tiene efecto en una respuesta.

Si es "true", copia el verbo encontrado en el atributo source del elemento <Copy> a la solicitud especificada en el elemento <AssignTo>.

Valor predeterminado Falso
¿Es obligatorio? Opcional
Tipo Booleano
Elemento principal <Copy>
Elementos secundarios Ninguna

El elemento <Verb> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Copy source="[request|response]">
    <Verb>[false|true]</Verb>
  </Copy>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se configura <Verb> como “true”, que copia el verbo desde la solicitud predeterminada a una nueva solicitud personalizada:

<AssignMessage name="copy-verb-1">
  <Copy source="request">
    <Verb>true</Verb>
  </Copy>
  <AssignTo createNew="true" transport="http" type="request">MyCustomRequest</AssignTo>
</AssignMessage>

Solo puedes usar <Verb> cuando se cumplan los siguientes criterios:

  • Tipo de mensaje: solicitud

<Version> (secundario de <Copy>)

Determina si la versión HTTP se copia de la solicitud de origen a la solicitud de destino. Este elemento no tiene efecto en una respuesta.

Si es "true", copia la versión HTTP que se encuentra en el atributo source del elemento <Copy> al objeto especificado por el elemento <AssignTo>.

Valor predeterminado Falso
¿Es obligatorio? Opcional
Tipo Booleano
Elemento principal <Copy>
Elementos secundarios Ninguna

El elemento <Version> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Copy source="[request|response]">
    <Version>[false|true]</Version>
  </Copy>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se configura <Version> como “true” en la solicitud, lo que copia la versión del objeto de solicitud predeterminado a un objeto de solicitud personalizado nuevo:

<AssignMessage name="copy-version-1">
  <Copy source="request">
    <Version>true</Version>
  </Copy>
  <AssignTo createNew="true" transport="http" type="request">MyCustomRequest</AssignTo>
</AssignMessage>

Solo puedes usar <Version> cuando se cumplan los siguientes criterios:

  • Tipo de mensaje: solicitud

<DisplayName>

Se usan además del atributo name para etiquetar la política en el editor de proxy de la IU de administración con un nombre de lenguaje natural diferente.

El elemento <DisplayName> es común a todas las políticas.

Valor predeterminado N/A
¿Es obligatorio? Opcional. Si omites <DisplayName>, se usa el valor del atributo name de la política.
Tipo String
Elemento principal <PolicyElement>
Elementos secundarios Ninguna

El elemento <DisplayName> usa la siguiente sintaxis:

Sintaxis

<PolicyElement>
  <DisplayName>policy_display_name</DisplayName>
  ...
</PolicyElement>

Ejemplo

<PolicyElement>
  <DisplayName>My Validation Policy</DisplayName>
</PolicyElement>

El elemento <DisplayName> no tiene atributos ni elementos secundarios.

<IgnoreUnresolvedVariables>

Determina si el procesamiento se detiene cuando se encuentra una variable sin resolver.

Valor predeterminado Falso
¿Es obligatorio? Opcional
Tipo Booleano
Elemento principal <AssignMessage>
Elementos secundarios Ninguna

Configúralo como true para ignorar las variables sin resolver y continuar con el procesamiento, de lo contrario, false. El valor predeterminado es false.

Establecer <IgnoreUnresolvedVariables> como true no es lo mismo que establecer continueOnError de <AssignMessage> a true, ya que es específico de establecer y obtener valores de variables. Si configuras continueOnError como true, Edge ignorará todos los errores, no solo los que encuentres. variables.

El elemento <IgnoreUnresolvedVariables> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <IgnoreUnresolvedVariables>[true|false]</IgnoreUnresolvedVariables>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se configura <IgnoreUnresolvedVariables> como “verdadero”:

<AssignMessage name="ignoreunresolvedvariables">
  <Copy source="response">
    ...
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
  </Copy>
</AssignMessage>

<Remove>

Quita los encabezados, los parámetros de búsqueda de la consulta, los parámetros de formulario y/o la carga útil del mensaje de un mensaje. El mensaje puede ser una solicitud o una respuesta. Especifica en qué mensaje actúa <Remove> mediante el elemento <AssignTo>.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo Tipo complejo
Elemento principal <AssignMessage>
Elementos secundarios <FormParams>
<Headers>
<Payload>
<QueryParams>

Un caso de uso común para <Remove> es borrar un parámetro de búsqueda que contiene información sensible del objeto de solicitud entrante para evitar pasarlo al servidor de backend.

El elemento <Remove> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Remove>
    <!-- Can also be an empty array (<FormParams/>) -->
    <FormParams>
      <FormParam name="formparam_name">formparam_value</FormParam>
      ...
    </FormParams>
    <!-- Can also be an empty array (<Headers/>) -->
    <Headers>
      <Header name="header_name">header_value</Header>
      ...
    </Headers>
    <Payload>[false|true]</Payload>
    <!-- Can also be an empty array (<QueryParams/>) -->
    <QueryParams>
      <QueryParam name="queryparam_name">queryparam_value</QueryParam>
      ...
    </QueryParams>
  </Remove>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se quita el cuerpo del mensaje de la respuesta:

<AssignMessage continueOnError="false" enabled="true" name="remove-1">
  <DisplayName>remove-1</DisplayName>
  <Remove>
    <Payload>true</Payload>
  </Remove>
  <AssignTo createNew="false" transport="http" type="response"/>
</AssignMessage>

En el flujo de respuesta, esta política quita el cuerpo de la respuesta y muestra solo los encabezados HTTP al cliente.

Ejemplo 2

En el siguiente ejemplo, se quitan todos los parámetros de formulario y un parámetros de búsqueda de la solicitud entrante:

<AssignMessage continueOnError="false" enabled="true" name="remove-2">
  <Remove>
    <!-- Empty (<FormParams/>) removes all form parameters -->
    <FormParams/>
    <QueryParams>
      <QueryParam name="qp1"/>
    </QueryParams>
  </Remove>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

<FormParams> (secundario de <Remove>)

Quita los parámetros de búsqueda especificados de la solicitud. Este elemento no causa ningún efecto en una respuesta.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo Arreglo de elementos <FormParam> o un arreglo vacío
Elemento principal <Remove>
Elementos secundarios <FormParam>

El elemento <FormParams> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Remove>
    <!-- Can also be an empty array (<FormParams/>) -->
    <FormParams>
      <FormParam name="formparam_name">formparam_value</FormParam>
      ...
    </FormParams>
  </Remove>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se quitan tres parámetros de búsqueda de la solicitud:

<AssignMessage name="remove-formparams-1">
  <Remove>
    <FormParams>
      <FormParam name="form_param_1"/>
      <FormParam name="form_param_2"/>
      <FormParam name="form_param_3"/>
    </FormParams>
  </Remove>
  <AssignTo createNew="false" transport="http" type="application/x-www-form-urlencoded"/>
</AssignMessage>

Ejemplo 2

En el siguiente ejemplo, se quitan todos los parámetros de búsqueda de la solicitud:

<AssignMessage name="remove-formparams-2">
  <Remove>
    <FormParams/>
  </Remove>
  <AssignTo createNew="false" transport="http" type="application/x-www-form-urlencoded"/>
</AssignMessage>

Ejemplo 3

Si hay varios parámetros de formulario con el mismo nombre, utiliza la siguiente sintaxis:

<AssignMessage name="remove-formparams-3">
  <Remove>
    <FormParams>
      <FormParam name="f1"/>
      <FormParam name="f2"/>
      <FormParam name="f3.2"/>
    </FormParams>
  </Remove>
  <AssignTo createNew="false" transport="http" type="application/x-www-form-urlencoded"/>
</AssignMessage>

En este ejemplo, se copia "f1", "f2" y el segundo valor de "f3". Si “h3” tiene solo un valor, no se quita.

Solo puedes usar <FormParams> cuando se cumplan los siguientes criterios:

  • Tipo de mensaje: solicitud
  • Content-Type: "application/x-www-form-urlencoded"

<Headers> (secundario de <Remove>)

Quita los encabezados HTTP especificados de la solicitud o respuesta, que se especifica mediante el elemento <AssignTo>.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo Arreglo de elementos <Header> o un arreglo vacío
Elemento principal <Remove>
Elementos secundarios <Header>

El elemento <Headers> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Remove>
    <!-- Can also be an empty array (<Headers/>) -->
    <Headers>
      <Header name="header_name">header_value</Header>
      ...
    </Headers>
  </Remove>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se quita el encabezado user-agent de la solicitud:

<AssignMessage name="remove-headers-1">
  <Remove>
    <Headers>
      <Header name="user-agent"/>
    </Headers>
  </Remove>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

Ejemplo 2

En el siguiente ejemplo, se quitan todos los encabezados de la solicitud:

<AssignMessage name="remove-headers-2">
  <Remove>
    <Headers/>
  </Remove>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

Ejemplo 3

Si hay varios encabezados con el mismo nombre, usa la siguiente sintaxis:

<AssignMessage name="remove-headers-3">
  <Remove>
    <Headers>
      <Header name="h1"/>
      <Header name="h2"/>
      <Header name="h3.2"/>
    </Headers>
  </Remove>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

En este ejemplo, se quita "h1", "h2" y el segundo valor de "h3". de la solicitud. Si es "h3" tiene un solo valor, entonces no se quita.

<Payload> (secundario de <Remove>)

Determina si <Remove> borra la carga útil en la solicitud o respuesta, que se especifica mediante el elemento <AssignTo>. Definido como "verdadero" a borrar la carga útil; de lo contrario, será “false”. El valor predeterminado es "false".

Valor predeterminado Falso
¿Es obligatorio? Opcional
Tipo Booleano
Elemento principal <Remove>
Elementos secundarios Ninguna

El elemento <Payload> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Remove>
    <Payload>[false|true]</Payload>
  </Remove>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se configura <Payload> como “verdadero”. para que la carga útil de la solicitud sea borrado:

<AssignMessage name="remove-payload-1">
  <Remove>
    <Payload>true</Payload>
  </Remove>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

<QueryParams> (secundario de <Remove>)

Quita los parámetros de búsqueda especificados de la solicitud. Este elemento no causa ningún efecto en una respuesta.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo Arreglo de elementos <QueryParam> o un arreglo vacío
Elemento principal <Remove>
Elementos secundarios <QueryParam>

El elemento <QueryParams> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Remove>
    <!-- Can also be an empty array (<QueryParams/>) -->
    <QueryParams>
      <QueryParam name="queryparam_name">queryparam_value</QueryParam>
      ...
    </QueryParams>
  </Remove>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se quita un solo parámetro de búsqueda de la solicitud:

<AssignMessage name="remove-queryparams-1">
  <Remove>
      <QueryParams>
        <QueryParam name="qp1"/>
      </QueryParams>
  </Remove>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

Ejemplo 2

En el siguiente ejemplo, se quitan todos los parámetros de búsqueda de la solicitud:

<AssignMessage name="remove-queryparams-2">
  <Remove>
      <QueryParams/>
  </Remove>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

Ejemplo 3

Si hay varios parámetros de búsqueda con el mismo nombre, usa la siguiente sintaxis:

<AssignMessage name="remove-queryparams-3">
  <Remove>
      <QueryParams>
        <QueryParam name="qp1"/>
        <QueryParam name="qp2"/>
        <QueryParam name="qp3.2"/>
      </QueryParams>
  </Remove>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

En este ejemplo, se quita “qp1”, “qp2” y el segundo valor de “qp3”. de la solicitud. Si “qp3” tiene un solo valor, entonces no se quita.

Ejemplo 4

En el siguiente ejemplo, se quita el parámetro de búsqueda apikey de la solicitud:

<AssignMessage name="remove-query-param">
  <Remove>
    <QueryParams>
      <QueryParam name="apikey"/>
    </QueryParams>
  </Remove>
  <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

Solo puedes usar <QueryParams> cuando se cumplan los siguientes criterios:

  • Verbo HTTP: GET
  • Tipo de mensaje: solicitud

<Set>

Establece la información en la solicitud o mensaje de respuesta, que se especifica mediante el elemento <AssignTo>. <Set> reemplaza los encabezados o parámetros que ya existen en el mensaje original. Para crear un nuevo encabezado o parámetro, en su lugar, usa el elemento <Add>.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo Tipo complejo
Elemento principal <AssignMessage>
Elementos secundarios <FormParams>
<Headers>
<Payload>
<Path>
<QueryParams>
<ReasonPhrase>
<StatusCode>
<Verb>
<Version>

El elemento <Set> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Set>
    <FormParams>
      <FormParam name="formparam_name">formparam_value</FormParam>
      ...
    </FormParams>
    <Headers>
      <Header name="header_name">header_value</Header>
      ...
    </Headers>
    <Path>path</Path>
    <Payload contentType="content_type" variablePrefix="prefix"
        variableSuffix="suffix">new_payload</Payload>
    <QueryParams>
      <QueryParam name="queryparam_name">queryparam_value</QueryParam>
      ...
    </QueryParams>
    <ReasonPhrase>reason_for_error or {variable}</ReasonPhrase>
    <StatusCode>HTTP_status_code or {variable}</StatusCode>
    <Verb>[GET|POST|PUT|PATCH|DELETE|{variable}]</Verb>
    <Version>[1.0|1.1|{variable}]</Verb>
  </Set>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se muestra el elemento <Set>:

<AssignMessage continueOnError="false" enabled="true" name="set-1">
  <Set>
    <FormParams>
      <FormParam name="myparam">{request.header.myparam}</FormParam>
    </FormParams>
    <Headers>
        <Header name="user-agent">{request.header.user-agent}</Header>
    </Headers>
    <QueryParams>
      <QueryParam name="name">{request.header.name}</QueryParam>
      <QueryParam name="address">{request.header.address}</QueryParam>
    </QueryParams>
    <!-- <Verb>GET</Verb> -->
    <Payload contentType="text/plain">42</Payload>
    <Path/>
    <ReasonPhrase>Bad request</ReasonPhrase>
    <StatusCode>400</StatusCode>
    <Verb>POST</Verb>
    <Verb>{my_variable}</Verb>
    <Version>1.1</Version>
  </Set>
  <AssignTo createNew="false" transport="http" type="response"/>
</AssignMessage>

<FormParams> (secundario de <Set>)

Reemplaza los parámetros de formulario existentes en una solicitud y los reemplaza por los nuevos valores que especificas con este elemento. Este elemento no tiene efecto en una respuesta.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo Arreglo de elementos <FormParam>
Elemento principal <Set>
Elementos secundarios <FormParam>

El elemento <FormParams> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Set>
    <FormParams>
      <FormParam name="formparam_name">formparam_value</FormParam>
      ...
    </FormParams>
  </Set>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se configura un parámetro de formulario llamado “myparam” al valor de la La variable request.header.myparam en una solicitud personalizada nueva:

<AssignMessage name="set-formparams-1">
  <Set>
    <FormParams>
      <FormParam name="myparam">{request.header.myparam}</FormParam>
    </FormParams>
  </Set>
    <AssignTo createNew="true" transport="http" type="request">MyCustomRequest</AssignTo>
</AssignMessage>

Solo puedes usar <FormParams> cuando se cumplan los siguientes criterios:

  • Verbo HTTP: POST
  • Tipo de mensaje: solicitud

Si defines parámetros de formulario vacíos en tu política (<Add><FormParams/></Add>), la política no agregará ningún parámetro de formulario. Esto es lo mismo que omitir <FormParams>.

<Set> cambia el Content-Type del mensaje a "application/x-www-form-urlencoded" antes de enviarlo al extremo objetivo.

<Headers> (secundario de <Set>)

Reemplaza los encabezados HTTP existentes en la solicitud o respuesta, que se especifica mediante el elemento <AssignTo>.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo Arreglo de elementos <Header>
Elemento principal <Set>
Elementos secundarios <Header>

El elemento <Headers> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Set>
    <Headers>
      <Header name="header_name">header_value</Header>
      ...
    </Headers>
  </Set>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se establece el encabezado user-agent en el valor de la variable request.header.user-agent:

<AssignMessage name="set-headers-1">
  <Set>
    <Headers>
      <Header name="user-agent">{request.header.user-agent}</Header>
    </Headers>
  </Set>
  <AssignTo createNew="true" transport="http" type="response"/>
</AssignMessage>

Si defines encabezados vacíos en tu política (<Add><Headers/></Add>), la política no agregará encabezados. Esto es lo mismo que omitir <Headers>.

<Path> (secundario de <Set>)

<Payload> (secundario de <Set>)

Define el cuerpo del mensaje de una solicitud o respuesta, que se especifica mediante el elemento <AssignTo>. La carga útil puede ser cualquier tipo de contenido válido, como texto sin formato, JSON o XML.

Valor predeterminado (string vacía)
¿Es obligatorio? Opcional
Tipo String
Elemento principal <Set>
Elementos secundarios Ninguna

El elemento <Payload> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Set>
    <Payload contentType="content_type" variablePrefix="prefix"
        variableSuffix="suffix">new_payload</Payload>
  </Set>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se configura una carga útil de texto sin formato:

<AssignMessage name="set-payload-1">
  <Set>
    <Payload contentType="text/plain">42</Payload>
  </Set>
</AssignMessage>

Ejemplo 2

En el siguiente ejemplo, se configura una carga útil de JSON:

<AssignMessage name="set-payload-2">
  <Set>
    <Payload contentType="application/json">
      {"name":"foo", "type":"bar"}
    </Payload>
  </Set>
</AssignMessage>

Ejemplo 3

En el siguiente ejemplo, se insertan valores de variable en la carga útil mediante la inserción de nombres de variables entre llaves:

<AssignMessage name="set-payload-3">
  <Set>
    <Payload contentType="application/json">
      {"name":"foo", "type":"{variable_name}"}
    </Payload>
  </Set>
</AssignMessage>

En versiones anteriores de Apigee Edge, por ejemplo, en versiones anteriores a la versión 16.08.17 en la nube, podrías no uses llaves para denotar referencias variables dentro de las cargas útiles de JSON. En esas versiones, necesitabas usar los atributos variablePrefix y variableSuffix para especificar los caracteres delimitadores y usarlos a fin de encerrar los nombres de las variables de la siguiente manera:

<AssignMessage name="set-payload-3b">
  <Set>
    <Payload contentType="application/json" variablePrefix="@" variableSuffix="#">
      {"name":"foo", "type":"@variable_name#"}
    </Payload>
  </Set>
</AssignMessage>

Esta sintaxis anterior sigue funcionando.

Ejemplo 4

El contenido de <Payload> se considera una plantilla de mensaje. Esto significa que la política AssignMessage reemplaza las variables entre llaves con el valor de las variables a las que se hace referencia en el entorno de ejecución.

En el siguiente ejemplo, se usa la sintaxis de llaves para configurar parte de la carga útil en un valor de variable:

<AssignMessage name="set-payload-4">
  <Set>
    <Payload contentType="text/xml">
      <root>
        <e1>sunday</e1>
        <e2>funday</e2>
        <e3>{var1}</e3>
      </root>
    </Payload>
  </Set>
</AssignMessage>

En la siguiente tabla, se describen los atributos de <Payload>:

Atributo Descripción Presencia Tipo
contentType

Si se especifica, el valor de contentType se asigna al encabezado HTTP Content-Type.

Opcional String
variablePrefix Especifica de manera opcional el delimitador principal en una variable de flujo. La configuración predeterminada es “{”. Para obtener más información, consulta Referencia de variables de flujo. Opcional Caracteres
variableSuffix De manera opcional, especifica el delimitador final en una variable de flujo. La configuración predeterminada es "}". Para obtener más información, consulta Referencia de variables de flujo. Opcional Caracteres

<QueryParams> (secundario de <Set>)

Reemplaza los parámetros de búsqueda existentes en la solicitud con valores nuevos. Este elemento no causa ningún efecto en una respuesta.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo Arreglo de elementos <QueryParam>
Elemento principal <Set>
Elementos secundarios <QueryParam>

El elemento <QueryParams> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Set>
    <QueryParams>
      <QueryParam name="queryparam_name">queryparam_value</QueryParam>
      ...
    </QueryParams>
  </Set>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se configura el parámetro de búsqueda "address" en el valor de la variable request.header.address:

<AssignMessage continueOnError="false" enabled="true" name="set-queryparams-1">
  <Set>
    <QueryParams>
      <QueryParam name="address">{request.header.address}</QueryParam>
    </QueryParams>
  </Set>
</AssignMessage>

Solo puedes usar <QueryParams> cuando se cumplan los siguientes criterios:

  • Verbo HTTP: GET
  • Tipo de mensaje: solicitud

Si defines parámetros de búsqueda vacíos en tu política (<Set><QueryParams/></Set>), la política no establece ningún parámetro de consulta. Esto es lo mismo que omitir <QueryParams>.

<ReasonPhrase> (secundario de <Set>)

Establece la frase de motivo en la respuesta. Por lo general, esto se hace para depurar en combinación con <StatusCode>. Este elemento no causa ningún efecto en una solicitud.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo String
Elemento principal <Set>
Elementos secundarios Ninguna

El elemento <ReasonPhrase> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Set>
    <ReasonPhrase>reason_for_error or {variable}</ReasonPhrase>
  </Set>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se define una frase de motivo simple:

<AssignMessage name="set-reasonphrase-1">
  <Set>
    <ReasonPhrase>Bad medicine</ReasonPhrase>
  </Set>
  <AssignTo createNew="true" transport="http" type="response"/>
</AssignMessage>

Ejemplo 2

El contenido de <ReasonPhrase> se considera una plantilla de mensaje. Esto significa que se reemplazará en el entorno de ejecución un nombre de variable entre llaves por el valor de la variable a la que se hace referencia, como se muestra en el siguiente ejemplo:

<AssignMessage name="set-reasonphrase-2">
  <Set>
    <ReasonPhrase>{calloutresponse.reason.phrase}</ReasonPhrase>
  </Set>
  <AssignTo createNew="true" transport="http" type="response"/>
</AssignMessage>

Solo puedes usar <ReasonPhrase> cuando se cumplan los siguientes criterios:

  • Tipo de mensaje: Respuesta

<StatusCode> (secundario de <Set>)

Establece el código de estado en la respuesta. Este elemento no causa ningún efecto en una solicitud.

Valor predeterminado “200” (cuando el atributo createNew de <AssignTo> se configura como “true”)
¿Es obligatorio? Opcional
Tipo String o variable
Elemento principal <Set>
Elementos secundarios Ninguna

El elemento <StatusCode> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Set>
    <StatusCode>HTTP_status_code or {variable}</StatusCode>
  </Set>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se configura un código de estado simple:

<AssignMessage name="set-statuscode-1">
  <Set>
    <StatusCode>404</StatusCode>
  </Set>
  <AssignTo createNew="true" transport="http" type="response"/>
</AssignMessage>

Ejemplo 2

El contenido de <StatusCode> se considera una plantilla de mensaje. Esto significa que un nombre de variable entre llaves se reemplazará en el entorno de ejecución por el valor de la variable a la que se hace referencia, como se muestra en el siguiente ejemplo:

<AssignMessage name="set-statuscode-2">
  <Set>
    <StatusCode>{calloutresponse.status.code}</StatusCode>
  </Set>
  <AssignTo createNew="true" transport="http" type="response"/>
</AssignMessage>

Solo puedes usar <StatusCode> cuando se cumplan los siguientes criterios:

  • Tipo de mensaje: Respuesta

<Verb> (secundario de <Set>)

Establece el verbo HTTP en la solicitud. Este elemento no tiene efecto en una respuesta.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo String o variable
Elemento principal <Set>
Elementos secundarios Ninguna

El elemento <Verb> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Set>
    <Verb>[GET|POST|PUT|PATCH|DELETE|{variable}]</Verb>
  </Set>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se configura un verbo simple en la solicitud:

<AssignMessage name="set-verb-1">
  <Set>
    <Verb>POST</Verb>
  </Set>
  <AssignTo createNew="true" transport="http" type="request"/>
</AssignMessage>

Ejemplo 2

El contenido de <Verb> se considera una plantilla de mensaje. Esto significa que un nombre de variable entre llaves se reemplazará en el entorno de ejecución por el valor de la variable a la que se hace referencia.

En el siguiente ejemplo, se usa una variable para propagar un verbo:

<AssignMessage name="set-verb-2">
  <Set>
    <Verb>{my_variable}</Verb>
  </Set>
  <AssignTo createNew="true" transport="http" type="request"/>
</AssignMessage>

Solo puedes usar <Verb> cuando se cumplan los siguientes criterios:

  • Tipo de mensaje: solicitud

<Version> (secundario de <Set>)

Establece la versión HTTP en una solicitud. Este elemento no tiene efecto en una respuesta.

Valor predeterminado N/A
¿Es obligatorio? Opcional
Tipo String o variable
Elemento principal <Set>
Elementos secundarios Ninguna

El elemento <Version> usa la siguiente sintaxis:

Sintaxis

<AssignMessage
    continueOnError="[false|true]"
    enabled="[true|false]"
    name="policy_name" >
  <Set>
    <Version>[1.0|1.1|{variable}]</Verb>
  </Set>
</AssignMessage>

Ejemplo 1

En el siguiente ejemplo, se establece el número de versión en “1.1”:

<AssignMessage name="set-version-1">
  <Set>
    <Version>1.1</Version>
  </Set>
  <AssignTo createNew="true" transport="http" type="request"/>
</AssignMessage>

Ejemplo 2

El siguiente comando usa una variable entre llaves para establecer el número de versión:

<AssignMessage name="set-version-2">
  <Set>
    <Version>{my_version}</Version>
  </Set>
  <AssignTo createNew="true" transport="http" type="request"/>
</AssignMessage>

El contenido de <Version> se considera una plantilla de mensaje. Esto significa que un nombre de variable entre llaves se reemplazará en el entorno de ejecución por el valor de la variable a la que se hace referencia.

Solo puedes usar <Version> cuando se cumplan los siguientes criterios:

  • Tipo de mensaje: solicitud

Crea mensajes de solicitud personalizados

Puedes usar la políticaAssignMessage para crear un mensaje de solicitud personalizado. Después de crear una solicitud personalizada, puedes usarla de las maneras siguientes:

  • Accede a sus variables en otras políticas
  • Pásalo a un servicio externo

Para crear un mensaje de solicitud personalizado, usa el elemento <AssignTo> en tu política deAssignMessage . Establece createNew como "verdadero" y especifica el nombre del mensaje nuevo en el cuerpo del elemento, como se muestra en el siguiente ejemplo:

<AssignMessage name="assignto-2">
  <AssignTo createNew="true" transport="http" type="request"/>
</AssignMessage>

De forma predeterminada, Edge no hace nada con el mensaje de solicitud personalizado. Después de crearla, Edge continuar el flujo con la solicitud original. Para usar la solicitud personalizada, agrega una política como la política ServiceCallout a tu proxy que pueda pasar la solicitud personalizada a un servicio externo.

En los siguientes ejemplos, se crean mensajes de solicitud personalizados:

Ejemplo 1

En el siguiente ejemplo, se crea un objeto de solicitud personalizado con un mensaje de asignación:

<AssignMessage name="AssignMessage-3">
  <AssignTo createNew="true" type="request">MyCustomRequest</AssignTo>
  <Copy>
    <Headers>
     <Header name="user-agent"/>
    </Headers>
  </Copy>
  <Set>
    <QueryParams>
      <QueryParam name="address">{request.queryparam.addy}</QueryParam>
    </QueryParams>
    <Verb>GET</Verb>
  </Set>
  <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
</AssignMessage>

En este ejemplo, se dan las siguientes situaciones:

  • Crea un nuevo objeto de mensaje de solicitud llamado "MyCustomRequest".
  • En MyCustomRequest, esta política:
    • Copia el valor del encabezado HTTP user-agent del encabezado al mensaje nuevo. Dado que <Copy> usa una referencia absoluta al elemento de flujo user-agent, no hay debes especificar el atributo source en <Copy>.
    • Configura el parámetro de búsqueda address en el mensaje personalizado con el valor del parámetro de búsqueda addy de la solicitud entrante.
    • Establece el verbo HTTP como GET.
  • Establece <IgnoreUnresolvedVariables> como "false". Cuando <IgnoreUnresolvedVariables> tiene el valor “false”. Si una de las variables que intenta agregar la política no existe, Edge se detendrá el procesamiento en el flujo de la API.

Ejemplo 2

A continuación, se muestra otro ejemplo en el que se muestra cómo crear un objeto de solicitud personalizado con Asigna Mensaje:

<AssignMessage name="AssignMessage-2">
  <AssignTo createNew="true" type="request">partner.request</AssignTo>
  <Set>
    <Verb>POST</Verb>
    <Payload contentType="text/xml">
      <request><operation>105</operation></request>
    </Payload>
  </Set>
</AssignMessage>

En este ejemplo, se crea una solicitud personalizada nueva llamada “partner.request”. Luego, establece <Verb> y <Payload> en la nueva solicitud.

Puedes acceder a un mensaje de solicitud personalizado en otra política de AssignMessage que se genera más adelante en el flujo. En el siguiente ejemplo, se obtiene el valor del encabezado user-agent del mensaje de solicitud personalizado:

<AssignMessage name="custom-request-1-access">
  <DisplayName>custom-request-1-access</DisplayName>
  <AssignTo createNew="false" type="request"></AssignTo>
  <Set>
    <Headers>
      <Header name="user-agentCopyCustomRequest">{MyCustomRequest.header.user-agent}</Header>
    </Headers>
  </Set>
</AssignMessage>

Videos

Mira los siguientes videos para obtener más información acerca de la política de AssignMessage.

Video Descripción
¿Por qué usar la política de asignación de mensajes? Obtén información sobre los beneficios de usar la política de AssignMessage para modificar la solicitud o la respuesta a la API sin modificar el código de backend.
Copia los elementos de la API mediante la política de AssignMessage Copia elementos desde una solicitud o respuesta de la API y crea un objeto de solicitud o respuesta nuevo con la política de AssignMessage.
Quitar elementos de la API con la política de AssignMessage Quita los elementos de la API y modifícala antes de que alcance el backend de destino mediante la política de AssignMessage.
Agrega y establece elementos de API con la política de AssignMessage Para cambiar la solicitud o respuesta de la API, agrega parámetros de búsqueda, encabezados, parámetros de formulario o cargas útiles con la política de AssignMessage.
Cómo crear variables personalizadas con la política AssignMessage Establece variables de flujo personalizadas mediante la política de AssignMessage y aprovecha las variables en otras políticas en el proxy de API.
Crea objetos de solicitud o respuesta nuevos mediante la política de AssignMessage Crea objetos de solicitud o respuesta a la API nuevos mediante la política de AssignMessage en el entorno de ejecución de la API.
Crea una API de prueba con la política de AssignMessage Para crear una API de REST simple, agrega la política de AssignMessage en el flujo de respuesta.
Establece o modifica la carga útil con la política de AssignMessage Convertir la solicitud de REST en una solicitud de SOAP mediante la configuración de la carga útil de SOAP con la políticaAssignMessage en el entorno de ejecución de la API.

Códigos de error

En esta sección, se describen los códigos y mensajes de error que se muestran, y las variables de falla que establece Edge cuando esta política activa un error. Esta información es importante para saber si estás desarrollando reglas de fallas con el propósito de manejar fallas. Para obtener más información, consulta Qué debes saber sobre los errores de políticas y Cómo solucionar fallas.

Errores de entorno de ejecución

Estos errores pueden producirse cuando se ejecuta la política.

Código de falla Estado de HTTP Causa Corregir
steps.assignmessage.SetVariableFailed 500 La política no pudo establecer una variable. Consulta la string con error para el nombre de la variable sin resolver.
steps.assignmessage.VariableOfNonMsgType 500

Este error ocurre si el atributo source del elemento <Copy> se configuró como una variable que no es del tipo message.

Las variables del tipo de mensaje representan respuestas y solicitudes HTTP completas. El Edge integrado Las variables de flujo request, response y message son del tipo mensaje. Para obtener más información acerca de las variables de mensaje, consulta la Referencia de las variables.

steps.assignmessage.UnresolvedVariable 500

Este error ocurre si una variable especificada en la política de asignación de mensajes es una de las siguientes:

  • Está fuera del alcance (no está disponible en el flujo específico en el que se ejecuta la política)
  • o
  • no se puede resolver (no está definido)

Errores en la implementación

Estos errores pueden generarse cuando implementas un proxy que contiene esta política.

Nombre del error Causa Corregir
InvalidIndex Si el índice especificado en los elementos <Copy> o <Remove> del mensaje de asignación sea 0 o un número negativo, la implementación del proxy de API fallará.
InvalidVariableName Si el elemento secundario <Name> está vacío o no se especificó en el elemento <AssignVariable>, la implementación del proxy de API fallará porque no hay un nombre de variable válido al que asignarle un valor. Se requiere un nombre de variable válido.
InvalidPayload Una carga útil especificada en la política no es válida.

Variables con fallas

Estas variables se configuran cuando esta política activa un error en el entorno de ejecución. Para obtener más información, consulta Qué debes saber sobre los errores de la política.

Variables Donde Ejemplo
fault.name="fault_name" fault_name es el nombre de la falla, como se indica en la tabla de Errores del entorno de ejecución anterior. El nombre de la falla es la última parte del código de la falla. fault.name Matches "UnresolvedVariable"
assignmessage.policy_name.failed policy_name es el nombre especificado por el usuario de la política que generó la falla. assignmessage.AM-SetResponse.failed = true

Ejemplo de respuesta de error

{  
   "fault":{  
      "detail":{  
         "errorcode":"steps.assignmessage.VariableOfNonMsgType"
      },
      "faultstring":"AssignMessage[AM-SetResponse]: value of variable is not of type Message"
   }
}

Ejemplo de regla de falla

<faultrule name="VariableOfNonMsgType"></faultrule><FaultRule name="Assign Message Faults">
    <Step>
        <Name>AM-CustomNonMessageTypeErrorResponse</Name>
        <Condition>(fault.name Matches "VariableOfNonMsgType") </Condition>
    </Step>
    <Step>
        <Name>AM-CustomSetVariableErrorResponse</Name>
        <Condition>(fault.name = "SetVariableFailed")</Condition>
    </Step>
    <Condition>(assignmessage.failed = true) </Condition>
</FaultRule>

Esquemas

Un esquema XML (.xsd) define cada tipo de política. Como referencia, los esquemas de políticas están disponibles en GitHub.

Temas relacionados

En las muestras de la plataforma de API, están disponibles ejemplos de cómo trabajar de la política AssignMessage.

Para ver un ejemplo más avanzado de cómo anular target.url del ProxyEndpoint, consulta este artículo de la comunidad de Apigee.

Para ver una "ruta de acceso" en acción en una política ServiceCallout, consulta este ejemplo de cómo hacerlo en las muestras de GitHub de Apigee. Solo clona el repositorio y sigue las instrucciones en ese tema. En el ejemplo, se usa la política AssignMessage para establecer una ruta de solicitud. y, luego, utiliza una política de texto destacado de servicios para realizar la solicitud a un servicio externo.