Configurando a Atividade Procurar Objetos

Você deve criar uma consulta SForce Object Search Language (SOSL) para configurar a atividade Procurar Objetos.

Sobre Esta Tarefa

As seções a seguir discutem as etapas para configurar a atividade Procurar Objetos, criar uma consulta SOSL e fornecer regras de sintaxe de SOSL para o IBM® WebSphere Cast Iron.

Para configurar a atividade Procurar Objetos, conclua as etapas a seguir:

Procedimento

  1. Na Lista de Verificação, selecione Configurar. A janela Especificar Consulta é aberta.
  2. Crie uma consulta SOSL na janela Especificar Consulta.
  3. Opcional: É possível especificar parâmetros dinâmicos na cláusula de procura da instrução SOSL. Depois, é possível mapear esses parâmetros dinamicamente como os parâmetros de entrada para a atividade, o que permite que a atividade controle dinamicamente a consulta com base na entrada para a orquestração. Use um cifrão ($) para indicar um parâmetro e suceda-o com o nome do parâmetro.
  4. Clique no ícone Validar Validar Consulta, para validar a consulta. Se a consulta for inválida, o ícone Feedback de Validação ícone Feedback de Validação será mostrado no canto inferior esquerdo da janela Especificar Consulta. Para consultas inválidas:
    • Clique no ícone Feedback de Validação no canto inferior esquerdo da janela Especificar Consulta para uma lista de validação de erros.
    • Use o ícone Atualizar para atualizar metadados e revalidar a instrução SOSL.

Criando Consultas SOSL

Sobre Esta Tarefa

Ao criar uma consulta SForce Object Search Language (SOSL), é possível usar parâmetros dinâmicos na cláusula WHERE da instrução SOSL. Depois, o Studio pode mapear esses parâmetros dinamicamente como os parâmetros de entrada para a atividade. Isto permite o controle dinâmico da consulta com base na entrada para a orquestração.

O SForce Object Search Language não define uma sintaxe para consultas parametrizadas; entretanto, o IBM WebSphere Cast Iron impinge algumas regras de sintaxe de SOSL proprietário. É possível usar parâmetros em expressões simples ou configurar expressões.

Regras de Sintaxe de SOSL para IBM WebSphere Cast Iron

Sobre Esta Tarefa

  • Use um cifrão ($) para indicar um parâmetro. Após o cifrão ($), especifique uma cadeia de caracteres alfanuméricos. O primeiro caractere deve ser uma letra [a-zA-Z], seguida opcionalmente por uma ou mais letras [a-zA-Z], dígitos [0-9] ou ( _ ) sublinhados.
    Nota: Os nomes de parâmetros fazem distinção entre maiúsculas e minúsculas; portanto, os parâmetros $a e $A são considerados parâmetros diferentes.
    A tabela a seguir contém exemplos de declarações de parâmetros válidos e inválidos:
    Parâmetro Válido ou Inválido
    $AnAccount válido
    $a123_456 válido
    $123a inválido
    $_id inválido
  • Você deve declarar parâmetros na parte Consulta de Procura da instrução SOSL. As chaves ( { } ) demarcam a parte da Consulta de Procura da instrução SOSL.
    Importante: Não use aspas duplas ( " " ) para delimitar parâmetros. Se você delimitar parâmetros em aspas duplas, a atividade tratará o parâmetro como um literal de procura de cadeia.
  • O tipo de parâmetro é sempre xsd:string. Durante a substituição, a atividade inclui um caractere de escape em qualquer parâmetro declarado usando um caractere reservado. Os caracteres reservados incluem os seguintes caracteres:
    Caracteres Reservados Descrição
    & e comercial (símbolo &)
    * asterisco
    \ barra invertida
    [ ] colchetes
    : dois-pontos
    , vírgula
    { } chaves
    " aspas duplas
    ! ponto de exclamação
    - sinal de menos
    + sinal de mais
    ' aspa única
    ~ til
    ^ circunflexo
    | barra vertical
  • Os parâmetros podem aparecer mais de uma vez em uma determinada instrução SOQL. Entretanto, mesmo que o parâmetro apareça mais de uma vez na instrução SOQL, ele só aparecerá uma vez no mapa de parâmetros de entrada. A atividade substitui o mesmo valor para todos os locais em que o parâmetro é usado no tempo de execução.