dolibarr 19.0.3
establishment.class.php
Go to the documentation of this file.
1<?php
2/* Copyright (C) 2015 Alexandre Spangaro <aspangaro@open-dsi.fr>
3 * Copyright (C) 2018-2020 Frédéric France <frederic.france@netlogic.fr>
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 3 of the License, or
8 * (at your option) any later version.
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
14 *
15 * You should have received a copy of the GNU General Public License
16 * along with this program. If not, see <https://www.gnu.org/licenses/>.
17 */
18
25require_once DOL_DOCUMENT_ROOT.'/core/class/commonobject.class.php';
26
31{
35 public $element = 'establishment';
36
40 public $table_element = 'establishment';
41
45 public $table_element_line = '';
46
50 public $fk_element = 'fk_establishment';
51
56 public $ismultientitymanaged = 1;
57
61 public $picto = 'establishment';
62
66 public $id;
67
71 public $ref;
72
76 public $rowid;
77
81 public $label;
82
86 public $address;
87
91 public $zip;
92
96 public $town;
97
101 public $country_id;
102
106 public $status;
107
111 public $entity;
112
116 public $fk_user_mod;
117
121 public $fk_user_author;
122
126 public $datec;
127
128 const STATUS_OPEN = 1;
129 const STATUS_CLOSED = 0;
130
131
132 public $fields = array(
133 'rowid' =>array('type'=>'integer', 'label'=>'TechnicalID', 'enabled'=>1, 'visible'=>-1, 'notnull'=>1, 'position'=>10),
134 'entity' =>array('type'=>'integer', 'label'=>'Entity', 'default'=>1, 'enabled'=>1, 'visible'=>-2, 'notnull'=>1, 'position'=>15, 'index'=>1),
135 'ref' =>array('type'=>'varchar(30)', 'label'=>'Ref', 'enabled'=>1, 'visible'=>-1, 'notnull'=>1, 'showoncombobox'=>1, 'position'=>20),
136 'label' =>array('type'=>'varchar(128)', 'label'=>'Label', 'enabled'=>1, 'visible'=>-1, 'showoncombobox'=>2, 'position'=>22),
137 'address' =>array('type'=>'varchar(255)', 'label'=>'Address', 'enabled'=>1, 'visible'=>-1, 'position'=>25),
138 'zip' =>array('type'=>'varchar(25)', 'label'=>'Zip', 'enabled'=>1, 'visible'=>-1, 'position'=>30),
139 'town' =>array('type'=>'varchar(50)', 'label'=>'Town', 'enabled'=>1, 'visible'=>-1, 'position'=>35),
140 'fk_state' =>array('type'=>'integer', 'label'=>'Fkstate', 'enabled'=>1, 'visible'=>-1, 'position'=>40),
141 'fk_country' =>array('type'=>'integer', 'label'=>'Fkcountry', 'enabled'=>1, 'visible'=>-1, 'position'=>45),
142 'profid1' =>array('type'=>'varchar(20)', 'label'=>'Profid1', 'enabled'=>1, 'visible'=>-1, 'position'=>50),
143 'profid2' =>array('type'=>'varchar(20)', 'label'=>'Profid2', 'enabled'=>1, 'visible'=>-1, 'position'=>55),
144 'profid3' =>array('type'=>'varchar(20)', 'label'=>'Profid3', 'enabled'=>1, 'visible'=>-1, 'position'=>60),
145 'phone' =>array('type'=>'varchar(20)', 'label'=>'Phone', 'enabled'=>1, 'visible'=>-1, 'position'=>65),
146 'fk_user_author' =>array('type'=>'integer:User:user/class/user.class.php', 'label'=>'Fkuserauthor', 'enabled'=>1, 'visible'=>-1, 'notnull'=>1, 'position'=>70),
147 'fk_user_mod' =>array('type'=>'integer:User:user/class/user.class.php', 'label'=>'Fkusermod', 'enabled'=>1, 'visible'=>-1, 'position'=>75),
148 'datec' =>array('type'=>'datetime', 'label'=>'DateCreation', 'enabled'=>1, 'visible'=>-1, 'notnull'=>1, 'position'=>80),
149 'tms' =>array('type'=>'timestamp', 'label'=>'DateModification', 'enabled'=>1, 'visible'=>-1, 'notnull'=>1, 'position'=>85),
150 'status' =>array('type'=>'integer', 'label'=>'Status', 'enabled'=>1, 'visible'=>-1, 'position'=>500),
151 );
152
153
159 public function __construct($db)
160 {
161 $this->db = $db;
162 }
163
170 public function create($user)
171 {
172 global $conf, $langs;
173
174 $error = 0;
175 $now = dol_now();
176
177 // Clean parameters
178 $this->label = trim($this->label);
179 $this->address = trim($this->address);
180 $this->zip = trim($this->zip);
181 $this->town = trim($this->town);
182
183 if (empty($this->ref)) {
184 $this->ref = '(PROV)';
185 }
186
187 $this->db->begin();
188
189 $sql = "INSERT INTO ".MAIN_DB_PREFIX."establishment (";
190 $sql .= "ref";
191 $sql .= ", label";
192 $sql .= ", address";
193 $sql .= ", zip";
194 $sql .= ", town";
195 $sql .= ", fk_country";
196 $sql .= ", status";
197 $sql .= ", entity";
198 $sql .= ", datec";
199 $sql .= ", fk_user_author";
200 $sql .= ", fk_user_mod";
201 $sql .= ") VALUES (";
202 $sql .= "'".$this->db->escape($this->ref)."'";
203 $sql .= ", '".$this->db->escape($this->label)."'";
204 $sql .= ", '".$this->db->escape($this->address)."'";
205 $sql .= ", '".$this->db->escape($this->zip)."'";
206 $sql .= ", '".$this->db->escape($this->town)."'";
207 $sql .= ", ".((int) $this->country_id);
208 $sql .= ", ".((int) $this->status);
209 $sql .= ", ".((int) $conf->entity);
210 $sql .= ", '".$this->db->idate($now)."'";
211 $sql .= ", ".((int) $user->id);
212 $sql .= ", ".((int) $user->id);
213 $sql .= ")";
214
215 dol_syslog(get_class($this)."::create", LOG_DEBUG);
216 $resql = $this->db->query($sql);
217 if (!$resql) {
218 $error++;
219 $this->errors[] = "Error ".$this->db->lasterror();
220 }
221
222 // Commit or rollback
223 if ($error) {
224 foreach ($this->errors as $errmsg) {
225 dol_syslog(get_class($this)."::create ".$errmsg, LOG_ERR);
226 $this->error .= ($this->error ? ', '.$errmsg : $errmsg);
227 }
228 $this->db->rollback();
229 return -1 * $error;
230 } else {
231 $this->id = $this->db->last_insert_id(MAIN_DB_PREFIX.'establishment');
232
233 $sql = 'UPDATE '.MAIN_DB_PREFIX."establishment SET ref = '".$this->db->escape($this->id)."'";
234 $sql .= " WHERE rowid = ".((int) $this->id);
235 $this->db->query($sql);
236
237 $this->db->commit();
238 return $this->id;
239 }
240 }
241
248 public function update($user)
249 {
250 global $langs;
251
252 // Check parameters
253 if (empty($this->label)) {
254 $this->error = 'ErrorBadParameter';
255 return -1;
256 }
257
258 $this->db->begin();
259
260 $sql = "UPDATE ".MAIN_DB_PREFIX."establishment";
261 $sql .= " SET ref = '".$this->db->escape($this->ref)."'";
262 $sql .= ", label = '".$this->db->escape($this->label)."'";
263 $sql .= ", address = '".$this->db->escape($this->address)."'";
264 $sql .= ", zip = '".$this->db->escape($this->zip)."'";
265 $sql .= ", town = '".$this->db->escape($this->town)."'";
266 $sql .= ", fk_country = ".($this->country_id > 0 ? $this->country_id : 'null');
267 $sql .= ", status = ".((int) $this->status);
268 $sql .= ", fk_user_mod = ".((int) $user->id);
269 $sql .= ", entity = ".((int) $this->entity);
270 $sql .= " WHERE rowid = ".((int) $this->id);
271
272 dol_syslog(get_class($this)."::update", LOG_DEBUG);
273 $result = $this->db->query($sql);
274 if ($result) {
275 $this->db->commit();
276 return 1;
277 } else {
278 $this->error = $this->db->lasterror();
279 $this->db->rollback();
280 return -1;
281 }
282 }
283
290 public function fetch($id)
291 {
292 $sql = "SELECT e.rowid, e.ref, e.label, e.address, e.zip, e.town, e.status, e.fk_country as country_id, e.entity,";
293 $sql .= ' c.code as country_code, c.label as country';
294 $sql .= " FROM ".MAIN_DB_PREFIX."establishment as e";
295 $sql .= ' LEFT JOIN '.MAIN_DB_PREFIX.'c_country as c ON e.fk_country = c.rowid';
296 $sql .= " WHERE e.rowid = ".((int) $id);
297
298 dol_syslog(get_class($this)."::fetch", LOG_DEBUG);
299 $result = $this->db->query($sql);
300 if ($result) {
301 $obj = $this->db->fetch_object($result);
302 if ($obj) {
303 $this->id = $obj->rowid;
304 $this->ref = $obj->ref;
305 $this->label = $obj->label;
306 $this->address = $obj->address;
307 $this->zip = $obj->zip;
308 $this->town = $obj->town;
309 $this->status = $obj->status;
310 $this->entity = $obj->entity;
311
312 $this->country_id = $obj->country_id;
313 $this->country_code = $obj->country_code;
314 $this->country = $obj->country;
315
316 return 1;
317 } else {
318 return 0;
319 }
320 } else {
321 $this->error = $this->db->lasterror();
322 return -1;
323 }
324 }
325
332 public function delete($id)
333 {
334 $this->db->begin();
335
336 $sql = "DELETE FROM ".MAIN_DB_PREFIX."establishment WHERE rowid = ".((int) $id);
337
338 dol_syslog(get_class($this)."::delete", LOG_DEBUG);
339 $result = $this->db->query($sql);
340 if ($result) {
341 $this->db->commit();
342 return 1;
343 } else {
344 $this->error = $this->db->lasterror();
345 $this->db->rollback();
346 return -1;
347 }
348 }
349
356 public function getLibStatut($mode = 0)
357 {
358 return $this->LibStatut($this->status, $mode);
359 }
360
361 // phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
369 public function LibStatut($status, $mode = 0)
370 {
371 // phpcs:enable
372 if (empty($this->labelStatus) || empty($this->labelStatusShort)) {
373 global $langs;
374 //$langs->load("mymodule");
375 $this->labelStatus[self::STATUS_OPEN] = $langs->transnoentitiesnoconv('Open');
376 $this->labelStatus[self::STATUS_CLOSED] = $langs->transnoentitiesnoconv('Closed');
377 $this->labelStatusShort[self::STATUS_OPEN] = $langs->transnoentitiesnoconv('Open');
378 $this->labelStatusShort[self::STATUS_CLOSED] = $langs->transnoentitiesnoconv('Closed');
379 }
380
381 $statusType = 'status'.$status;
382 if ($status == self::STATUS_OPEN) {
383 $statusType = 'status4';
384 }
385 if ($status == self::STATUS_CLOSED) {
386 $statusType = 'status6';
387 }
388
389 return dolGetStatus($this->labelStatus[$status], $this->labelStatusShort[$status], '', $statusType, $mode);
390 }
391
392
399 public function info($id)
400 {
401 $sql = 'SELECT e.rowid, e.ref, e.datec, e.fk_user_author, e.tms as datem, e.fk_user_mod, e.entity';
402 $sql .= ' FROM '.MAIN_DB_PREFIX.'establishment as e';
403 $sql .= ' WHERE e.rowid = '.((int) $id);
404
405 dol_syslog(get_class($this)."::fetch info", LOG_DEBUG);
406 $result = $this->db->query($sql);
407
408 if ($result) {
409 if ($this->db->num_rows($result)) {
410 $obj = $this->db->fetch_object($result);
411
412 $this->id = $obj->rowid;
413
414 $this->user_creation_id = $obj->fk_user_author;
415 $this->user_modification_id = $obj->fk_user_mod;
416 $this->date_creation = $this->db->jdate($obj->datec);
417 $this->date_modification = empty($obj->datem) ? '' : $this->db->jdate($obj->datem);
418 }
419 $this->db->free($result);
420 } else {
421 dol_print_error($this->db);
422 }
423 }
424
435 public function getNomUrl($withpicto = 0, $option = '', $notooltip = 0, $morecss = '', $save_lastsearch_value = -1)
436 {
437 global $conf, $langs, $hookmanager;
438
439 if (!empty($conf->dol_no_mouse_hover)) {
440 $notooltip = 1; // Force disable tooltips
441 }
442
443 $result = '';
444
445 $label = img_picto('', $this->picto).' <u>'.$langs->trans("Establishment").'</u>';
446 if (isset($this->status)) {
447 $label .= ' '.$this->getLibStatut(5);
448 }
449 $label .= '<br>';
450 $label .= '<b>'.$langs->trans('Ref').':</b> '.$this->ref;
451
452 $label .= '<br>';
453 $label .= '<b>'.$langs->trans('Residence').':</b> '.$this->address.', '.$this->zip.' '.$this->town;
454
455 $url = DOL_URL_ROOT.'/hrm/establishment/card.php?id='.$this->id;
456
457 if ($option != 'nolink') {
458 // Add param to save lastsearch_values or not
459 $add_save_lastsearch_values = ($save_lastsearch_value == 1 ? 1 : 0);
460 if ($save_lastsearch_value == -1 && isset($_SERVER["PHP_SELF"]) && preg_match('/list\.php/', $_SERVER["PHP_SELF"])) {
461 $add_save_lastsearch_values = 1;
462 }
463 if ($add_save_lastsearch_values) {
464 $url .= '&save_lastsearch_values=1';
465 }
466 }
467
468 $linkclose = '';
469 if (empty($notooltip)) {
470 if (getDolGlobalString('MAIN_OPTIMIZEFORTEXTBROWSER')) {
471 $label = $langs->trans("Establishment");
472 $linkclose .= ' alt="'.dol_escape_htmltag($label, 1).'"';
473 }
474 $linkclose .= ' title="'.dol_escape_htmltag($label, 1).'"';
475 $linkclose .= ' class="classfortooltip'.($morecss ? ' '.$morecss : '').'"';
476 } else {
477 $linkclose = ($morecss ? ' class="'.$morecss.'"' : '');
478 }
479
480 if ($option == 'nolink') {
481 $linkstart = '<span';
482 } else {
483 $linkstart = '<a href="'.$url.'"';
484 }
485 $linkstart .= $linkclose.'>';
486 if ($option == 'nolink') {
487 $linkend = '</span>';
488 } else {
489 $linkend = '</a>';
490 }
491
492 $result .= $linkstart;
493
494 if ($withpicto) {
495 $result .= img_object(($notooltip ? '' : $label), ($this->picto ? $this->picto : 'generic'), ($notooltip ? (($withpicto != 2) ? 'class="paddingright"' : '') : 'class="'.(($withpicto != 2) ? 'paddingright ' : '').'classfortooltip"'), 0, 0, $notooltip ? 0 : 1);
496 }
497
498 if ($withpicto != 2) {
499 $result .= $this->label;
500 }
501
502 $result .= $linkend;
503 //if ($withpicto != 2) $result.=(($addlabel && $this->label) ? $sep . dol_trunc($this->label, ($addlabel > 1 ? $addlabel : 0)) : '');
504
505 global $action, $hookmanager;
506 $hookmanager->initHooks(array('establishmentdao'));
507 $parameters = array('id'=>$this->id, 'getnomurl' => &$result);
508 $reshook = $hookmanager->executeHooks('getNomUrl', $parameters, $this, $action); // Note that $action and $object may have been modified by some hooks
509 if ($reshook > 0) {
510 $result = $hookmanager->resPrint;
511 } else {
512 $result .= $hookmanager->resPrint;
513 }
514
515 return $result;
516 }
517
523 public function getCountryCode()
524 {
525 global $mysoc;
526
527 // We return country code of bank account
528 if (!empty($this->country_code)) {
529 return $this->country_code;
530 }
531
532 // We return country code of managed company
533 if (!empty($mysoc->country_code)) {
534 return $mysoc->country_code;
535 }
536
537 return '';
538 }
539
546 public function initAsSpecimen()
547 {
548 $this->id = 0;
549 $this->ref = '0';
550 $this->label = 'Department AAA';
551 }
552}
print $langs trans("AuditedSecurityEvents").'</strong >< span class="opacitymedium"></span >< br > status
Definition security.php:604
$object ref
Definition info.php:79
Parent class of all other business classes (invoices, contracts, proposals, orders,...
Class to manage establishments.
__construct($db)
Constructor.
getCountryCode()
Return account country code.
update($user)
Update record.
initAsSpecimen()
Initialise object with example values Id must be 0 if object instance is a specimen.
LibStatut($status, $mode=0)
Return the status.
getLibStatut($mode=0)
Give a label from a status.
getNomUrl($withpicto=0, $option='', $notooltip=0, $morecss='', $save_lastsearch_value=-1)
Return a link to the object card (with optionaly the picto)
fetch($id)
Load an object from database.
create($user)
Create object in database.
info($id)
Information on record.
dol_print_error($db='', $error='', $errors=null)
Displays error message system with all the information to facilitate the diagnosis and the escalation...
img_object($titlealt, $picto, $moreatt='', $pictoisfullpath=false, $srconly=0, $notitle=0)
Show a picto called object_picto (generic function)
dol_now($mode='auto')
Return date for now.
img_picto($titlealt, $picto, $moreatt='', $pictoisfullpath=false, $srconly=0, $notitle=0, $alt='', $morecss='', $marginleftonlyshort=2)
Show picto whatever it's its name (generic function)
getDolGlobalString($key, $default='')
Return dolibarr global constant string value.
dol_syslog($message, $level=LOG_INFO, $ident=0, $suffixinfilename='', $restricttologhandler='', $logcontext=null)
Write log message into outputs.