Configuration de l'activité Demander objets

Vous devez créer une requête SOSL (Sforce Object Search Language) pour configurer l'activité Rechercher objets. Les sections suivantes décrivent les étapes permettant de configurer l'activité Rechercher objets, de créer une requête SOSL et d'indiquer des règles syntaxiques SOSL pour IBM® Cast Iron.

Procédure

  1. Dans Liste de contrôle, sélectionnez Configurer.

    La fenêtre Spécifier une requête apparaît.

  2. Créez une requête SOSL dans la fenêtre Spécifier une requête.
  3. Facultatif : Vous pouvez spécifier des paramètres dynamiques dans la clause de recherche de l'instruction SOSL. Vous pouvez ensuite mapper ces paramètres dynamiquement en tant que paramètres d'entrée de l'activité, ce qui permet à l'activité de contrôler dynamiquement la requête, en fonction des entrées dans l'orchestration. Utilisez le signe dollar ($) pour indiquer un paramètre et faites-le suivre du nom du paramètre.
  4. Cliquez sur l'icône Valider , pour valider la requête.
    Si la requête n'est pas valide, l'icône Retour de validation apparaît dans l'angle inférieur gauche de la fenêtre Spécifier une requête. Pour les requêtes non valides :
    1. Cliquez sur l'icône Retour de validation dans l'angle inférieur gauche de la fenêtre Spécifier une requête pour afficher la liste des erreurs de validation.
    2. Utilisez l'icône Actualiser pour actualiser les métadonnées et revalider l'instruction SOSL.
  5. Dans la Liste de contrôle, sélectionnez Requête pour configurer des options de requête spécifiques.

    Le panneau Options de requête apparaît.

  6. Sélectionnez Inclure les éléments supprimés dans la requête (exécuter une opération queryAll), pour demander les enregistrement supprimés en plus des enregistrement existants. Si vous ne sélectionnez cette option, le dispositif d'intégration ne demande que les enregistrements existants.
  7. Spécifiez une Taille de lot de requêtes entre 200 et 2000 requêtes afin d'optimiser les performances du dispositif d'intégration.

    Cette option détermine la taille des lots à utiliser dans l'en-tête SOAP de QueryOptions pour tous les appels de requête et n'affecte pas le nombre de résultats renvoyés par l'activité. Par défaut, cette option est paramétrée à 500 requêtes.

Création de requêtes SOSL

Lorsque vous créez une requête SOQL, vous pouvez utiliser des paramètres dynamiques dans la clause WHERE de l'instruction SOQL. Studio peut alors dynamiquement mapper ces paramètres en tant que paramètres d'entrée de l'activité. Cela permet le contrôle dynamique de la requête en fonction de l'entrée dans l'orchestration.

Pourquoi et quand exécuter cette tâche

SOSL (SForce Object Query Language) ne définit pas de syntaxe pour les requêtes paramétrées ; toutefois, Cast Iron impose des règles syntaxiques SOQL propriétaires. Vous pouvez utiliser des paramètres dans des expressions simples ou des expressions définies.

Règles syntaxiques SOSL pour for Cast Iron
  • Utilisez le signe dollar ($) pour indiquer un paramètre. Après le signe dollar ($), spécifiez une chaîne de caractères alphanumériques. Le premier caractère doit être une lettre [a-zA-Z], suivie facultativement par une ou plusieurs lettres [a-zA-Z], chiffres [0-9] ou traits de soulignement ( _ ).
    Remarque : Les noms de paramètre sont sensibles à la casse, par conséquent les paramètres $a et $A sont considérés comme différents.
    Le tableau suivant contient des exemples de déclarations de paramètre valides et non valides :
    Paramètre Valide ou non valide
    $AnAccount valide
    $a123_456 valide
    $123a non valide
    $_id non valide
  • Vous devez déclarer les paramètres à droite d'une expression, dans une clause WHERE.
  • Les paramètres peuvent apparaître plusieurs fois dans une instruction SOQL donnée. Toutefois, même si le paramètre apparaît plusieurs fois dans l'instruction SOQL, il n'apparaît qu'une fois dans la mappe de paramètre d'entrée. L'activité substitue la même valeur pour tous les emplacements où le paramètre est utilisé à l'exécution.
    Remarque : Lorsque vous utilisez le même nom de paramètre et qu'il existe une non-concordance de type, une erreur se produit. Par exemple, l'instruction SOQL suivante génère une erreur car $param est utilisé en tant que chaîne et que type de date :

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

  • Le type de la zone où un paramètre est comparé détermine le type du paramètre et indique si le paramètre est utilisé dans une expression simple, une expression définie ou une partie d'une expression définie.
    Type d'expression Description
    Expressions simples Par exemple : Select ID from Account where Name = $NameParam

    Le SoapType de la zone à gauche de l'expression détermine le type de paramètre. Si le type de zone est nillable et que l'opérateur est ( = ) ou ( != ), le paramètre est nillable. L'attribution de la valeur xsi:nil=true dans le paramètre définit la valeur de paramètre à NULL lorsqu'il est substitué. Si le type de paramètre requiert que ce dernier soit entouré d'apostrophes (‘), la valeur du paramètre est entourée d'apostrophes pendant la substitution et son contenu est échappé automatiquement.

    Pour SOQL, la barre oblique inversée (\) et l'apostrophe (‘) sont échappées.

    Expressions définies Par exemple : Select ID From Account where ID in $idList

    Le type de paramètre est une séquence répétée de SoapType de la zone à gauche de l'expression. Le paramètre n'est nillable et comporte minOccurs=1 et maxOccurs=unbounded sur l'élément.

    La séquence est développée à l'exécution pour être une valeur correcte, par exemple :

    Select Id From Account where Id in (‘value1',‘value2')

    Partie d'une expression définie Les paramètres d'une liste définie sont traités comme un type de paramètre d'expression simple, par exemple : SELECT Name from Account where BillingState IN (‘California', $state2)

    Dans cet exemple, le type de paramètre $state2 est le SoapType de la zone Account BillingState et il ne s'agit pas d'un élément répété. Le paramètre n'est pas nillable.




Commentaires | Notices


Icône d'horodatage Dernière révision: Friday, November 1, 2013


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