PT
Español
English
Português
    Remover dependências entre campos adicionais

    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:

    1. A eliminação é Cascata: o sistema primeiro remove o filteredValueIds associado à dependência e depois à própria dependência.
    2. Se o campo pai ficar sem nenhuma dependência configurada após a exclusão, seu flag hasDependencies Muda automaticamente para false no endpoint LIST.
    3. 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.