|
Linux server.jmdstrack.com 3.10.0-1160.119.1.el7.tuxcare.els10.x86_64 #1 SMP Fri Oct 11 21:40:41 UTC 2024 x86_64
/ home/ jmdstrac/ public_html/ devices/ src/ |
|
|
<?php
/**
* ---------------------------------------------------------------------
*
* GLPI - Gestionnaire Libre de Parc Informatique
*
* http://glpi-project.org
*
* @copyright 2015-2023 Teclib' and contributors.
* @copyright 2003-2014 by the INDEPNET Development Team.
* @licence https://www.gnu.org/licenses/gpl-3.0.html
*
* ---------------------------------------------------------------------
*
* LICENSE
*
* This file is part of GLPI.
*
* 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 3 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, see <https://www.gnu.org/licenses/>.
*
* ---------------------------------------------------------------------
*/
/**
* Alert class
**/
class Alert extends CommonDBTM
{
// ALERTS TYPE
const THRESHOLD = 1;
const END = 2;
const NOTICE = 3;
const NOTCLOSED = 4;
const ACTION = 5;
const PERIODICITY = 6;
public function prepareInputForAdd($input)
{
if (!isset($input['date']) || empty($input['date'])) {
$input['date'] = $_SESSION['glpi_currenttime'];
}
return $input;
}
/**
* Clear all alerts of an alert type for an item
*
* @param string $itemtype ID of the type to clear
* @param string $ID ID of the item to clear
* @param integer $alert_type ID of the alert type to clear
*
* @return boolean
*/
public function clear($itemtype, $ID, $alert_type)
{
return $this->deleteByCriteria(['itemtype' => $itemtype, 'items_id' => $ID, 'type' => $alert_type], 1);
}
/**
* Clear all alerts for an item
*
* @since 0.84
*
* @param string $itemtype ID of the type to clear
* @param integer $ID ID of the item to clear
*
* @return boolean
*/
public function cleanDBonItemDelete($itemtype, $ID)
{
return $this->deleteByCriteria(['itemtype' => $itemtype, 'items_id' => $ID], 1);
}
public static function dropdown($options = [])
{
$p = [
'name' => 'alert',
'value' => 0,
'display' => true,
'inherit_parent' => false,
];
if (count($options)) {
foreach ($options as $key => $val) {
$p[$key] = $val;
}
}
$times = [];
if ($p['inherit_parent']) {
$times[Entity::CONFIG_PARENT] = __('Inheritance of the parent entity');
}
$times[Entity::CONFIG_NEVER] = __('Never');
$times[DAY_TIMESTAMP] = __('Each day');
$times[WEEK_TIMESTAMP] = __('Each week');
$times[MONTH_TIMESTAMP] = __('Each month');
return Dropdown::showFromArray($p['name'], $times, $p);
}
/**
* Builds a Yes/No dropdown
*
* @param array $options Display options
*
* @return void|string (see $options['display'])
*/
public static function dropdownYesNo($options = [])
{
$p = [
'name' => 'alert',
'value' => 0,
'display' => true,
'inherit_parent' => false,
];
if (count($options)) {
foreach ($options as $key => $val) {
$p[$key] = $val;
}
}
$times = [];
if ($p['inherit_parent']) {
$times[Entity::CONFIG_PARENT] = __('Inheritance of the parent entity');
}
$times[0] = __('No');
$times[1] = __('Yes');
return Dropdown::showFromArray($p['name'], $times, $p);
}
/**
* ?
*
* @param string $name Dropdown name
* @param string $value Dropdown selected value
* @param array $options Display options
*
* @return void|string (see $options['display'])
*/
public static function dropdownIntegerNever($name, $value, $options = [])
{
$p = [
'min' => 1,
'max' => 100,
'step' => 1,
'toadd' => [],
'display' => true,
];
if (isset($options['inherit_parent']) && $options['inherit_parent']) {
$p['toadd'][-2] = __('Inheritance of the parent entity');
}
$never_string = __('Never');
if (isset($options['never_string']) && $options['never_string']) {
$never_string = $options['never_string'];
}
if (isset($options['never_value']) && $options['never_value']) {
$p['toadd'][$options['never_value']] = $never_string;
} else {
$p['toadd'][0] = $never_string;
}
$p['value'] = $value;
foreach ($options as $key => $val) {
$p[$key] = $val;
}
return Dropdown::showNumber($name, $p);
}
/**
* Does alert exists
*
* @since 9.5.0 Made all params required. Dropped invalid defaults.
* @param string $itemtype The item type
* @param integer $items_id The item's ID
* @param integer $type The type of alert (see constants in {@link \Alert} class)
*
* @return integer|boolean
*/
public static function alertExists($itemtype, $items_id, $type)
{
global $DB;
if ($items_id <= 0 || $type <= 0) {
return false;
}
$iter = $DB->request(self::getTable(), ['itemtype' => $itemtype, 'items_id' => $items_id, 'type' => $type]);
if ($row = $iter->current()) {
return $row['id'];
}
return false;
}
/**
* Get date of alert
*
* @since 0.84
* @since 9.5.0 Made all params required. Dropped invalid defaults.
*
* @param string $itemtype The item type
* @param integer $items_id The item's ID
* @param integer $type The type of alert (see constants in {@link \Alert} class)
*
* @return mixed|boolean
*/
public static function getAlertDate($itemtype, $items_id, $type)
{
global $DB;
if ($items_id <= 0 || $type <= 0) {
return false;
}
$iter = $DB->request(self::getTable(), ['itemtype' => $itemtype, 'items_id' => $items_id, 'type' => $type]);
if ($row = $iter->current()) {
return $row['date'];
}
return false;
}
/**
* Display last alert
*
* @param string $itemtype The item type
* @param integer $items_id The item's ID
*
* @return void
*/
public static function displayLastAlert($itemtype, $items_id)
{
global $DB;
if ($items_id) {
$iter = $DB->request(self::getTable(), ['FIELDS' => 'date',
'ORDER' => 'date DESC',
'LIMIT' => 1,
'itemtype' => $itemtype,
'items_id' => $items_id
]);
if ($row = $iter->current()) {
//TRANS: %s is the date
echo sprintf(__('Alert sent on %s'), Html::convDateTime($row['date']));
}
}
}
}