setSaveType(ZBX_WIDGET_FIELD_TYPE_STR); $this->setValidationRules(['type' => API_OBJECTS, 'fields' => [ 'hosts' => ['type' => API_STRINGS_UTF8, 'flags' => API_REQUIRED], 'items' => ['type' => API_STRINGS_UTF8, 'flags' => API_REQUIRED], 'color' => ['type' => API_COLOR], 'type' => ['type' => API_INT32, 'in' => implode(',', [SVG_GRAPH_TYPE_LINE, SVG_GRAPH_TYPE_POINTS, SVG_GRAPH_TYPE_STAIRCASE])], 'width' => ['type' => API_INT32, 'in' => implode(',', range(0, 10))], 'pointsize' => ['type' => API_INT32, 'in' => implode(',', range(1, 10))], 'transparency' => ['type' => API_INT32, 'in' => implode(',', range(0, 10))], 'fill' => ['type' => API_INT32, 'in' => implode(',', range(0, 10))], 'missingdatafunc' => ['type' => API_INT32, 'in' => implode(',', [SVG_GRAPH_MISSING_DATA_NONE, SVG_GRAPH_MISSING_DATA_CONNECTED, SVG_GRAPH_MISSING_DATA_TREAT_AS_ZERO])], 'axisy' => ['type' => API_INT32, 'in' => implode(',', [GRAPH_YAXIS_SIDE_LEFT, GRAPH_YAXIS_SIDE_RIGHT])], 'timeshift' => ['type' => API_TIME_UNIT, 'in' => implode(':', [ZBX_MIN_TIMESHIFT, ZBX_MAX_TIMESHIFT])] ]]); $this->setDefault([]); } /** * Set additional flags, which can be used in configuration form. * * @param int $flags * * @return $this */ public function setFlags($flags) { parent::setFlags($flags); if ($flags & self::FLAG_NOT_EMPTY) { $strict_validation_rules = $this->getValidationRules(); self::setValidationRuleFlag($strict_validation_rules['fields']['hosts'], API_NOT_EMPTY); self::setValidationRuleFlag($strict_validation_rules['fields']['items'], API_NOT_EMPTY); self::setValidationRuleFlag($strict_validation_rules['fields']['color'], API_NOT_EMPTY); self::setValidationRuleFlag($strict_validation_rules['fields']['timeshift'], API_NOT_EMPTY); $this->setStrictValidationRules($strict_validation_rules); } else { $this->setStrictValidationRules(null); } return $this; } public function setValue($value) { foreach ($value as &$val) { // Values received from frontend are strings. Values received from database comes as arrays. // TODO: remove hack with modifying of unvalidated data. if (array_key_exists('hosts', $val)) { $val['hosts'] = CWidgetHelper::splitPatternIntoParts($val['hosts']); } if (array_key_exists('items', $val)) { $val['items'] = CWidgetHelper::splitPatternIntoParts($val['items']); } } unset($val); $this->value = $value; return $this; } /** * Default values filled in newly created data set or used as unspecified values. * * @return array */ public static function getDefaults() { return [ 'hosts' => [], 'items' => [] ]; } /** * Returns array of supported override options. * * @return array */ public static function getOverrideOptions() { return ['color', 'width', 'type', 'transparency', 'fill', 'pointsize', 'missingdatafunc', 'axisy', 'timeshift']; } /** * Function makes field specific validation for values set using self::setValue(). * * @param bool $strict Either to make a strict validation. * * @return array $errors List of errors found during validation. */ public function validate($strict = false) { $errors = parent::validate($strict); $value = $this->getValue(); $label = ($this->label === null) ? $this->name : $this->label; // Validate options. if (!$errors && $strict) { foreach ($value as $index => $overrides) { if (!array_intersect(self::getOverrideOptions(), array_keys($overrides))) { $errors[] = _s('Invalid parameter "%1$s": %2$s.', $label.'/'.($index + 1), _('at least one override option must be specified') ); break; } } } return $errors; } /** * Prepares array entry for widget field, ready to be passed to CDashboard API functions. * Reference is needed here to avoid array merging in CWidgetForm::fieldsToApi method. With large number of widget * fields it causes significant performance decrease. * * @param array $widget_fields reference to Array of widget fields. */ public function toApi(array &$widget_fields = []) { $value = $this->getValue(); foreach ($value as $index => $val) { // Hosts and items fields are stored as arrays to bypass length limit. foreach ($val['hosts'] as $num => $pattern_item) { $widget_fields[] = [ 'type' => ZBX_WIDGET_FIELD_TYPE_STR, 'name' => $this->name.'.hosts.'.$index.'.'.$num, 'value' => $pattern_item ]; } foreach ($val['items'] as $num => $pattern_item) { $widget_fields[] = [ 'type' => ZBX_WIDGET_FIELD_TYPE_STR, 'name' => $this->name.'.items.'.$index.'.'.$num, 'value' => $pattern_item ]; } foreach (self::getOverrideOptions() as $opt) { if (array_key_exists($opt, $val)) { $widget_fields[] = [ 'type' => ($opt === 'color' || $opt === 'timeshift') ? ZBX_WIDGET_FIELD_TYPE_STR : ZBX_WIDGET_FIELD_TYPE_INT32, 'name' => $this->name.'.'.$opt.'.'.$index, 'value' => $val[$opt] ]; } } } } }