Configuration de l'activité Rechercher objets

Vous devez créer une requête SOSL (Sforce Object Search Language) pour configurer l'activité Rechercher objets.

Pourquoi et quand exécuter cette tâche

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.

Pour configurer l'activité Rechercher objets, procédez comme suit :

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 Valider la requête pour valider la requête. Si la requête n'est pas valide, l'icône Retour de validation 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 :
    • 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.
    • Utilisez l'icône Actualiser pour actualiser les métadonnées et revalider l'instruction SOSL.

Création de requêtes SOSL

Pourquoi et quand exécuter cette tâche

Lorsque vous créez une requête SOSL (Sforce Object Search Language), vous pouvez utiliser des paramètres dynamiques dans la clause WHERE de l'instruction SOSL. 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.

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

Règles syntaxiques SOSL pour IBM Cast Iron

Pourquoi et quand exécuter cette tâche

  • 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 dans la portion Requête de recherche de l'instruction SOSL. Les accolades ( { } ) délimitent la portion Requête de recherche de l'instruction SOSL.
    Important : N'utilisez pas les guillemets ( " " ) pour délimiter les paramètres. Si vous entourez les paramètres de guillemets, l'activité traite le paramètre comme un littéral de recherche de chaîne.
  • Le type de paramètre est toujours xsd:string. Pendant la substitution, l'activité échappe tout paramètre que vous déclarez avec un caractère réservé. Les caractères réservés sont les suivants :
    Caractères réservés Description
    & perluète
    * astérisque
    \ barre oblique inversée
    [ ] crochets
    : deux-points
    , virgule
    { } accolades
    " guillemet
    ! point d'exclamation
    - signe moins
    + signe plus
    ' apostrophe
    ~ tilde
    ^ flèche vers le haut
    | barre verticale
  • 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.



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_Search_Objects_Activity.html