HTTP v2 (Beta) ELIMINAR Actividad¶
Introducción¶
Una actividad HTTP v2 (Beta) DELETE, utilizando su conexión HTTP v2 (Beta), elimina un recurso en un servidor HTTP y puede usarse como fuente (para proporcionar datos en una operación) o como destino (para consumir datos en una operación).
Nota
Este conector se publica actualmente como una versión beta. Se pueden proporcionar comentarios sobre errores y mejoras sugeridas a través de su Administrador de éxito del cliente (CSM).
Crear una Actividad DELETE HTTP v2 (Beta)¶
Se crea una instancia de una actividad HTTP v2 (Beta) DELETE a partir de una conexión HTTP v2 (Beta) utilizando su tipo de actividad DELETE.
Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño o copie el tipo de actividad y péguelo en el tela de diseño. Para obtener más información, consulte Creación de una instancia de actividad en Reutilización de componentes.
Una actividad existente de HTTP v2 (Beta) DELETE se puede editar desde estas ubicaciones:
- El tela de diseño (vea Menú de acciones de componentes en Tela de Diseño).
- La pestaña Componentes del panel del proyecto (vea Menú de acciones de componentes en Ficha Componentes del panel Proyecto).
Configurar una Actividad DELETE HTTP v2 (Beta)¶
Siga estos pasos para configurar una actividad HTTP v2 (Beta) ELIMINAR:
-
Paso 1: Introduzca un nombre y especifique la configuración
Proporcione un nombre para la actividad y especifique la URL, los parámetros de solicitud, los encabezados de solicitud y configuraciones adicionales. -
Paso 2: proporcionar el esquema de solicitud
Proporcione un esquema de solicitud personalizado (opcional). Si no proporciona un esquema de respuesta personalizado, se utilizará el esquema de respuesta predeterminado del conector. -
Paso 3: proporcionar el esquema de respuesta
Proporcione un esquema de respuesta personalizado (opcional). Si no proporciona un esquema de respuesta personalizado, se utilizará el esquema de respuesta predeterminado del conector. -
Paso 4: Revisar los esquemas de datos
Se muestran los esquemas de solicitud y respuesta configurados.
Paso 1: Ingrese un Nombre y Especifique la Configuración¶
En este paso, proporcione un nombre para la actividad y especifique la URL, los parámetros de solicitud, los encabezados de solicitud y la configuración adicional. Cada elemento de la interfaz de usuario de este paso se describe a continuación.
Consejo
Campos con un icono de variable admite el uso de variables globales, variables del proyecto, y variables de jitterbit. Comience escribiendo un corchete abierto
[
en el campo o haciendo clic en el icono de variable para mostrar una lista de las variables existentes para elegir.
Importante
Los campos de las tablas muestran el icono de variable solo en el modo de edición. Para que los valores de las variables de estos campos se completen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.
-
Nombre: Introduzca un nombre para identificar la actividad. El nombre debe ser único para cada actividad HTTP v2 (Beta) DELETE y no debe contener barras inclinadas
/
o dos puntos:
. -
Ruta: Ingrese una URL para usar en la actividad:
- Si se deja en blanco, la URL base configurada en la conexión HTTP v2 (Beta) se utilizará en tiempo de ejecución.
- Si se especifica una ruta parcial, se agregará a la URL base configurada en la conexión HTTP v2 (Beta).
- Si se especifica una URL completa, anulará la URL base configurada en la conexión HTTP v2 (Beta).
Los parámetros de la solicitud se pueden incluir encerrándolos entre corchetes
{
}
. Parámetros de consulta (como/queryrecord?id=10
) también puede ser usado.-** URL:** Muestra la URL completa que se utilizará en tiempo de ejecución.
-
Solicitar parámetros: Haz clic en el ícono de agregar
para agregar una fila a la siguiente tabla e ingresar un Nombre y un Valor para cada parámetro de solicitud. Los parámetros de solicitud proporcionados se codificarán automáticamente como URL.
Como alternativa, se pueden proporcionar parámetros de solicitud en la transformación de solicitud. Los parámetros de solicitud que no comparten una clave se envían de forma acumulativa, independientemente de dónde se especifiquen. Si se especifica la misma clave de parámetro tanto en este campo como en la solicitud, la especificada en la solicitud tiene prioridad.
Para guardar la fila, haga clic en el icono de envío
en la columna más a la derecha.
Para editar o eliminar una sola fila, coloque el cursor sobre la columna más a la derecha y use el icono de edición
o eliminar icono
.
Para eliminar todas las filas, haga clic en Borrar todo.
-
Encabezados de solicitud: Haga clic en el icono de añadir
para agregar una fila a la siguiente tabla e ingresar un Nombre y un Valor para cada encabezado de solicitud.
Como alternativa, los encabezados se pueden definir en otros campos de configuración de la interfaz de usuario o se pueden proporcionar en la transformación de la solicitud. Los encabezados que no comparten una clave se envían de forma acumulativa, independientemente de dónde se especifiquen.
Si se especifica la misma clave de encabezado en varios lugares, se sigue este orden de precedencia:
- Un encabezado proporcionado en la transformación de la solicitud anula todos los campos a continuación.
- Un encabezado proporcionado en el campo Encabezados de solicitud de una actividad HTTP v2 (Beta) ELIMINAR (este campo) anula el campo restante a continuación.
- Un encabezado provisto en el campo Encabezados de solicitud de una conexión HTTP v2 (Beta) tiene la menor precedencia.
Para guardar la fila, haga clic en el icono de envío
en la columna más a la derecha.
Para editar o eliminar una sola fila, coloque el cursor sobre la columna más a la derecha y use el icono de edición
o eliminar icono
.
Para eliminar todas las filas, haga clic en Borrar todo.
-
Configuración adicional: Haz clic en el ícono de agregar
para agregar una fila a la siguiente tabla e ingresar un Nombre y un Valor para cada configuración adicional.
Se admiten estas configuraciones adicionales:
Llave Valor predeterminado Tipo de datos Descripción connection-timeout
30000
Entero El tiempo de espera de la transferencia en milisegundos. Si no se especifica esta configuración, el tiempo de espera de transferencia predeterminado es 30000
milisegundos (30 segundos). Ajustado a0
para un tiempo de espera ilimitado.content-type
— Cadena El tipo de contenido de la estructura de solicitud que espera la API en particular. Por ejemplo, text/plain
,application/json
,application/x-www-form-urlencoded
, etc. Si no se especifica esta configuración, no hay un valor predeterminado.max-redirect
50
Entero El número máximo de redireccionamientos a seguir. Si no se especifica esta configuración, el valor predeterminado es seguir 50
redirecciones Ajustado a0
o un número negativo para evitar seguir cualquier redireccionamiento.trailing-linebreaks
false
Cadena Elimina los espacios en blanco iniciales y finales y los saltos de línea cuando se establece en true
. Si esta configuración no se especifica o se establece enfalse
, los datos no se modifican.Como alternativa, se pueden proporcionar configuraciones adicionales en la transformación de solicitud. Las configuraciones adicionales que no comparten una clave se envían de forma acumulativa, independientemente de dónde se especifiquen. Para todas las configuraciones, excepto para el tipo de contenido, si se especifica la misma clave de configuración tanto en este campo como en la solicitud, la especificada en la solicitud tiene prioridad.
Para
content-type
, un valor especificado aquí tiene prioridad sobre todos los demás lugares de la interfaz de usuario donde se puede especificar el tipo de contenido. Si el tipo de contenido se especifica en varios lugares, se sigue este orden de prioridad:- Un
Content-Type
El encabezado proporcionado en la tabla Configuración adicional de una actividad HTTP v2 (Beta) ELIMINAR (esta tabla) anula todos los campos a continuación. - El
bodyContentType
El campo especificado en una transformación de solicitud anula los campos restantes a continuación. - Un
Content-Type
encabezado proporcionado en la transformación de solicitudheaders
node anula los campos restantes a continuación. - Un
Content-Type
El encabezado proporcionado en el campo Encabezados de solicitud de una actividad HTTP v2 (Beta) ELIMINAR anula los campos restantes a continuación. - Un
Content-Type
El encabezado proporcionado en el campo Encabezados de solicitud de una conexión HTTP v2 (Beta) anula el campo restante a continuación. - Un
Content-Type
el encabezado provisto en el campo Content-Type de una conexión HTTP v2 (Beta) tiene la menor prioridad.
Para guardar la fila, haga clic en el icono de envío
en la columna más a la derecha.
Para editar o eliminar una sola fila, coloque el cursor sobre la columna más a la derecha y use el icono de edición
o eliminar icono
.
Para eliminar todas las filas, haga clic en Borrar todo.
- Un
-
Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.
-
Siguiente: Haga clic para almacenar temporalmente la configuración para este paso y continuar con el próximo paso. La configuración no se guardará hasta que haga clic en el botón Terminado en el último paso.
-
Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.
Paso 2: Proporcionar el Esquema de Solicitud¶
En este paso, puede proporcionar un esquema de solicitud personalizado. Si no proporciona un esquema de solicitud personalizado, se utilizará el esquema de solicitud predeterminado del conector.
-
Proporcionar esquema de solicitud: El esquema de solicitud define la estructura de los datos de solicitud que utiliza la actividad HTTP v2 (Beta) DELETE. Para obtener instrucciones sobre cómo completar esta sección de configuración de actividad, consulte Esquemas definidos en una actividad.
-
Atrás: Haga clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.
-
Siguiente: Haga clic para almacenar temporalmente la configuración para este paso y continuar con el próximo paso. La configuración no se guardará hasta que haga clic en el botón Terminado en el último paso.
-
Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.
Paso 3: Proporcionar el Esquema de Respuesta¶
En este paso, puede proporcionar un esquema de respuesta personalizado. Si no proporciona un esquema de respuesta personalizado, se utilizará el esquema de respuesta predeterminado del conector.
-
Respuesta: El esquema de respuesta define la estructura de los datos de respuesta que utiliza la actividad HTTP v2 (Beta) DELETE. Para obtener instrucciones sobre cómo completar esta sección de configuración de actividad, consulte Esquemas definidos en una actividad.
-
Atrás: Haga clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.
-
Siguiente: Haga clic para almacenar temporalmente la configuración para este paso y continuar con el próximo paso. La configuración no se guardará hasta que haga clic en el botón Terminado en el último paso.
-
Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.
Paso 4: Revisar los Esquemas de Datos¶
Se muestran los esquemas de solicitud y respuesta configurados.
-
Esquemas de datos: Estos esquemas de datos son heredados por transformaciones adyacentes y se muestran de nuevo durante mapeo de transformación.
Si se proporcionaron esquemas personalizados en los pasos anteriores, se mostrarán. Si no se proporcionaron esquemas personalizados, se mostrarán los esquemas predeterminados incluidos con el conector.
Los esquemas de solicitud y respuesta predeterminados constan de estos nodos y campos:
-
Solicitud:
Solicitar nodo/campo de esquema Notas json Formato del esquema de solicitud solicitud Solicitar nodo raíz Nodo raíz encabezados Nodo de encabezados artículo Nodo de un encabezado específico clave Clave de la encabezado valor Valor del encabezado parámetros de solicitud Nodo de parámetros de solicitud artículo Nodo de un parámetro de solicitud específico llave Clave del parámetro de solicitud valor Valor del parámetro de solicitud Configuraciones adicionales Nodo de configuraciones adicionales artículo Nodo de una configuración adicional específica llave Clave de la configuración adicional valor Valor del ajuste adicional cuerpo Cuerpo de la solicitud tipo de contenido del cuerpo Content-Type
del cuerpo de la solicitud
Nota
Este campo tiene prioridad sobre un
Content-Type
encabezado provisto en elheaders
nodo. -
Respuesta:
Nodo/campo de esquema de respuesta Notas json Formato del esquema de respuesta respuesta Nodo de respuesta elemento de respuesta Nodo del elemento de respuesta estado Un valor booleano que indica si se devolvió una respuesta propiedades Propiedades de la respuesta encabezados Nodo de encabezados artículo Nodo de un encabezado específico clave Clave de la encabezado valor Valor del encabezado contenido de respuesta Contenido de la respuesta error Nodo de error código de estado Código de estado HTTP de la respuesta detalles Detalles de la respuesta
-
-
Actualizar: Haz clic en el icono de actualización
o la palabra Actualizar para regenerar esquemas desde el extremo HTTP v2 (Beta). Esta acción también regenera un esquema en otras ubicaciones del proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.
-
Atrás: Haga clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.
-
Terminado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.
-
Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.
Próximos Pasos¶
Después de configurar una actividad HTTP v2 (Beta) DELETE, complete la configuración de la operación agregando y configurando otras actividades, transformaciones o secuencias de comandos como pasos de la operación. También puede configurar los ajustes de operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujos de trabajo o en uno diferente.
Se puede acceder a las acciones de menú para una actividad desde el panel del proyecto y el tela de diseño. Para obtener más información, consulte Menú de acciones de actividad en Conceptos básicos del conector.
Las actividades HTTP v2 (Beta) DELETE que se usan como fuente se pueden usar con estos patrones de operación:
- Patrón de transformación
- Patrón de archivo de dos objetivos (solo como primera fuente)
- Patrón de archivo HTTP de dos objetivos (solo como primera fuente)
- Patrón de dos transformaciones (como primera o segunda fuente)
Las actividades HTTP v2 (Beta) DELETE que se usan como destino se pueden usar con estos patrones de operación:
- Patrón de transformación
- Patrón de dos transformaciones (como primer o segundo objetivo)
Un caso de uso típico es usar una actividad HTTP v2 (Beta) DELETE como destino en el Patrón de dos transformaciones. En este ejemplo, la primera transformación (HTTP v2 (Beta) DELETE Request) crea una estructura de solicitud que se pasa a la actividad HTTP v2 (Beta) DELETE. La segunda transformación (HTTP v2 (Beta) DELETE Response) recibe la estructura de respuesta, que luego se escribe en una variable mediante una actividad Variable Write (Write HTTP v2 (Beta) DELETE Response) y luego se registra un mensaje. el secuencia de comandos_Escribir en el registro de operaciones_:
Para usar la actividad con funciones de secuencias de comandos, escriba los datos en una ubicación temporal y luego use esa ubicación temporal en la función de secuencias de comandos.
Cuando esté listo, desplegar y ejecutar la operación y validar el comportamiento comprobando los registros de operación.