Zum Inhalt springen

Microsoft Dynamics CRM Connector-Abfrage im Jitterbit Design Studio

Einführung

Eine Microsoft Dynamics CRM Query-Aktivität unter Verwendung ihres Microsoft Dynamics CRM Endpoint, fragt ein Objekt in Microsoft Dynamics CRM ab und soll als Quelle in einem Operation verwendet werden.

Erstellen einer Microsoft Dynamics CRM Abfrageaktivität

Eine Instanz einer Microsoft Dynamics CRM Query-Aktivität wird aus einem Microsoft Dynamics CRM Endpoint erstellt mithilfe des Aktivitätstyps Abfrage.

Um eine Instanz einer Aktivität zu erstellen, folgen Sie einer dieser Optionen:

  • Navigieren Sie zu Datei > Neu > Konnektoren > Neue MS CRM-Abfrage.
  • Erweitern Sie in der Strukturansicht links unter Konnektoren die Option Microsoft Dynamics CRM, klicken Sie dann mit der rechten Maustaste auf MS CRM-Abfragen und wählen Sie Neue MS CRM-Abfrage.
  • Klicken Sie in der oberen Symbolleiste auf das Konnektorsymbol. Wählen Sie im Dialogfeld Microsoft Dynamics CRM und dann MS CRM Query aus.

Konfigurieren einer Microsoft Dynamics CRM Abfrageaktivität

Führen Sie die folgenden Schritte aus, um eine Microsoft Dynamics CRM -Abfrage-Aktivität zu konfigurieren:

Schritt 1: Auswählen oder Erstellen eines Endpoint

Wählen oder erstellen Sie in diesem Schritt einen Endpoint aus der Dropdown-Liste Verfügbare MS CRM Endpoints:

Anhang

  • Name: Nachdem Sie einen vorhandenen Endpoint ausgewählt haben, können Sie hier den Namen des Endpoint ändern.
  • Verbindungsparameter: Nachdem Sie einen vorhandenen Endpoint ausgewählt haben, werden dessen Verbindungsparameter angezeigt und Sie können diese Parameter hier ändern. Weitere Informationen zu den einzelnen Verbindungsparametern finden Sie unter Microsoft Dynamics CRM Connector-Endpoint.
  • Weiter: Klicken Sie hier, um zum nächsten Bildschirm zu navigieren.
  • Abbrechen: Klicken Sie hier, um die Aktivitätskonfiguration ohne Speichern zu schließen.

Schritt 2: Objekt auswählen

Wählen Sie in diesem Schritt das abzufragende Objekt aus und wählen Sie eine Option zum Erstellen der Abfrage.

Auswählen eines Objekts

Wählen Sie das abzufragende Objekt aus:

Anhang

  • Filter: Geben Sie einen beliebigen Teil des Objektnamens in das Suchfeld ein, um die Liste der Objekte zu filtern. Die Suche ist nicht groß- und kleinschreibungsabhängig. Wenn in der Tabelle bereits Objekte angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Objekte während der Suche vom Endpoint neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.
  • Anzeigen: Wählen Sie entweder Logischer Name oder Anzeigename, um die Anzeige der Objektnamen zu ändern.
  • Objekt auswählen: Klicken Sie in der Tabelle irgendwo auf eine Zeile, um ein Objekt auszuwählen. Es kann nur ein Objekt ausgewählt werden. Das ausgewählte Objekt wird blau hervorgehoben.

  • Aktualisieren: Klicken Sie hier, um Objekte vom Microsoft Dynamics CRM Endpoint neu zu laden. Dies kann nützlich sein, wenn Objekte zu Microsoft Dynamics CRM hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Objekttabelle verwendet werden.

    Hinweis

    Wenn die Liste nicht mit kürzlich hinzugefügten Objekten gefüllt wird oder kürzlich entfernte Objekte weiterhin angezeigt werden, befolgen Sie diese Schritte, um die zwischengespeicherten Werte zu löschen und die Liste korrekt zu füllen:

    1. Folgen Sie auf Ihrem lokalen Computer dem Pfad C:\Users\<username>\JitterbitStudio\cache\7.1\ConnectorObjectCache\MSCrm.

    2. Löschen Sie die dort vorhandenen Dateien.

    3. Klicken Sie erneut auf die Schaltfläche Aktualisieren.

  • Zurück: Klicken Sie hier, um zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie hier, um zum nächsten Bildschirm zu gelangen.

  • Abbrechen: Klicken Sie hier, um die Aktivitätskonfiguration ohne Speichern zu schließen.

Auswählen einer Abfrage

Wählen Sie die Abfrageerstellungsoption aus, die Ihrer Situation entspricht:

