Chiamata di una risorsa tramite una chiave di identificazione composita calling-a-resource-using-a-composite-identification-key
In alcuni casi, potrebbe essere necessario definire per una risorsa una chiave di identificazione composta da due campi. Una volta configurata la chiave di identificazione, devi configurare una definizione di filtro per poter chiamare la risorsa con questa chiave di identificazione, dall’interfaccia Campaign Standard o dalle API.
In questo caso d’uso, il Profilo la risorsa è stata estesa con personalizzate "ID CRM" e "categoria" campi. Creeremo una chiave di identificazione per la risorsa Profilo, che sarà costituita da questi due campi. Quindi configureremo una definizione di filtro, in modo da poter accedere alla risorsa Profilo utilizzando la chiave di identificazione.
I passaggi principali per questo caso d’uso sono:
- Configura la chiave di identificazione per la risorsa Profilo, in base ai due campi.
- Configura la definizione del filtro per poter chiamare la risorsa profilo utilizzando la relativa chiave di identificazione.
- Chiama la risorsa Profilo dall’interfaccia o dall’API.
Argomenti correlati:
Passaggio 1: configurare la chiave di identificazione step-1-configure-the-identification-key
-
Prima di configurare la chiave di identificazione, accertati che la risorsa sia stata estesa con i campi desiderati e che sia stata pubblicata. Per ulteriori informazioni al riguardo, consulta questa sezione.
-
Vai a Administration / Development / Custom resources , quindi aprire il Profile risorsa.
-
In Identification keys , fare clic sul pulsante Create element pulsante.
-
Aggiungi i due campi personalizzati "ID CRM" e "Categoria", quindi fai clic su Confirm.
note note NOTE Se desideri visualizzare i due campi personalizzati nell’interfaccia del profilo, configura Screen definition scheda. Per ulteriori informazioni al riguardo, consulta questa sezione. -
Ora puoi configurare la definizione del filtro in modo da poter chiamare la risorsa utilizzando la relativa chiave di identificazione.
Passaggio 2: configurare la definizione del filtro step-2-configure-the-filter-definition
-
In Filter definition , fare clic su Add an element, quindi inserisci l’etichetta e l’ID della definizione del filtro.
-
Modifica le proprietà della definizione del filtro per configurarne le regole.
-
Trascina nell’area di lavoro la tabella contenente i campi utilizzati nella chiave di identificazione.
-
Seleziona il primo campo utilizzato nella chiave di identificazione ("ID CRM"), quindi attiva il Switch to parameters opzione.
-
In Filter conditions sezione, mantieni Equal , quindi definire il nome del parametro e fare clic sul segno più per crearlo.
note note NOTE Dopo aver fatto clic su + , il nome del parametro viene generato automaticamente. Tieni presente queste informazioni, in quanto saranno necessarie per utilizzare il filtro delle API. -
Ripeti i passaggi precedenti con tutti i campi che compongono la chiave di identificazione ("categoria"), quindi salva le modifiche.
-
La definizione del filtro è ora configurata. Puoi pubblicare la risorsa in modo che il filtro sia disponibile.
Passaggio 3: chiama la risorsa in base alla sua chiave di identificazione step-3-call-the-resource-based-on-its-identification-key
Una volta configurata la chiave di identificazione e la relativa definizione del filtro, puoi utilizzarle per chiamare la risorsa dall’interfaccia standard di Campaign o dalle API REST.
Per utilizzare la definizione del filtro dall’interfaccia, utilizza una Query attività in un flusso di lavoro (consulta questa sezione). Il filtro è quindi disponibile nel riquadro a sinistra.
Per utilizzare la definizione del filtro dalle API REST di Campaign Standard, utilizza la sintassi seguente:
GET /profileAndServicesExt/<resourceName>/by<filterName>?<param1_parameter>=<value>&<param2_parameter>=<value>
Nel nostro caso, la sintassi per recuperare un profilo dalla categoria "Spring" con l’ID del sistema di gestione delle relazioni con i clienti "123456" sarebbe:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/byidentification_key?category_parameter=spring&crm_id_parameter=123456
Per ulteriori informazioni, consulta Documentazione API REST di Campaign Standard.