Configure dependências entre campos adicionais

Detalhes da petição

• URL base: {host}/ASMSAPI/
• Uri: /api/v9/additionalsfields/dependents/load
• Tipo: POST

• Títulos obrigatórios:

• tipo de conteúdo: application/json
• Autorização X: Portador {token}

Descrição do URL

• {host}: Ele representa o domínio do ambiente no qual a API está localizada.
• ASMSAPI/: Prefixo de API fixo.
• URI: Ponto de extremidade específico para a solicitação.

⚐ URL DE EXEMPLO:

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

Parâmetros do Corpo do Pedido

⚐ NOTA:

• Um campo filho só pode ter Um campo de pai solteiro. Se você tentar configurar um campo filho que já tenha outro pai atribuído, a dependência retornará success: false.
• O campo pai e o campo filho devem pertencer ao Mesmo modelo e para o Mesmo tipo de caso. Z- O campo pai não pode ser o mesmo que o campo filho.
• Apenas os corpos tipo Lista, CatálogoLista e CheckBox Eles podem atuar como um campo principal.
• Só pode existir um campo ShortText com herdeiraValores=verdadeiro por combinação de sourceFieldId + triggerValueId.
• Se uma dependência existente for encaminhada (mesmo sourceFieldId + targetFieldId + triggerValueId), o sistema executa um upsert- Atualiza propriedades e substitui filteredValueIds existentes.
• O processamento é Independente por item: Se uma dependência falhar, as outras são processadas com sucesso.

Propriedades de correção automática

O sistema aplica as seguintes correções automáticas quando combinações inconsistentes de visível, editável e obrigatório são submetidas:

⚐ NOTA: Para Campos de Tipo CheckBox Como campo pai, o endpoint aceita o envio de filteredValueIds e as propriedades visível, editável e obrigatória, porém essa configuração não tem impacto nos consoles Especialista e Cliente. A partir do console de administrador, você não pode configurar valores ou propriedades filtradas para dependências de campos CheckBox.

Corpo da petição

Dependência de List → List com filteredValueIds:

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

Dependência CatalogList → ShortText com inheritValues:

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

Lista de Dependências → CheckBox:

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

Múltiplas dependências em uma única solicitação:

{
    "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]
        }
    ]
}

Responder

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

Parâmetros de resposta

Mensagens de erro