myfab Tools

• Règle générale
• Gestion de fichier
• Gestion FTP / SFTP / FTS TLS
• Impressions Jasper
• Création/Manipulation de fichier XML
• Traitement BL mf_do_partial_picking

Règle générale

Globalement, et pour chaque méthode utilisable et présente dans myfab Tools, il faut passer par une instance du modèle mf.tool pour pouvoir appeler et utiliser ces méthodes. Par exemple :

self.env["mf.tools"].mf_get_file_name_extension(file_to_convert_name)

Dans le cas où il y a besoin d'utiliser plusieurs fois les "tools" dans la même méthode ou la même action serveur, on peut mettre l'instance dans une variable. Par exemple :

tools = self.env["mf.tools"]

if self.mf_protocol == "ftp":

    return tools.mf_login_to_ftp(mf_ftp_adress,mf_login,mf_password)

elif self.mf_protocol == "sftp":

    return tools.mf_login_to_sftp(mf_ftp_adress,mf_login,mf_password

Les pages suivantes présentent des exemples d'utilisation des différents outils mis à disposition dans le module myfab Tools.

Gestion de fichier

Le tableau ci-dessous reprend les différentes méthodes utilisables, avec un exemple et une description ainsi que les données d'entrée et de sortie attendues.

Exemple action serveur pour imprimer un BL dans un fichier (avec le modèle jasper ayant l'ID=100)

Gestion FTP / SFTP / FTS TLS

1. Protocole FTP Standard

Toutes les méthodes FTP fonctionnent globalement sur le même principe, aussi seules les méthodes pour le FTP standard sont explicitées ci-dessous.

Exemple d'utilisation d'une connexion FTP :

ftp = tools.mf_login_to_ftp(adress,login,password)

tools.mf_ftp_move_to_folder(ftp,folder)

tools.mf_send_file_to_ftp(ftp, str(self.number)+".csv",True)

2. Protocole FTP TLS

Le protocole FTP TLS utilise les mêmes méthodes que le FTP standard sauf pour le login :

mf_login_to_ftp_tls(ftp_adress,login,password)

3. Protocole SFTP

Variantes de méthodes propres au protocole SFTP :

• mf_login_to_sftp(sftp_adress,login,password)
• mf_sftp_move_to_folder(sftp,folder)
• mf_send_file_to_sftp(sftp,file_name,delete)
• mf_sftp_get_all_files(sftp,delete)
• mf_sftp_get_file_by_name(sftp,file_name, delete)
  

Impressions Jasper

Via la méthode ci-dessous, on peut manipuler l'impression de documents Jasper :

Combiné avec la méthode de sauvegarde de fichier ci-dessus on peut créer un fichier pdf sur le serveur local. Exemple d'utilisation :

report_file, report_format, model_report =

tools.mf_print_report(config.mf_invoice_report_to_print,invoice)

tools.save_file(invoice.number.replace("/","_")+".pdf",report_file)

Exemple action serveur pour imprimer un BL dans un fichier (avec le modèle jasper ayant l'ID=100)

Création/Manipulation de fichier XML

Les méthodes suivantes permette de créer et manipuler les fichiers XML . Cela peut par exemple servir pour exporter un fichier XML à partir de données d'Open-Prod depuis une action serveur par exemple.

Exemple : dans une action serveur

tools = env['mf.tools']
etree = tools.mf_get_lxml_libary().etree

data_xml_de_base="""<?xml version="1.0" encoding="utf-8"?>
<ProcessMaterialInformation>
	<ApplicationArea>
        <Sender>
            <LogicalID>OPP</LogicalID>
        </Sender>
        <Receiver>
            <ID>QUBES</ID>
        </Receiver>
        <CreationDateTime>2010-07-22T11:20:33</CreationDateTime>
	</ApplicationArea>
    <DataArea>
		<Process>
		</Process>
		<MaterialInformation>
			<ID>ItemsDefinition</ID>
			<Description>Material classes and material definitions for all the items</Description>
			<PublishedDate>2010-07-22T11:20:33</PublishedDate>
		</MaterialInformation>
	</DataArea>
</ProcessMaterialInformation>
"""


xml=etree.fromstring(data_xml_de_base)
#incrément auto à chaque export  : sequence code ITEM_QUBES
res=env['ir.sequence'].next_by_code('ITEM_QUBES')
BODID=etree.SubElement(xml,'BODID') # crée balise BODID dans la balise root du xml
tools.lxml_element_set_text(BODID,res) #affecte valeur texte à la balise créé

#Ajoute une balise article pour chaque produit en vie avec une sous balise id et description
MaterialInformations= xml.xpath("//MaterialInformation")
article_rcs=env['product.product'].search([('state','=','lifeserie')])
for MaterialInformation in MaterialInformations:
    for article_rc in article_rcs: 
        #  créer une sous balise MaterialDefinition dans MaterialInformation
        MaterialDefinition=etree.SubElement(MaterialInformation,'MaterialDefinition')# crée balise MaterialDefinition
        #  Créer balise ID avec la valeur -> code
        codep=etree.SubElement(MaterialDefinition,'ID')
        tools.lxml_element_set_text(codep,article_rc.code)
        #   Créer balise Description avec la valeur -> name
        codep=etree.SubElement(MaterialDefinition,'Description')
        tools.lxml_element_set_text(codep,article_rc.name)
#Récupère le contenu en texte
file_content=etree.tostring(xml)
#sauvegarde le text dans fichier sur le serveur
env['mf.tools'].save_file("/home/openprod/Documents/toto.xml",file_content)
#affiche le contenu
#raise Warning(etree.tostring(xml))

Traitement BL mf_do_partial_picking

Cette méthode permet de traite un picking en précisant les ids des lignes à traiter ainsi que les quantités pour chaque ligne. Les lignes de mouvements du picking qui ne seront forcées avec une quantité à 0. 

URL : {{url serveur}} /web/api/endpoint
{
"db":{{base}},
"token":{{token}},
"model":"mf.tools",
"method": "call_kw",
"call_method": "mf_do_partial_picking",
"args":[],
"kwargs":[["picking_id",68],["move_ids",[614,615]],["qtys",[5,3]]]
}