[comment]: # ({c71a2e54-c71a2e54})
# correlation.update

[comment]: # ({/c71a2e54-c71a2e54})

[comment]: # ({b9562236-b9562236})
### Descrição

`correlação de objeto.update(correlações de objeto/matriz)`

Este método permite atualizar as correlações existentes.

::: noteclassic
Este método está disponível apenas para o tipo de usuário *Super admin*.
As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Ver
[Do utilizador
funções](/manual/web_interface/frontend_sections/administration/user_roles)
Para maiores informações.
:::

[comment]: # ({/b9562236-b9562236})

[comment]: # ({ce355bf6-326bc80e})
### Parâmetros 

`(object/array)` Propriedades de correlação a serem atualizadas.

A propriedade `correlationid` deve ser definida para casa correlação, todas as outras propriedades são opcionais. 
property must be defined for each correlation, all
other properties are optional. Somente as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.

Além das propriedades padrão [standard correlation
properties](object#correlation), o método aceita os seguintes parâmetros.


|Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição|
|--|--|------|
|filtro|objeto|Objeto de [filter](/manual/api/reference/correlation/object#correlation_filter) para substituir o filtro atual.|
|operações|array|[operations](/manual/api/reference/correlation/object#correlation_operation) para substituir as operações existentes.|

[comment]: # ({/ce355bf6-326bc80e})

[comment]: # ({13e1dc13-13e1dc13})
### Valores de retorno

`(object)` Retorna um objeto contendo os IDs das correlações atualizadas sob a propriedade `correlationids`.

[comment]: # ({/13e1dc13-13e1dc13})

[comment]: # ({b41637d2-b41637d2})
### Exemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({84b38e7f-67bb2dfb})
#### Desativar correlação

Solicitação:

``` {.java}
{
    "jsonrpc": "2.0",
    "método": "correlação.atualização",
    "parâmetros": {
        "correlationid": "1",
        "estado": "1"
    },
    "auth": "343baad4f88b4106b9b5961e77437688",
    "id": 1
}
```

Resposta:

``` {.java}
{
    "jsonrpc": "2.0",
    "resultado": {
        "correlationids": [
            "1"
        ]
    },
    "id": 1
}
```

[comment]: # ({/84b38e7f-67bb2dfb})

[comment]: # ({8611676c-d6ef1778})
#### Substitua as condições, mas mantenha o método de avaliação

Solicitação:

``` {.java}
{
    "jsonrpc": "2.0",
    "método": "correlação.atualização",
    "parâmetros": {
        "correlationid": "1",
        "filtro": {
            "condições": [
                {
                    "tipo": 3,
                    "oldtag": "erro",
                    "newtag": "ok"
                }
            ]
        }
    },
    "auth": "343baad4f88b4106b9b5961e77437688",
    "id": 1
}
```

Resposta:

``` {.java}
{
    "jsonrpc": "2.0",
    "resultado": {
        "correlationids": [
            "1"
        ]
    },
    "id": 1
}
```

[comment]: # ({/8611676c-d6ef1778})

[comment]: # ({e7d15410-e7d15410})
### Veja também

- [Filtro de correlação](object#correlation_filter)
- [Operação de correlação](object#correlation_operation)

[comment]: # ({/e7d15410-e7d15410})

[comment]: # ({40fa665f-40fa665f})
### Fonte

CCorrelation::update() em
*ui/include/classes/api/services/CCorrelation.php*.

[comment]: # ({/40fa665f-40fa665f})