Aktivität 'Objekte abfragen' konfigurieren

Sie müssen eine SOSL-Abfrage (Sforce Object Search Language) erstellen, um die Aktivität Objekte suchen zu konfigurieren. In den folgenden Abschnitten werden die Schritte zur Konfiguration der Aktivität Objekte suchen, zur Erstellung einer SOSL-Abfrage und zur Bereitstellung von SOSL-Syntaxregeln für IBM® Cast Iron erläutert.

Vorgehensweise

  1. Wählen Sie in der Prüfliste die Task Konfigurieren aus.

    Das Fenster Abfrage angeben wird angezeigt.

  2. Erstellen Sei eine SOSL-Abfrage im Fenster Abfrage angeben.
  3. Optional: Sie können dynamische Parameter in der Suchklausel der SOSL-Anweisung angeben. Sie können diese Parameter anschließend dynamisch als Eingabeparameter für die Aktivität zuordnen. Dies ermöglicht der Aktivität, die Abfrage auf Grundlage der Eingabe in die Orchestrierung dynamisch zu steuern. Verwenden Sie das Dollarzeichen ($), um einen Parameter zu kennzeichnen, und geben Sie nach dem Dollarzeichen den Parameternamen ein.
  4. Klicken Sie auf das Symbol 'Validieren' , um die Abfrage zu validieren.
    Wenn die Abfrage ungültig ist, wird das Symbol Validierungsfeedback in der linken, unteren Ecke des Fensters Abfrage angeben angezeigt. Gehen Sie bei ungültigen Abfragen wie folgt vor:
    1. Klicken Sie auf das Symbol Validierungsfeedback in der linken, unteren Ecke des Fensters Abfrage angeben, um eine Liste der Gültigkeitsfehler zu erhalten.
    2. Verwenden Sie das Symbol Aktualisieren , um Metadaten zu aktualisieren und die SOSL-Anweisung erneut zu überprüfen.
  5. Wählen Sie in der Prüfliste die Option Abfrage aus, um bestimmte Abfrageoptionen zu konfigurieren.

    Das Teilfenster Abfrageoptionen wird angezeigt.

  6. Wählen Sie Gelöschte Elemente in die Abfrage aufnehmen (Operation 'queryAll' ausführen) aus, damit die Abfrage zusätzlich zu vorhanden Elementen auch gelöschte Elemente umfasst. Wenn Sie diese Option nicht auswählen, führt die Integrationseinheit (Integration Appliance) die Abfrage nur für vorhandene Element aus.
  7. Geben Sie für die Größe des Abfragestapels einen Wert zwischen 200 und 2000 Abragen ein, um die Leistung der Integrationseinheit (Integration Appliance) zu optimieren.

    Die Option bestimmt die Stapelgröße, die im SOAP-Header 'QueryOptions' für alle Abfrageaufrufe verwendet werden soll, und hat keine Auswirkung auf die Anzahl der Ergebnisse, die von der Aktivität zurückgegeben werden. Der Standardwert für diese Option beträgt 500 Abfragen.

SOSL-Abfragen erstellen

Bei der Erstellung einer SOQL-Abfrage, können Sie dynamische Parameter in der Klausel WHERE der SOQL-Anweisung verwenden. Studio kann anschließend diese Parameter als Eingabeparameter für die Aktivität dynamisch zuordnen. Dies ermöglicht eine dynamische Steuerung der Abfrage auf Grundlage der Eingabe in die Orchestrierung.

Informationen zu diesem Vorgang

Die Abfragesprache SOQL (SForce Object Query Language) definiert keine Syntax für parametrisierte Abfragen. Cast Iron setzt jedoch einige proprietäre SOSL-Syntaxregeln um. Sie können Parameter entweder in einfachen Ausdrücken oder in Gruppenausdrücken verwenden.

