Différences

Ci-dessous, les différences entre deux révisions de la page.

--- dev:api:python:db_common [2017/09/11 09:05]
florian
+++ dev:api:python:db_common [2023/06/13 13:46] (Version actuelle)
florian [Exemples]
@@ Ligne 3: / Ligne 3: @@
 ===== dbgenericselectindict =====
-Fonction générique de sélection d'enregistrements d'une table. Retourne un dictionnaire indexé selon la valeur d'un champ choisi.
+generic function to select multiple records and return them in a dict
+>>> ret=db_common.dbgenericselectindict(session,"test","test_id",["fld1","fld2","fldx"],"fld","A","fld2","D","fld2",2,">")
+Execute query : select fld1,fld2,fldx,test_id from test where fld2 > 2 order by fldx ASC, fld2 DESC; and put results in a dict
+>>> print ret
+[8 :["fld1" : "foo", "fld2" : 4, "fldx" : "bar"],9 :["fld1" : "foox", "fld2" : 3, "fldx" : "cbar"],....] keys 8,9 are test_id values
 ==== Paramètres ====
@@ Ligne 9: / Ligne 14: @@
 ^ Paramètre ^ Type ^ Default ^ Description ^
 | **usession** | session  | None | NCHP Session  |
-| **itbl** | string  | None | Nom de la table à interroger  |
+| **itbl** | string  | None | table to fetch  |
-| **ifldkey** | string  | None | Nom du champ dont les valeurs seront les clés du dictionnaire  |
+| **ifldkey** | string  | None | fields that wil be key for return dict  |
-| **iflds** | list  | None | Une liste de noms de champs à sélectionner  |
+| **iflds** | list  | None | fields to put values in  |
-| **iorder** | string  | None | Nom du champ pour la clause ORDER  |
+| **iorder** | string  | None | Field for default sort  |
-| **isens** | "A" or "D"  | A | Sens du tri (A pour ascendat, D pour descendant)  |
+| **isens** | "A" or "D"  | A | sort ascendant or descendant  |
 | **iorderother** | string  |  | optional second sort  |
 | **isensother** | "A" or "D"  | A | sort ascendant or descendant for second sort  |
@@ Ligne 26: / Ligne 31: @@
 | **ifldcondval3** |  |  |  |
 | **ifldop3** |  | = |  |
+==== Retour ====
+^ Type de retour ^ Valeur de retour ^
+| dict  | dictionary containing recordset |
 {{:wiki:icons:info.png}} Ne vous fiez pas aux paramètres d'ordre car le résultat étant un dictionnaire, l'ordre des clés/valeurs dans un dictionnaire en Python est arbitraire (et vous ne pourrez pas le connaitre).
@@ Ligne 43: / Ligne 54: @@
 </code>
+===== dbgenericselect =====
+generic function to fetch record in a system table on a primary key
+>>> ret=db_common.dbgenericselect(session,"test",32,"fld1","fld2","fldx")
+Execute query : select fld1,fld2,fldx from test where test_id=32;
+==== Paramètres ====
+^ Paramètre ^ Type ^ Default ^ Description ^
+| **usession** | session  | None | NCHP Session  |
+| **itbl** | string  | None | table to fetch  |
+| **iidval** | long  | None | Primary Key of record to get  |
+| **itblfld** | string multiple  | None | fields to get  |
+==== Retour ====
+^ Type de retour ^ Valeur de retour ^
+| list,description  | row selected , description of fields (datatype etc) : see description in db modules (db_mysql,db_postgres etc....) |
+===== dbgenericgetvalue =====
+Retourne la valeur de la colonne souhaitée du premier enregistrement qui satisfait les filtres.
+==== Paramètres ====
+^ Paramètre ^ Type ^ Default ^ Description ^
+| **usession** | session  | None | NCHP Session  |
+| **itbl** | string  | None | La table source  |
+| **ifldkey** | string  | None | Nom de la première colonne filtre (obligatoire)  |
+| **ifldkeyval** | value  | None | Valeur du premier filtre  |
+| **ifldtoreturn** | string  | None | Nom de la colonne dont on veut obtenir la valeur  |
+| **ifldkey2** | string  |  | Nom de la deuxième colonne filtre  |
+| **ifldkeyval2** | value  |  | Valeur du deuxième filtre                   |
+| **ifldkey3** | string   |  | Nom de la troisième colonne filtre |
+| **ifldkeyval3** | value   |  | Valeur du troisième filtre |
+| **ifldkey4** | string   |  | Nom de la quatrième colonne filtre |
+| **ifldkeyval4** | value   |  | Valeur du quatrième filtre |
+==== Retour ====
+^ Type de retour ^ Valeur de retour ^
+|  | La valeur trouvée ou None |
+==== Exemples ====
+Par exemple si l'on veut obtenir le nom du client dont le numéro est 1005:
+<code python>
+nomclient = db_common.dbgenericgetvalue(
+	usession = gses,
+	itbl = "facture",
+	ifldkey = "CLIENT_NUM",
+	ifldkeyval = 1005,
+	ifldkey2 = "CLIENT_SOCIETE",
+	ifldkeyval2 = "MASOCIETE",
+	ifldtoreturn = "CLIENT_NOM"
+)
+</code>

EzGED Wiki

Outils pour utilisateurs

Outils du site

Différences

Outils de la page