Atualizando um Documento do Domino

Use a atividade Atualizar Documento para atualizar um documento no banco de dados do Domino. Cada documento atualizado deve ser exclusivamente identificável por seu UniversalID ou NotesID.

Usando a atividade de atualização

  1. 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.
  2. Selecione a guia Atividades e expanda a pasta Domino.
  3. Arraste Atividade de Atualização da pasta do Domino para a orquestração. A representação gráfica da orquestração, juntamente com a área da janela Lista de Verificação é exibida.
  4. A área da janela Lista de Verificação lista as tarefas (Resumo, Selecionar Terminal, Configurar, Entradas do Mapa, Saídas do Mapa) que você deve concluir para configurar uma atividade de saída.
  5. 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.

  6. Clique em Configurar na Lista de Verificação. A área de janela Configurar é exibida.
    • Clique em Procurar para selecionar um banco de dados existente na área da janela Procurar Bancos 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 da janela Procurar 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ê selecionar o nome do banco de dados.

Especificando as entradas do mapa para a atividade de atualização

Os parâmetros de entrada para a atividade de atualização são UniversalID ou NotesID e todos os campos de dados de negócios (específicos para o formulário selecionado) devem ser atualizados.
  1. Clique em Entrada do Mapa no painel Lista de verificação.
    Os parâmetros de entrada para a atividade do Domino são exibidos na área de janela Atividade de Destino. Os parâmetros de entrada são definidos na tabela a seguir.
    Nome do Parâmetro Descrição (Description)
    UniversalID Um UniversalID de um documento é uma propriedade de leitura/gravação que identifica exclusivamente um documento em todas as réplicas de um banco de dados. No formato de caractere, UniversalID é uma combinação de 32 caracteres de dígitos hexadecimais (0-9, A-F). Um UniversalID também é conhecido como um ID exclusivo ou UNID. O tipo de dados é sequência.
    NotesID Um NotesID de um documento é uma propriedade somente leitura e possui um valor hexadecimal de até 8 caracteres, que identifica exclusivamente um documento em um banco de dados específico. Um NotesID representa o local de um documento dentro de um arquivo de banco de dados específico. Assim, os documentos que são réplicas de um outro geralmente possuem diferentes IDs da nota. Um NotesID não muda, a menos que o documento seja excluído.
    Nota: Vocêdeve mapear os parâmetros de entrada da atividade.
    Nota: Para preencher dinamicamente os campos incluídos do documento do Domino, que não fazem parte da estrutura de entradas de mapa, use a propriedade AdditionalFields e forneça os nomes e valores de campo na seção FieldDetails.

Para Tipos de Formulário que são iguais em vários bancos de dados, agora é 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.

Parâmetros Opcionais para uma Atividade do Domino

A seguir estão os parâmetros opcionais que são definidos para a atividade de atualização.
Tabela 1. Parâmetros opcionais
Nome do Parâmetro Descrição
MarkAsRead Especifica se o documento deve ser marcado como leitura durante uma operação de atualização. Seu tipo é booleano.
MakeResponse Especifica se o documento deve ser disponibilizado como a resposta do documento salvo mesmo se outro usuário modificar e salvar o documento. Seu tipo é booleano.
ForceSave Especifica se o documento deve ser salvo de maneira forçada durante um conflito de uma operação de atualização. Seu tipo é booleano.
databaseName databaseName é o nome do banco de dados no qual o documento é atualizado. Se um valor for configurado para esse parâmetro, o valor do banco de dados no painel Configurar será sobrescrito. Esse parâmetro é útil quando documentos com a mesma estrutura (Formulário) devem ser atualizados em 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 para 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
password Especifica a senha associada ao nome de 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.

Especificando as Saídas de Mapeamento para uma Atividade do Domino

  1. Clique em Saída do mapa na área da janela Lista de verificação.

    Os parâmetros de saída para a atividade do Domino são exibidos na área de janela Atividade de Partida.

    Nota: É possível mapear os parâmetros de saída da atividade que é baseada em seu requisito.

Comportamento do Sinalizador de Resumo (sinalizador de campo)

Quando um documento é atualizado para um formulário contendo campos do tipo Authors, Readers ou Names, e dados são configurados para esses campos em Mapear Entrada, o sinalizador de resumo é configurado com as permissões adequadas com base no tipo de campo do Domino. Esse recurso é suportado do servidor Domino versão 8.5.3 em diante.

Por exemplo:
  1. Se um campo do Domino do tipo Authors for configurado com um valor CN=SYSTEM/O=IBM, o sinalizador de resumo será SUMMARY READ/WRITE-ACCESS NAMES "CN=SYSTEM/O=IBM".
  2. Se um campo do Domino do tipo Readers for configurado com um valor CN=SYSTEM/O=IBM, o sinalizador de resumo será SUMMARY READ-ACCESS NAMES "CN=SYSTEM/O=IBM".
  3. Se um campo do Domino do tipo Names for configurado com um valor CN=SYSTEM/O=IBM, o sinalizador de resumo será SUMMARY NAMES "CN=SYSTEM/O=IBM".