1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
|
<?php
/*
** Zabbix
** Copyright (C) 2001-2019 Zabbix SIA
**
** This program is free software; you can redistribute it and/or modify
** it under the terms of the GNU General Public License as published by
** the Free Software Foundation; either version 2 of the License, or
** (at your option) any later version.
**
** This program is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
** GNU General Public License for more details.
**
** You should have received a copy of the GNU General Public License
** along with this program; if not, write to the Free Software
** Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
**/
class CScreenImporter extends CAbstractScreenImporter {
/**
* Import screens.
*
* @param array $screens
*
* @return mixed
*/
public function import(array $screens) {
$screens = zbx_toHash($screens, 'name');
$this->checkCircularScreenReferences($screens);
do {
$independentScreens = $this->getIndependentScreens($screens);
$screensToCreate = [];
$screensToUpdate = [];
foreach ($independentScreens as $name) {
$screen = $screens[$name];
unset($screens[$name]);
$screen = $this->resolveScreenReferences($screen);
if ($screenId = $this->referencer->resolveScreen($screen['name'])) {
$screen['screenid'] = $screenId;
$screensToUpdate[] = $screen;
}
else {
$screensToCreate[] = $screen;
}
}
if ($this->options['screens']['createMissing'] && $screensToCreate) {
$newScreenIds = API::Screen()->create($screensToCreate);
foreach ($screensToCreate as $num => $newScreen) {
$screenidId = $newScreenIds['screenids'][$num];
$this->referencer->addScreenRef($newScreen['name'], $screenidId);
}
}
if ($this->options['screens']['updateExisting'] && $screensToUpdate) {
API::Screen()->update($screensToUpdate);
}
} while (!empty($independentScreens));
// if there are screens left in $screens, then they have unresolved references
foreach ($screens as $screen) {
$unresolvedReferences = [];
foreach ($screen['screenitems'] as $screenItem) {
if ($screenItem['resourcetype'] == SCREEN_RESOURCE_SCREEN
&& !$this->referencer->resolveScreen($screenItem['resource']['name'])) {
$unresolvedReferences[] = $screenItem['resource']['name'];
}
}
$unresolvedReferences = array_unique($unresolvedReferences);
throw new Exception(_n('Cannot import screen "%1$s": subscreen "%2$s" does not exist.',
'Cannot import screen "%1$s": subscreens "%2$s" do not exist.',
$screen['name'], implode(', ', $unresolvedReferences), count($unresolvedReferences)));
}
}
/**
* Check if screens have circular references.
* Circular references can be only in screen items that represent another screen.
*
* @throws Exception
* @see checkCircularRecursive
*
* @param array $screens
*/
protected function checkCircularScreenReferences(array $screens) {
foreach ($screens as $screenName => $screen) {
if (empty($screen['screenitems'])) {
continue;
}
foreach ($screen['screenitems'] as $screenItem) {
$checked = [$screenName];
if ($circScreens = $this->checkCircularRecursive($screenItem, $screens, $checked)) {
throw new Exception(_s('Circular reference in screens: %1$s.', implode(' - ', $circScreens)));
}
}
}
}
/**
* Recursive function for searching for circular screen references.
* If circular reference exist it return array with screens names that fort it.
*
* @param array $screenItem screen to inspect on current recursive loop
* @param array $screens all screens where circular references should be searched
* @param array $checked screen names that already were processed,
* should contain unique values if no circular references exist
*
* @return array|bool
*/
protected function checkCircularRecursive(array $screenItem, array $screens, array $checked) {
// if element is not map element, recursive reference cannot happen
if ($screenItem['resourcetype'] != SCREEN_RESOURCE_SCREEN) {
return false;
}
$screenName = $screenItem['resource']['name'];
// if current screen name is already in list of checked screen names,
// circular reference exists
if (in_array($screenName, $checked)) {
// to have nice result containing only screens that have circular reference,
// remove everything that was added before repeated screen name
$checked = array_slice($checked, array_search($screenName, $checked));
// add repeated name to have nice loop like s1->s2->s3->s1
$checked[] = $screenName;
return $checked;
}
else {
$checked[] = $screenName;
}
// we need to find screen that current element reference to
// and if it has screen items check all them recursively
if (!empty($screens[$screenName]['screenitems'])) {
foreach ($screens[$screenName]['screenitems'] as $sItem) {
return $this->checkCircularRecursive($sItem, $screens, $checked);
}
}
return false;
}
/**
* Get screens that don't have screen items that reference not existing screen i.e. screen items references can be resolved.
* Returns array with screen names.
*
* @param array $screens
*
* @return array
*/
protected function getIndependentScreens(array $screens) {
foreach ($screens as $num => $screen) {
if (empty($screen['screenitems'])) {
continue;
}
foreach ($screen['screenitems'] as $screenItem) {
if ($screenItem['resourcetype'] == SCREEN_RESOURCE_SCREEN) {
if (!$this->referencer->resolveScreen($screenItem['resource']['name'])) {
unset($screens[$num]);
continue 2;
}
}
}
}
return zbx_objectValues($screens, 'name');
}
}
|
