Configurar dependencias entre campos adicionales

Detalles de la petición

• URL Base: {host}/ASMSAPI/
• Uri: /api/v9/additionalsfields/dependents/load
• Tipo: POST
• Encabezados requeridos:
  • content-type: application/json
  • X-Authorization: Bearer {token}

Descripción de la URL

• {host}: Representa el dominio del ambiente en el que se encuentra la API.
• ASMSAPI/: Prefijo fijo de la API.
• Uri: Endpoint específico para la petición.

⚐ EJEMPLO URL:

https://{host}/ASMSAPI/api/v9/additionalsfields/dependents/load

Parámetros del cuerpo de la petición

⚐ NOTA:

• Un campo hijo solo puede tener un único campo padre. Si se intenta configurar un campo hijo que ya tiene otro padre asignado, la dependencia retornará success: false.
• El campo padre y el campo hijo deben pertenecer al mismo modelo y al mismo tipo de caso. Z- El campo padre no puede ser el mismo que el campo hijo.
• Solo los campos tipo List, CatalogList y CheckBox pueden actuar como campo padre.
• Solo puede existir un campo ShortText con inheritValues=true por combinación de sourceFieldId + triggerValueId.
• Si se reenvía una dependencia existente (mismo sourceFieldId + targetFieldId + triggerValueId), el sistema realiza un upsert: actualiza las propiedades y reemplaza los filteredValueIds existentes.
• El procesamiento es independiente por ítem: si una dependencia falla, las demás se procesan correctamente.

Auto-corrección de propiedades

El sistema aplica las siguientes correcciones automáticas cuando se envían combinaciones incoherentes de visible, editable y mandatory:

⚐ NOTA: Para campos tipo CheckBox como campo padre, el endpoint acepta el envío de filteredValueIds y las propiedades visible, editable y mandatory, sin embargo esta configuración no tiene repercusión en las consolas Specialist y Customer. Desde la consola Administrator no es posible configurar valores filtrados ni propiedades para dependencias de campos tipo CheckBox.

Cuerpo de la petición

Dependencia List → List con filteredValueIds:

{
    "dependencies": [
        {
            "sourceFieldId": 543,
            "triggerValueId": 494,
            "targetFieldId": 544,
            "visible": true,
            "editable": true,
            "mandatory": true,
            "inheritValues": false,
            "filteredValueIds": [497, 498, 499]
        }
    ]
}

Dependencia CatalogList → ShortText con inheritValues:

{
    "dependencies": [
        {
            "sourceFieldId": 545,
            "triggerValueId": 81,
            "targetFieldId": 546,
            "visible": true,
            "editable": true,
            "mandatory": false,
            "inheritValues": true,
            "filteredValueIds": []
        }
    ]
}

Dependencia CheckBox → List:

{
    "dependencies": [
        {
            "sourceFieldId": 552,
            "triggerValueId": 1,
            "targetFieldId": 544,
            "visible": true,
            "editable": true,
            "mandatory": false,
            "inheritValues": false,
            "filteredValueIds": []
        }
    ]
}

Múltiples dependencias en una sola petición:

{
    "dependencies": [
        {
            "sourceFieldId": 543,
            "triggerValueId": 494,
            "targetFieldId": 544,
            "visible": true,
            "editable": true,
            "mandatory": true,
            "inheritValues": false,
            "filteredValueIds": [497, 498]
        },
        {
            "sourceFieldId": 543,
            "triggerValueId": 495,
            "targetFieldId": 544,
            "visible": true,
            "editable": true,
            "mandatory": true,
            "inheritValues": false,
            "filteredValueIds": [500]
        }
    ]
}

Respuesta

{
    "content": [
        {
            "errorMessage": null,
            "sourceFieldId": 543,
            "success": true,
            "targetFieldId": 544,
            "triggerValueId": 494
        }
    ],
    "totalItems": 1
}

Parámetros Response

Mensajes de error