Get Started

Installazione SDK #

Configurazione della sincronizzazione dei dati #

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

Utilizzeremo la parte Repositories di DynamicWeb per accedere a questo.

I file per la 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 la 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. 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. 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 Products

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

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

Configurare la 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 su Add Empty Page e poi scegliere Page come tipo.

4. Dare alla pagina il nome “Products”, e impostare lo stato della pagina su Hide in menu

5. Cliccare su “New Paragraph” e scorrere fino a Add paragraph. Da qui, scegliere App.

6. Dargli il nome “Products”.

7. Scegliere App > Content > Query publisher

8. Sotto Query, scegliere Products.query.

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

10. In cima alla pagina, cliccare su Save.

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

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

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

14. Cliccare su 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 Contents, Orders, Categories e Customers, assicurandosi di sostituire products/Products con il tipo di dato pertinente in tutto.

Eseguire la prima sincronizzazione con clerk.io #

1. Accedere al 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 su Salva.

5. Cliccare su Inizia nuova sincronizzazione dei dati.

6. Attendere il termine della sincronizzazione.