Trovaprodotti Core: differenze tra le versioni

Da Webmobili Wiki.
← Differenza precedente
 
(38 versioni intermedie di uno stesso utente non sono mostrate)
Riga 1: Riga 1:
Il negozio dalla sua backoffice ClientAdmin avrà la possibilità di creare un '''prodotto a Catalogo''' valido solo per il suo Trovaprodotti oppure un '''prodotto Occasione''' che potrà essere visibile su ''DesignbestOutlet'', ''Commerce'' e ''Trovaprodotti''.<br/>
Il negozio dalla sua backoffice ClientAdmin avrà la possibilità di creare un '''prodotto a Catalogo''' valido solo per il suo Trovaprodotti oppure un '''prodotto Occasione''' che potrà essere visibile su ''DesignbestOutlet'', ''Commerce'' e ''Trovaprodotti''.<br/>
Il negozio potrà aggiungere suoi ''Manufacturer'' e proprie ''Tipologie''.
Il negozio potrà  
* aggiungere propri ''Manufacturer''
* aggiungere propri ''Ambienti''
* aggiungere proprie ''Tipologie'' nei nuovi ambienti o in ambienti già esistenti




== Manufacturer Custom ==
== Manufacturer Custom ==
Il negozio potrà inserire i propri Marchi specificando: ''Nome'', ''Immagine/Logo'' e se sarà in ''evidenza'' nella pagine di elenco dei Marchi.
Il negozio potrà inserire i propri Marchi specificando: ''Nome'', ''Immagine/Logo'' e se sarà in ''evidenza'' nella pagine di elenco dei Marchi.<br/>
L'immagine non sarà obbligatoria se il manufacturer nuovo verrà assegnato solo ad occasioni. Se invece verrà assegnato a prodotti a catalogo custom, il suo logo apparirà nel listing dei brand.


== Category Custom ==
Il negozio potrà inserire '''tipologie proprie''' specificando: ''Nome tipo'' e ''Ambiente'' di appartenenza (che può essere a sua volta custom o esistente).


Tabelle coinvolte:
* <code>TP_Manufacturer</code>
* <code>TP_Map_TPProduct_TPManufacturer</code>
* <code>TP_Map_Product_TPManufacturer</code>
* <code>TP_Manufacturer_InEvidence</code>


=== TP_Manufacturer ===
== Strategia di Estensione Contestuale ==
Manufacturer Custom relativi al Trovaprodotti del negozio.
Per evitare di creare delle logiche circostanziali, poco elastiche e di elevata manutenzione abbiamo deciso di adottare un '''paradigma simile all'estensione delle classi''' nella programmazione ad oggetti.<br/><br/>


In pratica ''estendiamo le tabelle'' esistenti, cioè ne creiamo una copia che abbia un campo <code>Context</code> che identifichi il contesto di appartenenza (es. un Trovaprodotti specifico).<br/>
Il '''contesto''' rappresenta l'unione delle due tabelle (<code>normale + nomale_ext</code>) come se fossero un'unica tabella integrata nelle logiche Core.<br/>
Questa ''unione'' viene implementata tramite una '''scalar function''' che prende in input il ''contesto''.<br/><br/>


=== TP_Map_TPProduct_TPManufacturer ===
=== Esempio Pratico ===
Mapping tra Prodotti Custom e Manufacturer Custom del negozio.
volendo aggiungere nuovi Manufacturer solo per il Trovaprodotti di <code>PincoPallino (id 1111)</code>,<br/>
basterà utilizzare una funzione <code>ManufacturerExt(1111) AS Manufacturer</code> e fare le query come se ci trovassimo nel pool di Designbest.<br/><br/>


=== TP_Map_Product_TPManufacturer ===
In questo caso <code>ManufacturerExt(1111)</code> rappresenta la somma di tutti i '''manufacturer di Designbest + quelli custom''' che sono stati aggiunti dal '''contesto n° 1111'''
Mapping tra Prodotti Occasione e Manufacturer Custom del negozio.
<syntaxhighlight lang="sql">
ManufacturerExt(1111)  =


=== TP_Manufacturer_InEvidence ===
SELECT Campo1, Campo2, Campo3, 1 AS Core FROM Manufacturer
Manufacturer Designbest che il negozio vuole mettere in evidenza nella pagina Marchi.
UNION
SELECT Campo1, Campo2, Campo3, 0 AS Core FROM Manufacturer_Ext WHERE Context = 1111
</syntaxhighlight>


