[comment]: # translation:outdated [comment]: # ({2956300c-2956300c}) # configuration.importcompare [comment]: # ({/2956300c-2956300c}) [comment]: # ({24146d56-069ae59d}) ### Опис `array configuration.importcompare(object parameters)` Овај метод омогућава упоређивање датотеке за увоз са тренутним системским елементима и показује шта ће бити промењено ако се ова увозна датотека увезе. ::: noteclassic Овај метод је доступан корисницима било ког типа. Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте [User roles](/manual/web_interface/frontend_sections/users/user_roles) за више информација. ::: [comment]: # ({/24146d56-069ae59d}) [comment]: # ({8ad7aa47-0ae26f0f}) ### Параметри `(object)` Параметри који садрже све могуће податке за увози правила како треба поступити са тим подацима. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |format|string|Формат серијализиваног стринга.

Могуће вредности:
`yaml` - YAML;
`xml` - XML;
`json` - JSON.

[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *обавезно*| |rules|object|Правила како треба поредити нове и постојеће објекте.

[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):
- *обавезно*| |rules|object|Правила како треба поредити нове и постојеће објекте.

Параметар `rules` је описан детаљно у табели испод.

[Parameter behavior](/manual/ api/reference_commentary#parameter-behavior):
- *обавезно*| ::: notetip Ако нису дата правила, неће бити ничега да се ажурира и резултат ће бити празан. ::: ::: notetip Поређење ће бити извршено само за групе домаћина и шаблоне. Окидачи и графови ће бити поређени само са увезеним шаблонима, а сви остали ће се сматрати "новим". ::: Објекат `rules` подржава следеће парамтре. |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryRules|object|Правила како увозити LLD правила.

Подржани параметри:
`createMissing` - `(boolean)` ако је постављено на `true`, ново LLD правило ће бити креирано; подразумевано: `false`;
`updateExisting` - `(boolean)` ако је постављено на `true`, ново LLD правило ће бити ажурирано; подразумевано: `false`;
`deleteMissing` - `(boolean)` ако је постављено на `true`, правила која нису присутна у увезеним подацима биће обрисана из базе података; подразумевано: `false`.| |graphs|object|Правила како импортовати графове.

Подржани параметри:
`createMissing` - `(boolean)` ако је постављено на `true`, креираће се нови графици; подразумевано: `false`;
`updateExisting` - `(boolean)` ако је постављено на `true`, постојеће групе домаћина ће бити ажуриране; подразумевано: `false`;
`deleteMissing` - `(boolean)` ако је постављено на `true`, графици који нису нису присутни у увезеним подацима биће обрисани из базе података;подразуемевано: `false`.| |host_groups|object|Правила како увозити групе домаћина.

Подржани параметри:
`createMissing` - `(boolean)` ако је постављено на`true`, биће креиране нове групе домаћина; подразумевано: `false`;
`updateExisting` - `(boolean)` ако је постављено на `true`, постојеће групе домаћина ће бити ажуриране; подразумевано: `false`.| |template_groups|object|Правила како увозити групе шаблона.

Подржани параметри:
`createMissing` - `(boolean)` ако је постављено на `true`, нове групе шаблона ће бити креиране; подразумевано: `false`;
`updateExisting` - `(boolean)` ако је постављено на `true`, постојеће групе шаблона ће бити ажуриране; подразумевано: `false`.| |hosts|object|Правила како увозити домаћине.

Подржани параметри:
`createMissing` - `(boolean)` ако је постављено на `true`, нови домаћини ће бити креирани; подразумевано: `false`;
`updateExisting` - `(boolean)` ако је постављено на `true`, постојећи домаћини ће бити ажурирани; подразумевано: `false`.

Овај параметар неће правити никакву разлику за излаз. Дозвољено је само за доследност са `configuration.import`.| |httptests|object|Правила како увозити веб сценарије.

Подржани параметри:
`createMissing` - `(boolean)` ако је постављено на `true`, нови веб сценарији ће бити креирани; подразумевано: `false`;
`updateExisting` - `(boolean)` ако је постављено на `true`, постојећи веб сценарији ће бити ажурирани; подразумевано: `false`;
`deleteMissing` - `(boolean)` ако је постављено на `true`, веб сценарији који нису присутни у увезеним подацима биће обрисани из базе података; подразумевано: `false`.| |images|object|Правила како увозити слике.

Подржани параметри:
`createMissing` - `(boolean)` ако је постављено на `true`, нове слике ће бити креиране; подразумевано: `false`;
`updateExisting` - `(boolean)` ако је постављено на `true`, постојеће слике ће бити ажуриране; подразумевано: `false`.

Овај параметар неће правити разлику на излазу. Ово је дозвољено само са коинзистентношћу са `configuration.import`.| |items|object|Правила како увозити ставке.

Подржани параметри:
`createMissing` - `(boolean)` ако је постављено на `true`, нове ставке ће бити креиране; подразумевано: `false`;
`updateExisting` - `(boolean)` ако је постављено на `true`, постојеће ставке ће бити ажуриране; подразумевано: `false`;
`deleteMissing` - `(boolean)` ако је постављено на `true`, ставке које нису присутне у увезеним подацима биће избрисане из базе података; подразумевано: `false`.| |maps|object|Правила како увозити мапе.

Подржани параметри:
`createMissing` - `(boolean)` ако је постављено на `true`, нове мапе ће се креирати; подразумевано: `false`;
`updateExisting` - `(boolean)` ако је постављено на `true`, нове мапе ће бити ажуриране; подразумевано: `false`.

Овај параметар неће направити разлику на излазу. Ово је дозвољено само за коинзистентност са`configuration.import`.| |mediaTypes|object|Правила како увозити типове медија.

Подржани параметри:
`createMissing` - `(boolean)` ако је постављено на `true`, нови типови медија ће бити креирани; подразумевано: `false`;
`updateExisting` - `(boolean)` ако је постављено на `true`, нови типови медија ће бити ажурирани; подразумевано: `false`.

Ови параметри не праве разлику на излазу. Ово је дозвољено само за коинзистентност са `configuration.import`.| |templateLinkage|object|Правила како увозити линкове шаблона.

Подржани параметри:
`createMissing` - `(boolean)` ако је постављено на `true`, шаблони који нису линковани за домаћина или шаблон који се увози, а присутни су у увезеним подацима, биће линковани; подразумеванo: `false`;
`deleteMissing` - `(boolean)` ако су постављени на `true`, шаблони који су линковани за домаћина или шаблон који се увози, а нису присутни у увезеним подацима, биће уклоњени без брисања ентитета (items, triggers, итд.) наслеђених од уклоњених шаблона; подразумеванo: `false`.| |templates|object|Правила како увозити шаблоне.

Подржани параметри:
`createMissing` - `(boolean)` ако је постављено на `true`, нови шаблон ће бити креиран; подразумевано: `false`;
`updateExisting` - `(boolean)` ако је постављено на `true`, постојећи шаблон ће бити ажуриран; подразумевано: `false`.| |templateDashboards|object|Правила како увозити шаблоне контролних табли.

Подржани параметри:
`createMissing` - `(boolean)` ако је постављен на `true`, нови шаблони контролних табли ће бити креирани; подразумевано: `false`;
`updateExisting` - `(boolean)` ако је постављено на `true`, постојећи шаблони контролних табли ће бити ажурирани; подразумевано: `false`;
`deleteMissing` - `(boolean)` ако је постављено на `true`, шаблони контролних табли који нису присутни у увезеним подацима биће обрисани из базе података; подразумевано: `false`.| |triggers|object|Правила како увозити окидаче.

Подржани параметри:
`createMissing` - `(boolean)` ако је постављен на `true`, нови окидачи ће бити креирани; подразумевано: `false`;
`updateExisting` - `(boolean)` ако је постављено на `true`, постојећи окидачи ће бити ажурирани; подразумевано: `false`;
`deleteMissing` - `(boolean)` ако је постављено на `true`, окидачи који нису присутни у увезеним подацима биће обрисани из базе података; подразумевано: `false`.| |valueMaps|object|Правила како увозити вредносне мапе домаћина или шаблона.

Подржани параметри:
`createMissing` - `(boolean)` ако је постављено на `true`, нове вредносне мапе ће бити креиране ; подразумевано: `false`;
`updateExisting` - `(boolean)` ако је постављено на `true`, постојеће мапе ће бити ажуриране; подразумевано: `false`;
`deleteMissing` - `(boolean)` ако ј епостављено на `true`, вредносне мапе које нису присутне у увезеним подацима биће обрисане из базе података; подразумевано: `false`.| [comment]: # ({/8ad7aa47-0ae26f0f}) [comment]: # ({5ee9fb6b-43693d8e}) ### Повратне вредности `(array)` Враћа низ са променама у конфигурацији, које ће бити направљене. [comment]: # ({/5ee9fb6b-43693d8e}) [comment]: # ({b41637d2-b41637d2}) ### Примери [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({ee3ffa2c-d979e902}) #### Поређење увоза шаблона Упоредите шаблон садржан у XML стрингу са тренутним елементима система, и прикажите шта ће бити промењено ако се овај шаблон увезе. [Захтев](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "configuration.importcompare", "params": { "format": "xml", "rules": { "discoveryRules": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "graphs": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "host_groups": { "createMissing": true, "updateExisting": true }, "template_groups": { "createMissing": true, "updateExisting": true }, "httptests": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "templateLinkage": { "createMissing": true, "deleteMissing": true }, "templates": { "createMissing": true, "updateExisting": true }, "templateDashboards": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "triggers": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "valueMaps": { "createMissing": true, "updateExisting": true, "deleteMissing": true } }, "source": "\n7.4 7df96b18c230490a9a0a9e2307226338Templates\n" }, "id": 1 } ``` Одговор: ```json { "jsonrpc": "2.0", "result": { "templates": { "updated": [ { "before": { "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", "template": "New template", "name": "New template", "groups": [ { "name": "Templates" } ] }, "after": { "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", "template": "New template", "name": "New template", "groups": [ { "name": "Templates" } ] }, "items": { "added": [ { "after": { "uuid": "648006da5971424ead0c47ddbbf1ea2e", "name": "CPU utilization", "key": "system.cpu.util", "value_type": "FLOAT", "units": "%" }, "triggers": { "added": [ { "after": { "uuid": "736225012c534ec480c2a66a91322ce0", "expression": "avg(/New template/system.cpu.util,3m)>70", "name": "CPU utilization too high on 'New host' for 3 minutes", "priority": "WARNING" } } ] } } ], "removed": [ { "before": { "uuid": "6805d4c39a624a8bab2cc8ab63df1ab3", "name": "CPU load", "key": "system.cpu.load", "value_type": "FLOAT" }, "triggers": { "removed": [ { "before": { "uuid": "ab4c2526c2bc42e48a633082255ebcb3", "expression": "avg(/New template/system.cpu.load,3m)>2", "name": "CPU load too high on 'New host' for 3 minutes", "priority": "WARNING" } } ] } } ], "updated": [ { "before": { "uuid": "7f1e6f1e48aa4a128e5b6a958a5d11c3", "name": "Zabbix agent ping", "key": "agent.ping" }, "after": { "uuid": "7f1e6f1e48aa4a128e5b6a958a5d11c3", "name": "Zabbix agent ping", "key": "agent.ping", "delay": "3m" } } ] } } ] } }, "id": 1 } ``` [comment]: # ({/ee3ffa2c-d979e902}) [comment]: # ({f4cf61e8-c9a0185c}) ### Извор CConfiguration::importcompare() у *ui/include/classes/api/services/CConfiguration.php*. [comment]: # ({/f4cf61e8-c9a0185c})