[comment]: # translation:outdated

[comment]: # ({e205e572-e205e572})
# > Correlatie-object

De volgende objecten zijn direct gerelateerd aan de `correlatie` API.

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

[comment]: # ({d4571dd8-935ba6ef})
### Correlatie

Het correlatieobject heeft de volgende eigenschappen.

|Eigenschap|[Type](/manual/api/reference_commentary#data_types)|Omschrijving|
|--|--|------|
|correlationid|string|ID van de correlatie.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *alleen-lezen*<br>- *vereist* voor update-operaties|
|naam|string|Naam van de correlatie.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *vereist* voor aanmaak-operaties|
|omschrijving|string|Omschrijving van de correlatie.|
|status|integer|Of de correlatie ingeschakeld of uitgeschakeld is.<br><br>Mogelijke waarden:<br>0 - *(standaard)* ingeschakeld;<br>1 - uitgeschakeld.|

[comment]: # ({/d4571dd8-935ba6ef})

[comment]: # ({e242e1d8-d12c2169})
### Correlatiebewerking

Het correlatiebewerkingsobject definieert een bewerking die wordt uitgevoerd wanneer een correlatie wordt uitgevoerd. Het heeft de volgende eigenschappen.

|Eigenschap|[Type](/manual/api/reference_commentary#data_types)|Omschrijving|
|--|--|------|
|type|integer|Type bewerking.<br><br>Mogelijke waarden:<br>0 - oude gebeurtenissen sluiten;<br>1 - nieuwe gebeurtenis sluiten.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *vereist*|

[comment]: # ({/e242e1d8-d12c2169})

[comment]: # ({59d7af11-d0662dba})
### Correlatiefilter

Het correlatiefilterobject definieert een reeks voorwaarden die moeten worden voldaan om de geconfigureerde correlatiebewerkingen uit te voeren. Het heeft de volgende eigenschappen.

|Eigenschap|[Type](/manual/api/reference_commentary#data_types)|Omschrijving|
|--|--|------|
|evaltype|integer|Methode voor evaluatie van filtervoorwaarden.<br><br>Mogelijke waarden:<br>0 - en/of;<br>1 - en;<br>2 - of;<br>3 - aangepaste expressie.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *vereist*|
|voorwaarden|array|Set van [filtervoorwaarden](#correlation-filter-condition) die worden gebruikt voor het filteren van resultaten.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *vereist*|
|eval\_formula|string|Gegenereerde expressie die wordt gebruikt voor het evalueren van filtervoorwaarden. De expressie bevat ID's die specifieke filtervoorwaarden aangeven aan de hand van de `formulaid`. De waarde van `eval_formula` is gelijk aan de waarde van `formula` voor filters met een aangepaste expressie.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *alleen-lezen*|
|formula|string|Aangepaste door de gebruiker gedefinieerde expressie die wordt gebruikt voor het evalueren van voorwaarden van filters met een aangepaste expressie. De expressie moet ID's bevatten die specifieke filtervoorwaarden aangeven aan de hand van de `formulaid`. De ID's die in de expressie worden gebruikt, moeten exact overeenkomen met degenen die zijn gedefinieerd in de filtervoorwaarden: geen enkele voorwaarde mag ongebruikt of weggelaten blijven.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *vereist* als `evaltype` is ingesteld op "aangepaste expressie"|

[comment]: # ({/59d7af11-d0662dba})

[comment]: # ({806339c2-72ee5420})
#### Correlatiefiltervoorwaarde

Het correlatiefiltervoorwaardeobject definieert een specifieke voorwaarde die moet worden gecontroleerd voordat de correlatiebewerkingen worden uitgevoerd.

|Eigenschap|[Type](/manual/api/reference_commentary#data_types)|Omschrijving|
|--|--|------|
|type|integer|Type voorwaarde.<br><br>Mogelijke waarden:<br>0 - oude gebeurtenistag;<br>1 - nieuwe gebeurtenistag;<br>2 - nieuwe gebeurtenishostgroep;<br>3 - gebeurtenistagpaar;<br>4 - oude gebeurtenistagwaarde;<br>5 - nieuwe gebeurtenistagwaarde.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *vereist*|
|tag|string|Gebeurtenistag (oud of nieuw).<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *vereist* als `type` is ingesteld op "oude gebeurtenistag", "nieuwe gebeurtenistag", "oude gebeurtenistagwaarde" of "nieuwe gebeurtenistagwaarde"|
|groupid|string|Hostgroep-ID.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *vereist* als `type` is ingesteld op "nieuwe gebeurtenishostgroep"|
|oldtag|string|Oude gebeurtenistag.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *vereist* als `type` is ingesteld op "gebeurtenistagpaar"|
|newtag|string|Oude gebeurtenistag.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *vereist* als `type` is ingesteld op "gebeurtenistagpaar"|
|value|string|Gebeurtenistagwaarde (oud of nieuw).<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *vereist* als `type` is ingesteld op "oude gebeurtenistagwaarde" of "nieuwe gebeurtenistagwaarde"|
|formulaid|string|Willekeurige unieke ID die wordt gebruikt om naar de voorwaarde te verwijzen vanuit een aangepaste expressie. Kan alleen hoofdletters bevatten. De ID moet door de gebruiker worden gedefinieerd bij het wijzigen van filtervoorwaarden, maar wordt opnieuw gegenereerd bij het opvragen ervan nadien.|
|operator|integer|Voorwaarde-operator.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *vereist* als `type` is ingesteld op "nieuwe gebeurtenishostgroep", "oude gebeurtenistagwaarde" of "nieuwe gebeurtenistagwaarde"|

::: notetip
Voor een beter begrip van hoe filters met verschillende soorten expressies te gebruiken, zie voorbeelden op de pagina's van de methodes [correlation.get](get#correlaties-ophalen) en [correlation.create](create#een-aangepaste-expressie-filter-gebruiken).
:::

De volgende operatoren en waarden worden ondersteund voor elk type voorwaarde.

|Voorwaarde|Voorwaarden-naam|Ondersteunde operatoren|Verwachte waarde|
|---------|--------------|-------------------|--------------|
|2|Hostgroep|=, <>|Hostgroep-ID.|
|4|Oude gebeurtenistagwaarde|=, <>, like, not like|string|
|5|Nieuwe gebeurtenistagwaarde|=, <>, like, not like|string|

[comment]: # ({/806339c2-72ee5420})