== Category Custom ==
<code>ManufacturerExt(1111)</code> , tramite il campo <code>@Core</code> è in grado di sapere se si trova nel contesto specifico oppure nel core Designbest.
Il negozio potrà inserire '''tipologie proprie''' specificando: ''Nome tipo'' e ''Ambiente'' di appartenenza (che può essere a sua volta custom o esistente).<br/><br/>
 
==== Ambiguità degli ID ====
A causa dell''''ambiguità degli ID''' (i nuovi possono collidere con quelli del core, non c'è univocità),<br/>
ad ogni <code>JOIN</code> con le tabelle ''Ext'' è necessario specificare il parametro <code>@Core</code> per specificare se si tratta di record custom del contesto oppure di record di Designbest.<br/><br/>
 
Nel caso di una '''GET dei Manufacturer''', i recordset avranno sempre il campo <code>@Core</code> che indica se il manu in questione è di Designbest o un custom manu del contesto corrente.<br/>
In questo modo il frontend sarà in grado di mostrare la scheda prodotto con la coppia <code>@ID INT, @Core BIT</code>.
<syntaxhighlight lang="sql">
SELECT Nome, SeoNome, Descrizione, Core
FROM ManufacturerExt(1111) AS Manufacturer
</syntaxhighlight>
Per ogni riga di risultato, l'applicativo sa se il prodotto è del contesto (<code>Core = 0</code>) o di Designbest (<code>Core = 1</code>)
<br/>


Tabelle coinvolte:
Nel caso di un '''FILTRO dei Manufacturer''', nella <code>WHERE</code> è sempre necessario specificare se stiamo cercando tra i custom record del contesto o in Designbest specificando il parametro <code>Core</code>
* <code>TP_Category</code>
<syntaxhighlight lang="sql">
* <code>TP_Map_TPProduct_TPCategory</code>
SELECT Nome, SeoNome, Descrizione, Core
* <code>TP_CategoryRename</code>
FROM ManufacturerExt(1111) AS Manufacturer
* <code>TP_CategoryHide</code>
WHERE Manufacturer.ID = 275 AND Manufacturer.Core = @FromCore
* <code>TP_CategorySort</code>
</syntaxhighlight>
Necessario il parametro booleano <code>@FromCore</code> per suggerire di cercare dentro i custom record del contesto o dentro al core Designbest<br/><br/>


== Prodotti a Catalogo ==
=== Tabelle estese ===
Prodotto nuovo creato dal negozio e visibile tra i prodotti a catalogo solamente sul suo Trovaprodotti.<br/>
Al momento, per '''Trovaprodotti''' abbiamo esteso le seguenti tabelle
Il Nuovo prodotto potrà essere aggiunto ad un ''catalogo'' ed ad una ''tipologia'' esistenti su Designbest oppure associato ad un ''custom Manu'' e/o una ''custom tipologia''.


Tabelle coinvolte:
<table class="wikitable sortable">
* <code>TP_Product</code>
  <tr>
* <code>TP_ProductCulture</code>
    <th>Tabella estesa</th>
* <code>TP_CustomPrice_Product</code>
    <th>Funzione di unione</th>
  </tr>
  <tr>
    <td><code>Product_Ext</code></td>
    <td rowspan="2"><code>ProductExt(@ContextID INT, @LanguageID INT = 1)</code></td>
  </tr>
  <tr>
    <td><code>ProductCulture_Ext</code></td>
   
  </tr>
  <tr>
    <td><code>ProductThumbs_Ext</code></td>
    <td><code>ProductThumbsExt(@ContextID INT, @LanguageID INT = 1)</code></td>
  </tr>
  <tr>
    <td><code>Manufacturer_Ext</code></td>
    <td><code>ManufacturerExt(@ContextID INT)</code></td>
  </tr>
  <tr>
    <td><code>Mapping_ShopPoint_Manufacturer_Ext</code></td>
    <td><code>Mapping_ShopPoint_ManufacturerExt(@ContextID INT)</code></td>
  </tr>
  <tr>
    <td><code>Category_Ext</code></td>
    <td><code>CategoryExt(@ContextID INT)</code></td>
  </tr>
  <tr>
    <td><code>LocalizedProperty_Ext</code></td>
    <td><code>LocalizedPropertyExt(@ContextID INT, @LocaleKeyGroup NVARCHAR(100), @LocaleKey NVARCHAR(100), @LanguageID INT = 1)</code></td>
  </tr>
  <tr>
    <td><code>Picture_Ext</code></td>
    <td><code>PictureExt(@ContextID INT, @LocaleKeyGroup NVARCHAR(100), @LocaleKey NVARCHAR(100))</code></td>
  </tr>
  <tr>
    <td><code>FT_Products_IT_Ext</code></td>
    <td><code>FT_Products_ItExt(@ContextID INT)</code></td>
  </tr>
  <tr>
    <td><code>FT_Products_EN_Ext</code></td>
    <td><code>FT_Products_EnExt(@ContextID INT)</code></td>
  </tr>
  <tr>
    <td><code>FT_Products_FR_Ext</code></td>
    <td><code>FT_Products_FrExt(@ContextID INT)</code></td>
  </tr>
  <tr>
    <td><code>FT_Products_DE_Ext</code></td>
    <td><code>FT_Products_DeExt(@ContextID INT)</code></td>
  </tr>
</table>


=== TP_Product ===
Il campo ''ManufacturerId'' corrisponde al Manu su Designbest.<br/>
Nel caso di '''Manu Custom''' questo valore deve essere uguale al '''ManuId 4212''' che corrisponde al display name '''Xtra Catalogo''' e SEO '''custom_manufacturer''' e bisognerà settare il mapping nella tabella <code>TP_Map_TPProduct_TPManufacturer</code>.<br/><br/>
Il campo ''CategoryId'' corrisponde alla Category su Designbest.<br/>
Nel caso di Tipologia Custom bisogna creare anche un Ambiente Custom nella tabella <code>TP_Category</code> e mapparla al prodotto in <code>TP_Map_TPProduct_TPCategory</code>.


Note:
=== Estensione delle picture ===
* le 2 tabelle sopra sono pronte per il ''multi-culture'', ma la UI permette solo di inserire IT;
La tabella <code>Picture_Ext</code> permette di estendere le immagini, ma il folder del file system è unico per tutte (core e non),<br/>
* possibilità di inserimento ''Prezzo'' oppure una ''Price Notes'' ad esempio ''"A partire da ..."'';
perciò non possiamo mantenere lo stesso schema di generazione dei nomi.<br/>
* associando al prodotto una Tipologia Custom sarà necessario anche associare una Tipologia Designbest (il prodotto si vedrà in entrambe le tipologie);
Quando creiamo una nuova picture per
* possibilità di nascondere ambienti e tipologie;
* Prodotto custom
* possibilità di ordinare ambienti e tipologie;
* Category custom
* possibilità di rinominare ambienti e tipologie;
* Manufacturer custom
è necessario ricordarsi che nel campo <code>Picture.EntityValue</code> bisogna mettere
* <code>productext-<contextid></code>
* <code>categoryext-<contextid></code>
* <code>manufacturerext-<contextid></code>


== Prodotti Occasione ==
== Struttura delle url ==
Ecco una ipotesi<br/>
HOMEPAGE
* <code>/it/44334</code> - ''hp''


LISTING DA AMBIENTE
* <code>/it/44334/catalog/ambient-16_1</code> - ''ambiente'' obbligatorio
* <code>/it/44334/catalog/ambient-16_1/type-48_1</code> - ''ambiente/tipo''
* <code>/it/44334/catalog/ambient-16_1/brand-275_1</code> - ''ambiente/manu''
* <code>/it/44334/catalog/ambient-16_1/type-48_1/brand-275_1</code> - ''ambiente/tipo/manu''


== Prodotti Custom ==
LISTING DA MANU
Il progetto permette ai rivenditori di
* <code>/it/44334/brands</code>
* Creare '''manufacturer custom'''
* <code>/it/44334/brand-275_1</code> - ''manu''
* Creare '''ambienti e tipologie custom''', con possibilità di creare una ''tipologia custom sotto un ambiente già esistente''
* <code>/it/44334/brand-275_1/ambient-16_1</code> - ''manu/ambiente''
* Creare '''prodotti custom''' che possono avere ambiente/tipologia/manufacturer standard oppure tra quelli custom appena creati.
* <code>/it/44334/brand-275_1/ambient-16_1/type-48_1</code> - ''manu/ambiente/tipo (duplicata)''


=== Listing Prodotti ===
LISTING NEWS
Il listing dei prodotti che fanno parte del core Designbest è gestito a basso livello dalla Stored Procedure <code>TP_ProductList</code> e gestisce i '''caso standard''' nei quali i parametri ''ambiente'', ''tipologia'' e ''manufacturer'' sono tutti del core Designbest.<br/><br/>
* <code>/it/44334/news</code>
* <code>/it/44334/news/ambient-16_1</code>
* <code>/it/44334/news/brand-275_1</code>
* <code>/it/44334/news/ambient-16_1/brand-275_1</code>


Per quanto riguarda i '''prodotti custom''', devono essere recuperati a parte e integrati dentro al listing standard.<br/>
LISTING SEARCH
La Stored Procedure che se ne occupa è <code>TP_CustomProductList</code><br/>
* <code>/it/44334/search</code>
Si distinguono ''5 casi'':
# <code>(ambiente, tipologia, manu)Designbest</code>
# <code>(ambiente, manu)Designbest + (tipologia)Custom</code>
# <code>(ambiente)Designbest + (tipologia, manu)Custom</code>
# <code>(manu)Designbest + (ambiente, tipologia)Custom</code>
# <code>(ambiente, tipologia, manu)Custom</code>
<br/><br/>
<table class="wikitable">
  <tr>
    <th>1</th>
    <th>2</th>
    <th>3</th>
    <th>4</th>
    <th>5</th>
  </tr>


  <tr>
LISTING OCCASIONI
    <td>
* <code>/it/44334/offers</code> - ''tutte''
<pre>
* <code>/it/44334/offers/ambient-16_1</code> - ''ambiente''
AMB  Db
* <code>/it/44334/offers/ambient-16_1/type-48_1</code> - ''ambiente/tipo''
TYPE Db
* <code>/it/44334/offers/ambient-16_1/brand-275_1</code> - ''ambiente/manu''
MANU Db
* <code>/it/44334/offers/ambient-16_1/type-48_1/brand-275_1</code> - ''ambiente/tipo/manu''
</pre>
    </td>
    <td>
<pre>
AMB  Db
TYPE Cus
MANU Db
</pre>
    </td>
    <td>
<pre>
AMB  Db
TYPE Cus
MANU Cus
</pre>
    </td>
    <td>
<pre>
AMB  Cus
TYPE Cus
MANU Db
</pre>
    </td>
    <td>
<pre>
AMB  Cus
TYPE Cus
MANU Cus
</pre>
    </td>
  </tr>
</table>

Versione attuale delle 08:06, 28 giu 2023

Il negozio dalla sua backoffice ClientAdmin avrà la possibilità di creare un prodotto a Catalogo valido solo per il suo Trovaprodotti oppure un prodotto Occasione che potrà essere visibile su DesignbestOutlet, Commerce e Trovaprodotti.
Il negozio potrà

  • aggiungere propri Manufacturer
  • aggiungere propri Ambienti
  • aggiungere proprie Tipologie nei nuovi ambienti o in ambienti già esistenti


Manufacturer Custom

[modifica]

Il negozio potrà inserire i propri Marchi specificando: Nome, Immagine/Logo e se sarà in evidenza nella pagine di elenco dei Marchi.
L'immagine non sarà obbligatoria se il manufacturer nuovo verrà assegnato solo ad occasioni. Se invece verrà assegnato a prodotti a catalogo custom, il suo logo apparirà nel listing dei brand.

Category Custom

[modifica]

Il negozio potrà inserire tipologie proprie specificando: Nome tipo e Ambiente di appartenenza (che può essere a sua volta custom o esistente).


Strategia di Estensione Contestuale

[modifica]

Per evitare di creare delle logiche circostanziali, poco elastiche e di elevata manutenzione abbiamo deciso di adottare un paradigma simile all'estensione delle classi nella programmazione ad oggetti.

In pratica estendiamo le tabelle esistenti, cioè ne creiamo una copia che abbia un campo Context che identifichi il contesto di appartenenza (es. un Trovaprodotti specifico).
Il contesto rappresenta l'unione delle due tabelle (normale + nomale_ext) come se fossero un'unica tabella integrata nelle logiche Core.
Questa unione viene implementata tramite una scalar function che prende in input il contesto.

Esempio Pratico

[modifica]

volendo aggiungere nuovi Manufacturer solo per il Trovaprodotti di PincoPallino (id 1111),
basterà utilizzare una funzione ManufacturerExt(1111) AS Manufacturer e fare le query come se ci trovassimo nel pool di Designbest.

In questo caso ManufacturerExt(1111) rappresenta la somma di tutti i manufacturer di Designbest + quelli custom che sono stati aggiunti dal contesto n° 1111 

ManufacturerExt(1111)   =

SELECT Campo1, Campo2, Campo3, 1 AS Core FROM Manufacturer
UNION
SELECT Campo1, Campo2, Campo3, 0 AS Core FROM Manufacturer_Ext WHERE Context = 1111

ManufacturerExt(1111) , tramite il campo @Core è in grado di sapere se si trova nel contesto specifico oppure nel core Designbest.

Ambiguità degli ID

[modifica]

A causa dell'ambiguità degli ID (i nuovi possono collidere con quelli del core, non c'è univocità),
ad ogni JOIN con le tabelle Ext è necessario specificare il parametro @Core per specificare se si tratta di record custom del contesto oppure di record di Designbest.