SOSL-Syntaxregeln für Cast Iron
  • Verwenden Sie das Dollarzeichen ($), um einen Parameter zu kennzeichnen. Geben Sie nach dem Dollarzeichen ($) eine Zeichenfolge alphanumerischer Zeichen an. Das erste Zeichen muss ein Buchstabe [a-zA-Z] sein, nach dem optional ein oder mehrere Buchstaben [a-zA-Z], Ziffern [0-9] oder ( _ ) Unterstreichungszeichen folgen können.
    Anmerkung: Bei Parameternamen muss die Groß-/Kleinschreibung beachtet werden. Die Parameter '$a' und '$A' werden daher als unterschiedliche Parameter betrachtet.
    Die folgende Tabelle enthält Beispiele gültiger und ungültiger Parameterdeklarationen:
    Parameter Gültig oder ungültig
    $AnAccount gültig
    $a123_456 gültig
    $123a ungültig
    $_id ungültig
  • Sie müssen Parameter auf der rechten Seite eines Ausdrucks in einer Klausel WHERE deklarieren.
  • Parameter können mehrfach in einer bestimmten SOQL-Anweisung vorkommen. Obwohl die Parameter mehrmals in der SOQL-Anweisung vorkommen können, erscheinen sie nur einmal in der Eingabeparameterzuordnung. Die Aktivität ersetzt denselben Wert an allen Positionen, an denen der Parameter zur Laufzeit verwendet wird.
    Anmerkung: Wenn Sie denselben Parameternamen verwenden und der Typ nicht übereinstimmt, tritt ein Fehler auf. Die folgende SOQL führt beispielsweise zu einem Fehler, weil '$param' sowohl als Zeichenfolge als auch als Datumstyp verwendet wird:

    SELECT Name from Account where Name like $param and createdDate > $param

  • Der Typ des Feldes, in dem ein Parameter verglichen wird, bestimmt den Typ des Parameters und legt fest, ob der Parameter in einem einfachen Ausdruck, einem Gruppenausdruck oder einem Teil eines Gruppenausdrucks verwendet wird.
    Typ des Ausdrucks Beschreibung
    Einfacher Ausdruck Beispiel: Select ID from Account where Name = $NameParam

    Der 'SoapType' des Feldes auf der linken Seite des Ausdrucks bestimmt den Parametertyp. Falls der Feldtyp auf null festlegbar ist und der Operator ( = ) oder ( != ) verwendet wird, ist der Parameter auf null festlegbar. Die Definition von 'xsi:nil=true' für den Parameter legt den Parameterwert bei der Ersetzung auf null fest. Falls der Parametertyp das Einschließen in einfache Anführungszeichen (‘) erfordert, wird der Parameterwert bei der Ersetzung in einfache Anführungszeichen gesetzt und die Inhalte werden automatisch mit Escapezeichen versehen.

    Bei SOQL werden der umgekehrte Schrägstrich (\) und die einfachen Anführungszeichen (‘) mit Escapezeichen versehen.

    Gruppenausdrücke Beispiel: Select ID From Account where ID in $idList

    Der Parametertyp ist eine wiederholte Folge des Typs 'SoapType' des Felds auf der linken Seite des Ausdrucks. Der Parameter ist nicht auf null festlegbar und weist minOccurs=1, maxOccurs=unbounded für das Element auf.

    Die Folge wird zur Laufzeit zu einem ordnungsgemäßen Gruppenwert erweitert. Zum Beispiel:

    Wählen Sie die ID vom Account aus, wobei die ID in (‘value1',‘value2') vorkommt.

    Teil eines Gruppenausdrucks Parameter innerhalb einer Gruppenliste werden wie einfache Ausdrucksparametertypen behandelt. Zum Beispiel: SELECT Name from Account where BillingState IN (‘California', $state2)

    In diesem Beispiel ist der Parametertyp '$state2' der 'SoapType' des Felds Account BillingState und kein sich wiederholendes Element. Der Parameter ist nicht auf null festlegbar.




Feedback | Notices


Timestamp icon Letzte Aktualisierung: Friday, November 8, 2013


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/SerMax_Configuring_the_Query_Objects_Activity.html