icingadb-web/application/forms/Command/Object/ScheduleServiceDowntimeForm.php
Alexander A. Klimov 3c8ed68cc6 Upgrade license from GPLv2 to GPLv2+
This was easy because only README.md and doc/01-About.md were redacted manually, everything else via:
git ls-files -z |xargs -0 perl -pi -e 's/Icinga GmbH \| GPLv2/Icinga GmbH | GPLv2+/'

This is legal because we have only merged PRs with label:cla/signed or made by Icinga staff:
https://github.com/Icinga/icingadb-web/pulls?page=1&q=is%3Apr+is%3Aclosed+-label%3Acla%2Fsigned+-author%3Anilmerg

This has no risk for us in people distributing their own version under GPLv3 only.
After all, we won't take their patches anyway, unless they sign our CLA.

This is the cleanest solution for having e.g. these in one address space:

* Icinga Web, GPLv2+
* K8s Web, AGPLv3
* Thirdparty, some LGPLv3 and Apache-2.0

Apropos, K8s Web is even v3-licensed on purpose, to have a stronger protection against cloud ops.
2025-11-21 13:31:24 +01:00

296 lines
11 KiB
PHP

<?php
/* Icinga DB Web | (c) 2021 Icinga GmbH | GPLv2+ */
namespace Icinga\Module\Icingadb\Forms\Command\Object;
use CallbackFilterIterator;
use DateInterval;
use DateTime;
use Icinga\Application\Config;
use Icinga\Module\Icingadb\Command\Object\ScheduleDowntimeCommand;
use Icinga\Module\Icingadb\Forms\Command\CommandForm;
use Icinga\Web\Notification;
use ipl\Html\Attributes;
use ipl\Html\HtmlElement;
use ipl\Html\Text;
use ipl\Orm\Model;
use ipl\Validator\CallbackValidator;
use ipl\Web\FormDecorator\IcingaFormDecorator;
use ipl\Web\Widget\Icon;
use Iterator;
use Traversable;
class ScheduleServiceDowntimeForm extends CommandForm
{
/** @var DateTime downtime start */
protected $start;
/** @var DateTime fixed downtime end */
protected $fixedEnd;
/**@var DateTime flexible downtime end */
protected $flexibleEnd;
/** @var DateInterval flexible downtime duration */
protected $flexibleDuration;
/** @var mixed Comment Text */
protected $commentText;
/**
* Initialize this form
*/
public function __construct()
{
$this->start = new DateTime();
$config = Config::module('icingadb');
$this->commentText = $config->get('settings', 'servicedowntime_comment_text');
$fixedEnd = clone $this->start;
$fixed = $config->get('settings', 'servicedowntime_end_fixed', 'PT1H');
$this->fixedEnd = $fixedEnd->add(new DateInterval($fixed));
$flexibleEnd = clone $this->start;
$flexible = $config->get('settings', 'servicedowntime_end_flexible', 'PT2H');
$this->flexibleEnd = $flexibleEnd->add(new DateInterval($flexible));
$flexibleDuration = $config->get('settings', 'servicedowntime_flexible_duration', 'PT2H');
$this->flexibleDuration = new DateInterval($flexibleDuration);
$this->on(self::ON_SUCCESS, function () {
if ($this->errorOccurred) {
return;
}
$countObjects = count($this->getObjects());
Notification::success(sprintf(
tp('Scheduled downtime successfully', 'Scheduled downtime for %d services successfully', $countObjects),
$countObjects
));
});
}
protected function assembleElements()
{
$isFlexible = $this->getPopulatedValue('flexible') === 'y';
$this->addHtml(new HtmlElement(
'div',
Attributes::create(['class' => 'form-description']),
new Icon('info-circle', ['class' => 'form-description-icon']),
new HtmlElement(
'ul',
null,
new HtmlElement(
'li',
null,
Text::create(t(
'This command is used to schedule host and service downtimes. During the downtime specified'
. ' by the start and end time, Icinga will not send notifications out about the hosts and'
. ' services. When the scheduled downtime expires, Icinga will send out notifications for'
. ' the hosts and services as it normally would.'
))
)
)
));
$decorator = new IcingaFormDecorator();
$this->addElement(
'textarea',
'comment',
[
'required' => true,
'label' => t('Comment'),
'description' => t(
'If you work with other administrators, you may find it useful to share information about'
. ' the host or service that is having problems. Make sure you enter a brief description of'
. ' what you are doing.'
),
'value' => $this->commentText
]
);
$decorator->decorate($this->getElement('comment'));
$this->addElement(
'localDateTime',
'start',
[
'data-use-datetime-picker' => true,
'required' => true,
'value' => $this->start,
'label' => t('Start Time'),
'description' => t('Set the start date and time for the downtime.')
]
);
$decorator->decorate($this->getElement('start'));
$this->addElement(
'localDateTime',
'end',
[
'data-use-datetime-picker' => true,
'required' => true,
'label' => t('End Time'),
'description' => t('Set the end date and time for the downtime.'),
'value' => $isFlexible ? $this->flexibleEnd : $this->fixedEnd,
'validators' => [
'DateTime' => ['break_chain_on_failure' => true],
'Callback' => function ($value, $validator) {
/** @var CallbackValidator $validator */
if ($value <= $this->getValue('start')) {
$validator->addMessage(t('The end time must be greater than the start time'));
return false;
}
if ($value <= (new DateTime())) {
$validator->addMessage(t('A downtime must not be in the past'));
return false;
}
return true;
}
]
]
);
$decorator->decorate($this->getElement('end'));
$this->addElement(
'checkbox',
'flexible',
[
'class' => 'autosubmit',
'label' => t('Flexible'),
'description' => t(
'To make this a flexible downtime, check this option. A flexible downtime starts when the host'
. ' or service enters a problem state sometime between the start and end times you specified.'
. ' It then lasts as long as the duration time you enter.'
)
]
);
$decorator->decorate($this->getElement('flexible'));
if ($isFlexible) {
$hoursInput = $this->createElement(
'number',
'hours',
[
'required' => true,
'label' => t('Duration'),
'value' => $this->flexibleDuration->h,
'min' => 0,
'validators' => [
'Callback' => function ($value, $validator) {
/** @var CallbackValidator $validator */
if ($this->getValue('minutes') == 0 && $value == 0) {
$validator->addMessage(t('The duration must not be zero'));
return false;
}
return true;
}
]
]
);
$this->registerElement($hoursInput);
$decorator->decorate($hoursInput);
$minutesInput = $this->createElement(
'number',
'minutes',
[
'required' => true,
'value' => $this->flexibleDuration->m,
'min' => 0
]
);
$this->registerElement($minutesInput);
$minutesInput->addWrapper(
new HtmlElement('label', null, new HtmlElement('span', null, Text::create(t('Minutes'))))
);
$hoursInput->getWrapper()->on(
IcingaFormDecorator::ON_ASSEMBLED,
function ($hoursInputWrapper) use ($minutesInput, $hoursInput) {
$hoursInputWrapper
->insertAfter($minutesInput, $hoursInput)
->getAttributes()->add('class', 'downtime-duration');
}
);
$hoursInput->prependWrapper(
new HtmlElement('label', null, new HtmlElement('span', null, Text::create(t('Hours'))))
);
$this->add($hoursInput);
}
$this->addElement(
'select',
'child_options',
array(
'description' => t('Schedule child downtimes.'),
'label' => t('Child Options'),
'options' => [
ScheduleDowntimeCommand::IGNORE_CHILDREN => t(
'Do nothing with children'
),
ScheduleDowntimeCommand::TRIGGER_CHILDREN => t(
'Schedule a downtime for all children and trigger them by this downtime'
),
ScheduleDowntimeCommand::SCHEDULE_CHILDREN => t(
'Schedule non-triggered downtime for all children'
)
]
)
);
$decorator->decorate($this->getElement('child_options'));
}
protected function assembleSubmitButton()
{
$this->addElement(
'submit',
'btn_submit',
[
'required' => true,
'label' => tp('Schedule downtime', 'Schedule downtimes', count($this->getObjects())),
'data-progress-label' => tp('Scheduling downtime', 'Scheduling downtimes', count($this->getObjects()))
]
);
(new IcingaFormDecorator())->decorate($this->getElement('btn_submit'));
}
protected function getCommands(Iterator $objects): Traversable
{
$granted = new CallbackFilterIterator($objects, function (Model $object): bool {
return $this->isGrantedOn('icingadb/command/downtime/schedule', $object);
});
$command = new ScheduleDowntimeCommand();
$command->setComment($this->getValue('comment'));
$command->setAuthor($this->getAuth()->getUser()->getUsername());
$command->setStart($this->getValue('start')->getTimestamp());
$command->setEnd($this->getValue('end')->getTimestamp());
$command->setChildOption((int) $this->getValue('child_options'));
if ($this->getElement('flexible')->isChecked()) {
$command->setFixed(false);
$command->setDuration(
$this->getValue('hours') * 3600 + $this->getValue('minutes') * 60
);
}
$granted->rewind(); // Forwards the pointer to the first element
if ($granted->valid()) {
// Chunk objects to avoid timeouts with large sets
yield $command->setObjects($granted)->setChunkSize(250);
}
}
}