Remover dependências entre campos adicionais
Detalhes da petição
- URL base: {host}/ASMSAPI/
- Uri: /api/v9/additionalsfields/dependents/delete
- Tipo: EXCLUIR
-
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/delete
Descrição
Esse endpoint permite remover dependências entre campos adicionais previamente configurados usando o endpoint LOAD. Cada dependência é identificada pela combinação única de sourceFieldId + targetFieldId + triggerValueId. Múltiplas dependências podem ser removidas em uma única solicitação.
Parâmetros do Corpo do Pedido
| Nome | Tipo de dado | Obrigatório | Descrição |
|---|---|---|---|
| Dependências | Lista | Sim | Um array de objetos que define as dependências a serem excluídas. Múltiplas dependências podem ser enviadas em uma única solicitação. |
| sourceFieldId | Número | Sim | Identificador do campo pai da dependência a ser excluída. |
| targetFieldId | Número | Sim | Identificador do campo filho da dependência a ser excluída. |
| triggerValueId | Número | Sim | Identificador do valor de gatilho da dependência a ser excluída. Para campos do tipo CheckBox, esse valor é sempre 1 (verdade). |
⚐ NOTA:
- A eliminação é Cascata: o sistema primeiro remove o
filteredValueIdsassociado à dependência e depois à própria dependência.- Se o campo pai ficar sem nenhuma dependência configurada após a exclusão, seu flag
hasDependenciesMuda automaticamente parafalseno endpoint LIST.- O processamento é Independente por item: Se uma dependência não existir ou falhar, as outras são processadas com sucesso.
Corpo da petição
Exclua uma dependência:
{
"dependencies": [
{
"sourceFieldId": 543,
"targetFieldId": 544,
"triggerValueId": 494
}
]
}
Remova múltiplas dependências em uma única solicitação:
{
"dependencies": [
{
"sourceFieldId": 543,
"targetFieldId": 544,
"triggerValueId": 494
},
{
"sourceFieldId": 543,
"targetFieldId": 544,
"triggerValueId": 495
},
{
"sourceFieldId": 552,
"targetFieldId": 543,
"triggerValueId": 1
}
]
}
Responder
Remoção bem-sucedida:
{
"content": [
{
"errorMessage": null,
"sourceFieldId": 543,
"success": true,
"targetFieldId": 544,
"triggerValueId": 494
}
],
"totalItems": 1
}
Processamento independente — uma dependência válida e uma inválida:
{
"content": [
{
"errorMessage": null,
"sourceFieldId": 543,
"success": true,
"targetFieldId": 544,
"triggerValueId": 494
},
{
"errorMessage": "Dependency not found for source 543, target 544, triggerValue 99999",
"sourceFieldId": 543,
"success": false,
"targetFieldId": 544,
"triggerValueId": 99999
}
],
"totalItems": 2
}
Parâmetros de resposta
| Nome | Tipo de dado | Descrição |
|---|---|---|
| totalItems | Número | Dependências totais processadas na petição. |
| conteúdo | Lista | Liste com o resultado de cada dependência enviada. |
| sourceFieldId | Número | Identificador do campo pai enviado na solicitação. |
| targetFieldId | Número | O identificador do campo filho enviado na solicitação. |
| triggerValueId | Número | O identificador do valor de gatilho enviado na solicitação. |
| Sucesso | Booleano | Indica se a dependência foi eliminada com sucesso. Se for false, o campo errorMessage descreve o motivo. |
| Mensagem de erro | Texto | Descrição do erro quando o sucesso é false. Seu valor é null quando a operação for bem-sucedida. |
Mensagens de erro
| Código | Status HTTP | Mensagem de erro |
|---|---|---|
| 200 | OKEY | success: false — Dependency not found for source {id}, target {id}, triggerValue {id} |
| 401 | Desautorizado | Token não fornecido ou expirado. |