Nel caso di una GET dei Manufacturer, i recordset avranno sempre il campo @Core che indica se il manu in questione è di Designbest o un custom manu del contesto corrente.
In questo modo il frontend sarà in grado di mostrare la scheda prodotto con la coppia @ID INT, @Core BIT. 

SELECT Nome, SeoNome, Descrizione, Core
FROM ManufacturerExt(1111) AS Manufacturer

Per ogni riga di risultato, l'applicativo sa se il prodotto è del contesto (Core = 0) o di Designbest (Core = 1)

Nel caso di un FILTRO dei Manufacturer, nella WHERE è sempre necessario specificare se stiamo cercando tra i custom record del contesto o in Designbest specificando il parametro Core 

SELECT Nome, SeoNome, Descrizione, Core
FROM ManufacturerExt(1111) AS Manufacturer
WHERE Manufacturer.ID = 275 AND Manufacturer.Core = @FromCore

Necessario il parametro booleano @FromCore per suggerire di cercare dentro i custom record del contesto o dentro al core Designbest

Tabelle estese

[modifica]

Al momento, per Trovaprodotti abbiamo esteso le seguenti tabelle

Tabella estesa Funzione di unione
Product_Ext ProductExt(@ContextID INT, @LanguageID INT = 1)
ProductCulture_Ext
ProductThumbs_Ext ProductThumbsExt(@ContextID INT, @LanguageID INT = 1)
Manufacturer_Ext ManufacturerExt(@ContextID INT)
Mapping_ShopPoint_Manufacturer_Ext Mapping_ShopPoint_ManufacturerExt(@ContextID INT)
Category_Ext CategoryExt(@ContextID INT)
LocalizedProperty_Ext LocalizedPropertyExt(@ContextID INT, @LocaleKeyGroup NVARCHAR(100), @LocaleKey NVARCHAR(100), @LanguageID INT = 1)
Picture_Ext PictureExt(@ContextID INT, @LocaleKeyGroup NVARCHAR(100), @LocaleKey NVARCHAR(100))
FT_Products_IT_Ext FT_Products_ItExt(@ContextID INT)
FT_Products_EN_Ext FT_Products_EnExt(@ContextID INT)
FT_Products_FR_Ext FT_Products_FrExt(@ContextID INT)
FT_Products_DE_Ext FT_Products_DeExt(@ContextID INT)


