Consultando Documentos do Domino
A atividade Consultar Documento é usada para consultar documentos do banco de dados no servidor Lotus® Domino® que correspondam aos valores especificados nos campos de documento.
- Dados de negócios de documento: Quando especificar os dados de negócios de documento na seção Entrada de Mapa, o conector lê todos os dados válidos a partir da entrada de mapa. O conector procura no banco de dados para saber se há documentos que correspondem a esses dados válidos. Todos os documentos correspondentes que podem ser representados usando o esquema de mapear saída são retornados como uma resposta.
- ParentDocumentUNID: Quando você especifica um ParentDocumentUNID válido na seção Mapear Entrada, o conector consulta todos os documentos-filho para esse documento-pai. Todos os documentos correspondentes, que podem ser representados usando o esquema de saída de mapa, são retornados como uma resposta.
- Nenhum conjunto de dado: Quando nenhum dado for fornecido na entrada de mapa, o conector consultará os documentos que podem ser representados usando o esquema de mapear saída.
- Método Procura do Banco de Dados: Os critérios de seleção determinados para um documento retorna todos os documentos em um banco de dados que atendem aos critérios.
Por padrão, a atividade usa o método Procura do Banco de Dados para procurar documentos. Para configurar explicitamente a procura para esse tipo, configure o valor do parâmetro opcional searchType para NORMAL_SEARCH na seção de entrada do mapa. Esse método suporta a procura de documentos com base nos seguintes tipos de critério de procura:
- Valores únicos: É possível especificar um valor único nos critérios
de procura. Por exemplo, o conector pode consultar documentos que são baseados
no único número, palavra ou data que é especificado no campo de procura. É possível
localizar mais informações sobre os valores de procura que podem ser especificados
nos campos de tipo Número e Data nos seguintes pontos.
- Números: É possível especificar um número de dois dígitos ou um valor de número inteiro como os critérios de procura no campo de tipo de Números. É possível usar essa função de procura para consultar documentos em que o campo de tipo Número é igual a um determinado valor. Por exemplo, para consultar documentos nos quais o salário do funcionário é igual a 1234.56, insira o valor 1234.56 no campo EmployeeSalary.
- Data: É possível especificar uma data como os critérios de procura em qualquer campo de tipo de Data. Por exemplo, para consultar documentos nos quais o nascimento é igual a 1982/11/22, especifique o valor 1982/11/22 no campo Nascimento.
- Valores múltiplos: É possível especificar diversos valores como critério de procura para qualquer tipo de campo do Lotus Domino. Esse recurso pode ser usado para localizar os documentos com os valores especificados no tempo de execução. Por exemplo, é possível configurar o conector para recuperar documentos que correspondem às palavras especificadas no critério de procura.
- Procura de texto para conteúdo rich text: É possível especificar os textos para procurar documentos que têm conteúdo rich text no tempo de execução. O conector realiza uma procura usando os textos especificados no campo RichText, e todos os documentos correspondentes são recuperados pelo conector. O conector suporta procuras de conteúdo de texto única e múltipla para o campo RichText. Também é possível fornecer sufixos de curinga, como *, para procurar documentos no campo RichText.
- Procurar usando vários campos: É possível especificar valores de procura em mais de um campo. Nessa configuração, a atividade usa o operador AND lógico para agrupar sequências de procura. Por exemplo, é possível especificar um valor único, valores múltiplos, RichText ou ParentDocumentUNID em diferentes campos. A atividade retorna apenas o conteúdo da procura que corresponde a todos os critérios especificados.
- Valores únicos: É possível especificar um valor único nos critérios
de procura. Por exemplo, o conector pode consultar documentos que são baseados
no único número, palavra ou data que é especificado no campo de procura. É possível
localizar mais informações sobre os valores de procura que podem ser especificados
nos campos de tipo Número e Data nos seguintes pontos.
- Método de Procura FTSearch/Indexada do Banco de Dados: Realiza uma procura de texto completo de todos os documentos em um banco de dados. Quando o banco de dados é completamente
indexado, o método de procura indexada é mais rápido se comparado ao método Procurar no
Banco de Dados. O método classifica os dados de saída por pontuação de relevância. Quando a coleção é classificada por relevância, a relevância mais alta aparece
primeiro. Para configurar explicitamente as procuras para esse tipo, configure o valor
do parâmetro opcional searchType como FULL_TEXT_SEARCH na seção de entrada do mapa.
- Procurar usando diversos campos: O método de procura indexada suporta a procura usando diversos campos. É possível especificar os valores de procura em mais de um campo. Nessa configuração, o conector usa o operador AND lógico para agrupar as sequências de procura. Por exemplo, é possível especificar um valor único, valores múltiplos ou ParentDocumentUNID em diferentes campos. O conector retorna uma operação AND lógica de todos os critérios de procura especificados, retornando correspondências aproximadas e exatas para os campos de tipo de sequência e correspondências exatas para os campos de tipo numérico.
Nota: O método de procura indexada não funciona para os campos RichText, Anexos e Data.
- Clique com o botão direito do mouse em Orquestração na área da janelaProjeto e clique em Nova Orquestração para criar ou abrir uma orquestração. A área da janela de orquestração é exibida.
- Selecione a guia Atividades e expanda a pasta Domino.
- Arraste Atividade de Consulta da pasta Domino para a orquestração. Uma representação gráfica da orquestração juntamente com a Lista de verificação é exibida.
- Clique em Selecionar Terminal e, em seguida,
selecione um terminal do Domino.
Para obter instruções sobre a criação ou edição de um terminal do Domino, consulte Criando ou Editando um Terminal para uma Atividade do Domino.
- Clique em Configurar na Lista de Verificação. A área de janela Configurar é exibida.
- Clique em Navegar para selecionar um banco de dados existente na área de janela Navegar no Banco de Dados do Domino. Procurar Bancos de Dados do Domino exibe todos os bancos de dados para o terminal selecionado.
- Clique em Avançar para selecionar um formulário existente na área de janela Navegar nos Formulários do Domino.
Procurar Formulários do Domino exibe todos os formulários presentes no banco de dados selecionado do servidor do Domino. Nota: O botão Avançar só é ativado após você ter selecionado o nome do banco de dados.
- Campos com nomes canônicos aceitam campos que podem ter nomes canônicos como John Smith/IBM/COUNTRY como valores, que são separados por vírgulas. Especifique os nomes canônicos nesse campo se quiser converter os valores nesses campos a endereços de correio na Internet, como johnsmith@country.ibm.com. Alguns dos exemplos de nome de campo são Para, De, CC, Coordenador, Participante Requerido, entre outros.
- Selecione Mapear Entradas na Lista de Verificação.
Os esquemas XML gerados a partir do objeto selecionado da atividade Consultar Documentos são exibidos como nós sob o parâmetro de entrada de solicitação no painel Atividade de Destino.
Para Tipos de Formulário que são iguais em vários bancos de dados, é possível especificar o nome do banco de dados como parte dos parâmetros opcionais nas entradas de mapa, em que a mesma orquestração pode ser usada para executar operações de saída em bancos de dados diferentes. Para isso, você deve especificar o nome do banco de dados no parâmetro opcional databaseName (descrito na Tabela 1). Se o parâmetro databaseName for preenchido com um valor, a operação de saída será executada no banco de dados especificado no parâmetro databaseName. Se não houver um valor especificado, o nome do banco de dados que é especificado durante a configuração será usado para executar a operação de saída.
O parâmetro de entrada opcional é descrito na tabela a seguir:
Tabela 1. Parâmetro de Entrada Opcional Nome do parâmetro Descrição databaseName databaseName é o nome do banco de dados a partir do qual o documento é consultado. Se um valor for configurado para esse parâmetro, o valor do banco de dados fornecido no painel Configurar será sobrescrito. Esse parâmetro é útil quando documentos com a mesma estrutura (Formulário) precisam ser consultados a partir de vários bancos de dados usando a mesma orquestração. O conector Domino também suporta a conexão de terminal dinâmico com um servidor Domino diferente. Durante o tempo de execução, se quiser se conectar dinamicamente a um servidor Domino diferente do configurado na página do terminal, inclua os novos parâmetros opcionais em dominoConnectionProperties das entradas de mapa. Os parâmetros de dominoConnectionProperties são descritos na tabela a seguir:Tabela 2. Parâmetros de Conexão Opcionais Parâmetros Descrição Parâmetros dominoConnectionProperties hostName Especifica o nome ou endereço de IP da máquina na qual o servidor Domino está em execução. diiopPort Especifica a porta Domino Internet Inter-ORB Protocol (DIIOP) que permite que applets ou aplicativos Java™ acessem dados do Domino remotamente usando CORBA. O valor padrão é 63148. username Especifica o nome do usuário para se conectar ao servidor Domino Parâmetros connectionPool minimumConnections Especifica o número mais baixo de conexões do servidor Domino que o Integration Appliance mantém abertas no conjunto de conexões. A inserção de 0 (zero) é suportada. O valor-padrão é 5. maximumConnections Especifica o número máximo de conexões do servidor Domino que o Integration Appliance pode manter abertas no conjunto de conexões. A inserção de 0 (zero) significa que o número máximo de conexões é ilimitado. O valor padrão é 25. maxIdleTime Especifica a quantidade de tempo em minutos que uma conexão do servidor Domino pode ficar aberta no estado inativo antes de ser encerrada pelo Integration Appliance. A inserção de 0 (zero) significa que as conexões são fechadas quando retornadas para o conjunto — nenhum tempo inativo. O valor padrão é 120 minutos. maxWait Especifica o período de tempo, em segundos, que o Dispositivo de Integração aguarda uma conexão quando todas as conexões no conjunto são esgotadas. Se nenhuma conexão é obtida após o tempo de espera, uma exceção é lançada. O valor padrão é 300 segundos. reclaimConnections Especifica o intervalo em que o conector verifica conexões inativas. As conexões inativas são recuperadas até que o número mínimo de conexões seja atingido, conforme especificado no parâmetro Minimum Connections. O valor padrão é 5 minutos. password Especifica a senha associada ao nome de usuário para se conectar ao servidor Domino. - Crie um mapa entre as variáveis de orquestração e o
parâmetro de entrada da atividade. Nota: Os valores devem ser fornecidos no tempo de execução para quaisquer elementos obrigatórios da estrutura de entrada. Um valor pode ser fornecido ao especificar um valor padrão para o elemento ou ao vincular o elemento a um nó de entrada. Durante o tempo de execução, se nenhum valor for fornecido para um elemento obrigatório, a atividade emitirá uma exceção, que será relatada pelo Web Management Console. Se um valor não for fornecido no tempo de execução para um parâmetro de entrada opcional, nenhuma exceção será emitida durante o tempo de execução.
- Selecione o tipo de procura a ser usado para a atividade:
Tabela 3. Tipo de Procura Nome do Parâmetro Descrição searchType Especifica o tipo de procura a ser usado para esta atividade. Os valores são: - NORMAL_SEARCH: Usa o método Procura do Banco de Dados do Domino.
- FULL_TEXT_SEARCH: Usa o método FTSearch do Banco de Dados do Domino.
- Selecione Mapear Saídas na lista de verificação.
Os esquemas XML gerados para reter a resposta da atividade são exibidos como nós sob o parâmetro de saída de resposta no painel Atividade de Partida.
Nota: Campos incluídos dinamicamente presentes no documento do Domino e não gerados nas estruturas de entrada/saída do mapa são manipulados pelo conector do Domino. Durante a recuperação de documentos usando essa atividade, os dados para esses campos ficam disponíveis na seção de saídas de mapa sob AdditionalFields.
queryUsingTimestamp é o parâmetro usado para consultar documentos baseados em registro de data e hora. A propriedade timestamp é recursiva. É possível definir groupFields, name, operator e value sob a propriedade timestamp.
Os parâmetros de saída opcionais são descritos na tabela a seguir:
Nome do Parâmetro Descrição queryUsingTimestamp A seguir estão as propriedades timestamp:Tabela 4. Propriedades timestamp Propriedade Valores groupFields É possível especificar diversos valores, como: AND, OR, (,), AND(, OR(, )AND, )OR, )AND( e )OR(. Nota: É possível ter diversas condições. groupFields deve ser usado quando se tem diversas condições.nome Especifique um destes valores: createdTimestamp ou lastModifiedTimestamp Operador Especifique um destes valores: GREATER_THAN, GREATER_THAN_OR_EQUAL_TO, EQUAL_TO, LESS_THAN, LESS_THAN_OR_EQUAL_TO e NOT_EQUAL_TO value Especifique os valores de data e hora. Por exemplo, 26-09-2013 12:05:00 PM EST. Nota: Se você não mencionar o fuso horário, por padrão, o fuso horário do servidor será considerado.Nota:- A consulta de documentos baseados no operador NOT_EQUAL_TO (!=) não é suportada na Procura de Texto Completo.
- A consulta de documentos usando horário não é suportada na Procura de Texto Completo. Por exemplo, [_RevisionDate] = 05/06/2013 09:30:00.
- A consulta de documentos usando o operador EQUAL_TO com registro de data e hora não funciona com o tipo de Procura Normal. Por exemplo, @Modified = [05/06/2013 09:14:22].
- Consultando documentos usando Procura de Texto Completo como Tipo de Procura, é possível consultar documentos que são baseados apenas em Data, e não em Data e Hora. Por exemplo, lastModfiedDateTime >= 05/20/2013 20:00:00 não é suportado na Procura de Texto Completo.
- Crie um mapa entre os parâmetros de saída e as variáveis de orquestração.