Konfigurere Webhooks
Vigtigt!
Nogle eller alle af disse funktioner, der er angivet i dette emne, er tilgængelige som del af en forhåndsversion. Indholdet og funktionerne kan ændres.
Webhooks skal konfigureres for syv specifikke objekter: UserGroups, Kategories, Brugere,UserGroupAssignments,Addresses,AddressAssignment,Kataloger. Denne artikel indeholder en gennemgang af de trin, du skal bruge til at konfigurere og aktivere webhooks til Sitecore Order Connector.
Trin 1. Konfigurer Webhooks på OrderCloud-portalen
Dette trin skal angive kilden for hver webhook for at sikre, at de er konfigureret korrekt.
Gå til OrderConfig-portal > API-konsol > Leveringskonfigurationer > POST-integrationer/deliveryconfig. Udfyld navn som WebhooksDeliveryConfig, markér aktiveret.
Rul ned, og find Event Hub. Udfyld navn og forbindelsesstreng fra Eventstream OrderCloud-kilden. Vælg Send. Bemærk leveringskonfigurations-id.
Gå til Webhooks, vælg lynet i øverste venstre hjørne, og skift til den klassiske visning.
For hvert af de syv objekter skal du oprette en webhook for hver enkelt. Vælg POST-webhook-slutpunktet for hver webhook, og udfyld navnet.
Erstat med det JSON, der er angivet i JSON for webhooks for hver webhook.
Udfyld det korrekte API-klient-id og det korrekte konfigurations-id for levering.
Trin 2. Konfiguration af webhooks for connectoren
Dette trin skal angive destinationen for hver webhook for at sikre, at de er konfigureret korrekt.
Gå til din Webhooks Eventstream-ressource.
Opret en ny brugerdefineret appkilde, der hedder OrderCloud.
Opret en ny destination for hver af de syv objekter.
Vælg Søhus som ny destination.
Angiv objektnavnet (Kategorier som eksempel) i felterne Destinationsnavn og Delta-tabel.
Angiv det oprettede Navn på bronzesøhus og navnet på det tilknyttede arbejdsområde.
Gentag disse trin for de øvrige seks objekter.
Når du har oprettet alle de syv destinationer, skal du vælge Deaktiver alle.
Trin 3. Aktivere de konfigurerede Webhooks
Når kilden og destinationen for webhooks er konfigureret, skal du aktivere dem, så Webhooks udløses ved hver dataopdatering. For at starte dataflowet skal du udløse webhooket. Du kan f.eks. oprette en ny kategori på kildesiden og iagttage, at den replikeres på destinationssiden.
Gå tilbage til Eventstream-kilden.
Vælg det bølge ikon for et webbillede i deres område (kategorier for eksempel), og arranger filtre.
Gentag trinnene for at udløse de andre seks webhooks. Du kan se de arrangerede objekter i sektionen Arrangerede objekter.
Vælg Aktivér alle. Nu synkroniserer Eventstream-ressourcen de nye handlinger for arrangerede objekter.
JSON til webhooks
AddressAssignmentsWebhook
{
"Name": "AddressAssignmentsWebhook",
"ApiClientIDs": ["<API_CLIENT_IDS>"],
"WebhookRoutes": [
{
"Route": "v1/buyers/{buyerID}/addresses/{addressID}/assignments",
"Verb": "DELETE"
},
{
"Route": "v1/buyers/{buyerID}/addresses/assignments",
"Verb": "POST"
}
],
"DeliveryConfigID": "<DELIVERY_CONFIG_FROM_EARLIER>"
}
AddressWebhook
{
"Name": "AddressWebhook",
"ApiClientIDs": ["<API_CLIENT_IDS>"],
"WebhookRoutes": [
{
"Route": "v1/buyers/{buyerID}/addresses",
"Verb": "POST"
},
{
"Route": "v1/buyers/{buyerID}/addresses/{addressID}",
"Verb": "DELETE"
},
{
"Route": "v1/buyers/{buyerID}/addresses/{addressID}",
"Verb": "PATCH"
},
{
"Route": "v1/buyers/{buyerID}/addresses/{addressID}",
"Verb": "PUT"
}
],
"DeliveryConfigID": "<DELIVERY_CONFIG_FROM_EARLIER>"
}
CatalogsWebhook
{
"Name": "CatalogsWebhook",
"ApiClientIDs": ["<API_CLIENT_IDS>"],
"WebhookRoutes": [
{
"Route": "v1/catalogs",
"Verb": "POST"
},
{
"Route": "v1/catalogs/{catalogID}",
"Verb": "DELETE"
},
{
"Route": "v1/catalogs/{catalogID}",
"Verb": "PATCH"
},
{
"Route": "v1/catalogs/{catalogID}",
"Verb": "PUT"
}
],
"DeliveryConfigID": "<DELIVERY_CONFIG_FROM_EARLIER>"
}
CategoriesWebhook
{
"Name": "CategoriesWebhook",
"ApiClientIDs": ["<API_CLIENT_IDS>"],
"WebhookRoutes": [
{
"Route": "v1/catalogs/{catalogID}/categories",
"Verb": "POST"
},
{
"Route": "v1/catalogs/{catalogID}/categories/{categoryID}",
"Verb": "DELETE"
},
{
"Route": "v1/catalogs/{catalogID}/categories/{categoryID}",
"Verb": "PATCH"
},
{
"Route": "v1/catalogs/{catalogID}/categories/{categoryID}",
"Verb": "PUT"
}
],
"DeliveryConfigID": "<DELIVERY_CONFIG_FROM_EARLIER>"
}
UserGroupAssignmentsWebhook
{
"Name": "UserGroupAssignmentsWebhook",
"ApiClientIDs": ["<API_CLIENT_IDS>"],
"WebhookRoutes": [
{
"Route": "v1/buyers/{buyerID}/usergroups/{userGroupID}",
"Verb": "PATCH"
},
{
"Route": "v1/buyers/{buyerID}/usergroups/{userGroupID}",
"Verb": "PUT"
},
{
"Route": "v1/buyers/{buyerID}/usergroups/{userGroupID}/assignments/{userID}",
"Verb": "DELETE"
},
{
"Route": "v1/buyers/{buyerID}/usergroups/assignments",
"Verb": "POST"
}
],
"DeliveryConfigID": "<DELIVERY_CONFIG_FROM_EARLIER>"
}
UserGroupsWebhook
{
"Name": "UserGroupsWebhook",
"ApiClientIDs": ["<API_CLIENT_IDS>"],
"WebhookRoutes": [
{
"Route": "v1/buyers/{buyerID}/usergroups",
"Verb": "POST"
},
{
"Route": "v1/buyers/{buyerID}/usergroups/{userGroupID}",
"Verb": "DELETE"
},
{
"Route": "v1/buyers/{buyerID}/usergroups/{userGroupID}",
"Verb": "PATCH"
},
{
"Route": "v1/buyers/{buyerID}/usergroups/{userGroupID}",
"Verb": "PUT"
}
],
"DeliveryConfigID": "<DELIVERY_CONFIG_FROM_EARLIER>"
}
UsersWebhook
{
"Name": "UsersWebhook",
"ApiClientIDs": ["<API_CLIENT_IDS>"],
"WebhookRoutes": [
{
"Route": "v1/buyers/{buyerID}/users",
"Verb": "POST"
},
{
"Route": "v1/buyers/{buyerID}/users/{userID}",
"Verb": "DELETE"
},
{
"Route": "v1/buyers/{buyerID}/users/{userID}",
"Verb": "PATCH"
},
{
"Route": "v1/buyers/{buyerID}/users/{userID}",
"Verb": "PUT"
}
],
"DeliveryConfigID": "<DELIVERY_CONFIG_FROM_EARLIER>"
}
Arrangerede objekter
UserGroups
Kategorier
Brugere
UserGroupAssignments
Adresser
AddressAssignment
Kataloger
Vigtigt!
Kontakt Microsoft Cloud for Retail-teamet på mcfrcommunity@microsoft.com for at få flere oplysninger.