Solo pasarela de API de DataPower

Extract

Utilice la política Extraer para extraer y transformar datos de campos en el contexto de API.

Antes de empezar

Tabla 1. Pasarelas que dan soporte a esta política y a las versiones de política correspondientes
Pasarela Versión de política
DataPower® API Gateway 2.0.0

En este tema se describe cómo configurar la política en el editor de ensamblaje. Para obtener detalles sobre cómo configurar la política en el origen de OpenAPI , consulte extract.

Acerca de esta tarea

La política Extraer especifica el origen de datos que contiene el contenido a transformar, los campos que contienen el contenido y las expresiones que definen cómo transformar el contenido. Puede utilizar un subconjunto de notación JSONata para especificar los campos a extraer y transformar. Para obtener más información, consulte Construcción de expresiones JSONata para extraer y transformar datos.

La entrada a la política Extraer deben ser datos analizados. Una forma de generar datos analizados es añadir una política Analizar antes de la política Extraer en el ensamblaje.

Procedimiento

  1. En el panel de navegación, pulse Icono de desarrollo en el panel de navegación Desarrollary, a continuación, seleccione la pestaña API.
    Se abre la página Desarrollar .
  2. Pulse el título de la definición de API con la que desea trabajar.
  3. Seleccione la pestaña Pasarela y, a continuación, pulse Políticas en el panel de navegación.
    Para obtener más información sobre cómo trabajar con el editor de ensamblaje para una API, consulte El editor de ensamblaje.
  4. Busque la política Extraer en la paleta y arrastre la política al lienzo.
  5. Especifique las propiedades siguientes.
    Tabla 2. Propiedades de política de Extraer
    Etiqueta de propiedad Obligatorio Descripción Tipo de datos
    Título El título de la política.

    El valor predeterminado es extract.

    serie
    Descripción Nee Una descripción de la política. serie
    root El origen de datos que contiene el contenido que se va a transformar.

    El valor predeterminado es message.body.

    serie
    Captura La expresión de vía de acceso que identifica el campo.

    El valor predeterminado es $, que indica toda la entrada.

    serie
    transformacion Expresión que define cómo transformar el contenido. serie
  6. Especifique una versión para la política pulsando el icono Origen Icono OpenAPI Sourcey completando la sección version del YAML de política. Por ejemplo:
    execute:
      - extract:
          version: 2.0.0
          title: extract
    ...
    Debe especificar una versión para la política que sea compatible con la pasarela que está utilizando. Cuando se publica la API, si la versión es incompatible con la pasarela, se genera un error de validación que especifica las versiones disponibles.
  7. Pulse Guardar.

Ejemplo

Transforme el contenido del campo account para incluir sólo los últimos 4 caracteres.
- extract:
    version: 2.0.0
    title: extract
    root: message.body
    extracts:
      - capture: $.members.policy.**.account
        transform: $substring($,-4)
    description: Include only the last 4 characters of the account field.