* Copyright (C) 2005-2009 Regis Houssin * Copyright (C) 2020 Gauthier VERDOL * Copyright (C) 2024 Frédéric France * Copyright (C) 2024 MDW * * 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 . * or see https://www.gnu.org/ */ /** * \file htdocs/core/modules/workstation/mod_workstation_standard.php * \ingroup workstation * \brief File of class to manage Workstation numbering rules standard */ require_once DOL_DOCUMENT_ROOT . '/core/modules/workstation/modules_workstation.php'; /** * Class to manage the Standard numbering rule for Workstation */ class mod_workstation_standard extends ModeleNumRefWorkstation { /** * Dolibarr version of the loaded document * @var string Version, possible values are: 'development', 'experimental', 'dolibarr', 'dolibarr_deprecated' or a version string like 'x.y.z'''|'development'|'dolibarr'|'experimental' */ public $version = 'dolibarr'; // 'development', 'experimental', 'dolibarr' public $prefix = 'WKSTATION'; /** * @var string Error code (or message) */ public $error = ''; /** * @var string name */ public $name = 'standard'; /** * Return description of numbering module * * @param Translate $langs Lang object to use for output * @return string Descriptive text */ public function info($langs) { global $langs; return $langs->trans("SimpleNumRefNoDateModelDesc", $this->prefix); } /** * Return an example of numbering * * @return string Example */ public function getExample() { return $this->prefix."-0001"; } /** * Checks if the numbers already in the database do not * cause conflicts that would prevent this numbering working. * * @param CommonObject $object Object we need next value for * @return boolean false if conflict, true if ok */ public function canBeActivated($object) { global $conf, $db; $max = ''; $posindice = strlen($this->prefix) + 2; $sql = "SELECT MAX(CAST(SUBSTRING(ref FROM ".$posindice.") AS SIGNED)) as max"; $sql .= " FROM ".MAIN_DB_PREFIX."workstation_workstation"; $sql .= " WHERE ref LIKE '".$db->escape($this->prefix)."-%'"; if ($object->ismultientitymanaged == 1) { $sql .= " AND entity = ".$conf->entity; } elseif ($object->ismultientitymanaged == 2) { // TODO } $resql = $db->query($sql); if ($resql) { $row = $db->fetch_row($resql); if ($row) { $max = $row[0]; } } /*if ($coyymm && !preg_match('/'.$this->prefix.'[0-9][0-9][0-9][0-9]/i', $coyymm)) { $langs->load("errors"); $this->error = $langs->trans('ErrorNumRefModel', $max); return false; }*/ return true; } /** * Return next free value * * @param Workstation $object Object we need next value for * @return string|int<-1,0> Next value if OK, <=0 if KO */ public function getNextValue($object) { global $db; // First we get the max value $posindice = strlen($this->prefix) + 2; $sql = "SELECT MAX(CAST(SUBSTRING(ref FROM ".$posindice.") AS SIGNED)) as max"; $sql .= " FROM ".MAIN_DB_PREFIX."workstation_workstation"; $sql .= " WHERE ref LIKE '".$db->escape($this->prefix)."-%'"; //$sql .= " AND entity = ".$conf->entity; $resql = $db->query($sql); if ($resql) { $obj = $db->fetch_object($resql); if ($obj) { $max = intval($obj->max); } else { $max = 0; } } else { dol_syslog("mod_workstation_standard::getNextValue", LOG_DEBUG); return -1; } if ($max >= (pow(10, 4) - 1)) { $num = $max + 1; // If counter > 9999, we do not format on 4 chars, we take number as it is } else { $num = sprintf("%04d", $max + 1); } dol_syslog("mod_workstation_standard::getNextValue return ".$this->prefix."-".$num); return $this->prefix."-".$num; } }