Anhang

  • Jitterbits Abfrage-Generator verwenden: Wählen Sie die Verwendung des Jitterbit Abfrage Generators aus, in dem Sie eine Abfrage erstellen können, entweder automatisch durch Auswählen von Feldern und Festlegen von Bedingungen oder manuell durch direkte Eingabe einer Abfrage. Weitere Informationen finden Sie unter Jitterbits Abfrage Generator verwenden unten.
  • Herunterladen oder Kopieren einer gespeicherten Abfrage aus Ihrem CRM-System: Wählen Sie diese Option aus, um eine zuvor gespeicherte Abfrage aus Ihrer Microsoft Dynamics CRM Instanz herunterzuladen oder zu kopieren.
  • Zurück: Klicken Sie hier, um zum vorherigen Schritt zurückzukehren.
  • Weiter: Klicken Sie hier, um zum nächsten Bildschirm zu gelangen.
  • Abbrechen: Klicken Sie hier, um die Aktivitätskonfiguration ohne Speichern zu schließen.

Schritt 3: Erstellen der Abfrage

Erstellen Sie in diesem Schritt die Abfrage oder laden Sie die Abfrage von Ihrer Microsoft Dynamics CRM Instanz herunter.

Die in diesem Schritt der Konfiguration einer Microsoft Dynamics CRM Abfrage-Aktivität verwendete Schnittstelle hängt von den Abfrageerstellungsoptionen ab, die in Schritt 2: Objekt auswählen ausgewählt wurden:

Verwenden Sie den Abfrage von Jitterbit

Wenn Jitterbits Abfrage-Generator verwenden unter Optionen zur Abfrageerstellung ausgewählt ist, wird diese Schnittstelle angezeigt:

Anhang

  • Attribute auswählen: Dieser Abschnitt zeigt die im Microsoft Dynamics CRM Endpoint verfügbaren Attribute an:

    • Alle Attribute verwenden: Wählen Sie „Alle Attribute in der ausgefüllten Liste Abfrage“ aus.
    • Filter: Geben Sie einen beliebigen Teil des Attributnamens in das Suchfeld ein, um die Liste der Attribute zu filtern. Die Suche ist nicht groß- und kleinschreibungsabhängig. Wenn in der Tabelle bereits Attribute angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert.
    • Alles auswählen: Klicken Sie, um alle Attribute für die Abfrage auszuwählen.
    • Alle entfernen: Klicken Sie hier, um die Auswahl aller zuvor ausgewählten Attribute für die Abfrage aufzuheben.

  • Resultierendes Fetch-XML:** Wenn Sie Felder auswählen, wird die Abfrage im Textfeld Resultierendes Fetch-XML automatisch mit dem Objekt, den ausgewählten Attributen und Bedingungen aufgefüllt.

  • Filter: Fügt Bedingungen hinzu, um die Abfrage weiter zu filtern. Wählen Sie im Abschnitt Filter die entsprechenden Operatoren aus, einen von UND oder ODER:

    • UND: Wählen Sie diese Option für Abfragen, bei denen sowohl linke als auch rechte Ausdrücke true.

    • ODER: Wählen Sie diese Option für Abfragen, die entweder einen linken oder einen rechten Ausdruck erfordern true.

    • Hinzufügen: Klicken Sie hier, um eine Bedingung hinzuzufügen. Nach dem Klicken auf Hinzufügen wird ein Dialogfeld angezeigt:

      Anhang

      • Attribut auswählen: Geben Sie einen beliebigen Teil des Attributnamens in das Suchfeld ein, um die Liste der anwendbaren Attribute zu füllen. Die Ergebnisse werden mit jedem Tastendruck in Echtzeit gefiltert. Alternativ können Sie auf Auswählen klicken, um aus einer Liste der verfügbaren Attribute auszuwählen.
      • Operator auswählen: Geben Sie einen beliebigen Teil des Operators in das Suchfeld ein, um die Liste der anwendbaren Operatoren zu füllen. Die Ergebnisse werden mit jedem Tastendruck in Echtzeit gefiltert. Alternativ können Sie auf Auswählen klicken, um aus einer Liste der verfügbaren Operatoren auszuwählen.
      • Wert eingeben: Geben Sie den gewünschten Wert ein, der mit den vorherigen Auswahlen verwendet werden soll.
      • Abbrechen: Klicken Sie hier, um den Dialog zu schließen, ohne die Bedingung zu speichern.
      • Ok: Klicken Sie hier, um den Dialog zu schließen und die Bedingung zu speichern.

    • Bearbeiten: Wählen Sie eine zuvor erstellte Bedingung aus und klicken Sie auf Bearbeiten, um die Auswahl für die Bedingung zu ändern.

    • Löschen: Wählen Sie eine zuvor erstellte Bedingung aus und klicken Sie auf Löschen, um die Bedingung aus der Abfrage zu entfernen.

  • Bestellung: Fügt Bestellungen hinzu, um die Antwort zu filtern:

    • Hinzufügen: Klicken Sie hier, um einem Attribut eine Reihenfolge hinzuzufügen. Nach dem Klicken auf Hinzufügen wird ein Dialogfeld angezeigt:

      Anhang

      • Suchen: Geben Sie einen beliebigen Teil des Attributnamens in das Suchfeld ein, um die Liste der anwendbaren Attribute zu füllen. Die Ergebnisse werden mit jedem Tastendruck in Echtzeit gefiltert.
      • Auswählen: Klicken Sie, um ein Attribut aus einer Liste verfügbarer Attribute auszuwählen.
      • Dropdown: Verwenden Sie das Dropdown-Menü, um die Reihenfolge für das Attribut auszuwählen, entweder Aufsteigend oder Absteigend.

    • Bearbeiten: Wählen Sie eine zuvor erstellte Bestellung aus und klicken Sie auf Bearbeiten, um die Auswahl für die Bestellung zu ändern.

    • Löschen: Wählen Sie eine zuvor erstellte Bestellung aus und klicken Sie auf Löschen, um die Bestellung aus der Abfrage zu entfernen.

  • Entitäten verknüpfen: Fügt der Abfrage eine Entitätsbeziehung hinzu:

    • Hinzufügen: Klicken Sie hier, um der Abfrage eine Entitätsbeziehung hinzuzufügen.
    • Bearbeiten: Wählen Sie eine zuvor verknüpfte Entität aus und klicken Sie auf Bearbeiten, um die Auswahl für die verknüpften Entitäten zu ändern.
    • Löschen: Wählen Sie eine zuvor verknüpfte Entität aus und klicken Sie auf Löschen, um die verknüpften Entitäten aus der Abfrage zu entfernen.

  • Zurück: Klicken Sie hier, um zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie hier, um die Datenstrukturen zu überprüfen und die Aktivitätskonfiguration abzuschließen.
  • Abbrechen: Klicken Sie hier, um die Aktivitätskonfiguration ohne Speichern zu schließen.

