Este tópico contém as seguintes seções:
Utilize o nó DataDelete para interagir com um banco de dados na origem de dados ODBC especificada. O nó DataDelete é um formato especializado do nó Database e a interação está restrita à exclusão de uma ou mais linhas de uma tabela no banco de dados. Você define o que será excluído, definindo instruções de mapeamento que utilizam os dados da mensagem de entrada de alguma forma para identificar a ação requerida.
Você pode definir uma propriedade para controlar se a atualização ao banco de dados é consolidada imediatamente ou adiada até que o fluxo de mensagens seja concluído, momento em que a atualização é consolidada ou revertida de acordo com o status geral de conclusão do fluxo de mensagens.
O nó DataDelete é representado no workbench pelo seguinte ícone:
Considere uma situação na qual você está executando uma promoção limitada. As mercadorias estão disponíveis apenas pelo período da promoção e cada cliente pode ter apenas um item. Quando o estoque da mercadoria acabar, você deve remover os respectivos detalhes do banco de dados de estoque. Quando a mensagem com o pedido do último item for recebida, o nó DataDelete será disparado para remover todos os detalhes desse item do banco de dados.
Quando você tiver colocado uma instância do nó DataDelete em um fluxo de mensagens, poderá configurá-lo. Clique com o botão direito do mouse na visualização do editor clique em Propriedades. As propriedades básicas do nó são exibidas.
Todas as propriedades obrigatórias, para as quais é necessário inserir um valor (aquelas que não possuem um valor padrão definido) são marcadas com um asterisco no diálogo das propriedades.
Configure o nó DataDelete da seguinte forma:
Em sistemas z/OS, o intermediário utiliza o ID da tarefa iniciada ou o ID do usuário e a senha que foram especificados no comando JCL mqsisetdbparms de BIPSDBP, no conjunto de dados de customização <hlq>.SBIPPROC.
Se você clicar em Procurar próximo ao campo de entrada, um diálogo é exibido, listando todas as rotinas de mapeamento disponíveis, acessíveis por esse nó. Selecione a rotina desejada e clique em OK.O nome da rotina é definida em Instrução.
Para trabalhar com a rotina de mapeamentos associada a esse nó, clique com o botão direito do mouse no nó e clique em Abrir Mappings. Se a rotina de mapeamento não existir, ela será criada com o nome padrão no arquivo padrão. Se o arquivo já existir, você poderá abrir o arquivo <flow_name>_<node_name>.mfmap na visualização Navegador.
Uma rotina de mapeamento é específica para o tipo de nó com o qual está associada; não é possível utilizar uma rotina de mapeamento desenvolvida para um nó DataDelete com qualquer outro nó que use mapeamentos (por exemplo, um nó DataInsert). Se você criar uma rotina de mapeamento, não será possível chamá-la a partir de outra rotina de mapeamento, embora seja possível chamá-la a partir de uma rotina ESQL.
Quando selecionar a caixa, o nó tratará todos os códigos de retorno positivos no banco de dados como erros e gerará exceções da mesma forma que faria para os erros negativos ou mais sérios.
Se você não selecionar a caixa, o nó tratará avisos como códigos de retorno normais e não gerará nenhuma exceção. O aviso mais significativo gerado é não-localizado, que pode ser tratado como um código de retorno normal de forma segura na maioria das circunstâncias.
Se você limpar a caixa, deverá tratar o erro no fluxo de mensagens para assegurar a integridade do intermediário e do banco de dados: o erro será ignorado se você não tratá-lo pelo seu próprio processamento, porque escolheu não chamar o tratamento de erros padrão pelo intermediário. Por exemplo, você pode conectar o terminal failure a uma sub-rotina de processamento de erros.
Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.
Os terminais do nó DataDelete são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
Entrada | O terminal de entrada que aceita a mensagem para processamento pelo nó. |
Defeito | O terminal de saía para qual a mensagem de entrada será propagada caso seja detectada uma falha durante o cálculo. Se você tiver selecionado Tratar Avisos como Erros, o nó propagará a mensagem para esse terminal mesmo se o processamento for concluído com êxito. |
Saída | O terminal de saída que exibe a mensagem após a execução da instrução do banco de dados. |
As tabelas a seguir descrevem as propriedades do nó; a coluna com cabeçalho M indica se a propriedade é obrigatória (marcado com um asterisco no diálogo de propriedades caso seja necessário digitar um valor quando nenhum padrão for definido), a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens no arquivo bar para implementá-lo).
As propriedades Básicas do nó DataDelete são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Fonte de Dados | Não | Sim | O nome da origem de dados ODBC do banco de dados no qual residem as tabelas as quais foram referidas nos mapeamentos associados a este nó (identificado pela propriedade Instrução). | |
Instrução | Sim | Não | DataDelete | O nome da rotina de mapeamento que contém as instruções que são executadas no banco de dados ou à árvore de mensagens. A rotina é exclusiva para esse tipo de nó. |
Transação | Sim | Não | Automático | O modo de transação para o nó. Ele pode ser Automático ou Consolidação. |
Tratar Avisos como Erros | Sim | Não | Não selecionada | Trata aviso SQL do banco de dados como erros. Se você selecionar a caixa de opções, esta ação é executada. |
Emitir Exceção em Erro do Banco de Dados | Sim | Não | Selecionada | Erros de banco de dados fazem com que o intermediário lance uma exceção. Se você selecionar a caixa de opções, esta ação é executada. |
As propriedades de Descrição do nó DataDelete são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Descrição Breve | Não | Não | Uma breve descrição do nó. | |
Descrição Longa | Não | Não | Texto que descreve a finalidade do nó no fluxo de mensagens. |