Què fa el botó «Run Query» de Temu Connector for Odoo

Quan apareix i qui hi arriba

El botó Run Query és a la pantalla Research Queries. La condició de la vista no l'amaga: a Odoo 17, 18 i 19 es veu sempre. El que ho limita és el camí fins a la pantalla: les fitxes s'obren des del menú Temu › Market Intelligence › Market Research, i els trams Market Intelligence i Market Research demanen el permís Temu Research & DSA. Si no el tens, no veus aquest tram del menú.

Amb Odoo en català, el botó es diu Run Query.

Un cas per veure'l funcionar

Exemple Cas il·lustratiu: l'empresa i les seves dades són inventades per explicar el flux.

Casa Alba Textil és una botiga inventada que ven a Temu i vol consultar la biblioteca d'anuncis. La Marta, que porta el comerç electrònic i té el permís Temu Research & DSA, entra a Temu › Market Intelligence › Market Research i obre una consulta a Research Queries. Al grup Ads Library Params deixa Ads Query Type a Product Name i prem Run Query.

Primer intent: Odoo li mostra Research & DSA UI is currently disabled for this Odoo database. Enable it from the Temu instance before using this option. És el primer que comprova el botó, abans de tocar la consulta, així que l'execució s'atura i no es desa res.

Segon intent: amb la funció ja habilitada des de la instància, la Marta torna a prémer. Ara el botó continua, demana les dades a Temu i, en acabar, la consulta queda com a realitzada.

Què fa el botó, per ordre

1. Comprova que la funció de recerca estigui habilitada a la instància de Temu de la consulta. Si no ho està, para amb el missatge del cas.
2. Comprova el mode d'accés de la consulta: aquesta operació fa servir l'API de Temu i només admet l'accés públic de recerca de l'article 40(12).
3. Segons el tipus de consulta, exigeix unes dades: per a SOR, les dates d'inici i de fi de la sol·licitud; per a informació de la botiga i per a productes de la botiga, el nom de la botiga i el codi de país; per a opinions de producte, aquests dos i l'identificador del producte. La consulta de biblioteca d'anuncis no en demana cap.
4. Demana les dades a Temu i n'extreu les files de la resposta.
5. Si tot ha anat bé, marca la consulta com a realitzada i desa el resultat (secció següent).

Què canvia en acabar

Quan la consulta acaba bé, el botó deixa la consulta com a realitzada i desa el mètode utilitzat amb els paràmetres enviats, la resposta de Temu, el nombre de resultats i la data i hora de l'última execució. També esborra el text d'error anterior. El nombre de resultats és el de files de la resposta; en els tipus que no són biblioteca d'anuncis, si no hi ha llista de files però la resposta porta contingut, en compta un.

Si alguna cosa falla dins de la consulta, el botó la deixa en estat d'error, desa el text de l'error i la data de l'última execució, i torna a llançar l'error perquè el vegis.

Biblioteca d'anuncis: diverses pàgines amb una sola pulsació

Aquest tipus de consulta té el seu propi recorregut. Entre els seus paràmetres, a la fitxa de Research Queries, grup Ads Library Params, hi ha aquests:

• Ads Query Type, amb els valors Product Name, Advertiser i Ad Payer; per defecte el codi fa servir Product Name.
• Category.
• Ad Publish Start Ts, l'ajuda del qual diu: «Milliseconds timestamp for ads library start filter.».
• Ad Publish End Ts, l'ajuda del qual diu: «Milliseconds timestamp for ads library end filter.».

Al executar, si la consulta no porta identificadors de llista i de cerca, el botó en genera i els desa a la consulta. Si l'idioma és buit fa servir l'anglès; el número de pàgina mínim és u; la mida de pàgina és vint si no s'indica i mai passa de cinquanta.

Si la consulta està marcada per portar totes les pàgines, el botó repeteix la petició pàgina a pàgina; si no, es queda a la primera. S'atura en arribar al màxim de pàgines de la instància (vint si no té valor), en rebre una pàgina buida, en assolir el total que informa Temu, quan la resposta indica que no hi ha més pàgines o, si no indica res, quan arriba una pàgina amb menys files que la mida de pàgina. Al final desa un resum amb les pàgines demanades, el motiu d'aturada, el total de files reunides i els mètodes utilitzats.

Què treure del cas

• El missatge de recerca desactivada no parla de la teva consulta: surt abans de revisar-ne res i no canvia res.
• El botó no s'amaga (a Odoo 17, 18 i 19); el que decideix si hi arribes és el permís Temu Research & DSA.
• Abans de prémer en una consulta de biblioteca d'anuncis, revisa els camps del grup Ads Library Params, entre ells Ads Query Type, Category i els dos de marca de temps, perquè acoten el que es demana.
• Per llançar la consulta de nou n'hi ha prou de tornar a prémer el botó; cada execució bona sobreescriu el resultat desat i esborra l'error anterior.

Com ajuda FlexigoTech

FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida. Si vols veure el mòdul, és a la seva pàgina de flexigotech.com.

Continua llegint

Comprovat al codi del connector (versió 19.0) i a les fonts enllaçades

Fonts

• Codi del mòdul: flexigobe_temu_connector 19.0 (455b3f0f): views/temu_ads_views.xml
• Codi del mòdul: flexigobe_temu_connector 19.0 (455b3f0f): models/temu_ads.py
• flexigotech.com/en/services.html