Anropa en resurs med en sammansatt identifieringsnyckel calling-a-resource-using-a-composite-identification-key
I vissa fall kan du behöva definiera en identifieringsnyckel som består av två fält för en resurs. När identifieringsnyckeln har konfigurerats måste du konfigurera en filterdefinition för att kunna anropa resursen med den här identifieringsnyckeln, antingen från Campaign Standardens gränssnitt eller API:er.
I det här fallet har resursen Profile utökats med anpassade fält för "CRM ID" och "category". Vi skapar en identifieringsnyckel för profilresursen som består av dessa två fält. Sedan konfigurerar vi en filterdefinition så att vi kan komma åt profilresursen med hjälp av identifieringsnyckeln.
De huvudsakliga stegen för det här användningsexemplet är:
- Konfigurera identifieringsnyckeln för profilresursen baserat på de två fälten.
- Konfigurera filterdefinitionen för att kunna anropa profilresursen med hjälp av dess identifieringsnyckel.
- Anropa profilresursen från gränssnittet eller från APis.
Relaterade ämnen:
Steg 1: Konfigurera identifieringsnyckeln step-1-configure-the-identification-key
-
Innan du konfigurerar identifieringsnyckeln måste du kontrollera att resursen har utökats med de önskade fälten och att den har publicerats. Mer information om detta finns i det här avsnittet.
-
Gå till menyn Administration / Development / Custom resources och öppna sedan resursen Profile.
-
Klicka på knappen Create element i avsnittet Identification keys.
-
Lägg till de två anpassade fälten CRM ID och Category och klicka sedan på Confirm.
note note NOTE Om du vill visa de två anpassade fälten i profilens gränssnitt konfigurerar du fliken Screen definition. Mer information om detta finns i det här avsnittet. -
Nu kan du konfigurera filterdefinitionen så att den kan anropa resursen med hjälp av dess identifieringsnyckel.
Steg 2: Konfigurera filterdefinitionen step-2-configure-the-filter-definition
-
Klicka på Add an element på fliken Filter definition och ange sedan filterdefinitionens etikett och ID.
-
Redigera filterdefinitionens egenskaper för att konfigurera dess regler.
-
Dra och släpp den tabell som innehåller de fält som används i identifieringsnyckeln till arbetsytan.
-
Markera det första fältet som används i identifieringsnyckeln ("CRM-ID") och aktivera sedan alternativet Switch to parameters.
-
I avsnittet Filter conditions behåller du operatorn Equal, definierar parameterns namn och klickar på plustecknet för att skapa det.
note note NOTE När du har klickat på knappen + genereras parameternamnet automatiskt. Observera den här informationen eftersom du behöver den för att använda filtret från API:erna. -
Upprepa stegen ovan med alla fält som utgör identifieringsnyckeln ("kategori") och spara sedan ändringarna.
-
Filterdefinitionen är nu konfigurerad. Du kan publicera resursen så att filtret är tillgängligt.
Steg 3: Anropa resursen baserat på dess identifieringsnyckel step-3-call-the-resource-based-on-its-identification-key
När identifieringsnyckeln och filterdefinitionen har konfigurerats kan du använda dem för att anropa resursen, antingen från standardgränssnittet för Campaign eller från REST-API:er.
Om du vill använda filterdefinitionen från gränssnittet använder du en Query-aktivitet i ett arbetsflöde (se det här avsnittet). Filtret är sedan tillgängligt i den vänstra rutan.
Om du vill använda filterdefinitionen från Campaign Standardens REST API:er använder du syntaxen nedan:
GET /profileAndServicesExt/<resourceName>/by<filterName>?<param1_parameter>=<value>&<param2_parameter>=<value>
I det här fallet skulle syntaxen för att hämta en profil från kategorin "vår" med CRM-ID:t "123456" vara:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/byidentification_key?category_parameter=spring&crm_id_parameter=123456
Mer information finns i dokumentationen för Campaign Standardens REST API:er.