2019-02-26 19:27:04 +01:00
< ? php
2023-02-06 18:02:28 +01:00
/* Copyright ( C ) 2019 Laurent Destailleur < eldy @ users . sourceforge . net >
* Copyright ( C ) 2023 Benjamin Falière < benjamin . faliere @ altairis . fr >
2019-02-26 19:27:04 +01:00
*
* 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
2019-09-23 21:55:30 +02:00
* along with this program . If not , see < https :// www . gnu . org / licenses />.
2019-02-26 19:27:04 +01:00
*/
/**
2019-05-19 13:01:11 +02:00
* \file bom / class / bom . class . php
2019-02-26 19:27:04 +01:00
* \ingroup bom
2019-03-04 13:30:43 +01:00
* \brief This file is a CRUD class file for BOM ( Create / Read / Update / Delete )
2019-02-26 19:27:04 +01:00
*/
// Put here all includes required by your class file
2019-11-11 23:59:36 +01:00
require_once DOL_DOCUMENT_ROOT . '/core/class/commonobject.class.php' ;
2019-02-26 19:27:04 +01:00
//require_once DOL_DOCUMENT_ROOT . '/societe/class/societe.class.php';
//require_once DOL_DOCUMENT_ROOT . '/product/class/product.class.php';
2021-06-24 09:54:30 +02:00
2019-02-26 19:27:04 +01:00
/**
2019-03-04 13:30:43 +01:00
* Class for BOM
2019-02-26 19:27:04 +01:00
*/
2019-03-04 13:30:43 +01:00
class BOM extends CommonObject
2019-02-26 19:27:04 +01:00
{
/**
* @ var string ID to identify managed object
*/
public $element = 'bom' ;
/**
* @ var string Name of table without prefix where object is stored
*/
public $table_element = 'bom_bom' ;
/**
* @ var int Does bom support multicompany module ? 0 = No test on entity , 1 = Test with field entity , 2 = Test with link by societe
*/
2019-03-04 14:01:30 +01:00
public $ismultientitymanaged = 1 ;
2019-02-26 19:27:04 +01:00
/**
2020-01-25 22:43:56 +01:00
* @ var int Does object support extrafields ? 0 = No , 1 = Yes
2019-02-26 19:27:04 +01:00
*/
public $isextrafieldmanaged = 1 ;
/**
* @ var string String with name of icon for bom . Must be the part after the 'object_' into object_bom . png
*/
2019-03-04 12:46:07 +01:00
public $picto = 'bom' ;
2019-02-26 19:27:04 +01:00
2019-03-12 19:20:01 +01:00
const STATUS_DRAFT = 0 ;
const STATUS_VALIDATED = 1 ;
2019-05-22 19:34:08 +02:00
const STATUS_CANCELED = 9 ;
2019-03-12 19:20:01 +01:00
2019-02-26 19:27:04 +01:00
/**
2021-03-15 14:16:55 +01:00
* 'type' field format ( 'integer' , 'integer:ObjectClass:PathToClass[:AddCreateButtonOrNot[:Filter]]' , 'sellist:TableName:LabelFieldName[:KeyFieldName[:KeyFieldParent[:Filter]]]' , 'varchar(x)' , 'double(24,8)' , 'real' , 'price' , 'text' , 'text:none' , 'html' , 'date' , 'datetime' , 'timestamp' , 'duration' , 'mail' , 'phone' , 'url' , 'password' )
2020-01-09 22:42:31 +01:00
* Note : Filter can be a string like " (t.ref:like:'SO-%') or (t.date_creation:<:'20160101') or (t.nature:is:NULL) "
2019-02-26 19:27:04 +01:00
* 'label' the translation key .
2021-03-15 14:16:55 +01:00
* 'picto' is code of a picto to show before value in forms
* 'enabled' is a condition when the field must be managed ( Example : 1 or ' $conf -> global -> MY_SETUP_PARAM )
* 'position' is the sort order of field .
* 'notnull' is set to 1 if not null in database . Set to - 1 if we must set data to null if empty ( '' or 0 ) .
2020-01-09 22:42:31 +01:00
* 'visible' says if field is visible in list ( Examples : 0 = Not visible , 1 = Visible on list and create / update / view forms , 2 = Visible on list only , 3 = Visible on create / update / view form only ( not list ), 4 = Visible on list and update / view form only ( not create ) . 5 = Visible on list and view only ( not create / not update ) . Using a negative value means field is not shown by default on list but can be selected for viewing )
2019-03-17 01:45:46 +01:00
* 'noteditable' says if field is not editable ( 1 or 0 )
2021-03-15 14:16:55 +01:00
* 'default' is a default value for creation ( can still be overwrote by the Setup of Default Values if field is editable in creation form ) . Note : If default is set to '(PROV)' and field is 'ref' , the default value will be set to '(PROVid)' where id is rowid when a new record is created .
2019-02-26 19:27:04 +01:00
* 'index' if we want an index in database .
* 'foreignkey' => 'tablename.field' if the field is a foreign key ( it is recommanded to name the field fk_ ... ) .
* 'searchall' is 1 if we want to search in this field when making a search from the quick search button .
* 'isameasure' must be set to 1 if you want to have a total on list for this field . Field type must be summable like integer or double ( 24 , 8 ) .
2022-03-24 13:31:03 +01:00
* 'css' and 'cssview' and 'csslist' is the CSS style to use on field . 'css' is used in creation and update . 'cssview' is used in view mode . 'csslist' is used for columns in lists . For example : 'css' => 'minwidth300 maxwidth500 widthcentpercentminusx' , 'cssview' => 'wordbreak' , 'csslist' => 'tdoverflowmax200'
2021-03-15 14:16:55 +01:00
* 'help' is a 'TranslationString' to use to show a tooltip on field . You can also use 'TranslationString:keyfortooltiponlick' for a tooltip on click .
2019-02-26 19:27:04 +01:00
* 'showoncombobox' if value of the field must be visible into the label of the combobox that list record
2021-03-15 14:16:55 +01:00
* 'disabled' is 1 if we want to have the field locked by a 'disabled' attribute . In most cases , this is never set into the definition of $fields into class , but is set dynamically by some part of code .
2021-04-29 12:10:55 +02:00
* 'arrayofkeyval' to set list of value if type is a list of predefined values . For example : array ( " 0 " => " Draft " , " 1 " => " Active " , " -1 " => " Cancel " )
2021-03-15 14:16:55 +01:00
* 'autofocusoncreate' to have field having the focus on a create form . Only 1 field should have this property set to 1.
* 'comment' is not used . You can store here any text of your choice . It is not used by application .
*
* Note : To have value dynamic , you can set value to 0 in definition and edit the value on the fly into the constructor .
2019-02-26 19:27:04 +01:00
*/
// BEGIN MODULEBUILDER PROPERTIES
/**
* @ var array Array with all fields and their property . Do not use it as a static var . It may be modified by constructor .
*/
2019-11-11 23:59:36 +01:00
public $fields = array (
2021-08-24 16:12:04 +02:00
'rowid' => array ( 'type' => 'integer' , 'label' => 'TechnicalID' , 'enabled' => 1 , 'visible' =>- 2 , 'position' => 1 , 'notnull' => 1 , 'index' => 1 , 'comment' => " Id " ,),
2019-11-11 23:59:36 +01:00
'entity' => array ( 'type' => 'integer' , 'label' => 'Entity' , 'enabled' => 1 , 'visible' => 0 , 'notnull' => 1 , 'default' => 1 , 'index' => 1 , 'position' => 5 ),
2022-07-28 18:06:37 +02:00
'ref' => array ( 'type' => 'varchar(128)' , 'label' => 'Ref' , 'enabled' => 1 , 'noteditable' => 1 , 'visible' => 4 , 'position' => 10 , 'notnull' => 1 , 'default' => '(PROV)' , 'index' => 1 , 'searchall' => 1 , 'comment' => " Reference of BOM " , 'showoncombobox' => '1' , 'csslist' => 'nowraponall' ),
2022-03-24 13:31:03 +01:00
'label' => array ( 'type' => 'varchar(255)' , 'label' => 'Label' , 'enabled' => 1 , 'visible' => 1 , 'position' => 30 , 'notnull' => 1 , 'searchall' => 1 , 'showoncombobox' => '2' , 'autofocusoncreate' => 1 , 'css' => 'minwidth300 maxwidth400' , 'csslist' => 'tdoverflowmax200' ),
2021-09-19 21:06:09 +02:00
'bomtype' => array ( 'type' => 'integer' , 'label' => 'Type' , 'enabled' => 1 , 'visible' => 1 , 'position' => 33 , 'notnull' => 1 , 'default' => '0' , 'arrayofkeyval' => array ( 0 => 'Manufacturing' , 1 => 'Disassemble' ), 'css' => 'minwidth175' , 'csslist' => 'minwidth175 center' ),
2021-03-05 09:47:38 +01:00
//'bomtype' => array('type'=>'integer', 'label'=>'Type', 'enabled'=>1, 'visible'=>-1, 'position'=>32, 'notnull'=>1, 'default'=>'0', 'arrayofkeyval'=>array(0=>'Manufacturing')),
2021-07-04 20:08:34 +02:00
'fk_product' => array ( 'type' => 'integer:Product:product/class/product.class.php:1:(finished IS NULL or finished <> 0)' , 'label' => 'Product' , 'picto' => 'product' , 'enabled' => 1 , 'visible' => 1 , 'position' => 35 , 'notnull' => 1 , 'index' => 1 , 'help' => 'ProductBOMHelp' , 'css' => 'maxwidth500' , 'csslist' => 'tdoverflowmax100' ),
2020-11-13 10:26:16 +01:00
'description' => array ( 'type' => 'text' , 'label' => 'Description' , 'enabled' => 1 , 'visible' =>- 1 , 'position' => 60 , 'notnull' =>- 1 ,),
2020-10-31 14:32:18 +01:00
'qty' => array ( 'type' => 'real' , 'label' => 'Quantity' , 'enabled' => 1 , 'visible' => 1 , 'default' => 1 , 'position' => 55 , 'notnull' => 1 , 'isameasure' => '1' , 'css' => 'maxwidth75imp' ),
2020-02-28 16:12:42 +01:00
//'efficiency' => array('type'=>'real', 'label'=>'ManufacturingEfficiency', 'enabled'=>1, 'visible'=>-1, 'default'=>1, 'position'=>100, 'notnull'=>0, 'css'=>'maxwidth50imp', 'help'=>'ValueOfMeansLossForProductProduced'),
2019-11-17 17:36:36 +01:00
'duration' => array ( 'type' => 'duration' , 'label' => 'EstimatedDuration' , 'enabled' => 1 , 'visible' =>- 1 , 'position' => 101 , 'notnull' =>- 1 , 'css' => 'maxwidth50imp' , 'help' => 'EstimatedDurationDesc' ),
2021-07-04 20:08:34 +02:00
'fk_warehouse' => array ( 'type' => 'integer:Entrepot:product/stock/class/entrepot.class.php:0' , 'label' => 'WarehouseForProduction' , 'picto' => 'stock' , 'enabled' => 1 , 'visible' =>- 1 , 'position' => 102 , 'css' => 'maxwidth500' , 'csslist' => 'tdoverflowmax100' ),
2019-10-16 18:37:26 +02:00
'note_public' => array ( 'type' => 'html' , 'label' => 'NotePublic' , 'enabled' => 1 , 'visible' =>- 2 , 'position' => 161 , 'notnull' =>- 1 ,),
'note_private' => array ( 'type' => 'html' , 'label' => 'NotePrivate' , 'enabled' => 1 , 'visible' =>- 2 , 'position' => 162 , 'notnull' =>- 1 ,),
2019-05-25 19:29:33 +02:00
'date_creation' => array ( 'type' => 'datetime' , 'label' => 'DateCreation' , 'enabled' => 1 , 'visible' =>- 2 , 'position' => 300 , 'notnull' => 1 ,),
'tms' => array ( 'type' => 'timestamp' , 'label' => 'DateModification' , 'enabled' => 1 , 'visible' =>- 2 , 'position' => 501 , 'notnull' => 1 ,),
'date_valid' => array ( 'type' => 'datetime' , 'label' => 'DateValidation' , 'enabled' => 1 , 'visible' =>- 2 , 'position' => 502 , 'notnull' => 0 ,),
2021-07-04 20:08:34 +02:00
'fk_user_creat' => array ( 'type' => 'integer:User:user/class/user.class.php' , 'label' => 'UserCreation' , 'picto' => 'user' , 'enabled' => 1 , 'visible' =>- 2 , 'position' => 510 , 'notnull' => 1 , 'foreignkey' => 'user.rowid' , 'csslist' => 'tdoverflowmax100' ),
'fk_user_modif' => array ( 'type' => 'integer:User:user/class/user.class.php' , 'label' => 'UserModif' , 'picto' => 'user' , 'enabled' => 1 , 'visible' =>- 2 , 'position' => 511 , 'notnull' =>- 1 , 'csslist' => 'tdoverflowmax100' ),
'fk_user_valid' => array ( 'type' => 'integer:User:user/class/user.class.php' , 'label' => 'UserValidation' , 'picto' => 'user' , 'enabled' => 1 , 'visible' =>- 2 , 'position' => 512 , 'notnull' => 0 , 'csslist' => 'tdoverflowmax100' ),
2019-11-05 20:20:57 +01:00
'import_key' => array ( 'type' => 'varchar(14)' , 'label' => 'ImportId' , 'enabled' => 1 , 'visible' =>- 2 , 'position' => 1000 , 'notnull' =>- 1 ,),
'model_pdf' => array ( 'type' => 'varchar(255)' , 'label' => 'Model pdf' , 'enabled' => 1 , 'visible' => 0 , 'position' => 1010 ),
2019-06-03 19:29:49 +02:00
'status' => array ( 'type' => 'integer' , 'label' => 'Status' , 'enabled' => 1 , 'visible' => 2 , 'position' => 1000 , 'notnull' => 1 , 'default' => 0 , 'index' => 1 , 'arrayofkeyval' => array ( 0 => 'Draft' , 1 => 'Enabled' , 9 => 'Disabled' )),
2019-02-26 19:27:04 +01:00
);
2020-11-24 21:28:57 +01:00
/**
* @ var int rowid
*/
2019-02-26 19:27:04 +01:00
public $rowid ;
2020-11-24 21:28:57 +01:00
/**
* @ var string ref
*/
2019-02-26 19:27:04 +01:00
public $ref ;
2020-11-24 21:28:57 +01:00
/**
* @ var string label
*/
2019-02-26 19:27:04 +01:00
public $label ;
2020-11-24 21:28:57 +01:00
/**
* @ var int bomtype
*/
2020-11-13 10:26:16 +01:00
public $bomtype ;
2020-11-24 21:28:57 +01:00
/**
* @ var string description
*/
2019-02-26 19:27:04 +01:00
public $description ;
2019-11-01 10:44:29 +01:00
2019-11-01 10:38:58 +01:00
/**
2020-10-31 14:32:18 +01:00
* @ var integer | string date_creation
*/
2019-02-26 19:27:04 +01:00
public $date_creation ;
2019-11-01 10:44:29 +01:00
2019-02-26 19:27:04 +01:00
public $tms ;
2020-11-24 21:28:57 +01:00
/**
* @ var int Id User creator
*/
2019-02-26 19:27:04 +01:00
public $fk_user_creat ;
2020-11-24 21:28:57 +01:00
/**
* @ var int Id User modifying
*/
2019-02-26 19:27:04 +01:00
public $fk_user_modif ;
2020-11-24 21:28:57 +01:00
/**
* @ var string import key
*/
2019-02-26 19:27:04 +01:00
public $import_key ;
2020-11-24 21:28:57 +01:00
/**
* @ var int status
*/
2019-02-26 19:27:04 +01:00
public $status ;
2020-11-24 21:28:57 +01:00
/**
* @ var int product Id
*/
2019-02-26 19:27:04 +01:00
public $fk_product ;
public $qty ;
2019-05-25 19:29:33 +02:00
public $efficiency ;
2019-02-26 19:27:04 +01:00
// END MODULEBUILDER PROPERTIES
// If this object has a subtable with lines
/**
* @ var int Name of subtable line
*/
2019-06-22 20:17:40 +02:00
public $table_element_line = 'bom_bomline' ;
2019-02-26 19:27:04 +01:00
/**
2020-12-05 23:53:55 +01:00
* @ var string Fieldname with ID of parent key if this field has a parent
2019-02-26 19:27:04 +01:00
*/
2019-06-22 20:17:40 +02:00
public $fk_element = 'fk_bom' ;
2019-02-26 19:27:04 +01:00
/**
2020-12-05 23:53:55 +01:00
* @ var string Name of subtable class that manage subtable lines
2019-02-26 19:27:04 +01:00
*/
2019-06-22 20:17:40 +02:00
public $class_element_line = 'BOMLine' ;
2020-12-05 23:53:55 +01:00
// /**
// * @var array List of child tables. To test if we can delete object.
// */
// protected $childtables=array();
2019-02-26 19:27:04 +01:00
/**
2019-06-22 20:17:40 +02:00
* @ var array List of child tables . To know object to delete on cascade .
2019-02-26 19:27:04 +01:00
*/
2019-11-11 23:59:36 +01:00
protected $childtablesoncascade = array ( 'bom_bomline' );
2019-02-26 19:27:04 +01:00
/**
2019-06-22 20:17:40 +02:00
* @ var BOMLine [] Array of subtable lines
2019-02-26 19:27:04 +01:00
*/
2019-06-22 20:17:40 +02:00
public $lines = array ();
2019-02-26 19:27:04 +01:00
2020-03-30 10:20:56 +02:00
/**
* @ var int Calculated cost for the BOM
*/
public $total_cost = 0 ;
/**
* @ var int Calculated cost for 1 unit of the product in BOM
*/
public $unit_cost = 0 ;
2019-02-26 19:27:04 +01:00
/**
* Constructor
*
* @ param DoliDb $db Database handler
*/
public function __construct ( DoliDB $db )
{
2019-06-20 02:56:44 +02:00
global $conf , $langs ;
2019-02-26 19:27:04 +01:00
$this -> db = $db ;
2021-02-23 17:51:46 +01:00
if ( empty ( $conf -> global -> MAIN_SHOW_TECHNICAL_ID ) && isset ( $this -> fields [ 'rowid' ])) {
$this -> fields [ 'rowid' ][ 'visible' ] = 0 ;
}
if ( empty ( $conf -> multicompany -> enabled ) && isset ( $this -> fields [ 'entity' ])) {
$this -> fields [ 'entity' ][ 'enabled' ] = 0 ;
}
2019-02-26 19:27:04 +01:00
// Unset fields that are disabled
2021-02-23 17:51:46 +01:00
foreach ( $this -> fields as $key => $val ) {
if ( isset ( $val [ 'enabled' ]) && empty ( $val [ 'enabled' ])) {
2019-02-26 19:27:04 +01:00
unset ( $this -> fields [ $key ]);
}
}
// Translate some data of arrayofkeyval
2021-02-23 17:51:46 +01:00
foreach ( $this -> fields as $key => $val ) {
if ( ! empty ( $val [ 'arrayofkeyval' ]) && is_array ( $val [ 'arrayofkeyval' ])) {
foreach ( $val [ 'arrayofkeyval' ] as $key2 => $val2 ) {
2019-11-11 23:59:36 +01:00
$this -> fields [ $key ][ 'arrayofkeyval' ][ $key2 ] = $langs -> trans ( $val2 );
2019-02-26 19:27:04 +01:00
}
}
}
}
/**
* Create object into database
*
* @ param User $user User that creates
* @ param bool $notrigger false = launch triggers after , true = disable triggers
* @ return int < 0 if KO , Id of created object if OK
*/
public function create ( User $user , $notrigger = false )
{
2021-02-23 17:51:46 +01:00
if ( $this -> efficiency <= 0 || $this -> efficiency > 1 ) {
$this -> efficiency = 1 ;
}
2019-06-13 14:20:13 +02:00
2019-02-26 19:27:04 +01:00
return $this -> createCommon ( $user , $notrigger );
}
/**
* Clone an object into another one
*
* @ param User $user User that creates
* @ param int $fromid Id of object to clone
* @ return mixed New object created , < 0 if KO
*/
public function createFromClone ( User $user , $fromid )
{
global $langs , $hookmanager , $extrafields ;
2020-10-31 14:32:18 +01:00
$error = 0 ;
2019-02-26 19:27:04 +01:00
2020-10-31 14:32:18 +01:00
dol_syslog ( __METHOD__ , LOG_DEBUG );
2019-02-26 19:27:04 +01:00
2020-10-31 14:32:18 +01:00
$object = new self ( $this -> db );
2019-02-26 19:27:04 +01:00
2020-10-31 14:32:18 +01:00
$this -> db -> begin ();
2019-02-26 19:27:04 +01:00
2020-10-31 14:32:18 +01:00
// Load source object
$result = $object -> fetchCommon ( $fromid );
2021-02-23 17:51:46 +01:00
if ( $result > 0 && ! empty ( $object -> table_element_line )) {
$object -> fetchLines ();
}
2019-06-03 22:07:34 +02:00
2020-10-31 14:32:18 +01:00
// Get lines so they will be clone
//foreach ($object->lines as $line)
// $line->fetch_optionals();
2019-06-03 22:07:34 +02:00
2020-10-31 14:32:18 +01:00
// Reset some properties
unset ( $object -> id );
unset ( $object -> fk_user_creat );
unset ( $object -> import_key );
2019-02-26 19:27:04 +01:00
2020-10-31 14:32:18 +01:00
// Clear fields
$object -> ref = empty ( $this -> fields [ 'ref' ][ 'default' ]) ? $langs -> trans ( " copy_of_ " ) . $object -> ref : $this -> fields [ 'ref' ][ 'default' ];
$object -> label = empty ( $this -> fields [ 'label' ][ 'default' ]) ? $langs -> trans ( " CopyOf " ) . " " . $object -> label : $this -> fields [ 'label' ][ 'default' ];
$object -> status = self :: STATUS_DRAFT ;
// ...
// Clear extrafields that are unique
2021-02-23 17:51:46 +01:00
if ( is_array ( $object -> array_options ) && count ( $object -> array_options ) > 0 ) {
2020-10-31 14:32:18 +01:00
$extrafields -> fetch_name_optionals_label ( $object -> table_element );
2021-02-23 17:51:46 +01:00
foreach ( $object -> array_options as $key => $option ) {
2020-10-31 14:32:18 +01:00
$shortkey = preg_replace ( '/options_/' , '' , $key );
2021-02-23 17:51:46 +01:00
if ( ! empty ( $extrafields -> attributes [ $this -> element ][ 'unique' ][ $shortkey ])) {
2020-10-31 14:32:18 +01:00
//var_dump($key); var_dump($clonedObj->array_options[$key]); exit;
unset ( $object -> array_options [ $key ]);
}
}
}
// Create clone
2019-02-26 19:27:04 +01:00
$object -> context [ 'createfromclone' ] = 'createfromclone' ;
2020-10-31 14:32:18 +01:00
$result = $object -> createCommon ( $user );
if ( $result < 0 ) {
$error ++ ;
$this -> error = $object -> error ;
$this -> errors = $object -> errors ;
}
2019-06-03 22:07:34 +02:00
2021-02-23 17:51:46 +01:00
if ( ! $error ) {
2020-10-31 14:32:18 +01:00
// copy internal contacts
2021-02-23 17:51:46 +01:00
if ( $this -> copy_linked_contact ( $object , 'internal' ) < 0 ) {
2020-10-31 14:32:18 +01:00
$error ++ ;
}
}
2019-06-03 22:07:34 +02:00
2021-02-23 17:51:46 +01:00
if ( ! $error ) {
2020-10-31 14:32:18 +01:00
// copy external contacts if same company
2021-02-23 17:51:46 +01:00
if ( property_exists ( $this , 'socid' ) && $this -> socid == $object -> socid ) {
if ( $this -> copy_linked_contact ( $object , 'external' ) < 0 ) {
2020-10-31 14:32:18 +01:00
$error ++ ;
2021-02-23 17:51:46 +01:00
}
2020-10-31 14:32:18 +01:00
}
}
2019-06-03 22:07:34 +02:00
2020-10-31 14:32:18 +01:00
// If there is lines, create lines too
2019-06-03 22:07:34 +02:00
2019-02-26 19:27:04 +01:00
2020-10-31 14:32:18 +01:00
unset ( $object -> context [ 'createfromclone' ]);
// End
if ( ! $error ) {
$this -> db -> commit ();
return $object ;
} else {
$this -> db -> rollback ();
return - 1 ;
}
2019-02-26 19:27:04 +01:00
}
/**
* Load object in memory from the database
*
* @ param int $id Id object
* @ param string $ref Ref
* @ return int < 0 if KO , 0 if not found , > 0 if OK
*/
public function fetch ( $id , $ref = null )
{
$result = $this -> fetchCommon ( $id , $ref );
2020-07-04 16:14:53 +02:00
2021-02-23 17:51:46 +01:00
if ( $result > 0 && ! empty ( $this -> table_element_line )) {
$this -> fetchLines ();
}
2021-09-20 15:29:55 +02:00
//$this->calculateCosts(); // This consume a high number of subrequests. Do not call it into fetch but when you need it.
2020-07-04 16:14:53 +02:00
2019-02-26 19:27:04 +01:00
return $result ;
}
/**
* Load object lines in memory from the database
*
* @ return int < 0 if KO , 0 if not found , > 0 if OK
*/
2019-03-12 19:20:01 +01:00
public function fetchLines ()
2019-02-26 19:27:04 +01:00
{
2019-11-11 23:59:36 +01:00
$this -> lines = array ();
2019-02-26 19:27:04 +01:00
2019-06-03 18:11:53 +02:00
$result = $this -> fetchLinesCommon ();
return $result ;
2019-03-12 19:20:01 +01:00
}
2019-02-26 19:27:04 +01:00
/**
* Load list of objects in memory from the database .
*
* @ param string $sortorder Sort Order
* @ param string $sortfield Sort field
* @ param int $limit limit
* @ param int $offset Offset
* @ param array $filter Filter array . Example array ( 'field' => 'valueforlike' , 'customurl' =>... )
* @ param string $filtermode Filter mode ( AND or OR )
* @ return array | int int < 0 if KO , array of pages if OK
*/
public function fetchAll ( $sortorder = '' , $sortfield = '' , $limit = 0 , $offset = 0 , array $filter = array (), $filtermode = 'AND' )
{
global $conf ;
dol_syslog ( __METHOD__ , LOG_DEBUG );
2019-11-11 23:59:36 +01:00
$records = array ();
2019-02-26 19:27:04 +01:00
2019-06-03 18:11:53 +02:00
$sql = 'SELECT ' ;
$sql .= $this -> getFieldList ();
2019-11-11 23:59:36 +01:00
$sql .= ' FROM ' . MAIN_DB_PREFIX . $this -> table_element . ' as t' ;
2021-02-23 17:51:46 +01:00
if ( $this -> ismultientitymanaged ) {
$sql .= ' WHERE t.entity IN (' . getEntity ( $this -> table_element ) . ')' ;
} else {
$sql .= ' WHERE 1 = 1' ;
}
2019-02-26 19:27:04 +01:00
// Manage filter
$sqlwhere = array ();
if ( count ( $filter ) > 0 ) {
foreach ( $filter as $key => $value ) {
2019-11-11 23:59:36 +01:00
if ( $key == 't.rowid' ) {
2021-08-27 22:42:04 +02:00
$sqlwhere [] = $key . " = " . (( int ) $value );
2020-05-21 15:05:19 +02:00
} elseif ( strpos ( $key , 'date' ) !== false ) {
2021-08-27 22:42:04 +02:00
$sqlwhere [] = $key . " = ' " . $this -> db -> idate ( $value ) . " ' " ;
2020-05-21 15:05:19 +02:00
} elseif ( $key == 'customsql' ) {
2019-02-26 19:27:04 +01:00
$sqlwhere [] = $value ;
2020-05-21 15:05:19 +02:00
} else {
2021-08-27 22:42:04 +02:00
$sqlwhere [] = $key . " LIKE '% " . $this -> db -> escape ( $value ) . " %' " ;
2019-02-26 19:27:04 +01:00
}
}
}
if ( count ( $sqlwhere ) > 0 ) {
2021-08-27 22:42:04 +02:00
$sql .= " AND ( " . implode ( " " . $filtermode . " " , $sqlwhere ) . " ) " ;
2019-02-26 19:27:04 +01:00
}
if ( ! empty ( $sortfield )) {
$sql .= $this -> db -> order ( $sortfield , $sortorder );
}
if ( ! empty ( $limit )) {
2021-08-27 22:42:04 +02:00
$sql .= $this -> db -> plimit ( $limit , $offset );
2019-02-26 19:27:04 +01:00
}
$resql = $this -> db -> query ( $sql );
if ( $resql ) {
$num = $this -> db -> num_rows ( $resql );
2021-02-23 17:51:46 +01:00
while ( $obj = $this -> db -> fetch_object ( $resql )) {
2019-02-26 19:27:04 +01:00
$record = new self ( $this -> db );
2019-06-03 18:11:53 +02:00
$record -> setVarsFromFetchObj ( $obj );
2019-02-26 19:27:04 +01:00
$records [ $record -> id ] = $record ;
}
$this -> db -> free ( $resql );
return $records ;
} else {
2019-11-11 23:59:36 +01:00
$this -> errors [] = 'Error ' . $this -> db -> lasterror ();
dol_syslog ( __METHOD__ . ' ' . join ( ',' , $this -> errors ), LOG_ERR );
2019-02-26 19:27:04 +01:00
return - 1 ;
}
}
/**
* Update object into database
*
* @ param User $user User that modifies
* @ param bool $notrigger false = launch triggers after , true = disable triggers
* @ return int < 0 if KO , > 0 if OK
*/
public function update ( User $user , $notrigger = false )
{
2021-02-23 17:51:46 +01:00
if ( $this -> efficiency <= 0 || $this -> efficiency > 1 ) {
$this -> efficiency = 1 ;
}
2019-06-13 14:20:13 +02:00
2019-02-26 19:27:04 +01:00
return $this -> updateCommon ( $user , $notrigger );
}
/**
* Delete object in database
*
* @ param User $user User that deletes
* @ param bool $notrigger false = launch triggers after , true = disable triggers
* @ return int < 0 if KO , > 0 if OK
*/
public function delete ( User $user , $notrigger = false )
{
return $this -> deleteCommon ( $user , $notrigger );
//return $this->deleteCommon($user, $notrigger, 1);
}
2019-06-03 20:46:11 +02:00
/**
* Delete a line of object in database
*
* @ param User $user User that delete
* @ param int $idline Id of line to delete
* @ param bool $notrigger false = launch triggers after , true = disable triggers
* @ return int > 0 if OK , < 0 if KO
*/
public function deleteLine ( User $user , $idline , $notrigger = false )
{
2021-02-23 17:51:46 +01:00
if ( $this -> status < 0 ) {
2019-06-03 20:46:11 +02:00
$this -> error = 'ErrorDeleteLineNotAllowedByObjectStatus' ;
return - 2 ;
}
return $this -> deleteLineCommon ( $user , $idline , $notrigger );
}
2019-03-12 19:20:01 +01:00
2019-03-15 18:06:26 +01:00
/**
* Returns the reference to the following non used BOM depending on the active numbering module
* defined into BOM_ADDON
*
* @ param Product $prod Object product
* @ return string BOM free reference
*/
public function getNextNumRef ( $prod )
{
2020-10-31 14:32:18 +01:00
global $langs , $conf ;
$langs -> load ( " mrp " );
2019-03-15 18:06:26 +01:00
2021-02-23 17:51:46 +01:00
if ( ! empty ( $conf -> global -> BOM_ADDON )) {
2020-10-31 14:32:18 +01:00
$mybool = false ;
$file = $conf -> global -> BOM_ADDON . " .php " ;
$classname = $conf -> global -> BOM_ADDON ;
// Include file with class
$dirmodels = array_merge ( array ( '/' ), ( array ) $conf -> modules_parts [ 'models' ]);
2021-02-23 17:51:46 +01:00
foreach ( $dirmodels as $reldir ) {
2020-10-31 14:32:18 +01:00
$dir = dol_buildpath ( $reldir . " core/modules/bom/ " );
// Load file with numbering class (if found)
$mybool |= @ include_once $dir . $file ;
}
2021-02-23 17:51:46 +01:00
if ( $mybool === false ) {
2020-10-31 14:32:18 +01:00
dol_print_error ( '' , " Failed to include file " . $file );
return '' ;
}
$obj = new $classname ();
$numref = $obj -> getNextValue ( $prod , $this );
2021-02-23 17:51:46 +01:00
if ( $numref != " " ) {
2020-10-31 14:32:18 +01:00
return $numref ;
} else {
$this -> error = $obj -> error ;
//dol_print_error($this->db,get_class($this)."::getNextNumRef ".$obj->error);
return " " ;
}
} else {
print $langs -> trans ( " Error " ) . " " . $langs -> trans ( " Error_BOM_ADDON_NotDefined " );
return " " ;
}
2019-03-15 18:06:26 +01:00
}
2019-03-12 19:20:01 +01:00
/**
* Validate bom
*
* @ param User $user User making status change
* @ param int $notrigger 1 = Does not execute triggers , 0 = execute triggers
* @ return int <= 0 if OK , 0 = Nothing done , > 0 if KO
*/
2019-10-16 01:36:07 +02:00
public function validate ( $user , $notrigger = 0 )
2019-03-12 19:20:01 +01:00
{
2020-10-31 14:32:18 +01:00
global $conf , $langs ;
2019-07-28 22:26:55 +02:00
2020-10-31 14:32:18 +01:00
require_once DOL_DOCUMENT_ROOT . '/core/lib/files.lib.php' ;
2019-03-12 19:20:01 +01:00
2020-10-31 14:32:18 +01:00
$error = 0 ;
2019-03-12 19:20:01 +01:00
2020-10-31 14:32:18 +01:00
// Protection
2021-02-23 17:51:46 +01:00
if ( $this -> status == self :: STATUS_VALIDATED ) {
2020-10-31 14:32:18 +01:00
dol_syslog ( get_class ( $this ) . " ::validate action abandonned: already validated " , LOG_WARNING );
return 0 ;
}
2019-03-12 19:20:01 +01:00
2020-10-31 14:32:18 +01:00
/* if ( ! (( empty ( $conf -> global -> MAIN_USE_ADVANCED_PERMS ) && ! empty ( $user -> rights -> bom -> create ))
2021-02-23 17:51:46 +01:00
|| ( ! empty ( $conf -> global -> MAIN_USE_ADVANCED_PERMS ) && ! empty ( $user -> rights -> bom -> bom_advance -> validate ))))
{
$this -> error = 'NotEnoughPermissions' ;
dol_syslog ( get_class ( $this ) . " ::valid " . $this -> error , LOG_ERR );
return - 1 ;
} */
2019-03-12 19:20:01 +01:00
2020-10-31 14:32:18 +01:00
$now = dol_now ();
2019-03-12 19:20:01 +01:00
2020-10-31 14:32:18 +01:00
$this -> db -> begin ();
2019-03-12 19:20:01 +01:00
2020-10-31 14:32:18 +01:00
// Define new ref
2021-02-23 17:51:46 +01:00
if ( ! $error && ( preg_match ( '/^[\(]?PROV/i' , $this -> ref ) || empty ( $this -> ref ))) { // empty should not happened, but when it occurs, the test save life
2020-10-31 14:32:18 +01:00
$this -> fetch_product ();
$num = $this -> getNextNumRef ( $this -> product );
} else {
$num = $this -> ref ;
}
$this -> newref = dol_sanitizeFileName ( $num );
2019-03-12 19:20:01 +01:00
2020-10-31 14:32:18 +01:00
// Validate
$sql = " UPDATE " . MAIN_DB_PREFIX . $this -> table_element ;
$sql .= " SET ref = ' " . $this -> db -> escape ( $num ) . " ', " ;
$sql .= " status = " . self :: STATUS_VALIDATED . " , " ;
$sql .= " date_valid=' " . $this -> db -> idate ( $now ) . " ', " ;
2021-06-09 15:36:47 +02:00
$sql .= " fk_user_valid = " . (( int ) $user -> id );
$sql .= " WHERE rowid = " . (( int ) $this -> id );
2019-03-12 19:20:01 +01:00
2020-10-31 14:32:18 +01:00
dol_syslog ( get_class ( $this ) . " ::validate() " , LOG_DEBUG );
$resql = $this -> db -> query ( $sql );
2021-02-23 17:51:46 +01:00
if ( ! $resql ) {
2020-10-31 14:32:18 +01:00
dol_print_error ( $this -> db );
$this -> error = $this -> db -> lasterror ();
$error ++ ;
}
2019-03-12 19:20:01 +01:00
2021-02-23 17:51:46 +01:00
if ( ! $error && ! $notrigger ) {
2020-10-31 14:32:18 +01:00
// Call trigger
$result = $this -> call_trigger ( 'BOM_VALIDATE' , $user );
2021-02-23 17:51:46 +01:00
if ( $result < 0 ) {
$error ++ ;
}
2020-10-31 14:32:18 +01:00
// End call triggers
}
2021-02-23 17:51:46 +01:00
if ( ! $error ) {
2020-10-31 14:32:18 +01:00
$this -> oldref = $this -> ref ;
// Rename directory if dir was a temporary ref
2021-02-23 17:51:46 +01:00
if ( preg_match ( '/^[\(]?PROV/i' , $this -> ref )) {
2020-10-31 14:32:18 +01:00
// Now we rename also files into index
$sql = 'UPDATE ' . MAIN_DB_PREFIX . " ecm_files set filename = CONCAT(' " . $this -> db -> escape ( $this -> newref ) . " ', SUBSTR(filename, " . ( strlen ( $this -> ref ) + 1 ) . " )), filepath = 'bom/ " . $this -> db -> escape ( $this -> newref ) . " ' " ;
$sql .= " WHERE filename LIKE ' " . $this -> db -> escape ( $this -> ref ) . " %' AND filepath = 'bom/ " . $this -> db -> escape ( $this -> ref ) . " ' and entity = " . $conf -> entity ;
$resql = $this -> db -> query ( $sql );
2021-02-23 17:51:46 +01:00
if ( ! $resql ) {
$error ++ ; $this -> error = $this -> db -> lasterror ();
}
2020-10-31 14:32:18 +01:00
// We rename directory ($this->ref = old ref, $num = new ref) in order not to lose the attachments
$oldref = dol_sanitizeFileName ( $this -> ref );
$newref = dol_sanitizeFileName ( $num );
$dirsource = $conf -> bom -> dir_output . '/' . $oldref ;
$dirdest = $conf -> bom -> dir_output . '/' . $newref ;
2021-02-23 17:51:46 +01:00
if ( ! $error && file_exists ( $dirsource )) {
2020-10-31 14:32:18 +01:00
dol_syslog ( get_class ( $this ) . " ::validate() rename dir " . $dirsource . " into " . $dirdest );
2021-02-23 17:51:46 +01:00
if ( @ rename ( $dirsource , $dirdest )) {
2020-10-31 14:32:18 +01:00
dol_syslog ( " Rename ok " );
// Rename docs starting with $oldref with $newref
$listoffiles = dol_dir_list ( $conf -> bom -> dir_output . '/' . $newref , 'files' , 1 , '^' . preg_quote ( $oldref , '/' ));
2021-02-23 17:51:46 +01:00
foreach ( $listoffiles as $fileentry ) {
2020-10-31 14:32:18 +01:00
$dirsource = $fileentry [ 'name' ];
$dirdest = preg_replace ( '/^' . preg_quote ( $oldref , '/' ) . '/' , $newref , $dirsource );
$dirsource = $fileentry [ 'path' ] . '/' . $dirsource ;
$dirdest = $fileentry [ 'path' ] . '/' . $dirdest ;
@ rename ( $dirsource , $dirdest );
}
}
}
}
}
// Set new ref and current status
2021-02-23 17:51:46 +01:00
if ( ! $error ) {
2020-10-31 14:32:18 +01:00
$this -> ref = $num ;
$this -> status = self :: STATUS_VALIDATED ;
}
2021-02-23 17:51:46 +01:00
if ( ! $error ) {
2020-10-31 14:32:18 +01:00
$this -> db -> commit ();
return 1 ;
} else {
$this -> db -> rollback ();
return - 1 ;
}
2019-03-12 19:20:01 +01:00
}
/**
* Set draft status
*
* @ param User $user Object user that modify
2019-10-16 01:20:58 +02:00
* @ param int $notrigger 1 = Does not execute triggers , 0 = Execute triggers
2019-03-12 19:20:01 +01:00
* @ return int < 0 if KO , > 0 if OK
*/
2019-10-16 01:20:58 +02:00
public function setDraft ( $user , $notrigger = 0 )
2019-03-12 19:20:01 +01:00
{
2019-10-16 01:20:58 +02:00
// Protection
2021-02-23 17:51:46 +01:00
if ( $this -> status <= self :: STATUS_DRAFT ) {
2019-10-16 01:20:58 +02:00
return 0 ;
}
2019-03-12 19:20:01 +01:00
2019-10-16 01:20:58 +02:00
/* if ( ! (( empty ( $conf -> global -> MAIN_USE_ADVANCED_PERMS ) && ! empty ( $user -> rights -> bom -> write ))
|| ( ! empty ( $conf -> global -> MAIN_USE_ADVANCED_PERMS ) && ! empty ( $user -> rights -> bom -> bom_advance -> validate ))))
{
$this -> error = 'Permission denied' ;
return - 1 ;
} */
2019-03-12 19:20:01 +01:00
2019-10-16 01:20:58 +02:00
return $this -> setStatusCommon ( $user , self :: STATUS_DRAFT , $notrigger , 'BOM_UNVALIDATE' );
}
2019-03-12 19:20:01 +01:00
2019-10-16 01:20:58 +02:00
/**
* Set cancel status
*
* @ param User $user Object user that modify
* @ param int $notrigger 1 = Does not execute triggers , 0 = Execute triggers
* @ return int < 0 if KO , 0 = Nothing done , > 0 if OK
*/
public function cancel ( $user , $notrigger = 0 )
{
// Protection
2021-02-23 17:51:46 +01:00
if ( $this -> status != self :: STATUS_VALIDATED ) {
2019-10-16 01:20:58 +02:00
return 0 ;
}
2019-03-12 19:20:01 +01:00
2019-10-16 01:20:58 +02:00
/* if ( ! (( empty ( $conf -> global -> MAIN_USE_ADVANCED_PERMS ) && ! empty ( $user -> rights -> bom -> write ))
|| ( ! empty ( $conf -> global -> MAIN_USE_ADVANCED_PERMS ) && ! empty ( $user -> rights -> bom -> bom_advance -> validate ))))
{
$this -> error = 'Permission denied' ;
return - 1 ;
} */
2019-03-12 19:20:01 +01:00
2019-10-16 01:36:07 +02:00
return $this -> setStatusCommon ( $user , self :: STATUS_CANCELED , $notrigger , 'BOM_CLOSE' );
2019-10-16 01:20:58 +02:00
}
2019-03-12 19:20:01 +01:00
2019-10-16 01:20:58 +02:00
/**
* Set cancel status
*
* @ param User $user Object user that modify
* @ param int $notrigger 1 = Does not execute triggers , 0 = Execute triggers
* @ return int < 0 if KO , 0 = Nothing done , > 0 if OK
*/
public function reopen ( $user , $notrigger = 0 )
{
// Protection
2021-02-23 17:51:46 +01:00
if ( $this -> status != self :: STATUS_CANCELED ) {
2019-10-16 01:20:58 +02:00
return 0 ;
}
2019-03-21 17:37:56 +01:00
2019-10-16 01:20:58 +02:00
/* if ( ! (( empty ( $conf -> global -> MAIN_USE_ADVANCED_PERMS ) && ! empty ( $user -> rights -> bom -> write ))
|| ( ! empty ( $conf -> global -> MAIN_USE_ADVANCED_PERMS ) && ! empty ( $user -> rights -> bom -> bom_advance -> validate ))))
{
$this -> error = 'Permission denied' ;
return - 1 ;
} */
2019-03-12 19:20:01 +01:00
2019-10-16 01:36:07 +02:00
return $this -> setStatusCommon ( $user , self :: STATUS_VALIDATED , $notrigger , 'BOM_REOPEN' );
2019-03-12 19:20:01 +01:00
}
2019-10-16 01:36:07 +02:00
2019-02-26 19:27:04 +01:00
/**
* Return a link to the object card ( with optionaly the picto )
*
* @ param int $withpicto Include picto in link ( 0 = No picto , 1 = Include picto into link , 2 = Only picto )
* @ param string $option On what the link point to ( 'nolink' , ... )
2020-10-31 14:32:18 +01:00
* @ param int $notooltip 1 = Disable tooltip
* @ param string $morecss Add more css on link
* @ param int $save_lastsearch_value - 1 = Auto , 0 = No save of lastsearch_values when clicking , 1 = Save lastsearch_values whenclicking
2019-02-26 19:27:04 +01:00
* @ return string String with URL
*/
2019-02-26 21:48:21 +01:00
public function getNomUrl ( $withpicto = 0 , $option = '' , $notooltip = 0 , $morecss = '' , $save_lastsearch_value = - 1 )
2019-02-26 19:27:04 +01:00
{
global $db , $conf , $langs , $hookmanager ;
2020-10-31 14:32:18 +01:00
2021-02-23 17:51:46 +01:00
if ( ! empty ( $conf -> dol_no_mouse_hover )) {
$notooltip = 1 ; // Force disable tooltips
}
2020-10-31 14:32:18 +01:00
$result = '' ;
2020-11-05 22:25:14 +01:00
$label = img_picto ( '' , $this -> picto ) . ' <u class="paddingrightonly">' . $langs -> trans ( " BillOfMaterials " ) . '</u>' ;
2020-10-31 14:32:18 +01:00
if ( isset ( $this -> status )) {
2020-11-05 22:25:14 +01:00
$label .= ' ' . $this -> getLibStatut ( 5 );
2020-10-31 14:32:18 +01:00
}
2020-11-05 22:25:14 +01:00
$label .= '<br>' ;
$label .= '<b>' . $langs -> trans ( 'Ref' ) . ':</b> ' . $this -> ref ;
2021-07-04 20:08:34 +02:00
if ( isset ( $this -> label )) {
$label .= '<br><b>' . $langs -> trans ( 'Label' ) . ':</b> ' . $this -> label ;
}
2022-01-10 20:58:08 +01:00
if ( ! empty ( $this -> fk_product ) && $this -> fk_product > 0 ) {
2022-01-11 20:37:20 +01:00
include_once DOL_DOCUMENT_ROOT . '/product/class/product.class.php' ;
2022-01-06 21:48:12 +01:00
$product = new Product ( $db );
$resultFetch = $product -> fetch ( $this -> fk_product );
2022-01-10 20:58:08 +01:00
if ( $resultFetch > 0 ) {
2022-01-10 21:00:38 +01:00
$label .= " <br><b> " . $langs -> trans ( " Product " ) . '</b>: ' . $product -> ref . ' - ' . $product -> label ;
2022-01-06 21:48:12 +01:00
}
}
2020-10-31 14:32:18 +01:00
2021-06-24 09:54:30 +02:00
$url = DOL_URL_ROOT . '/bom/bom_card.php?id=' . $this -> id ;
2020-10-31 14:32:18 +01:00
2021-02-23 17:51:46 +01:00
if ( $option != 'nolink' ) {
2020-10-31 14:32:18 +01:00
// Add param to save lastsearch_values or not
$add_save_lastsearch_values = ( $save_lastsearch_value == 1 ? 1 : 0 );
2021-02-23 17:51:46 +01:00
if ( $save_lastsearch_value == - 1 && preg_match ( '/list\.php/' , $_SERVER [ " PHP_SELF " ])) {
$add_save_lastsearch_values = 1 ;
}
if ( $add_save_lastsearch_values ) {
$url .= '&save_lastsearch_values=1' ;
}
2020-10-31 14:32:18 +01:00
}
$linkclose = '' ;
2021-02-23 17:51:46 +01:00
if ( empty ( $notooltip )) {
if ( ! empty ( $conf -> global -> MAIN_OPTIMIZEFORTEXTBROWSER )) {
2020-10-31 14:32:18 +01:00
$label = $langs -> trans ( " ShowBillOfMaterials " );
$linkclose .= ' alt="' . dol_escape_htmltag ( $label , 1 ) . '"' ;
}
$linkclose .= ' title="' . dol_escape_htmltag ( $label , 1 ) . '"' ;
$linkclose .= ' class="classfortooltip' . ( $morecss ? ' ' . $morecss : '' ) . '"' ;
2021-02-23 17:51:46 +01:00
} else {
$linkclose = ( $morecss ? ' class="' . $morecss . '"' : '' );
}
2019-02-26 19:27:04 +01:00
$linkstart = '<a href="' . $url . '"' ;
2019-11-11 23:59:36 +01:00
$linkstart .= $linkclose . '>' ;
$linkend = '</a>' ;
2019-02-26 19:27:04 +01:00
$result .= $linkstart ;
2021-02-23 17:51:46 +01:00
if ( $withpicto ) {
$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 );
}
if ( $withpicto != 2 ) {
$result .= $this -> ref ;
}
2019-02-26 19:27:04 +01:00
$result .= $linkend ;
//if ($withpicto != 2) $result.=(($addlabel && $this->label) ? $sep . dol_trunc($this->label, ($addlabel > 1 ? $addlabel : 0)) : '');
2019-11-11 23:59:36 +01:00
global $action , $hookmanager ;
2019-02-26 19:27:04 +01:00
$hookmanager -> initHooks ( array ( 'bomdao' ));
2021-11-22 19:57:26 +01:00
$parameters = array ( 'id' => $this -> id , 'getnomurl' => & $result );
2019-11-11 23:59:36 +01:00
$reshook = $hookmanager -> executeHooks ( 'getNomUrl' , $parameters , $this , $action ); // Note that $action and $object may have been modified by some hooks
2021-02-23 17:51:46 +01:00
if ( $reshook > 0 ) {
$result = $hookmanager -> resPrint ;
} else {
$result .= $hookmanager -> resPrint ;
}
2019-02-26 19:27:04 +01:00
return $result ;
}
/**
* Return label of the status
*
* @ param int $mode 0 = long label , 1 = short label , 2 = Picto + short label , 3 = Picto , 4 = Picto + long label , 5 = Short label + Picto , 6 = Long label + Picto
* @ return string Label of status
*/
public function getLibStatut ( $mode = 0 )
{
return $this -> LibStatut ( $this -> status , $mode );
}
2020-10-31 14:32:18 +01:00
// phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
2019-02-26 19:27:04 +01:00
/**
* Return the status
*
* @ param int $status Id status
* @ param int $mode 0 = long label , 1 = short label , 2 = Picto + short label , 3 = Picto , 4 = Picto + long label , 5 = Short label + Picto , 6 = Long label + Picto
* @ return string Label of status
*/
public function LibStatut ( $status , $mode = 0 )
{
// phpcs:enable
2021-02-23 17:51:46 +01:00
if ( empty ( $this -> labelStatus )) {
2019-02-26 19:27:04 +01:00
global $langs ;
2019-03-04 12:46:07 +01:00
//$langs->load("mrp");
2020-10-25 14:11:09 +01:00
$this -> labelStatus [ self :: STATUS_DRAFT ] = $langs -> transnoentitiesnoconv ( 'Draft' );
$this -> labelStatus [ self :: STATUS_VALIDATED ] = $langs -> transnoentitiesnoconv ( 'Enabled' );
$this -> labelStatus [ self :: STATUS_CANCELED ] = $langs -> transnoentitiesnoconv ( 'Disabled' );
2019-02-26 19:27:04 +01:00
}
2019-10-24 13:09:50 +02:00
$statusType = 'status' . $status ;
2021-02-23 17:51:46 +01:00
if ( $status == self :: STATUS_VALIDATED ) {
$statusType = 'status4' ;
}
if ( $status == self :: STATUS_CANCELED ) {
$statusType = 'status6' ;
}
2019-10-24 13:09:50 +02:00
2019-11-01 12:52:03 +01:00
return dolGetStatus ( $this -> labelStatus [ $status ], $this -> labelStatus [ $status ], '' , $statusType , $mode );
2019-02-26 19:27:04 +01:00
}
/**
* Load the info information in the object
*
* @ param int $id Id of object
* @ return void
*/
public function info ( $id )
{
$sql = 'SELECT rowid, date_creation as datec, tms as datem,' ;
2019-11-11 23:59:36 +01:00
$sql .= ' fk_user_creat, fk_user_modif' ;
$sql .= ' FROM ' . MAIN_DB_PREFIX . $this -> table_element . ' as t' ;
2021-03-14 11:48:39 +01:00
$sql .= ' WHERE t.rowid = ' . (( int ) $id );
2019-11-11 23:59:36 +01:00
$result = $this -> db -> query ( $sql );
2021-02-23 17:51:46 +01:00
if ( $result ) {
if ( $this -> db -> num_rows ( $result )) {
2019-02-26 19:27:04 +01:00
$obj = $this -> db -> fetch_object ( $result );
$this -> id = $obj -> rowid ;
2022-06-28 13:09:53 +02:00
$this -> user_creation_id = $obj -> fk_user_creat ;
$this -> user_modification_id = $obj -> fk_user_modif ;
2019-02-26 19:27:04 +01:00
$this -> date_creation = $this -> db -> jdate ( $obj -> datec );
2022-06-28 13:09:53 +02:00
$this -> date_modification = empty ( $obj -> datem ) ? '' : $this -> db -> jdate ( $obj -> datem );
2019-02-26 19:27:04 +01:00
}
$this -> db -> free ( $result );
2020-05-21 15:05:19 +02:00
} else {
2019-02-26 19:27:04 +01:00
dol_print_error ( $this -> db );
}
}
2019-05-19 16:21:11 +02:00
/**
* Create an array of lines
*
* @ return array | int array of lines if OK , < 0 if KO
*/
public function getLinesArray ()
{
2020-10-31 14:32:18 +01:00
$this -> lines = array ();
2019-05-19 16:21:11 +02:00
2020-10-31 14:32:18 +01:00
$objectline = new BOMLine ( $this -> db );
2021-09-15 20:03:38 +02:00
$result = $objectline -> fetchAll ( 'ASC' , 'position' , 0 , 0 , array ( 'customsql' => 'fk_bom = ' . (( int ) $this -> id )));
2019-05-19 16:21:11 +02:00
2021-02-23 17:51:46 +01:00
if ( is_numeric ( $result )) {
2022-06-02 09:46:26 +02:00
$this -> error = $objectline -> error ;
$this -> errors = $objectline -> errors ;
2020-10-31 14:32:18 +01:00
return $result ;
} else {
$this -> lines = $result ;
return $this -> lines ;
}
2019-05-19 16:21:11 +02:00
}
2019-06-03 20:46:11 +02:00
/**
* Create a document onto disk according to template module .
*
* @ param string $modele Force template to use ( '' to not force )
* @ param Translate $outputlangs objet lang a utiliser pour traduction
* @ param int $hidedetails Hide details of lines
* @ param int $hidedesc Hide description
* @ param int $hideref Hide ref
* @ param null | array $moreparams Array to provide more information
* @ return int 0 if KO , 1 if OK
*/
public function generateDocument ( $modele , $outputlangs , $hidedetails = 0 , $hidedesc = 0 , $hideref = 0 , $moreparams = null )
{
2019-11-11 23:59:36 +01:00
global $conf , $langs ;
2019-06-03 20:46:11 +02:00
$langs -> load ( " mrp " );
2020-08-04 11:02:16 +02:00
$outputlangs -> load ( " products " );
2019-06-03 20:46:11 +02:00
2019-11-11 23:59:36 +01:00
if ( ! dol_strlen ( $modele )) {
2019-06-03 20:46:11 +02:00
$modele = 'standard' ;
2020-09-10 01:49:09 +02:00
if ( $this -> model_pdf ) {
$modele = $this -> model_pdf ;
2019-11-11 23:59:36 +01:00
} elseif ( ! empty ( $conf -> global -> BOM_ADDON_PDF )) {
2019-06-03 20:46:11 +02:00
$modele = $conf -> global -> BOM_ADDON_PDF ;
}
}
$modelpath = " core/modules/bom/doc/ " ;
2019-11-05 20:14:33 +01:00
return $this -> commonGenerateDocument ( $modelpath , $modele , $outputlangs , $hidedetails , $hidedesc , $hideref , $moreparams );
2019-06-03 20:46:11 +02:00
}
2019-02-26 19:27:04 +01:00
/**
* Initialise object with example values
* Id must be 0 if object instance is a specimen
*
* @ return void
*/
public function initAsSpecimen ()
{
2020-10-31 14:32:18 +01:00
$this -> initAsSpecimenCommon ();
$this -> ref = 'BOM-123' ;
$this -> date = $this -> date_creation ;
2019-02-26 19:27:04 +01:00
}
/**
* Action executed by scheduler
* CAN BE A CRON TASK . In such a case , parameters come from the schedule job setup field 'Parameters'
*
* @ return int 0 if OK , <> 0 if KO ( this function is used also by cron so only 0 is OK )
*/
public function doScheduledJob ()
{
global $conf , $langs ;
//$conf->global->SYSLOG_FILE = 'DOL_DATA_ROOT/dolibarr_mydedicatedlofile.log';
$error = 0 ;
$this -> output = '' ;
2019-11-11 23:59:36 +01:00
$this -> error = '' ;
2019-02-26 19:27:04 +01:00
dol_syslog ( __METHOD__ , LOG_DEBUG );
$now = dol_now ();
$this -> db -> begin ();
// ...
$this -> db -> commit ();
return $error ;
}
2020-03-24 10:32:31 +01:00
2020-03-30 10:20:56 +02:00
/**
2021-09-20 15:29:55 +02:00
* BOM costs calculation based on cost_price or pmp of each BOM line .
* Set the property -> total_cost and -> unit_cost of BOM .
2020-05-07 23:39:03 +02:00
*
2020-03-30 10:33:48 +02:00
* @ return void
2020-03-30 10:20:56 +02:00
*/
2020-03-30 10:25:57 +02:00
public function calculateCosts ()
{
2022-09-15 16:02:49 +02:00
global $hookmanager ;
2020-04-10 10:59:32 +02:00
include_once DOL_DOCUMENT_ROOT . '/product/class/product.class.php' ;
2020-03-30 10:20:56 +02:00
$this -> unit_cost = 0 ;
2020-03-24 10:32:31 +01:00
$this -> total_cost = 0 ;
2020-03-30 10:20:56 +02:00
2022-09-15 16:02:49 +02:00
$parameters = array ();
$reshook = $hookmanager -> executeHooks ( 'calculateCostsBom' , $parameters , $this ); // Note that $action and $object may have been modified by hook
if ( $reshook > 0 ) {
return $hookmanager -> resPrint ;
}
2021-09-20 15:29:55 +02:00
if ( is_array ( $this -> lines ) && count ( $this -> lines )) {
require_once DOL_DOCUMENT_ROOT . '/fourn/class/fournisseur.product.class.php' ;
$productFournisseur = new ProductFournisseur ( $this -> db );
2020-03-24 10:32:31 +01:00
$tmpproduct = new Product ( $this -> db );
2021-09-20 15:29:55 +02:00
foreach ( $this -> lines as & $line ) {
$tmpproduct -> cost_price = 0 ;
$tmpproduct -> pmp = 0 ;
2022-01-26 15:15:53 +01:00
if ( empty ( $line -> fk_bom_child )) {
2022-01-26 14:41:36 +01:00
$result = $tmpproduct -> fetch ( $line -> fk_product , '' , '' , '' , 0 , 1 , 1 ); // We discard selling price and language loading
if ( $result < 0 ) {
$this -> error = $tmpproduct -> error ;
return - 1 ;
}
$line -> unit_cost = price2num (( ! empty ( $tmpproduct -> cost_price )) ? $tmpproduct -> cost_price : $tmpproduct -> pmp );
2023-02-06 17:56:21 +01:00
if (( empty ( $line -> unit_cost )) && ( $productFournisseur -> find_min_price_product_fournisseur ( $line -> fk_product ) > 0 )) {
if ( $productFournisseur -> fourn_remise_percent != " 0 " ) {
$line -> unit_cost = $productFournisseur -> fourn_unitprice_with_discount ;
} else {
2022-01-26 14:41:36 +01:00
$line -> unit_cost = $productFournisseur -> fourn_unitprice ;
}
2021-09-20 15:29:55 +02:00
}
2020-03-24 10:32:31 +01:00
2022-01-26 14:41:36 +01:00
$line -> total_cost = price2num ( $line -> qty * $line -> unit_cost , 'MT' );
$this -> total_cost += $line -> total_cost ;
} else {
$bom_child = new BOM ( $this -> db );
$res = $bom_child -> fetch ( $line -> fk_bom_child );
2022-01-26 15:15:53 +01:00
if ( $res > 0 ) {
2022-01-26 14:41:36 +01:00
$bom_child -> calculateCosts ();
2022-02-09 15:55:21 +01:00
$line -> childBom [] = $bom_child ;
2022-12-14 09:37:30 +01:00
$line -> total_cost = price2num ( $bom_child -> total_cost * $line -> qty , 'MT' );
2022-12-09 17:00:11 +01:00
$this -> total_cost += $line -> total_cost ;
2022-01-26 14:41:36 +01:00
} else {
$this -> error = $bom_child -> error ;
return - 2 ;
}
}
2021-09-20 15:29:55 +02:00
}
$this -> total_cost = price2num ( $this -> total_cost , 'MT' );
2022-01-26 14:41:36 +01:00
if ( $this -> qty > 0 ) {
2021-09-20 15:29:55 +02:00
$this -> unit_cost = price2num ( $this -> total_cost / $this -> qty , 'MU' );
2022-01-26 14:41:36 +01:00
} elseif ( $this -> qty < 0 ) {
$this -> unit_cost = price2num ( $this -> total_cost * $this -> qty , 'MU' );
2021-09-20 15:29:55 +02:00
}
2020-05-07 23:39:03 +02:00
}
2020-03-24 10:32:31 +01:00
}
2022-02-09 15:55:21 +01:00
2021-11-23 21:52:40 +01:00
/**
* Function used to replace a product id with another one .
*
* @ param DoliDB $db Database handler
* @ param int $origin_id Old product id
* @ param int $dest_id New product id
* @ return bool
*/
public static function replaceProduct ( DoliDB $db , $origin_id , $dest_id )
{
$tables = array (
'bom_bomline'
);
return CommonObject :: commonReplaceProduct ( $db , $origin_id , $dest_id , $tables );
}
2022-02-22 21:49:17 +01:00
2022-02-09 15:55:21 +01:00
/**
* Get Net needs by product
*
2022-02-10 10:46:04 +01:00
* @ param array $TNetNeeds Array of ChildBom and infos linked to
* @ param int $qty qty needed
2022-02-09 15:55:21 +01:00
* @ return void
*/
2022-02-10 10:22:53 +01:00
public function getNetNeeds ( & $TNetNeeds = array (), $qty = 0 )
{
if ( ! empty ( $this -> lines )) {
foreach ( $this -> lines as $line ) {
if ( ! empty ( $line -> childBom )) {
foreach ( $line -> childBom as $childBom ) $childBom -> getNetNeeds ( $TNetNeeds , $line -> qty * $qty );
} else {
2022-05-18 12:31:09 +02:00
if ( empty ( $TNetNeeds [ $line -> fk_product ])) {
$TNetNeeds [ $line -> fk_product ] = 0 ;
}
2022-02-09 15:55:21 +01:00
$TNetNeeds [ $line -> fk_product ] += $line -> qty * $qty ;
}
}
}
}
/**
* Get Net needs Tree by product or bom
*
2022-02-10 10:46:04 +01:00
* @ param array $TNetNeeds Array of ChildBom and infos linked to
* @ param int $qty qty needed
* @ param int $level level of recursivity
2022-02-09 15:55:21 +01:00
* @ return void
*/
2022-02-10 10:22:53 +01:00
public function getNetNeedsTree ( & $TNetNeeds = array (), $qty = 0 , $level = 0 )
{
if ( ! empty ( $this -> lines )) {
foreach ( $this -> lines as $line ) {
if ( ! empty ( $line -> childBom )) {
foreach ( $line -> childBom as $childBom ) {
2022-02-09 15:55:21 +01:00
$TNetNeeds [ $childBom -> id ][ 'bom' ] = $childBom ;
$TNetNeeds [ $childBom -> id ][ 'parentid' ] = $this -> id ;
$TNetNeeds [ $childBom -> id ][ 'qty' ] = $line -> qty * $qty ;
$TNetNeeds [ $childBom -> id ][ 'level' ] = $level ;
$childBom -> getNetNeedsTree ( $TNetNeeds , $line -> qty * $qty , $level + 1 );
}
2022-02-10 10:22:53 +01:00
} else {
2022-02-09 15:55:21 +01:00
$TNetNeeds [ $this -> id ][ 'product' ][ $line -> fk_product ][ 'qty' ] += $line -> qty * $qty ;
$TNetNeeds [ $this -> id ][ 'product' ][ $line -> fk_product ][ 'level' ] = $level ;
}
}
}
}
2022-09-01 17:16:59 +02:00
/**
* Recursively retrieves all parent bom in the tree that leads to the $bom_id bom
*
* @ param array $TParentBom We put all found parent bom in $TParentBom
* @ param int $bom_id ID of bom from which we want to get parent bom ids
2022-09-02 10:28:19 +02:00
* @ param int $level Protection against infinite loop
2022-09-01 17:16:59 +02:00
* @ return void
*/
2022-09-02 10:33:27 +02:00
public function getParentBomTreeRecursive ( & $TParentBom , $bom_id = '' , $level = 1 )
2022-09-01 17:23:40 +02:00
{
2022-09-01 17:16:59 +02:00
2022-09-02 10:28:19 +02:00
// Protection against infinite loop
if ( $level > 1000 ) {
2022-09-02 11:57:29 +02:00
return ;
2022-09-02 10:28:19 +02:00
}
2022-09-02 10:33:27 +02:00
if ( empty ( $bom_id )) $bom_id = $this -> id ;
2022-09-02 10:28:19 +02:00
2022-09-01 17:16:59 +02:00
$sql = ' SELECT l . fk_bom , b . label
FROM '.MAIN_DB_PREFIX.' bom_bomline l
INNER JOIN '.MAIN_DB_PREFIX.$this->table_element.' b ON b . rowid = l . fk_bom
2022-09-02 08:44:16 +02:00
WHERE fk_bom_child = ' . (( int ) $bom_id );
2022-09-01 17:16:59 +02:00
$resql = $this -> db -> query ( $sql );
2022-09-01 17:23:40 +02:00
if ( ! empty ( $resql )) {
while ( $res = $this -> db -> fetch_object ( $resql )) {
2022-09-01 17:16:59 +02:00
$TParentBom [ $res -> fk_bom ] = $res -> fk_bom ;
2022-09-02 10:28:19 +02:00
$this -> getParentBomTreeRecursive ( $TParentBom , $res -> fk_bom , $level + 1 );
2022-09-01 17:16:59 +02:00
}
}
}
2019-02-26 19:27:04 +01:00
}
/**
2019-03-12 19:20:01 +01:00
* Class for BOMLine
2019-02-26 19:27:04 +01:00
*/
2019-11-30 20:03:14 +01:00
class BOMLine extends CommonObjectLine
2019-02-26 19:27:04 +01:00
{
/**
* @ var string ID to identify managed object
*/
public $element = 'bomline' ;
/**
* @ var string Name of table without prefix where object is stored
*/
public $table_element = 'bom_bomline' ;
/**
* @ var int Does bomline support multicompany module ? 0 = No test on entity , 1 = Test with field entity , 2 = Test with link by societe
*/
public $ismultientitymanaged = 0 ;
/**
* @ var int Does bomline support extrafields ? 0 = No , 1 = Yes
*/
public $isextrafieldmanaged = 1 ;
/**
* @ var string String with name of icon for bomline . Must be the part after the 'object_' into object_bomline . png
*/
2019-05-26 01:06:19 +02:00
public $picto = 'bomline' ;
2019-02-26 19:27:04 +01:00
/**
* 'type' if the field format .
* 'label' the translation key .
* 'enabled' is a condition when the field must be managed .
* 'visible' says if field is visible in list ( Examples : 0 = Not visible , 1 = Visible on list and create / update / view forms , 2 = Visible on list only . Using a negative value means field is not shown by default on list but can be selected for viewing )
* 'notnull' is set to 1 if not null in database . Set to - 1 if we must set data to null if empty ( '' or 0 ) .
* 'default' is a default value for creation ( can still be replaced by the global setup of default values )
* 'index' if we want an index in database .
* 'foreignkey' => 'tablename.field' if the field is a foreign key ( it is recommanded to name the field fk_ ... ) .
* 'position' is the sort order of field .
* 'searchall' is 1 if we want to search in this field when making a search from the quick search button .
* 'isameasure' must be set to 1 if you want to have a total on list for this field . Field type must be summable like integer or double ( 24 , 8 ) .
* 'css' is the CSS style to use on field . For example : 'maxwidth200'
* 'help' is a string visible as a tooltip on field
* 'comment' is not used . You can store here any text of your choice . It is not used by application .
* 'showoncombobox' if value of the field must be visible into the label of the combobox that list record
2021-04-29 12:10:55 +02:00
* 'arrayofkeyval' to set list of value if type is a list of predefined values . For example : array ( " 0 " => " Draft " , " 1 " => " Active " , " -1 " => " Cancel " )
2019-02-26 19:27:04 +01:00
*/
// BEGIN MODULEBUILDER PROPERTIES
/**
* @ var array Array with all fields and their property . Do not use it as a static var . It may be modified by constructor .
*/
2019-11-11 23:59:36 +01:00
public $fields = array (
2019-10-27 15:56:20 +01:00
'rowid' => array ( 'type' => 'integer' , 'label' => 'LineID' , 'enabled' => 1 , 'visible' =>- 1 , 'position' => 1 , 'notnull' => 1 , 'index' => 1 , 'comment' => " Id " ,),
2019-05-26 01:16:06 +02:00
'fk_bom' => array ( 'type' => 'integer:BillOfMaterials:societe/class/bom.class.php' , 'label' => 'BillOfMaterials' , 'enabled' => 1 , 'visible' => 1 , 'position' => 10 , 'notnull' => 1 , 'index' => 1 ,),
'fk_product' => array ( 'type' => 'integer:Product:product/class/product.class.php' , 'label' => 'Product' , 'enabled' => 1 , 'visible' => 1 , 'position' => 20 , 'notnull' => 1 , 'index' => 1 ,),
2021-08-20 13:37:28 +02:00
'fk_bom_child' => array ( 'type' => 'integer:BOM:bom/class/bom.class.php' , 'label' => 'BillOfMaterials' , 'enabled' => 1 , 'visible' =>- 1 , 'position' => 40 , 'notnull' =>- 1 ,),
2019-02-26 19:27:04 +01:00
'description' => array ( 'type' => 'text' , 'label' => 'Description' , 'enabled' => 1 , 'visible' =>- 1 , 'position' => 60 , 'notnull' =>- 1 ,),
2019-05-26 01:16:06 +02:00
'qty' => array ( 'type' => 'double(24,8)' , 'label' => 'Quantity' , 'enabled' => 1 , 'visible' => 1 , 'position' => 100 , 'notnull' => 1 , 'isameasure' => '1' ,),
2019-10-27 01:49:31 +02:00
'qty_frozen' => array ( 'type' => 'smallint' , 'label' => 'QuantityFrozen' , 'enabled' => 1 , 'visible' => 1 , 'default' => 0 , 'position' => 105 , 'css' => 'maxwidth50imp' , 'help' => 'QuantityConsumedInvariable' ),
2020-10-31 14:32:18 +01:00
'disable_stock_change' => array ( 'type' => 'smallint' , 'label' => 'DisableStockChange' , 'enabled' => 1 , 'visible' => 1 , 'default' => 0 , 'position' => 108 , 'css' => 'maxwidth50imp' , 'help' => 'DisableStockChangeHelp' ),
'efficiency' => array ( 'type' => 'double(24,8)' , 'label' => 'ManufacturingEfficiency' , 'enabled' => 1 , 'visible' => 0 , 'default' => 1 , 'position' => 110 , 'notnull' => 1 , 'css' => 'maxwidth50imp' , 'help' => 'ValueOfEfficiencyConsumedMeans' ),
2019-10-15 19:57:23 +02:00
'position' => array ( 'type' => 'integer' , 'label' => 'Rank' , 'enabled' => 1 , 'visible' => 0 , 'default' => 0 , 'position' => 200 , 'notnull' => 1 ,),
2019-02-26 19:27:04 +01:00
'import_key' => array ( 'type' => 'varchar(14)' , 'label' => 'ImportId' , 'enabled' => 1 , 'visible' =>- 2 , 'position' => 1000 , 'notnull' =>- 1 ,),
);
2020-11-24 21:28:57 +01:00
/**
* @ var int rowid
*/
2019-02-26 19:27:04 +01:00
public $rowid ;
2020-11-24 21:28:57 +01:00
/**
* @ var int fk_bom
*/
2019-05-26 01:06:19 +02:00
public $fk_bom ;
2020-11-24 21:28:57 +01:00
/**
* @ var int Id of product
*/
2019-05-26 01:06:19 +02:00
public $fk_product ;
2020-11-24 21:28:57 +01:00
2021-08-20 13:37:28 +02:00
/**
* @ var int Id of parent bom
*/
public $fk_bom_child ;
2020-11-24 21:28:57 +01:00
/**
* @ var string description
*/
2019-02-26 19:27:04 +01:00
public $description ;
public $qty ;
2020-11-24 21:28:57 +01:00
/**
* @ var int qty frozen
*/
2019-10-27 01:49:31 +02:00
public $qty_frozen ;
public $disable_stock_change ;
2019-05-26 01:06:19 +02:00
public $efficiency ;
2020-11-24 21:28:57 +01:00
/**
* @ var int position of line
*/
2019-07-09 00:14:01 +02:00
public $position ;
2020-11-24 21:28:57 +01:00
/**
* @ var string import key
*/
2019-05-26 01:06:19 +02:00
public $import_key ;
2019-02-26 19:27:04 +01:00
// END MODULEBUILDER PROPERTIES
2020-03-30 10:20:56 +02:00
/**
* @ var int Calculated cost for the BOM line
*/
public $total_cost = 0 ;
/**
* @ var int Line unit cost based on product cost price or pmp
*/
public $unit_cost = 0 ;
2019-02-26 19:27:04 +01:00
2022-02-09 15:55:21 +01:00
/**
* @ var Bom array of Bom in line
*/
public $childBom = array ();
2022-05-31 14:20:59 +02:00
2019-02-26 19:27:04 +01:00
/**
* Constructor
*
* @ param DoliDb $db Database handler
*/
public function __construct ( DoliDB $db )
{
2019-06-20 02:56:44 +02:00
global $conf , $langs ;
2019-02-26 19:27:04 +01:00
$this -> db = $db ;
2021-02-23 17:51:46 +01:00
if ( empty ( $conf -> global -> MAIN_SHOW_TECHNICAL_ID ) && isset ( $this -> fields [ 'rowid' ])) {
$this -> fields [ 'rowid' ][ 'visible' ] = 0 ;
}
if ( empty ( $conf -> multicompany -> enabled ) && isset ( $this -> fields [ 'entity' ])) {
$this -> fields [ 'entity' ][ 'enabled' ] = 0 ;
}
2019-02-26 19:27:04 +01:00
// Unset fields that are disabled
2021-02-23 17:51:46 +01:00
foreach ( $this -> fields as $key => $val ) {
if ( isset ( $val [ 'enabled' ]) && empty ( $val [ 'enabled' ])) {
2019-02-26 19:27:04 +01:00
unset ( $this -> fields [ $key ]);
}
}
// Translate some data of arrayofkeyval
2021-02-23 17:51:46 +01:00
foreach ( $this -> fields as $key => $val ) {
if ( ! empty ( $val [ 'arrayofkeyval' ]) && is_array ( $val [ 'arrayofkeyval' ])) {
foreach ( $val [ 'arrayofkeyval' ] as $key2 => $val2 ) {
2019-11-11 23:59:36 +01:00
$this -> fields [ $key ][ 'arrayofkeyval' ][ $key2 ] = $langs -> trans ( $val2 );
2019-02-26 19:27:04 +01:00
}
}
}
}
/**
* Create object into database
*
* @ param User $user User that creates
* @ param bool $notrigger false = launch triggers after , true = disable triggers
* @ return int < 0 if KO , Id of created object if OK
*/
public function create ( User $user , $notrigger = false )
{
2021-02-23 17:51:46 +01:00
if ( $this -> efficiency < 0 || $this -> efficiency > 1 ) {
$this -> efficiency = 1 ;
}
2019-06-13 14:20:13 +02:00
2019-02-26 19:27:04 +01:00
return $this -> createCommon ( $user , $notrigger );
}
/**
* Load object in memory from the database
*
* @ param int $id Id object
* @ param string $ref Ref
* @ return int < 0 if KO , 0 if not found , > 0 if OK
*/
public function fetch ( $id , $ref = null )
{
$result = $this -> fetchCommon ( $id , $ref );
2019-03-12 19:20:01 +01:00
//if ($result > 0 && ! empty($this->table_element_line)) $this->fetchLines();
2019-02-26 19:27:04 +01:00
return $result ;
}
/**
* Load list of objects in memory from the database .
*
* @ param string $sortorder Sort Order
* @ param string $sortfield Sort field
* @ param int $limit limit
* @ param int $offset Offset
* @ param array $filter Filter array . Example array ( 'field' => 'valueforlike' , 'customurl' =>... )
* @ param string $filtermode Filter mode ( AND or OR )
* @ return array | int int < 0 if KO , array of pages if OK
*/
public function fetchAll ( $sortorder = '' , $sortfield = '' , $limit = 0 , $offset = 0 , array $filter = array (), $filtermode = 'AND' )
{
global $conf ;
dol_syslog ( __METHOD__ , LOG_DEBUG );
2019-11-11 23:59:36 +01:00
$records = array ();
2019-02-26 19:27:04 +01:00
2019-06-03 18:11:53 +02:00
$sql = 'SELECT ' ;
$sql .= $this -> getFieldList ();
2019-11-11 23:59:36 +01:00
$sql .= ' FROM ' . MAIN_DB_PREFIX . $this -> table_element . ' as t' ;
2021-02-23 17:51:46 +01:00
if ( $this -> ismultientitymanaged ) {
$sql .= ' WHERE t.entity IN (' . getEntity ( $this -> table_element ) . ')' ;
} else {
$sql .= ' WHERE 1 = 1' ;
}
2019-02-26 19:27:04 +01:00
// Manage filter
$sqlwhere = array ();
if ( count ( $filter ) > 0 ) {
foreach ( $filter as $key => $value ) {
2019-11-11 23:59:36 +01:00
if ( $key == 't.rowid' ) {
2021-08-27 22:42:04 +02:00
$sqlwhere [] = $key . " = " . (( int ) $value );
2020-05-21 15:05:19 +02:00
} elseif ( strpos ( $key , 'date' ) !== false ) {
2021-08-27 22:42:04 +02:00
$sqlwhere [] = $key . " = ' " . $this -> db -> idate ( $value ) . " ' " ;
2020-05-21 15:05:19 +02:00
} elseif ( $key == 'customsql' ) {
2019-02-26 19:27:04 +01:00
$sqlwhere [] = $value ;
2020-05-21 15:05:19 +02:00
} else {
2021-08-27 22:42:04 +02:00
$sqlwhere [] = $key . " LIKE '% " . $this -> db -> escape ( $value ) . " %' " ;
2019-02-26 19:27:04 +01:00
}
}
}
if ( count ( $sqlwhere ) > 0 ) {
2021-09-02 13:58:42 +02:00
$sql .= ' AND (' . implode ( ' ' . $this -> db -> escape ( $filtermode ) . ' ' , $sqlwhere ) . ')' ;
2019-02-26 19:27:04 +01:00
}
if ( ! empty ( $sortfield )) {
$sql .= $this -> db -> order ( $sortfield , $sortorder );
}
if ( ! empty ( $limit )) {
2021-08-27 22:42:04 +02:00
$sql .= $this -> db -> plimit ( $limit , $offset );
2019-02-26 19:27:04 +01:00
}
$resql = $this -> db -> query ( $sql );
if ( $resql ) {
$num = $this -> db -> num_rows ( $resql );
2021-02-23 17:51:46 +01:00
while ( $obj = $this -> db -> fetch_object ( $resql )) {
2019-02-26 19:27:04 +01:00
$record = new self ( $this -> db );
2019-06-03 18:11:53 +02:00
$record -> setVarsFromFetchObj ( $obj );
2019-02-26 19:27:04 +01:00
$records [ $record -> id ] = $record ;
}
$this -> db -> free ( $resql );
return $records ;
} else {
2019-11-11 23:59:36 +01:00
$this -> errors [] = 'Error ' . $this -> db -> lasterror ();
dol_syslog ( __METHOD__ . ' ' . join ( ',' , $this -> errors ), LOG_ERR );
2019-02-26 19:27:04 +01:00
return - 1 ;
}
}
/**
* Update object into database
*
* @ param User $user User that modifies
* @ param bool $notrigger false = launch triggers after , true = disable triggers
* @ return int < 0 if KO , > 0 if OK
*/
public function update ( User $user , $notrigger = false )
{
2021-02-23 17:51:46 +01:00
if ( $this -> efficiency < 0 || $this -> efficiency > 1 ) {
$this -> efficiency = 1 ;
}
2019-06-13 14:20:13 +02:00
2019-02-26 19:27:04 +01:00
return $this -> updateCommon ( $user , $notrigger );
}
/**
* Delete object in database
*
* @ param User $user User that deletes
* @ param bool $notrigger false = launch triggers after , true = disable triggers
* @ return int < 0 if KO , > 0 if OK
*/
public function delete ( User $user , $notrigger = false )
{
return $this -> deleteCommon ( $user , $notrigger );
//return $this->deleteCommon($user, $notrigger, 1);
}
/**
* Return a link to the object card ( with optionaly the picto )
*
* @ param int $withpicto Include picto in link ( 0 = No picto , 1 = Include picto into link , 2 = Only picto )
* @ param string $option On what the link point to ( 'nolink' , ... )
2020-10-31 14:32:18 +01:00
* @ param int $notooltip 1 = Disable tooltip
* @ param string $morecss Add more css on link
* @ param int $save_lastsearch_value - 1 = Auto , 0 = No save of lastsearch_values when clicking , 1 = Save lastsearch_values whenclicking
* @ return string String with URL
*/
public function getNomUrl ( $withpicto = 0 , $option = '' , $notooltip = 0 , $morecss = '' , $save_lastsearch_value = - 1 )
{
global $db , $conf , $langs , $hookmanager ;
2021-02-23 17:51:46 +01:00
if ( ! empty ( $conf -> dol_no_mouse_hover )) {
$notooltip = 1 ; // Force disable tooltips
}
2020-10-31 14:32:18 +01:00
$result = '' ;
$label = '<u>' . $langs -> trans ( " BillOfMaterialsLine " ) . '</u>' ;
$label .= '<br>' ;
$label .= '<b>' . $langs -> trans ( 'Ref' ) . ':</b> ' . $this -> ref ;
2021-09-18 19:34:46 +02:00
$url = DOL_URL_ROOT . '/bom/bomline_card.php?id=' . $this -> id ;
2020-10-31 14:32:18 +01:00
2021-02-23 17:51:46 +01:00
if ( $option != 'nolink' ) {
2020-10-31 14:32:18 +01:00
// Add param to save lastsearch_values or not
$add_save_lastsearch_values = ( $save_lastsearch_value == 1 ? 1 : 0 );
2021-02-23 17:51:46 +01:00
if ( $save_lastsearch_value == - 1 && preg_match ( '/list\.php/' , $_SERVER [ " PHP_SELF " ])) {
$add_save_lastsearch_values = 1 ;
}
if ( $add_save_lastsearch_values ) {
$url .= '&save_lastsearch_values=1' ;
}
2020-10-31 14:32:18 +01:00
}
$linkclose = '' ;
2021-02-23 17:51:46 +01:00
if ( empty ( $notooltip )) {
if ( ! empty ( $conf -> global -> MAIN_OPTIMIZEFORTEXTBROWSER )) {
2020-10-31 14:32:18 +01:00
$label = $langs -> trans ( " ShowBillOfMaterialsLine " );
$linkclose .= ' alt="' . dol_escape_htmltag ( $label , 1 ) . '"' ;
}
$linkclose .= ' title="' . dol_escape_htmltag ( $label , 1 ) . '"' ;
$linkclose .= ' class="classfortooltip' . ( $morecss ? ' ' . $morecss : '' ) . '"' ;
2021-02-23 17:51:46 +01:00
} else {
$linkclose = ( $morecss ? ' class="' . $morecss . '"' : '' );
}
2019-02-26 19:27:04 +01:00
$linkstart = '<a href="' . $url . '"' ;
2019-11-11 23:59:36 +01:00
$linkstart .= $linkclose . '>' ;
$linkend = '</a>' ;
2019-02-26 19:27:04 +01:00
$result .= $linkstart ;
2021-02-23 17:51:46 +01:00
if ( $withpicto ) {
$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 );
}
if ( $withpicto != 2 ) {
$result .= $this -> ref ;
}
2019-02-26 19:27:04 +01:00
$result .= $linkend ;
//if ($withpicto != 2) $result.=(($addlabel && $this->label) ? $sep . dol_trunc($this->label, ($addlabel > 1 ? $addlabel : 0)) : '');
2019-11-11 23:59:36 +01:00
global $action , $hookmanager ;
2019-02-26 19:27:04 +01:00
$hookmanager -> initHooks ( array ( 'bomlinedao' ));
2021-11-22 19:57:26 +01:00
$parameters = array ( 'id' => $this -> id , 'getnomurl' => & $result );
2019-11-11 23:59:36 +01:00
$reshook = $hookmanager -> executeHooks ( 'getNomUrl' , $parameters , $this , $action ); // Note that $action and $object may have been modified by some hooks
2021-02-23 17:51:46 +01:00
if ( $reshook > 0 ) {
$result = $hookmanager -> resPrint ;
} else {
$result .= $hookmanager -> resPrint ;
}
2019-02-26 19:27:04 +01:00
return $result ;
2020-10-31 14:32:18 +01:00
}
2019-02-26 19:27:04 +01:00
/**
* Return label of the status
*
* @ param int $mode 0 = long label , 1 = short label , 2 = Picto + short label , 3 = Picto , 4 = Picto + long label , 5 = Short label + Picto , 6 = Long label + Picto
* @ return string Label of status
*/
public function getLibStatut ( $mode = 0 )
{
return $this -> LibStatut ( $this -> status , $mode );
}
2020-10-31 14:32:18 +01:00
// phpcs:disable PEAR.NamingConventions.ValidFunctionName.ScopeNotCamelCaps
2019-02-26 19:27:04 +01:00
/**
* Return the status
*
* @ param int $status Id status
* @ param int $mode 0 = long label , 1 = short label , 2 = Picto + short label , 3 = Picto , 4 = Picto + long label , 5 = Short label + Picto , 6 = Long label + Picto
* @ return string Label of status
*/
public function LibStatut ( $status , $mode = 0 )
{
// phpcs:enable
2019-10-27 01:49:31 +02:00
return '' ;
2019-02-26 19:27:04 +01:00
}
/**
* Load the info information in the object
*
* @ param int $id Id of object
* @ return void
*/
public function info ( $id )
{
$sql = 'SELECT rowid, date_creation as datec, tms as datem,' ;
2019-11-11 23:59:36 +01:00
$sql .= ' fk_user_creat, fk_user_modif' ;
$sql .= ' FROM ' . MAIN_DB_PREFIX . $this -> table_element . ' as t' ;
2021-03-14 11:48:39 +01:00
$sql .= ' WHERE t.rowid = ' . (( int ) $id );
2019-11-11 23:59:36 +01:00
$result = $this -> db -> query ( $sql );
2021-02-23 17:51:46 +01:00
if ( $result ) {
if ( $this -> db -> num_rows ( $result )) {
2019-02-26 19:27:04 +01:00
$obj = $this -> db -> fetch_object ( $result );
$this -> id = $obj -> rowid ;
2022-06-28 13:09:53 +02:00
$this -> user_creation_id = $obj -> fk_user_creat ;
$this -> user_modification_id = $obj -> fk_user_modif ;
2019-02-26 19:27:04 +01:00
$this -> date_creation = $this -> db -> jdate ( $obj -> datec );
2022-06-28 13:09:53 +02:00
$this -> date_modification = empty ( $obj -> datem ) ? '' : $this -> db -> jdate ( $obj -> datem );
2019-02-26 19:27:04 +01:00
}
$this -> db -> free ( $result );
2020-05-21 15:05:19 +02:00
} else {
2019-02-26 19:27:04 +01:00
dol_print_error ( $this -> db );
}
}
/**
* Initialise object with example values
* Id must be 0 if object instance is a specimen
*
* @ return void
*/
public function initAsSpecimen ()
{
$this -> initAsSpecimenCommon ();
}
}