Get Started

Installazione SDK #

Configurazione della sincronizzazione dei dati #

L’SDK ti fornisce gli strumenti per iniziare a costruire indici per Clerk. Dovresti assicurarti di costruire gli indici regolarmente con attività pianificate affinché Clerk rimanga aggiornato. Raccomandiamo di aggiornarli almeno una volta al giorno.

Per la sincronizzazione dei dati con Clerk.io, dobbiamo configurare un REST API, con accesso ai dati necessari. (Prodotti, Ordini, Categorie, Pagine e Clienti).

Utilizzeremo la parte Repositories di DynamicWeb per accedervi.

I file per il REST API sono inclusi nel Clerk.io DynamicWeb SDK.

1. Inserisci i file del Repository dall’SDK di Clerk.io.

2. Aggiungi la chiave privata al file di configurazione.

3. Costruisci l’indice del Repository.

4. Configura il REST API.

5. Esegui la tua prima sincronizzazione su clerk.io.

Inserisci i file del Repository dall’SDK di Clerk #

Nella guida, faremo riferimento a THEME_NAME che dovrebbe essere sostituito con il nome del Tema utilizzato, ad esempio Rapido.

1. In DynamicWeb naviga su Files -> System -> Repositories e crea una nuova sottocartella chiamata Clerk.

2. Copia tutti i file dalla cartella Repositories nell’SDK di Clerk nella nuova cartella:

3. Products (Products.index & Products.query)

4. Categories (Categories.index & Categories.query)

5. Content (Content.index & Contents.query)

6. Customers (Customers.index & Customers.query)

7. Orders (Orders.index & Orders.query)

8. Naviga su Files -> Templates -> Designs -> THEME_NAME -> QueryPublisher.

9. Carica i seguenti file dall’SDK di Clerk su QueryPublisher:

10. ClerkProducts.cshtml

11. ClerkCategories.cshtml

12. ClerkContents.cshtml

13. ClerkCustomers.cshtml

14. ClerkOrders.cshtml

15. Naviga su Files -> Templates -> Designs -> THEME_NAME.

16. Copia i file dalla cartella Rapido nell’SDK di Clerk nella cartella THEME_NAME:

17. ClerkConfig.cshtml

18. Json.cshtml

Aggiungi la chiave privata al file di configurazione #

1. In my.clerk.io, naviga su Settings -> API keys.

2. Copia la chiave API privata.

3. In DynamicWeb, apri ClerkConfig.cshtml che hai appena copiato qui.

4. Sostituisci "##### CLERK Private Key Here #####" con la chiave API privata.

5. Salva le modifiche e chiudi.

Costruisci l’indice del Repository #

1. Naviga su Settings -> Repositories -> Clerk.

2. Clicca sull’indice Products

3. Sotto Builds -> Build, clicca sul pulsante Products per costruire l’indice.

4. Segui la stessa procedura per tutti gli indici (Categories, Contents, Customers, Orders)

Configura il REST API #

1. Naviga su Content nel menu laterale e crea una nuova cartella chiamata Clerk.

2. All’interno di questa cartella, crea una nuova pagina

3. Clicca su Add Empty Page e poi scegli Page come tipo.

4. Nomina la pagina “Products” e imposta lo stato della pagina su Hide in menu

5. Clicca su “New Paragraph” e scorri fino a Add paragraph. Da qui, scegli App.

6. Dagli il nome “Products”.

7. Scegli App > Content > Query publisher

8. Sotto Query, scegli Products.query.

9. Sotto Template in basso, scegli QueryPublisher/ClerkProducts.cshtml.

10. In cima alla pagina, clicca su Save.

11. Nel menu a sinistra, clicca sui 3 punti a destra della pagina Products, e clicca su Properties.

12. Sotto URL, imposta Exact url for this page su “/clerk/products”.

13. Nel menu in alto, deseleziona tutte le opzioni sopra Accessibility.

14. Clicca su Layout nel menu in alto.

15. Nel menu in alto, scegli il template Rapido: JSON

16. Salva di nuovo la pagina.

17. Ripeti questi passaggi per Contents, Orders, Categories e Customers, assicurandoti di sostituire products/Products con il tipo di dato pertinente in tutto.

Esegui la tua prima sincronizzazione su clerk.io #

1. Accedi al tuo backend di my.clerk.io.

2. Naviga nella sezione Dati.

3. Inserisci il dominio del tuo negozio sotto Store URL e aggiungi il tuo Shop ID per assicurarti che Clerk sincronizzi dal catalogo corretto.

4. Scegli eventuali opzioni di sincronizzazione aggiuntive che desideri.

5. Clicca su Salva.

6. Clicca su Inizia nuova sincronizzazione dati.

7. Aspetta che la sincronizzazione finisca.