Aufrufen einer Ressource mit einem zusammengesetzten Identifizierungsschlüssel calling-a-resource-using-a-composite-identification-key
Es kann vorkommen, dass Sie für eine Ressource einen Identifikationsschlüssel definieren müssen, der aus zwei Feldern besteht. Nach der Konfiguration des Identifizierungsschlüssels müssen Sie eine Filterdefinition konfigurieren, um die Ressource mit diesem Identifizierungsschlüssel entweder über die Campaign Standard-Benutzeroberfläche oder über APIs aufrufen zu können.
In unserem Beispiel wurde die Ressource Profil mit den benutzerdefinierten Feldern "CRM ID" und "Kategorie" erweitert. Wir erstellen zuerst einen Identifizierungsschlüssel für die Ressource "Profil" bestehend aus diesen beiden Feldern. Anschließend konfigurieren wir eine Filterdefinition, damit wir mithilfe des Identifizierungsschlüssels auf die Ressource "Profil" zugreifen können.
Dies sind die Schritte für diesen Anwendungsfall:
- Konfigurieren des Identifizierungsschlüssels für die Ressource "Profil" auf der Basis der beiden Felder.
- Konfigurieren der Filterdefinition, um die Ressource "Profil" mit dem Identifizierungsschlüssel aufrufen zu können.
- Aufrufen der Ressource "Profil" über die Benutzeroberfläche oder APIs.
Verwandte Themen:
Schritt 1: Identifizierungsschlüssel konfigurieren step-1-configure-the-identification-key
-
Bevor Sie den Identifizierungsschlüssel konfigurieren, stellen Sie sicher, dass die Ressource mit den gewünschten Feldern erweitert und veröffentlicht wurde. Weiterführende Informationen hierzu finden Sie in diesem Abschnitt.
-
Gehen Sie zum Menü Administration > Entwicklung > Benutzerdefinierte Ressourcen und öffnen Sie die Ressource Profil.
-
Wählen Sie im Bereich Identifizierungsschlüssel die Schaltfläche Element erstellen aus.
-
Fügen Sie die beiden benutzerdefinierten Felder "CRM ID" und "Kategorie" hinzu und wählen Sie Bestätigen aus.
note note NOTE Wenn Sie die beiden benutzerdefinierten Felder in der Benutzeroberfläche des Profils anzeigen möchten, konfigurieren Sie den Tab Bildschirmdefinition. Weiterführende Informationen hierzu finden Sie in diesem Abschnitt. -
Sie können nun die Filterdefinition konfigurieren, damit die Ressource mit dem Identifizierungsschlüssel aufgerufen werden kann.
Schritt 2: Filterdefinition konfigurieren step-2-configure-the-filter-definition
-
Wählen Sie im Tab Filterdefinition die Option Element hinzufügen aus und geben Sie den Titel und die Kennung der Filterdefinition ein.
-
Bearbeiten Sie die Eigenschaften der Filterdefinition, um deren Regeln zu konfigurieren.
-
Ziehen Sie die Tabelle mit den Feldern, die im Identifizierungsschlüssel verwendet werden, per Drag & Drop in den Arbeitsbereich.
-
Wählen Sie das erste Feld aus, das im Identifizierungsschlüssel verwendet wird ("CRM ID"), und aktivieren Sie die Option In den Parametermodus wechseln.
-
Behalten Sie im Bereich Filterbedingungen den Operator Gleich bei, definieren Sie den Namen des Parameters und klicken Sie auf das Pluszeichen, um ihn zu erstellen.
note note NOTE Durch Auswahl der Plusschaltfläche + wird der Parametername automatisch generiert. Notieren Sie sich diese Informationen, da Sie sie benötigen, um den Filter in den APIs zu verwenden. -
Wiederholen Sie die obigen Schritte mit allen Feldern des Identifizierungsschlüssels ("Kategorie") und speichern Sie dann Ihre Änderungen.
-
Die Filterdefinition ist jetzt konfiguriert. Sie können die Ressource veröffentlichen, damit der Filter verfügbar ist.
Schritt 3: die Ressource über ihren Identifizierungsschlüssel aufrufen step-3-call-the-resource-based-on-its-identification-key
Nachdem der Identifizierungsschlüssel und die Filterdefinition konfiguriert sind, können Sie sie verwenden, um die Ressource entweder über die Campaign Standard-Benutzeroberfläche oder über REST-APIs aufzurufen.
Um die Filterdefinition in der Benutzeroberfläche zu verwenden, fügen Sie die Aktivität Abfrage zu einem Workflow hinzu (siehe diesen Abschnitt). Der Filter ist dann im linken Fensterbereich verfügbar.
Um die Filterdefinition über Campaign Standard-REST-APIs zu verwenden, nutzen Sie die unten stehende Syntax:
GET /profileAndServicesExt/<resourceName>/by<filterName>?<param1_parameter>=<value>&<param2_parameter>=<value>
In unserem Fall lautet die Syntax zum Abrufen eines Profils aus der Kategorie "spring" mit der CRM-ID "123456":
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/byidentification_key?category_parameter=spring&crm_id_parameter=123456
Weiterführende Informationen dazu finden Sie in der Dokumentation zu Campaign Standard-REST-APIs.