La función Record.RemoveFields devuelve un registro tras eliminar uno o varios campos.
Record.RemoveFields(
record as record,
fields as any,
optional missingField as nullable number
) as record
- record: registro del que eliminar los campos
- fields: campo o campos a eliminar
- missingField: (opcional) criterio a seguir cuando no exista el campo a eliminar
Si el campo no existe, por defecto se devuelve un error, pero este comportamiento puede controlarse añadiendo el argumento missingField. Éste puede tomar los valores MissingField.Error, MissingField.UseNull o MissingField.Ignore. En estos dos últimos casos los campos inexistentes son ignorados.
El argumento fields puede ser una cadena de texto conteniendo el nombre del campo buscado, o una lista de nombres de campos.
En el caso de que dicho argumento se trate de una lista de campos, el orden en el que aparezcan éstos no es relevante.
Podemos eliminar el campo "name" del registro [id=1, name="Tom", city="London"] con la siguiente expresión:
Record.RemoveFields(
[id=1, name="Tom", city="London"],
"name"
)
Record
Un clic en el enlace Record nos muestra el registro generado:
Si queremos eliminar dos o más campos, éstos deberán incluirse en una lista:
Record.RemoveFields(
[id=1, name="Tom", city="London"],
{"name", "id"}
)
Record
En este caso el registro devuelto es el siguiente:
