update_custom_field
Para crear, actualizar o eliminar un campo personalizado de un objeto, utilice el método item/update_custom_field. Para enviar la solicitud, debe tener los derechos de acceso Ver campos personalizados y Gestionar campos personalizados al objeto.
Endpoint
svc=item/update_custom_field¶ms={
"itemId":<long>,
"id":<long>,
"callMode":"<text>",
"n":"<text>",
"v":"<text>"
}
Parámetros
La solicitud debe contener los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
itemId |
ID del objeto. |
id |
ID del campo personalizado. Al crear un campo personalizado, indique cualquier valor, por ejemplo, 0. El sistema lo ignora y asigna el ID libre más pequeño dentro del objeto (1, 2, y así sucesivamente). Los ID de los campos eliminados se reutilizan. |
callMode |
Acción: create, update o delete. |
Para crear o actualizar un campo personalizado, indique también los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
n |
Nombre del campo personalizado. |
v |
Valor del campo personalizado. |
Resultado devuelto
Si el campo personalizado se crea o se actualiza correctamente, se devuelve una respuesta con el siguiente formato:
[
<long>, /* ID del campo personalizado */
{
"id":<long>, /* ID del campo personalizado */
"n":"<text>", /* nombre */
"v":"<text>", /* valor */
"ct":<uint>, /* hora de creación (marca de tiempo Unix) */
"mt":<uint> /* hora de la última modificación (marca de tiempo Unix) */
}
]
Si el campo personalizado se elimina correctamente, se devuelve una respuesta con el siguiente formato:
[
<long>, /* ID del campo personalizado */
null
]
De lo contrario, se devuelve un código de error.
Códigos de error
| Código de error | Descripción |
|---|---|
| 4 | Parámetros de entrada incorrectos. Por ejemplo, callMode tiene un valor no admitido o no se encuentra el campo personalizado que se desea actualizar. |
| 6 | Error al crear el campo personalizado o no se encuentra el campo personalizado que se desea eliminar. |
| 7 | Error al obtener el objeto. Es posible que el usuario no tenga los derechos de acceso Ver campos personalizados y Gestionar campos personalizados al objeto. |