Marketo-Aktivität 'Alle Objekte abrufen' verwenden

Mit der Aktivität 'Alle Objekte abrufen' können Sie Details von Objekten aus Marketo abrufen.

Informationen zu diesem Vorgang

Verwenden Sie diese Task, um alle Objektdetails in der Marketo-Instanz abzurufen. Der Aufruf dieser Aktivität ist ein synchroner Aufruf, bei dem die Eingabedaten zur Verarbeitung an die Aktivität gesendet werden und die Antwort zurück an die Orchestrierung gesendet wird.

Vorgehensweise

  1. Öffnen Sie in einer aktiven Orchestrierung die Registerkarte Aktivitäten und blenden Sie den Inhalt des Ordners Marketo ein.
  2. Ziehen Sie das Symbol für die Aktivität Alle Objekte abrufen auf die Orchestrierung. Wählen Sie die Aktivität aus. Die Prüfliste der Marketo-Aktivität 'Alle Objekte abrufen' wird angezeigt.
  3. Klicken Sie in der Prüfliste auf Zusammenfassung.
  4. Prüfen Sie den Inhalt des Felds Aktivitätsname und nehmen Sie die erforderlichen Änderungen vor.
  5. Klicken Sie in der Prüfliste auf Endpunkt auswählen.
  6. Klicken Sie auf Durchsuchen und verwenden Sie das Dialogfenster Projektexplorer, um den relevanten Marketo-Endpunkt auszuwählen.
  7. Optional: Sie können den Endpunkt erstellen, indem Sie auf Neu klicken und die erforderlichen Verbindungsdetails angeben. Klicken Sie auf OK, um den Endpunkt zu speichern und für diese Konfiguration zu verwenden.
  8. Zum Ausführen erforderlicher Änderungen an der ausgewählten Endpunktkonfiguration klicken Sie auf Bearbeiten, um auf die Optionen in einem separaten Fenster zuzugreifen. Alle Änderungen, die Sie global ausführen, haben Auswirkungen auf alle Verwendungen des Endpunkts in aktiven Orchestrierungen.
  9. Klicken Sie in der Prüfliste auf Konfigurieren.
  10. Klicken Sie auf Durchsuchen, um den Objekttyp auszuwählen. Das Fenster Marketo durchsuchen wird angezeigt.
  11. Im Fenster Marketo durchsuchen können Sie den Objekttyp in der Objekttypliste auswählen. Klicken Sie auf OK.
  12. Klicken Sie in der Prüfliste auf Wiederholung. Überprüfen Sie die Standardeinstellungen und nehmen Sie die erforderlichen Änderungen vor.
    Anmerkung: Weitere Informationen finden Sie unter Optionen für 'Wiederholung' für Marketo REST API-Aktivitäten angeben.

    Die beiden nächsten Punkte (Schritt 13 und 14) gelten nicht für den Aktivitätstyp 'Objekt', da für diese Aktivität keine Eingabe erforderlich ist.

  13. Wählen Sie Eingaben zuordnen in der Prüfliste aus. Die XML-Schemas, die aus dem ausgewählten Objekt der Aktivität Alle Objekte abrufen generiert wurden, werden als Knoten unter dem Anforderungseingabeparameter im Fenster An Aktivität angezeigt.
  14. Erstellen Sie eine Zuordnung zwischen den Orchestrierungsvariablen und dem Eingabeparameter der Aktivität.
    Anmerkung: Während der Ausführung müssen Werte für obligatorische Elemente der Eingabestruktur angegeben werden. Ein Wert kann angegeben werden, indem ein Standardwert für ein Element eingegeben wird oder indem das Element mit einem Eingabeknoten verknüpft wird. Wenn während der Ausführung kein Wert für ein obligatorisches Element angegeben wird, löst die Aktivität eine Ausnahmebedingung aus, die von der Web Management Console gemeldet wird. Wenn während der Ausführung kein Wert für einen optionalen Eingabeparameter verfügbar ist, wird keine Ausnahmebedingung ausgelöst.
  15. Wählen Sie die Task Ausgaben zuordnen in der Prüfliste aus. Das XML-Schema, das zur Aufnahme der Antwort der Aktivität generiert wurde, wird als Knoten unter dem Antwortausgabeparameter im Fenster Von Aktivität angezeigt.
  16. Erstellen Sie eine Zuordnung zwischen den Ausgabeparametern und den Orchestrierungsvariablen.
    Tabelle 1. Pflichtfelder
    Objektname Feld Beschreibung
    Folder Content (Ordnerinhalt) FolderId Ist obligatorisch.
    Lead Object (Leadobjekt)
    • retrieveBy
    • id
    • Mögliche Werte für 'retrieveBy': ListId und ProgramId
    • D.er Wert von ID ist die ID der Liste oder die ID des Programms, für die bzw. das Leaddetails erforderlich sind.
    Lead Activity (Leadaktivität)
    • ActivityTypeId
    • nextPageToken
    • Die atomare Aktivität 'Paging-Token abrufen' kann zum Abrufen des Werts von 'nextPageToken' verwendet werden.
    • In einer Anforderung können mehrere 'activityTypeId'-Werte angegeben werden, da das Element unbegrenzt ist.
    Segments (Segmente) SegmentationId Ist obligatorisch.
    Tabelle 2. Allgemeine Parameter
    Objektname Feld
    offset Gibt die relative Anfangsposition an, bei der mit dem Abruf von Einträgen begonnen wird. Kann in Verbindung mit dem Parameter 'maxReturn' zur Seitenaufteilung bei großen Ergebnismengen verwendet werden. Standardwert: 0.
    maxReturn Die maximale Anzahl von Entitäten, die zurückgegeben werden sollen. Standardwert: 20. Maximalwert: 200.
    batchSize Die Anzahl der Datensätze, die in einem einzelnen Aufruf zurückgegeben werden sollen. (Standardwert und Maximalwert hängen von der Marketo-API ab. Gegenwärtig: 300.)
    nextPageToken Dient zum Abruf aufgeteilter Seiten bei großen Ergebnismengen.

Ergebnisse

Sie haben die Marketo-Aktivität 'Alle Objekte abrufen' konfiguriert.