Estensione delle picture

[modifica]

La tabella Picture_Ext permette di estendere le immagini, ma il folder del file system è unico per tutte (core e non),
perciò non possiamo mantenere lo stesso schema di generazione dei nomi.
Quando creiamo una nuova picture per

  • Prodotto custom
  • Category custom
  • Manufacturer custom

è necessario ricordarsi che nel campo Picture.EntityValue bisogna mettere

  • productext-<contextid>
  • categoryext-<contextid>
  • manufacturerext-<contextid>

Struttura delle url

[modifica]

Ecco una ipotesi
HOMEPAGE

  • /it/44334 - hp

LISTING DA AMBIENTE

  • /it/44334/catalog/ambient-16_1 - ambiente obbligatorio
  • /it/44334/catalog/ambient-16_1/type-48_1 - ambiente/tipo
  • /it/44334/catalog/ambient-16_1/brand-275_1 - ambiente/manu
  • /it/44334/catalog/ambient-16_1/type-48_1/brand-275_1 - ambiente/tipo/manu

LISTING DA MANU

  • /it/44334/brands
  • /it/44334/brand-275_1 - manu
  • /it/44334/brand-275_1/ambient-16_1 - manu/ambiente
  • /it/44334/brand-275_1/ambient-16_1/type-48_1 - manu/ambiente/tipo (duplicata)

LISTING NEWS

  • /it/44334/news
  • /it/44334/news/ambient-16_1
  • /it/44334/news/brand-275_1
  • /it/44334/news/ambient-16_1/brand-275_1

LISTING SEARCH

  • /it/44334/search

LISTING OCCASIONI

  • /it/44334/offers - tutte
  • /it/44334/offers/ambient-16_1 - ambiente
  • /it/44334/offers/ambient-16_1/type-48_1 - ambiente/tipo
  • /it/44334/offers/ambient-16_1/brand-275_1 - ambiente/manu
  • /it/44334/offers/ambient-16_1/type-48_1/brand-275_1 - ambiente/tipo/manu
Estratto da "https://wiki.wmdemo.it/index.php?title=Trovaprodotti_Core&oldid=3088"