Marketo-Aktivität 'Objekte erstellen' verwenden

Mit der Aktivität 'Objekte erstellen' können Sie Objekte in Marketo erstellen.

Informationen zu diesem Vorgang

Verwenden Sie diese Task, um Objekte in Marketo zu erstellen. 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 Objekte erstellen auf die Orchestrierung. Wählen Sie die Aktivität aus. Die Prüfliste der Marketo-Aktivität 'Objekte erstellen' 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.
  13. Wählen Sie Eingaben zuordnen in der Prüfliste aus. Die XML-Schemas, die aus dem ausgewählten Objekt der Aktivität Objekte erstellen generiert wurden, werden als Knoten unter dem Anforderungseingabeparameter im Fenster An Aktivität angezeigt.
    • Verschiedene Objekte haben unterschiedliche Sätze von Pflichtfeldern zum Erstellen eines Datensatzes. Wenn Pflichtfelder nicht angegeben werden, hat dies eine Fehlernachricht zur Folge, in der die fehlenden Felder aufgeführt werden.
    • Beim Erstellen von Dateien (Objekttyp 'File') werden Dateien der Typen 'text/html' und 'text/plain' unterstützt. Die Angabe 'ContentType' muss mit einem dieser Werte und Daten müssen im Feld “file” angegeben werden.
    Anmerkung:
    • Für das Erstellen einer Datei (Create File) und einer E-Mail-Schablone (Create Email Template) sind Binärdaten als Eingabeparameter für die Felder ‘file’ bzw. ‘content’ erforderlich.
    • Wenn beim Erstellen einer Datei (Create File) versucht wird, dieselbe Datei erneut hochzuladen, und
      • wenn das Flag ‘insert only’ (Nur Einfügen) den Wert 'true' hat, wird die Fehlernachricht wegen doppelter Dateierstellung ausgelöst.
      • wenn das Flag ‘insert only’ (Nur Einfügen) den Wert 'false' hat, wird die Anforderung erfolgreich ausgeführt, jedoch wird der Dateiinhalt nicht aktualisiert.
    • Die Erstellung von angepassten Aktivitäten wird nicht unterstützt. Diese Funktion ist in der Marketo-Instanz nicht aktiviert und wurde daher nicht implementiert. Beim Marketo-Support-Team wurde dazu ein Ticket geöffnet.
  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.

Ergebnisse

Sie haben die Marketo-Aktivität 'Objekte erstellen' konfiguriert.
Anmerkung:

Sie können mehrere Objekte als Eingabe für diese Aktivität hinzufügen. Zum Hinzufügen mehrerer Objekte als Eingabe klicken Sie mit der rechten Maustaste auf das Feld Objektname (Beispiel: Company) im Fenster An Aktivität unter Eingaben zuordnen und wählen die Option Vorkommen einblenden aus.