Utilize a janela Propriedades da UI do Item de Registro para definir e atualizar um item de dados em um registro da UI.
Digite o rótulo da UI para o item de dados no campo Legenda da UI. Se o item tiver um valor de ocorrência maior que um e o tipo de item for Submeter, Submeter Desvio ou Ligação de Programa, os rótulos podem ser definidos para cada ocorrência. Para definir vários rótulos, digite um por linha.
Exemplo
Os seguintes valores definem um botão de pressão na página HTML gerada com o texto "Executar Programa Selecionado" impresso no botão de pressão:
Nome do item de dados = "Ação-Enter" Ocorrência = 1 Tipo = Char Tamanho = 6 Decimais = 0 Tipo de UI = Submeter Propriedades de UI = Personalizadas Escopo = Local Rótulo da UI = "Executar Programa Selecionado"
Nota: | A Ocorrência, Tipo de UI, propriedades de UI e Escopo devem ser definidos no nível do registro e estão disponíveis no registro de UI. As definições restantes: Nome do item de dados, Tipo, Tamanho e Decimais podem ser definidos no Editor do Item de Dados assim como no Editor de Registros. |
Por padrão, o campo Rótulo da UI está em branco e não é definido um rótulo para a parte da UI gerada.
As definições do item de índice selecionado e item de ocorrências são válidas somente para itens de dados da matriz. Os campos Item de ocorrências e Item de índice selecionado estão disponíveis na janela Propriedades da UI do Item de Registro de um item de dados da matriz. Os itens de dados da matriz têm um valor de ocorrências maior do que um.
Selecione o item dos dados no campo Item das ocorrências que define o número de linhas a serem exibidas na página HTML gerada. O item das ocorrências especificado deve ser definido no registro UI desta forma:
O item de dados selecionado no campo Item de ocorrências não deve ser o item que você está definindo atualmente, será o item de índice selecionado ou o item de valor de submissão do registro.
Por definição, o campo Item das ocorrências fica em branco e nenhum item das ocorrências é definido.
Selecione o item de dados no campo Selected index item que recebe o índice ou índices do(s) elemento(s) selecionado(s) pelo usuário. O item de índice selecionado especificado deve ser definido no registro UI desta forma:
Você pode selecionar um item de matriz no campo Selected index item. Se o item de índice selecionado especificado for um item de matriz, a parte UI gerada será uma lista de seleção múltipla. O valor de ocorrências do item da matriz deve corresponder ao valor de ocorrências do item de dados que você está definindo.
Se o item de índice selecionado especificado não for um item de matriz, a parte UI gerada será uma lista de seleção única.
Por definição, o campo Selected index item fica em branco e nenhum item de índice selecionado é definido.
O item Submeter fica disponível na janela Propriedades da UI do Item de Dados de Registro quando o tipo da UI é Submeter ou Submeter Bypass.
Digite o valor no campo Valor inicial que você deseja colocar em Submeter item do valor definido.
Por padrão, o campo Valor inicial fica em branco e um valor inicial para Submeter item do valor definido não é especificado.
Um menu de contexto está disponível para o campo Valor inicial.
Selecione Cortar para remover o texto selecionado e colocá-lo na área de transferência.
Selecione Copiar para copiar o texto selecionado para a área de transferência sem excluí-lo da janela ativa.
Selecione Colar para copiar texto da área de transferência para a janela ativa. Todo o texto selecionado é substituído pelo texto da área de transferência. Se não houver texto selecionado, o texto na área de transferência será inserido na posição do cursor.
Selecione Excluir para remover o texto selecionado.
Escolha Selecionar Todos para selecionar o texto inteiro no campo.
O item Ligação do Programa está disponível na janela Propriedades da UI do Item de Registro somente quando o Tipo da UI estiver definido em Ligação do Programa ou Formulário. As seleções neste item definem uma ligação de hipertexto em outro Programa de transação na Web na página ou formulário HTML gerado.
Selecione o programa para chamar da lista suspensa Program. Um Programa de transação na Web é o único tipo válido de programa que você pode selecionar.
Nota: | Se você estiver definindo uma ligação de programa, a especificação do programa é obrigatória. |
Por definição, o campo Program fica em branco e não há nenhum programa especificado para a ligação do programa.
Selecione um registro da UI no campo Primeiro registro da UI que estiver definido no programa especificado no campo Programa.
Se os dados forem passados quando o programa for chamado, a seleção Primeiro registro da UI conterá a definição dos itens de dados que receberão os dados.
Nota: | Se você estiver definindo uma ligação de programa, a especificação do registro é opcional. |
Por padrão, o campo Primeiro registro da UI fica em branco e não há nenhum Primeiro registro da UI especificado.
Selecione Abrir como nova janela para lançar o programa ligado em uma janela separada quando a ligação do programa for selecionada pelo usuário.
Por definição, o campo Abrir como nova janela não é selecionado e uma nova janela não será lançada quando o usuário selecionar a ligação do programa.
Nota: | Se você estiver definindo uma ligação de programa, a especificação de uma nova janela no programa ligado é opcional. |
A definição do parâmetro de ligação associa um item de dados no programa ligado a um item de dados no programa de chamada. Você pode passar dados entre mais do que um conjunto de itens de dados por meio da definição de cada conjunto. Você também pode passar literais.
Os campos do parâmetro de ligação não ficam disponíveis até a definição do campo Primeiro registro da UI.
Se os parâmetros de ligação estiverem definidos e você limpar o campo Primeiro registro da UI, os parâmetros de ligação serão removidos quando você selecionar o botão de comando OK.
Selecione o item de dados na coluna Name que recebe os dados quando o programa é chamado. Este item de dados deve ser definido no Primeiro registro da UI especificado. Você não pode selecionar o mesmo nome mais que uma vez na lista de parâmetros de ligação.
Por definição, o campo Name fica em branco e um item de dados não é especificado para receber dados quando o usuário selecionar a ligação do programa.
Selecione o item de dados na coluna Value Item que passa dados quando o programa é chamado. O item de dados especificado como o item do valor e a ligação do programa devem ser definidos no mesmo registro da UI.
Você também pode passar um literal. Se quiser passar um literal, digite o literal na coluna Value Item.
Por definição, o campo Value Item fica em branco e os dados não são passados quando o usuário seleciona a ligação do programa.
Um menu de contexto está disponível para o campo Parâmetros de ligação.
Selecione Excluir para excluir a entrada de item Nome e Valor selecionada.
Selecione Insert Before para inserir uma entrada de item Nome e Valor na lista acima da entrada selecionada.
Selecione Insert After para inserir uma entrada de item Nome e Valor na lista abaixo da entrada selecionada.
Selecione Selecionar Tudo para selecionar todas as entradas Nome e Item do valor.
Selecione Desmarcar Tudo para limpar qualquer seleção.
Selecione Insert Before para inserir uma entrada de item Nome e Valor na lista acima da entrada selecionada.
Selecione Insert After para inserir uma entrada de item Nome e Valor na lista abaixo da entrada selecionada.
Selecione Delete para excluir a entrada de item Nome e Valor selecionada.
A guia Edições está sempre disponível na janela Propriedades da UI do Item de Dados no Editor de Item de Dados. Essa guia está disponível na janela Propriedades da UI do Item de Dados de Registro, do Editor de Registro, somente quando o tipo da UI do item de dados for definido como Oculto, Entrada, Entrada/Saída ou Saída. Se o tipo da UI não for definido como Oculto, Entrada, Entrada/Saída ou Saída, todas as edições definidas no Editor de Registro para uma definição de item não-compartilhado serão removidas quando o registro da UI for salvo.
Selecione o tipo de edição na lista suspensa Tipo de edição para definir o item de dados.
Data: Selecione Data para definir o item de dados como uma data. O item de dados especificado deve ser definido desta forma:
Time: Selecione Hora para definir o item de dados como uma hora. O item de dados especificado deve ser definido desta forma:
Boolean: Selecione Booleano para definir uma edição booleana. O item de dados especificado deve ser definido desta forma:
Os valores válidos do item numérico são 1 (verdadeiro) e 0 (falso). Os valores válidos do item de caractere são Y (verdadeiro) e N (falso).
Nenhum: Selecione Nenhum para definir o item de dados nem como data, hora ou booleano.
Por definição, o campo Nenhum é selecionado e o item não é definido como uma data, hora ou booleano.
Você pode definir uma função de edição para a validação dos dados digitados pelo usuário na parte da interface de usuário gerada. Se você definiu uma função de edição, selecione a função na lista drop-down Editar função.
A função de edição não pode ser definida com parâmetros. A função pode chamar outras funções definidas com parâmetros. EZEC10 e EZEC11 também são funções de edição válidas.
Por padrão, o campo Editar função está em branco e não é definida uma função de edição.
Você pode definir uma tabela de edição para a validação dos dados digitados pelo usuário na parte da interface de usuário gerada. Se você definiu uma tabela de edição, selecione a tabela na lista drop-down Editar tabela.
Por padrão, o campo Editar tabela está em branco e não é definida uma tabela de edição.
Digite, no campo Entrada mínima, o número mínimo de caracteres que o usuário é obrigado a digitar na parte da interface de usuário gerada. Se o usuário digitar qualquer dado na parte gerada da interface do usuário, será aplicada a definição de entrada mínima.
Por definição, o campo Entrada mínima é definido como zero e o usuário não é obrigado a digitar nenhum caractere na parte de UI gerada.
Digite um caractere no campo Caractere de Preenchimento para preencher posições não usadas na parte da UI gerada.
O caractere de preenchimento pode ser um caractere alfanumérico ou um espaço em branco.
O campo Caractere de Preenchimento não está disponível para itens DBCS, porque em branco é a única definição válida.
Por padrão, o campo item do Caractere de Preenchimento fica em branco e não é definido nenhum caractere de preenchimento.
Nota: | Nulo não é um caractere válido. |
Selecione Executar função de edição na web para executar a função de edição no servidor web no qual o bean de runtime do registro da UI é distribuído.
Quando Executar função de edição na web é selecionado, o escopo de dados da função fica estritamente limitado aos dados do registro da UI no qual a função é definida.
Quando Executar função de edição na web não é selecionado, a função de edição executa no servidor.
Por padrão, Executar função de edição na web não é selecionado e a função de edição executa no servidor.
Selecione Trocar para alterar os caracteres alfanuméricos no parte da UI gerada para caracteres em letra maiúscula, quando o usuário submeter a página HTML gerada.
Trocar não está disponível quando o tipo de dados é DBCS, Num, Numc, Pack, Pacf ou Bin.
O desdobramento não ocorre para campos numéricos, campos DBCS ou dados DBCS em campos mistos.
Por padrão, o campo Trocar não é selecionado e caracteres alfanuméricos na parte da UI gerada não são trocados para letra maiúscula.
Selecione o campo Entrada exigida para exigir que o usuário digite informações na parte da UI gerada, antes de submeter a página HTML gerada.
A edição é satisfeita se o campo contiver um valor diferente do espaço em branco ou igual a zero para um campo numérico. Os espaços em branco ou zero em campo numérico não vão satisfazer à verificação de edição.
Por padrão, o campo Entrada exigida não é selecionado e a entrada do usuário não é exigida na parte da UI gerada.
Selecione o campo Verificar espaço SO/SI para determinar se os dados mistos (SBCS ou DBCS) digitados na parte da UI gerada podem ser convertidos para o formato SO/SI do mainframe com um comprimento válido para a parte da UI gerada.
Campos mistos exigem menos bytes de memória nos sistemas OS/2 e Windows porque o formato DBCS ASCII não utiliza caracteres de escape SO/SI para delimitar dados DBCS.
Verificar espaço SO/SI está disponível somente para itens de dados mistos.
Por padrão, o campo Verificar espaço SO/SI é selecionado para itens de dados mistos e o comprimento dos dados formatados SO/SI é medido.
As edições numéricas são válidas somente para itens de dados numéricos.
Digite de um a três símbolos de caractere no campo Símbolo de moeda para especificar um símbolo para o item de dados.
O campo Símbolo de moeda está disponível somente quando o campo Moeda é selecionado. Os dados digitados no campo Símbolo de moeda serão ignorados se você:
O símbolo de moeda padrão do sistema é usado quando um símbolo de moeda não é definido e o campo Moeda é selecionado.
O símbolo de moeda padrão do sistema pode ser alterado pelo administrador do sistema por meio de procedimentos de personalização de opções que dependem do idioma.
Por padrão, o campo Símbolo de moeda está em branco e nenhum símbolo é definido para o item de dados.
Selecione o campo Moeda para exibir um símbolo monetário ou para aceitar um símbolo monetário para os dados numéricos na parte de UI gerada quando o usuário submeter a página HTML gerada.
O símbolo monetário é aceito antes ou depois dos dados numéricos digitados pelo usuário. O comprimento do campo é calculado automaticamente.
Por definição, o campo Moeda não está selecionado e nenhum símbolo monetário é aceito com os dados numéricos digitados pelo usuário na parte de Ui gerada.
Digite um número no campo Valor mínimo para definir o limite inferior de um intervalo de números que o usuário pode digitar na parte de UI gerada.
Quando o valor mínimo é especificado, é preciso também especificar o valor máximo.
Por definição, o campo Valor mínimo está em branco e nenhum limite inferior está definido para o intervalo de números que o usuário pode digitar na parte de UI gerada.
Digite um número no campo Valor máximo para definir o limite superior de um intervalo de números que o usuário pode digitar na parte de UI gerada.
Quando o valor máximo é especificado, é preciso também especificar o valor mínimo.
Por definição, o campo Valor máximo está em branco e nenhum limite superior está definido para o intervalo de números que o usuário pode digitar na parte de UI gerada.
Selecione uma opção no campo Sinal para definir como o usuário digitará um sinal na parte da UI gerada. O comprimento do campo é calculado automaticamente.
· esquerda: Selecione · Esquerda no campo Sinal para aceitar a entrada ou exibição de um sinal de mais (+) ou menos (-) à esquerda dos dados numéricos.
· direita: Selecione · Direita no campo Sinal para aceitar a entrada ou exibição de um sinal de mais (+) ou menos (-) à direita dos dados numéricos.
Nenhum: Selecione Nenhum no campo Sinal para impedir que o usuário digite um sinal com dados numéricos.
Por padrão, · Esquerda é selecionado no campo Sinal e a parte UI gerada aceita a entrada ou exibição de um sinal de mais (+) ou menos (-) à esquerda dos dados numéricos.
Selecione o campo Separador para aceitar um separador numérico na entrada ou para exibi-lo nos dados numéricos. O comprimento do campo é calculado automaticamente. Se o número de dígitos significativos for menor que 4, o Separador não será válido.
No VisualAge Generator Developer, o separador numérico padrão é determinado pela definição de sistema do ambiente de desenvolvimento.
Por definição, o campo Separador não está selecionado e um separador numérico não é aceito na entrada ou exibido na parte de UI gerada.
Selecione o campo Edição de zero para exibir um valor zero na parte da UI gerada.
Se o campo Edição de zero não for selecionado, o valor zero não serão exibido na parte da UI gerada.
Por padrão, o campo Edição de zero não é selecionado e o valor zero não é exibido na parte da UI gerada.
A guia Mensagens de Erro está sempre disponível na janela Propriedades da UI do Item de Dados no Editor de Item de Dados. Essa guia está disponível na janela Propriedades da UI do Item de Dados de Registro, do Editor de Registro, somente quando o tipo da UI do item de dados for definido como Oculto, Entrada, Entrada/Saída ou Saída. Se o tipo da UI não for definido como Oculto, Entrada, Entrada/Saída ou Saída, todas as teclas de mensagem definidas no Editor de Registro para uma definição de item não-compartilhado serão removidas quando o registro da UI for salvo.
Teclas de mensagens
As teclas de mensagens são usadas para apresentar uma mensagem de erro personalizada quando o usuário digita dados inválidos na parte de UI gerada. Você deve especificar uma tabela de mensagem no programa Web Transaction para usar mensagens de erro personalizadas.
Você pode criar uma tabela de mensagem no Editor de Tabela.
Para criar uma tabela de mensagem:
Digite uma tecla no campo Editar tabela para especificar a mensagem de erro personalizada que será apresentada ao usuário quando ele selecionar uma opção na parte da UI gerada nos casos de Correspondência Válida, Correspondência Inválida ou Tabela de Faixa. Uma tabela de edição deve ser definida no campo Editar tabela na guia Edições.
Por padrão, o campo Editar tabela fica em branco e nenhuma mensagem de erro personalizada é definida para a parte da UI gerada.
Se você não especificar seu número de mensagem próprio, a seguinte mensagem de erro padrão é exibida.
Digite uma tecla no campo Função EZE para especificar a mensagem de erro personalizada que será apresentada ao usuário quando ele digitar os dados que não são válidos para a parte da UI gerada. A função EZEC10 ou EZEC11 deve ser especificada no campo Editar função na guia Edições.
Por padrão, o campo Função EZE fica em branco e nenhuma mensagem de erro personalizada é definida para a parte da UI gerada.
Se você não especificar seu número de mensagem próprio, a seguinte mensagem de erro padrão é exibida.
Digite uma tecla no campo Entrada mínima para especificar a mensagem de erro personalizada que será apresentada ao usuário quando ele não digitar o número mínimo de caracteres obrigatórios na parte de UI gerada. O campo Valor mínimo na guia Edições deve ser selecionado.
Por definição, o campo Entrada mínima está em branco e nenhuma mensagem de erro personalizada está definida na parte de UI gerada.
Se você não especificar seu número de mensagem próprio, a seguinte mensagem de erro padrão é exibida.
Digite uma tecla no campo Entrada obrigatória para especificar a mensagem de erro personalizada que será apresentada ao usuário quando ele não digitar os dados na parte de UI gerada. O campo Entrada exigida na guia Edições deve ser selecionada.
Por definição, o campo Entrada obrigatória está em branco e nenhuma mensagem de erro personalizada está definida para a parte de UI gerada.
Se você não especificar seu número de mensagem próprio, a seguinte mensagem de erro padrão é exibida.
Digite uma tecla no campo Tipo de dados para especificar a mensagem de erro personalizada que será apresentada ao usuário quando ele digitar os dados que não são compatíveis com o tipo de dados definido para a parte de UI gerada.
Por definição, o campo Tipo de dados está em branco e nenhuma mensagem de erro personalizada está definida para a parte de UI gerada.
Se você não especificar seu número de mensagem próprio, a seguinte mensagem de erro padrão é exibida.
Digite uma tecla no campo Intervalo numérico para especificar a mensagem de erro personalizada que será apresentada ao usuário quando ele digitar dados numéricos que não estão dentro do intervalo definido para a parte de UI gerada. O Valor mínimo e o Valor máximo para a parte da UI gerada devem ser especificados na guia Edições.
Por definição, o campo Intervalo numérico está em branco e nenhuma mensagem de erro personalizada está definida para a parte de UI gerada.
Se você não especificar seu número de mensagem próprio, a seguinte mensagem de erro padrão é exibida.
Digite informações no campo Texto do Auxílio para definir o auxílio para a parte da UI gerada.
Por padrão, o campo Texto do Auxílio está em branco e nenhuma informação é definida para a parte da UI gerada.
Um menu de contexto está disponível para o campo Texto do Auxílio.
Selecione Cortar para remover o texto selecionado e colocá-lo na área de transferência.
Selecione Copiar para copiar o texto selecionado para a área de transferência sem excluí-lo da janela ativa.
Selecione Colar para copiar texto da área de transferência para a janela ativa. Todo o texto selecionado é substituído pelo texto da área de transferência. Se não houver texto selecionado, o texto na área de transferência será inserido na posição do cursor.
Selecione Excluir para remover o texto selecionado.
Escolha Selecionar Todos para selecionar o texto inteiro no campo.
Selecione OK para aceitar os valores e fechar a janela.
Selecione Cancelar para fechar a janela sem aceitar os valores.
Selecione Padrões para redefinir a definição padrão de valores em uma ou em todas as guias na janela.
Selecione Auxílio para exibir o auxílio para a janela.