Correspondance valeurs fk_status

sfeug · Septembre 25, 2020, 1:40

Bonjour,

Une petite question technique sur le module Ticket. Je fouille dans la REST API et dans la base de données et je butte sur le champs fk_statut tel que retrouvé dans la table llx_ticket et dans les points d’entrées /tickets/xxxxxx de l’API. Si je crois comprendre que ce champs indique la valeur du statut En cours ou En attente d’information du ticket, et que ces statut sont stockées sous forme d’entiers dans la base de données.

J’ai essayé de retrouver la « foreign key » correspondante, mais en reverse-engineerant la base, je ne trouve malheureusement pas de fk dans le schema. Le champs s’appelle bien fk_statut, mais point de clé étrangère dans PostgreSQL si je ne me trompe pas?

Je souhaiterais savoir où et comment je peux récupérer la liste complète des valeurs en entiers des différents statuts ainsi que leur correspondance sous forme de label, en anglais ou en français cela n’a pas d’importance.

Merci d’avance.

sfeug · Septembre 25, 2020, 3:01

J’ai partiellement la réponse, obtenue en déduisant les valeurs via les logs:

0 - non-lu
1 - lu
2 - assigné
3 - en cours
5 - en attente d’informations
7 - suspended
8 - cloturé
9 - annulé

Je ne cherche pas à savoir pourquoi il n’y a pas de statut 4.

Par contre j’aimerais toujours savoir où se situe la table désignée par la clé étrangère.

Merci d’avance.

sfeug · Septembre 25, 2020, 4:16

Mmmm après de premiers tests, je ne suis pas très sur de moi. Au secours!

yves57 · Septembre 28, 2020, 10:04

Bonjour,
La liste est définie en dur dans le code :

github.com

Dolibarr/dolibarr/blob/2e79064098f30ea6ade1d4e03d5d7a9f48b2e464/htdocs/ticket/class/ticket.class.php#L247


		'timing' => array('type'=>'varchar(20)', 'label'=>'Timing', 'visible'=>-1, 'enabled'=>1, 'position'=>42, 'notnull'=>-1, 'help'=>""),
		'datec' => array('type'=>'datetime', 'label'=>'DateCreation', 'visible'=>1, 'enabled'=>1, 'position'=>500, 'notnull'=>1),
		'date_read' => array('type'=>'datetime', 'label'=>'TicketReadOn', 'visible'=>1, 'enabled'=>1, 'position'=>501, 'notnull'=>1),
		'fk_user_assign' => array('type'=>'integer:User:user/class/user.class.php', 'label'=>'AssignedTo', 'visible'=>1, 'enabled'=>1, 'position'=>505, 'notnull'=>1),
		'date_close' => array('type'=>'datetime', 'label'=>'TicketCloseOn', 'visible'=>-1, 'enabled'=>1, 'position'=>510, 'notnull'=>1),
		'tms' => array('type'=>'timestamp', 'label'=>'DateModification', 'visible'=>-1, 'enabled'=>1, 'position'=>520, 'notnull'=>1),
		'message' => array('type'=>'text', 'label'=>'Message', 'visible'=>-2, 'enabled'=>1, 'position'=>540, 'notnull'=>-1,),
		'email_msgid' => array('type'=>'varchar(255)', 'label'=>'EmailMsgID', 'visible'=>-2, 'enabled'=>1, 'position'=>540, 'notnull'=>-1, 'help'=>'EmailMsgIDDesc'),
		'progress' => array('type'=>'varchar(100)', 'label'=>'Progression', 'visible'=>-1, 'enabled'=>1, 'position'=>540, 'notnull'=>-1, 'css'=>'right', 'help'=>"", 'isameasure'=>1),
		'resolution' => array('type'=>'integer', 'label'=>'Resolution', 'visible'=>-1, 'enabled'=>1, 'position'=>550, 'notnull'=>1),
		'fk_statut' => array('type'=>'integer', 'label'=>'Status', 'visible'=>1, 'enabled'=>1, 'position'=>600, 'notnull'=>1, 'index'=>1, 'arrayofkeyval'=>array(0 => 'Unread', 1 => 'Read', 3 => 'Answered', 4 => 'Assigned', 5 => 'InProgress', 6 => 'Waiting', 8 => 'Closed', 9 => 'Deleted')),
		'import_key' =>array('type'=>'varchar(14)', 'label'=>'ImportId', 'enabled'=>1, 'visible'=>-2, 'position'=>900),
	);
	// END MODULEBUILDER PROPERTIES


	/**
	 *  Constructor
	 *
	 *  @param DoliDb $db Database handler
	 */

et avec la traduction :

github.com

Dolibarr/dolibarr/blob/2e79064098f30ea6ade1d4e03d5d7a9f48b2e464/htdocs/langs/fr_FR/ticket.lang#L62-72


MenuListNonClosed=Tickets ouverts

TypeContact_ticket_internal_CONTRIBUTOR=Contributeur
TypeContact_ticket_internal_SUPPORTTEC=Utilisateur assigné
TypeContact_ticket_external_SUPPORTCLI=Contact client / suivi des tickets
TypeContact_ticket_external_CONTRIBUTOR=Contributeur externe

OriginEmail=E-mail source
Notify_TICKET_SENTBYMAIL=Envoi d'un message du ticket par e-mail

# Status
NotRead=Non lu
Read=Lu
Assigned=Assigné
InProgress=En cours
NeedMoreInformation=Attente d'information
Answered=Répondu
Waiting=En attente
Closed=Fermé
Deleted=Supprimé

sfeug · Septembre 28, 2020, 10:15

Merci @yves57 , j’ai essayé de chercher ce type d’information mais n’y étais pas parvenu. Après, pourquoi le champs est nommé fk_, honnêtement m’a l’air un peu louche et çà prête à confusion…

yves57 · Septembre 29, 2020, 6:40

Je pense que c’est pour indiquer que c’est un code, et non le statut lui même. Et non, ce n’est pas une « foreign key ».