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 seguintes seções discutem as etapas para configurar a atividade Procurar Objetos, criar uma consulta SOSL e fornecer regras de sintaxe SOSL para o IBM® 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. É 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 que é baseada 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

Durante a criação de 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. Isso permite o controle dinâmico da consulta que é baseada na entrada para a orquestração.

O Sforce Object Search Language não define uma sintaxe para consultas parametrizadas; no entanto, o IBM 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 SOSL para o IBM 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 (" ") ao redor dos parâmetros. Se você colocar os parâmetros entre aspas duplas, a atividade tratará o parâmetro como um literal de procura de sequência.
  • 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
    ' aspas simples
    ~ 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 nos quais o parâmetro é usado no tempo de execução.