Chiamata di una risorsa tramite una chiave di identificazione composita

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 di Campaign Standard o dalle API.

In questo caso d’uso, la risorsa Profilo è stata estesa con campi "CRM ID" e "category" personalizzati. Verrà creata una chiave di identificazione per la risorsa Profilo, che sarà composta da questi due campi. Configureremo quindi 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 i seguenti:

  1. Configura la chiave di identificazione per la risorsa Profilo, in base ai due campi.
  2. Configura la definizione del filtro per poter chiamare la risorsa Profilo utilizzando la relativa chiave di identificazione.
  3. Chiama la risorsa Profilo dall’interfaccia o dalle API.

Argomenti correlati:

Passaggio 1: Configura la chiave di identificazione

NOTA

I concetti globali durante la configurazione delle chiavi di identificazione sono descritti in questa sezione.

  1. 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.

  2. Vai al menu Administration / Development / Custom resources, quindi apri la risorsa Profile.

  3. Nella sezione Identification keys, fai clic sul pulsante Create element .

  4. Aggiungi i due campi personalizzati "ID CRM" e "Categoria", quindi fai clic su Confirm.

    NOTA

    Se desideri visualizzare i due campi personalizzati nell’interfaccia del profilo, configura la scheda Screen definition . Per ulteriori informazioni al riguardo, consulta questa sezione.

  5. Ora puoi configurare la definizione del filtro in modo da poter chiamare la risorsa utilizzando la relativa chiave di identificazione.

Passaggio 2: Configura la definizione del filtro

NOTA

I concetti globali durante la configurazione delle definizioni dei filtri sono descritti in questa sezione.

  1. Nella scheda Filter definition , fai clic su Add an element, quindi immetti l’etichetta e l’ID della definizione del filtro.

  2. Modifica le proprietà della definizione del filtro per configurarne le regole.

  3. Trascina nell’area di lavoro la tabella contenente i campi utilizzati nella chiave di identificazione .

  4. Seleziona il primo campo utilizzato nella chiave di identificazione ("ID CRM"), quindi attiva l'opzione Switch to parameters.

  5. Nella sezione Filter conditions , mantieni l’operatore Equal, definisci il nome del parametro e fai clic sul segno più per crearlo.

    NOTA

    Dopo aver fatto clic sul pulsante +, il nome del parametro viene generato automaticamente. Tieni presente queste informazioni, in quanto sarà necessario per utilizzare il filtro dalle API.

  6. Ripeti i passaggi precedenti con tutti i campi che compongono la chiave di identificazione ("categoria"), quindi salva le modifiche.

  7. 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

Una volta configurati la chiave di identificazione e la relativa definizione del filtro, puoi utilizzarli per chiamare la risorsa, dall’interfaccia Campaign standard o dalle API REST.

Per utilizzare la definizione del filtro dall'interfaccia, utilizza un'attività Query 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>
NOTA

Per chiamare un filtro personalizzato, utilizza il prefisso "by" seguito dal nome del filtro definito durante la configurazione della definizione del filtro in passaggio 2.

Nel nostro caso, la sintassi per recuperare un profilo dalla categoria "spring" con l’ID CRM "123456" sarebbe:

GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/byidentification_key?category_parameter=spring&crm_id_parameter=123456

Per ulteriori informazioni, consulta la documentazione Campaign Standard REST APIs.

In questa pagina

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now