Get Started

Installazione SDK #

Configurazione della sincronizzazione dei dati #

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

Useremo la parte Repositories di DynamicWeb per accedere a questo.

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

1. Inserire i file del Repository dal Clerk.io SDK.

2. Aggiungere la chiave privata al file di configurazione.

3. Costruire l’Indice del Repository.

4. Configurare il REST API.

5. Eseguire la prima sincronizzazione con clerk.io.

Inserire i file del Repository dal Clerk SDK #

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

1. In DynamicWeb navigare a Files -> System -> Repositories e creare una nuova sottocartella chiamata Clerk.

2. Copiare tutti i file dalla cartella Repositories nel Clerk SDK nella nuova cartella:

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

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

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

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

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

8. Navigare a Files -> Templates -> Designs -> THEME_NAME -> QueryPublisher.

9. Caricare i seguenti file dal Clerk SDK in QueryPublisher:

10. ClerkProducts.cshtml

11. ClerkCategories.cshtml

12. ClerkContents.cshtml

13. ClerkCustomers.cshtml

14. ClerkOrders.cshtml

15. Navigare a Files -> Templates -> Designs -> THEME_NAME.

16. Copiare i file dalla cartella Rapido nel Clerk SDK nella cartella THEME_NAME:

17. ClerkConfig.cshtml

18. Json.cshtml

Aggiungere la chiave privata al file di configurazione #

1. In my.clerk.io, navigare a Settings -> API keys.

2. Copiare la Chiave API privata.

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

4. Sostituire "##### CLERK Private Key Here #####" con la Chiave API privata.

5. Salvare le modifiche e chiudere.

Costruire l’Indice del Repository #

1. Navigare a Settings -> Repositories -> Clerk.

2. Cliccare sull’indice Prodotti

3. Sotto Builds -> Build, cliccare il pulsante Prodotti per costruire l’indice.

4. Seguire la stessa procedura per tutti gli indici (Categorie, Contenuti, Clienti, Ordini)

Configurare il REST API #

1. Navigare a Content nel menu laterale e creare una nuova cartella chiamata Clerk.

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

3. Cliccare Aggiungi Pagina Vuota e poi scegliere Pagina come tipo.

4. Dare alla pagina il nome “Prodotti”, e impostare lo Stato della Pagina su Nascondi nel menu

5. Cliccare “Nuovo Paragrafo” e scorrere fino a Aggiungi paragrafo. Da qui, scegliere App.

6. Dargli il nome “Prodotti”.

7. Scegliere App > Content > Query publisher

8. Sotto Query, scegliere Products.query.

9. Sotto Template in fondo, scegliere QueryPublisher/ClerkProducts.cshtml.

10. In cima alla pagina, cliccare Salva.

11. Nel menu a sinistra, cliccare sui 3 punti a destra della pagina Prodotti, e cliccare Proprietà.

12. Sotto URL, impostare URL esatto per questa pagina su “/clerk/products”.

13. Nel menu in alto, deselezionare tutte le opzioni sopra l’Accessibilità.

14. Cliccare Layout nel menu in alto.

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

16. Salvare di nuovo la pagina.

17. Ripetere questi passaggi per Contenuti, Ordini, Categorie e Clienti, assicurandosi di sostituire products/Products con il tipo di dato pertinente in tutto.

Eseguire la prima sincronizzazione con clerk.io #

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

2. Navigare alla sezione Dati.

3. Inserire il dominio del tuo webshop sotto Store URL, e scegliere eventuali opzioni di sincronizzazione aggiuntive che desideri.

4. Cliccare Salva.

5. Cliccare Avvia Nuova Sincronizzazione Dati.

6. Attendere il termine della sincronizzazione.