Laden Sie eine gespeicherte Abfrage aus Ihrem CRM-System herunter oder kopieren Sie sie

Wenn Eine gespeicherte Abfrage aus Ihrem CRM-System herunterladen oder kopieren für Optionen zum Erstellen von Abfragen ausgewählt ist, wird diese Schnittstelle angezeigt:

Anhang

  • Wählen Sie eine Abfrage aus: Verwenden Sie die Dropdown-Liste, um eine gespeicherte Abfrage aus der Microsoft Dynamics CRM Instanz auszuwählen.
  • Gespeicherte Abfragen herunterladen: Klicken Sie hier, um gespeicherte Abfragen aus der Microsoft Dynamics CRM Instanz herunterzuladen.
  • Texteditor: Sie können eine Abfrage manuell erstellen, indem Sie eine XML- Abfrage direkt in den Texteditor eingeben oder einfügen.
  • Baumeditor: Wählen Sie im Baumeditor einen Bedingungswert aus, um den Wert zu bearbeiten:
    • Bedingungswert bearbeiten: Geben Sie den gewünschten Bedingungswert ein.
    • Übernehmen: Klicken Sie hier, um den Bedingungswert auf die Abfrage anzuwenden.
  • Zurück: Klicken Sie hier, um zum vorherigen Schritt zurückzukehren.
  • Fertig: Klicken Sie hier, um die Datenstrukturen zu überprüfen und die Aktivitätskonfiguration abzuschließen.
  • Abbrechen: Klicken Sie hier, um die Aktivitätskonfiguration ohne Speichern zu schließen.

Schritt 4: Überprüfen der Datenstrukturen

Alle vom Endpoint generierten Anforderungs- oder Antwortstrukturen werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

Anhang

  • Name: Geben Sie einen Namen zur Identifizierung der Aktivität ein. Der Name muss für jede Microsoft Dynamics CRM Query-Aktivität eindeutig sein.
  • Endpoint: Wählen oder erstellen Sie einen neuen Endpoint, der für die Abfrage-Aktivität verwendet werden soll.
  • Bearbeiten: Klicken Sie hier, um den ausgewählten Microsoft Dynamics CRM Connector-Endpoint zu bearbeiten.
  • Typ: Hier wird der Aktivitätstyp angezeigt.
  • Objekt: Das zuvor ausgewählte Objekt aus Schritt 2: Objekt auswählen wird hier angezeigt.
  • Abfrage-XML: Klicken Sie auf Bearbeiten, um das zuvor konfigurierte Abfrage XML zu ändern.
  • In einer Integration verwenden: Wählen Sie eine der Optionen Vorgang erstellen, Anforderung erstellen oder Antwort erstellen aus.
    • Vorgang erstellen: Klicken Sie hier, um einen Operation mit der konfigurierten Abfrage-Aktivität zu erstellen.
    • Anfrage erstellen: Klicken Sie hier, um zum Transformation zu navigieren-Bildschirm, wo Sie eine Transformation für die konfigurierte Abfrage-Aktivität konfigurieren können.
    • Antwort erstellen: Klicken Sie hier, um zum Transformation zu navigieren-Bildschirm, wo Sie eine Transformation für die konfigurierte Abfrage-Aktivität konfigurieren können.

Nächste Schritte

Informationen zur Verwendung konfigurierter Aktivitäten in einem Operation finden Sie in den folgenden Ressourcen: