Get Started

Installer Clerk SDK på din DynamicWeb-butik og opsæt datasynkronisering. Denne guide guider dig gennem installationsprocessen og konfigurations­trinene.

Installation af SDK #

Opsæt datasynk #

SDK’et giver dig værktøjerne til at komme i gang med at opbygge indekser til Clerk. Du bør sikre dig, at indekserne bygges regelmæssigt med planlagte opgaver, så Clerk holdes opdateret. Vi anbefaler at opdatere dem mindst én gang om dagen.

For synkronisering af data til Clerk.io skal vi opsætte et REST API med adgang til de nødvendige data. (Products, Orders, Categories, Pages og Customers).

Vi bruger delen Repositories i DynamicWeb til at tilgå dette.

Filerne til REST API’et er inkluderet i Clerk.io DynamicWeb SDK.

1. Indsæt Repository-filer fra Clerk.io SDK.

2. Tilføj privat nøgle til konfigurationsfilen.

3. Byg Repository-indeks.

4. Opsæt REST API’et.

5. Kør din første sync til clerk.io.

Indsæt repository-filer #

I denne guide henviser vi til THEME_NAME, som skal erstattes med navnet på det anvendte tema, f.eks. Rapido.

1. I DynamicWeb, gå til Files -> System -> Repositories og opret en ny undermappe med navnet Clerk.

2. Kopiér alle filer fra mappen Repositories i Clerk SDK til den nye mappe:

   • Products (Products.index & Products.query)
   • Categories (Categories.index & Categories.query)
   • Content (Content.index & Contents.query)
   • Customers (Customers.index & Customers.query)
   • Orders (Orders.index & Orders.query)

3. Naviger til Files -> Templates -> Designs -> THEME_NAME -> QueryPublisher.

4. Upload følgende filer fra Clerk SDK til QueryPublisher:

   • ClerkProducts.cshtml
   • ClerkCategories.cshtml
   • ClerkContents.cshtml
   • ClerkCustomers.cshtml
   • ClerkOrders.cshtml

5. Naviger til Files -> Templates -> Designs -> THEME_NAME.

6. Kopiér filerne fra Rapido-mappen i Clerk SDK til THEME_NAME-mappen:

   • ClerkConfig.cshtml
   • Json.cshtml

Tilføj privat nøgle #

1. I my.clerk.io, gå til Developers -> API keys.

2. Kopiér Private API key.

3. I DynamicWeb, åbn ClerkConfig.cshtml som du lige har kopieret hertil.

4. Erstat "##### CLERK Private Key Here #####" med Private API key.

5. Gem ændringerne og luk.

Byg repository-indeks #

1. Gå til Settings -> Repositories -> Clerk.

2. Klik på Products-indekset

3. Under Builds -> Build, klik på Products-knappen for at bygge indekset.

4. Følg samme procedure for alle indekser (Categories, Contents, Customers, Orders)

Opsæt REST API #

1. Gå til Content i sidemenuen og opret en ny mappe med navnet Clerk.

2. Inde i denne mappe, opret en ny side

3. Klik på Add Empty Page og vælg derefter Page som type.

4. Navngiv siden “Products” og sæt Page Status til Hide in menu

5. Klik “New Paragraph” og scroll til Add paragraph. Vælg her App.

6. Giv den navnet “Products”.

7. Vælg App > Content > Query publisher

8. Under Query, vælg Products.query.

9. Under Template nederst, vælg QueryPublisher/ClerkProducts.cshtml.

10. Øverst på siden, klik Save.

11. I venstre menu, klik på de 3 prikker til højre for Products siden og klik Properties.

12. Under URL, sæt Exact url for this page til "/clerk/products".

13. I topmenuen, fjern markeringen på alle muligheder ovenover Accessibility.

14. Klik Layout i topmenuen.

15. I topmenuen, vælg skabelonen Rapido: JSON

16. Gem siden igen.

17. Gentag disse trin for Contents, Orders, Categories og Customers, og sørg for at erstatte products/Products med den relevante datatype undervejs.

Kør første sync #

1. Log ind på din my.clerk.io backend.

2. Gå til Data-sektionen.

3. Indtast din webshops domæne under Store URL og tilføj din Shop ID for at sikre, at Clerk synkroniserer fra det korrekte katalog.

4. Vælg eventuelle ekstra synkroniserings­muligheder du ønsker.

5. Klik Gem.

6. Klik Start New Data Sync.

7. Vent til synkroniseringen er færdig.