La llamada Insert

La llamada Insert se utiliza para crear un nuevo registro (entidad) de un tipo particular con los valores especificados.

La solicitud Insert: además del ID de inicio de sesión normal y los argumentos de contraseña, la llamada Insert también requiere los siguientes argumentos:      

Durante una inserción, no es necesario especificar todos los campos para ese tipo de entidad. La mayor parte de los campos son opcionales, excepto los marcados como obligatorios en la respuesta de descripción, y se indica mediante el atributo 'nullable' con el valor booleano '0'. Los campos que no se especifican se dejan en blanco o se establecen con valores predeterminados. Los campos que son demasiado largos se truncan.

Cuando se envían valores de campo desconocidos en la solicitud insert, la API del servicio web rechaza la llamada. Como resultado, se transmite el código de estado 300, tal como se indica en el siguiente mensaje:

Rejecting the value that is supplied for input data element "{ 0} "; due to a correlation failure because the data transformation process could not resolve the supplied input data element into native format.

La API aplica una definición estricta de valores de campo desconocidos por la que todos los campos en la llamada deben ser válidos para el usuario para esta operación.

Por ejemplo:

• La API rechaza llamadas que especifican un valor para un campo personalizado que se ha suprimido o eliminado del acceso de un usuario.
• La API rechaza llamadas que especifican campos de solo lectura.

Para algunos tipos de entidades, si se intenta insertar un nuevo registro que ya existe, la API no inserta ningún registro nuevo.

La respuesta Insert

La respuesta de servicio predeterminada para todas las llamadas de la API contiene el identificador del registro (ID de fila) de un registro que se inserta en el formato de salida solicitado para una llamada Insert.