Estructuras complejas de API REST en Jitterbit App Builder

Descripción general

Como novedad en VInyl 2.6, la API REST de App Builder ahora admite estructuras de API REST complejas para GET Operaciones. Con esta mejora, ahora es posible solicitar datos de varias tablas y anidar los resultados en una única estructura JSON.

Nota

Otros métodos HTTP como POST y PUT Actualmente no son compatibles.

Configuración

Vaya a App Builder IDE > Amplíe su empresa > Publicar
Cree su extremo REST como de costumbre con su tabla raíz/ extremo
Haga clic en el ícono Estructura para su extremo
Agregar recursos secundarios según sea necesario

Parámetros de recursos

Nombre	Descripción
Padre	La tabla principal en la jerarquía.
Nombre	El nombre de este nodo en la estructura de árbol. Tenga en cuenta que el nombre puede incluir barras diagonales para anidar la estructura con mayor profundidad.
Tabla	La tabla de la que se recuperarán los datos.
Tipo de campo	El tipo de campo. Matriz de objetos: Este es el tipo predeterminado donde cada fila de la tabla es un objeto JSON. Matriz de escalares: Una matriz de elementos de un solo valor, serializada en una matriz JSON de escalares. La tabla debe contener `Index` y `Value` Columnas. Objeto: Se asigna a un único objeto JSON (eliminando así la matriz JSON). La tabla solo debe devolver una fila como máximo.
Expandir por defecto	Si es verdadero, la tabla se expande por defecto (se muestra en el JSON de salida). Si es falso, el llamador REST deberá proporcionar un `$expand=true` propiedad de cadena de consultar para ver los datos Tenga en cuenta que esta propiedad solo afecta a una solicitud de recopilación (por ejemplo, `/orders`). Una solicitud de un artículo específico de una colección (p. ej. `/orders/101`) siempre expandirá las tablas secundarias.
Obtener límite máximo	Si se proporciona, indica el límite máximo de artículos que se pueden devolver en un `GET` solicitud. Si es NULL, se utiliza el valor máximo predeterminado para la API REST.
Enlaces de recursos	Establece los enlaces entre las tablas principal y secundaria.

Cambios en los parámetros de consultar

Los siguientes parámetros de consultar se han modificado para funcionar con estructuras de API REST complejas:

$fields permite especificar tablas secundarias.
- P. ej. details/*:Todos los campos de la details tabla secundaria
- P. ej. details/name:Solo el name campo de la details tabla secundaria
- P. ej. *: Todos los campos en todas las tablas
$expand se agregó un parámetro verdadero/falso para permitir que el llamador REST expanda tablas que no están expandidas por defecto (o viceversa). Solo se usa para solicitudes de recopilación.
- P. ej. $expand=true