Konfiguration för externa åtgärder

Gå till Administration > Configurations.

Klicka på External Actions på panelen mellan.

{width="800" modal="regular"}

Klicka på Create action överst till höger.

Ange URL:en till OpenAPI-specifikationen för den externa tjänsten och klicka på Create.

{width="500"}

Den externa tjänsten måste vara live och åtkomlig för att det här steget ska lyckas. Om det finns ett valideringsfel visas ett meddelande som beskriver felet och ett förslag till lösning. Mer information finns i Felsökning.

Granska Service details när URL:en har lösts.

Tjänstinformationen läses direkt från OpenAPI-specifikationen när åtgärden skapas. Du kan inte ändra dessa egenskaper i konfigurationen efter att du har skapat den.

Ange autentiseringsuppgifterna Authentication för den externa tjänsten (components.securitySchemes).

{width="600" modal="regular"}

Du kan ändra autentiseringsuppgifterna efter behov när den konfigurerade åtgärden har statusen Utkast eller Aktiv.

Klicka på Next.

Ange egenskaperna Configurations för att definiera hur åtgärden ska utbyta data med den externa tjänsten.

• Action type (Statisk) - Den typ av resenod som stöds:

  • External action (enableSplitPath = false)
  • External action split path (enableSplitPath = true)

  Du kan inte ändra åtgärdstypen efter att du har skapat åtgärdskonfigurationen.

• Accessors (Statisk) - (Endast delad sökväg för extern åtgärd) Variablerna som returneras av den externa tjänsten som ska vara tillgängliga som sökvägsvillkor i en extern delad sökvägsnod. (invocationPayloadDef.accessorsMetadata)

• Journey context (Statisk) - Omfånget för målgruppsdata som skickats i begäran (supportedEntityType):

  • Account - Skickar endast konton

  • People - Skickar endast personer

  • People in Account - Skickar konton och kontorelaterade personer

• Outgoing Fields - Mappa varje fält i tabellen till ett XDM-fält. Dessa fält skickas i begärandetexten till den externa tjänsten. Tjänstedefinitionsegenskaper: invocationPayloadDef.accountFields, invocationPayloadDef.fields.

  {width="600" modal="regular"}

• Incoming Fields - Mappa varje fält i tabellen till ett uppdateringsbart XDM-fält. Dessa fält fylls i från det externa tjänstsvaret. Tjänstedefinitionsegenskaper: callbackPayloadDef.accountFields, callbackPayloadDef.fields. Uppdateringsbart efter att det har skapats.

• Header parameters - Ange ett värde för varje rad som ska skickas som en HTTP-rubrik i begäran. Tjänstedefinitionsegenskap: invocationPayloadDef.headers.

• Timeout - Ange hur många minuter det ska ta att vänta på att den externa tjänsten ska anropa återanropet innan begäran anses vara misslyckad. Tjänstedefinitionsegenskap: timeout.

• Global attributes - Ange ett värde för varje rad som ska inkluderas som ett statiskt fält i begärandetexten. Tjänstedefinitionsegenskap: invocationPayloadDef.globalAttributes.

  {width="600" modal="regular"}

Klicka på Bakåtpilen för att gå tillbaka till listan och behålla åtgärden i läget Utkast.

Du kan också klicka på Activate om du vill ändra åtgärdskonfigurationen till läget Aktiv. Den konfigurerade externa åtgärden måste vara aktiv för att den ska kunna användas på kontoresor.