Trabalhando com Transformações

Uma transformação é um arquivo JSP (para projetos da Web) ou um SWT composto (para projetos rich client) que define como customizar telas específicas do host. Quando você cria uma transformação, tem a opção de selecionar a tela do host na qual a transformação será baseada. A tela do host pode ser baseada em uma tela do terminal host ou em uma captura de tela. Uma captura de tela pode ser obtida de um mapa do BMS importado (apenas 3270) ou diretamente do terminal host.

A aplicação de uma transformação é uma das possíveis ações de um evento de tela. Alguns usos comuns de transformações são:

Assistente para Criar uma Transformação

Utilize o assistente Criar uma Transformação para definir transformações de tela. É possível acessar o assistente de várias maneiras, como:

O assistente Criar uma Transformação aparece e permite que você selecione o projeto de destino, nomeie a transformação, substitua o nome do pacote (para projetos do rich client do HATS), forneça-lhe uma descrição e consulte o local no qual a definição de transformação é salva. Clique em Avançar quando especificar estes itens.

No painel Selecionar Tela, você tem a opção de selecionar a tela do host na qual a transformação será baseada. Na seção Selecionar uma Tela, você pode selecionar Utilizar tela do terminal do host ou Utilizar uma tela capturada anteriormente no menu suspenso. Você pode destacar certos campos na tela de host selecionando as diferentes opções ao lado de Destacar campos. Se quiser ver onde os campos de entrada estão definidos na tela, selecione a caixa de opções Entrada. Se quiser ver quais campos estão protegidos, selecione a caixa de opções Protegido. Se quiser destacar quaisquer campos ocultos, selecione a caixa de opções Oculto. Para modificar as cores dos campos de entrada, protegidos ou ocultos que estão em destaque, consulte Utilizando Preferências do HATS. Quando fizer suas seleções, clique em Avançar.

Existem quatro padrões de renderização a partir dos quais você pode selecionar, Tela Vazia, Renderização Padrão, Previamente Preenchida Utilizando Renderização Padrão e Previamente Preenchida Utilizando Campos.

Tela Vazia
Cria uma nova transformação em branco. Você pode incluir posteriormente componentes individuais utilizando os assistentes de Inserir Renderização Padrão ou Inserir Componentes do Host.
Processamento Padrão
Cria uma nova transformação que será exibida com a renderização padrão no tempo de execução. Utilize esse padrão se desejar utilizar um conjunto de renderização diferente do padrão, alterar a região da tela a ser renderizada ou incluir componentes adicionais utilizando o assistente Inserir Componentes do Host. Clique em Opções para definir a seguinte configuração no painel Opções de Renderização:
Utilizar a configuração de renderização padrão
Selecione essa caixa para utilizar a configuração de renderização padrão do aplicativo quando a transformação for renderizada no tempo de execução. Desmarque essa caixa para selecionar um conjunto de renderização específico para utilizar sempre.
Previamente Preenchida Utilizando Renderização Padrão
Cria uma nova transformação preenchida com tags de componente, geradas utilizando a renderização padrão, que pode ser customizada utilizando o assistente Editar Componente do Host. Clique em Opções para definir as seguinte configurações no painel Opções de Renderização:
Utilizar a configuração de renderização padrão
Selecione essa caixa para utilizar a configuração de renderização padrão do aplicativo quando a transformação for renderizada no tempo de execução. Desmarque essa caixa para selecionar um conjunto de renderização específico para utilizar sempre.
Incluir campos vazios e protegidos.
Selecione essa caixa para gerar tags (para transformações da Web) ou compostos de renderização de componentes (para transformações do RCP) para campos vazios e protegidos. Na maior parte dos casos, o padrão (não gerar tags ou compostos para esses campos) é suficiente e oferece mais flexibilidade para mover outros controles em torno da transformação.
Nota:
Em geral, ao criar uma transformação previamente preenchida, você deve capturar uma tela que tenha tanta informação exibida quanto possível. Por exemplo, se estiver criando uma transformação para uma tela que contém uma tabela, você deve capturar uma tela que tenha a tabela de dados inteira preenchida. Isso fará com que sejam gerados tags (para transformações da Web) e compostos (para transformações do RCP) para todos os campos da tabela.
Previamente Preenchida Utilizando Campos
Cria uma nova transformação preenchida com rótulos campos de entrada que podem ser customizados utilizando o assistente Editar Componente do Host.Clique em Opções para definir a seguinte configuração no painel Opções de Renderização:
Incluir campos vazios e protegidos.
Selecione essa caixa para gerar tags (para transformações da Web) ou compostos de renderização de componentes (para transformações do RCP) para campos vazios e protegidos. Na maior parte dos casos, o padrão (não gerar tags ou compostos para esses campos) é suficiente e oferece mais flexibilidade para mover outros controles em torno da transformação.
Nota:
Em geral, ao criar uma transformação previamente preenchida, você deve capturar uma tela que tenha tanta informação exibida quanto possível. Por exemplo, se estiver criando uma transformação para uma tela que contém uma tabela, você deve capturar uma tela que tenha a tabela de dados inteira preenchida. Isso fará com que sejam gerados tags (para transformações da Web) e compostos (para transformações do RCP) para todos os campos da tabela.

Utilize o botão Visualizar para exibir a transformação utilizando o padrão selecionado.

Após os padrões serem definidos, é possível organizar os componentes dentro de sua transformação. Se desejar ativar o assistente de customização de tela, selecione a caixa de opções Iniciar o Assistente para Criar Customização de Tela quando Concluir, em seguida, clique em Concluir. Para obter informações adicionais, consulte: Renderização Padrão.

Editando Transformações

As transformações nos projetos da Web do HATS são arquivos JSP e, por padrão, são editadas utilizando o Designer de Páginas. As transformações nos projetos rich client do HATS são compostos SWT e, por padrão, assumindo que o recurso do editor de aplicativos do cliente Java™ (VE) está instalado com o Rational SDP, são editadas utilizando o Editor Visual.

Editando Transformações para Projetos da Web

Você pode ver as transformações que foram criadas expandindo a pasta Conteúdo da Web/Transformações na visualização Projetos HATS. Para editar uma transformação utilizando o Designer de Páginas que foi construído no Rational SDP, dê um clique duplo no nome da transformação. Para ver outros editores disponíveis, clique com o botão direito no nome da transformação e selecione Abrir Com. Consulte a documentação do Rational SDP para o Designer de Páginas selecionando Ajuda > Conteúdo da Ajuda na barra de menus e, em seguida, procure no Designer da Página.

Nota:
Quando você copiar uma transformação de um projeto do HATS para outro, o arquivo de captura de tela associado à transformação não será copiado. A transformação copiada funcionará no tempo de execução sem o arquivo de captura de tela associado. Entretanto, não será possível visualizar a transformação copiada no HATS Toolkit sem o arquivo de captura de tela associado.

Para visualizar a transformação copiada, você deve copiar o arquivo de captura de tela associado ao selecioná-lo na pasta Capturas de Tela. Depois de ter copiado o arquivo de captura de tela, volte e selecione a transformação copiada da pasta Transformações e abra a transformação. Acesse a guia Design e clique com o botão direito em qualquer lugar na janela. Selecione Ferramentas do HATS > Editar Componente do Host. Quando o assistente for exibido, selecione a tela no menu suspenso e clique em Concluir.

As seguintes limitações se aplicam à edição de transformações:

Ao editar uma transformação, é possível alterar as propriedades de componentes do HATS ou outros controles (como botões, imagens e links), utilizando a visualização Propriedades. A visualização Propriedades está localizada na área inferior do editor de transformação. Você também pode acessar a visualização Propriedades selecionando Janela > Mostrar Visualização > Propriedades no menu do HATS.

A visualização Paleta também pode ser utilizada para incluir componentes do HATS em sua transformação. Você pode selecionar o componente no menu suspenso e arrastá-lo para sua transformação. A Paleta também contém diferentes tags (como HTML, tags de formato, JSP, Struts) para facilitar a edição. Esta visualização também pode ser ativada selecionando Janela > Mostrar Visualização > Paleta na barra de menus.

Nota:
Os componentes customizados, ENPTUI, e os componentes de caneta de luz não aparecem na seção Componentes do HATS na visualização Paleta do Designer de Páginas. Quando ativados, eles são acessados a partir da barra de menus do Rational SDP clicando em Ferramentas do HATS > Inserir Componente do Host.

As seguintes seções descrevem cada guia do Designer de Páginas.

Design

A guia Design do Designer de Páginas exibe a visualização de WYSIWYG atual da transformação conforme você faz alterações nela. A guia Design também aplica CSS (Cascading Style Sheets) às VCTs (Visual Component Tags).

Utilizar a tabela de layout livre permite organizar livremente os componentes e widgets no Designer de Páginas. Ele alinha automaticamente componentes, criando as células de tabela necessárias. Para ativar a tabela de layout livre, selecione Exibir > Tabelas de Layout Livre na barra de menus. Também é possível arrastar componentes da Paleta para sua transformação. Recomenda-se inserir apenas um componente por célula de tabela. Você não pode incluir um componente do HATS, ou outro tipo de componente, no meio da área definida por uma tag HATS:DefaultRendering ou Componente. A tabela de layout livre pode ser definida como uma preferência para transformações novas e vazias no HATS. Para obter informações adicionais, consulte Utilizando Preferências do HATS.

Nota:
O HATS não suporta o Editor Visual para editar transformações da Web.

Ao visualizar seu arquivo JSP na guia Design, os símbolos da JSP aparecem na parte superior esquerda do arquivo. Para ocultar este símbolos, acesse Janela > Preferências e localize a preferência Web. Acesse Web > Design da Página > Aparência > Editando Símbolos e desmarque a caixa de opção JSP.

Enquanto estiver na guia Design, é possível inserir ou editar itens na transformação utilizando o menu Ferramentas do HATS na barra de menus do HATS Toolkit ou na Paleta.

O menu Ferramentas do HATS contém os seguintes itens, cada um ativa um assistente de transformação. Para obter informações sobre cada assistente, consulte Assistentes de Transformação.

Os últimos dois itens de menu (Inserir Propriedades do Objeto de Integração, e Inserir Redirecionamento para o aplicativo do HATS) são descritos em Utilizando Objetos de Integração.

A gaveta dos Componentes do HATS na Paleta contém os seguintes componentes:

Nota:
Se você editar uma transformação e tentar inserir um componente do HATS entre dois caracteres de texto consecutivos, às vezes a tag não é inserida diretamente no local do cursor.

Se você desejar incluir imagens em seu projeto, tal como os no Rational SDP Gallery, é recomendado que as importe para o diretório Web Content/Common/Images de seu projeto. Você também pode importar imagens a partir da guia Galeria do Rational SDP.

Para importar imagens, clique em Arquivo > Importação > Geral > Sistema de Arquivos para abrir o assistente de Importação. Selecione a localização dos arquivos-fonte da imagem que deseja importar no campo De Diretório. Selecione o diretório project_name/Web Content/Common/Images como o Into folder. Quando os arquivos de origem de sua imagem são importados, clique com o botão direito na pasta Imagens, e selecione Mostrar Miniaturas na guia Miniatura na janela inferior direita para ver as imagens. Você pode usar o método de arrastar e soltar para copiar imagens dentro da exibição da guia Design de sua transformação.

Origem

A guia Origem exibe as tags HTML e JSP no arquivo transformation_name.jsp necessário para extrair componentes do host da tela do host, os widgets que você selecionou para apresentar esses componentes do host, e quaisquer outros itens que você adicionou à transformação. Conforme você faz alterações nas outras guias no Designer de Páginas, as tags e atributos exibidos nas tags do arquivo de origem são alterados para correspondência.

Você também pode fazer alterações diretamente nas tags e atributos no arquivo de origem ou pode inserir itens utilizando o menu suspenso Ferramentas do HATS na barra de menus do HATS Toolkit. Os itens que você pode inserir na guia Origem são os mesmos itens relacionados na guia Design. Coloque seu cursor no arquivo de origem no ponto em que deseja inserir um dos itens de menu e, então, selecione uma opção a partir do menu suspenso Ferramentas do HATS.

Quando um componente de host e seu widget de processamento tiverem sido inseridos, você pode utilizar a opção Editar Componente do Host no menu suspenso Ferramentas do HATS para modificar o componente do host e widget. Antes de clicar em Editar Componente do Host, certifique-se de que seu cursor esteja dentro da tag <HATS:Component>.

Quando você faz alterações no arquivo exibido na guia Origem, elas são refletidas nas outras guias de Designer de Páginas.

Dividir

A guia Dividir mostra as visualizações Design e Origem juntas.

Visualizar

A guia Visualizar fornece uma visualização do navegador da transformação mostrando o conteúdo HTML estático bem como renderizando tags <HATS:Component > (e todas as tags <HATS:xxxx>). Isso é similar à guia Design, mas você não pode fazer alterações neste conteúdo.

Editando Transformações para Projetos do Rich Client

Você pode ver as transformações que foram criadas expandindo a pasta Conteúdo do Rich Client/Transformações na visualização Projetos HATS.

Para editar uma transformação utilizando o editor padrão, clique duas vezes no nome da transformação. Para ver os editores disponíveis, clique com o botão direito no nome da transformação e selecione Abrir Com.

Assumindo que o recurso do editor de aplicativos do cliente Java (VE), também conhecido como Editor Visual, esteja instalado com o Rational SDP, é possível utilizá-lo para editar suas transformações. Além das informações nesta seção, consulte o capítulo Transformações na publicação HATS Rich Client Platform Programmer's Guide. Além disso, consulte o Centro de Informações para o seu produto Rational SDP. Por exemplo, consulte http://publib.boulder.ibm.com/infocenter/radhelp/v7r5/index.jsp e procure editor visual.

Duas áreas do Editor Visual incluem a visualização Design, geralmente exibida como a área superior, e a visualização Origem, geralmente exibida como a área inferior. Um item, tal como um componente ou um widget, é incluído na transformação selecionando o item a partir da visualização Paleta e soltando-o na visualização Design.

Na visualização Design, o estilo do modelo padrão é aplicado se a transformação contiver ao menos uma renderização de componente ou renderização padrão. Apenas o modelo padrão do projeto é aplicado. O HATS não tenta aplicar o estilo do modelo associado com a ação de aplicar que é associada com a transformação. Se você alterar seu modelo padrão enquanto estiver editando a transformação, as alterações no estilo podem não aparecer até que você feche e abra novamente o editor.

Visualização Paleta

A gaveta do HATS na visualização Paleta contém os seguintes itens que podem ser utilizados para incluir combinações para componentes do host e outros widgets em uma transformação SWT do HATS. Para obter informações sobre cada um dos assistentes referenciados, consulte Assistentes de Transformação.

Componente
Utilize este item para ativar o assistente Inserir Componente do Host para inserir a renderização para um componente específico.
Processamento Padrão
Utilize este item para ativar o assistente Inserir Renderização Padrão para inserir uma combinação de renderização padrão.
Tecla da Macro
Utilize este item para ativar o assistente Inserir Tecla da Macro para inserir um botão ou link que executará uma macro quando clicado.
Variável Global
Utilize este item para ativar o assistente Inserir Variável Global para exibir ou solicitar o valor de uma variável global.
Tecla do Host
Utilize este item para ativar o assistente Inserir Tecla do Host para inserir um botão ou link que enviará uma tecla do host quando clicado.
Tecla do Aplicativo
Utilize este item para ativar o assistente Inserir Tecla do Aplicativo para inserir um botão ou link para uma função de tecla do aplicativo.

Visualização Propriedades

Para fazer alterações nos compostos incluídos em uma transformação, utilize a visualização Propriedades. Os diálogos para fazer os seguintes tipos de alterações são fornecidos:

Dicas e Sugestões

Resumo das Diferenças entre Editar Transformações da Web e do Rich Client

A lista a seguir resume as principais diferenças entre a edição das transformações da Web utilizando o Designer de Páginas e editando as transformações do rich client utilizando o Editor Visual.

Assistentes de Transformação

Inserir Componente do Host

Com o assistente para Inserir Componente do Host, você seleciona a tela a partir da qual você deseja extrair um componente do host. Você também pode selecionar uma região na tela da qual extrair um componente do host desenhando um retângulo ao redor do texto. Coloque seu cursor no ponto na tela, clique e mantenha pressionado o botão esquerdo do mouse e mova o cursor para outra localização na tela, para desenhar o retângulo. Os campos na parte inferior do assistente mostram as linhas iniciais e finais e os números de coluna do retângulo. Você também pode digitar os número de linha e coluna digitando os números nos campos.

Você pode destacar certos campos na tela de host selecionando as diferentes opções ao lado de Destacar campos. Se quiser ver onde os campos de entrada estão definidos na tela, selecione a caixa de opções Entrada. Se quiser ver quais campos estão protegidos, selecione a caixa de opções Protegido. Se quiser destacar quaisquer campos ocultos, selecione a caixa de opções Oculto. Para modificar as cores dos campos de entrada, protegidos ou ocultos que estão em destaque, consulte Utilizando Preferências do HATS. Quando você já selecionou a linha inicial e final e os números de coluna na tela, clique em Avançar para exibir as opções de processamento dos componentes do host encontrados na região selecionada.

O HATS fornece o componentes do host e o widgets. Você pode selecionar um dos componentes do host e widgets fornecidos ou pode criar seus próprios componentes do host e widgets customizados. Para obter informações adicionais sobre componentes do host e widgets, consulte Descrições e Configurações do Componente e do Widget.

Clique em um dos componentes na lista Componentes. A janela Visualizar Componente exibe o componente se ele for localizado na região da tela. Se você desejar utilizar substituição de texto para o componente, clique no ícone Substituição de Texto à direito da lista de componentes para abrir e editar as configurações. Para obter informações adicionais sobre a substituição de texto, consulte Substituição de Texto.

Você pode selecionar o widget para usar na processamento do componente do host a partir dos widgets na lista de Widgets correspondente. Quando selecionar um widget, a janela Visualizar Widget exibe como o widget é exibido na página da Web final. Uma visualização maior do widget está disponível se você clicar no ícone Visualizar Widget em uma Janela Grande (a lupa).

É possível substituir as configurações de nível de projeto padrão por instâncias individuais dos componentes e widgets clicando nos ícones Configurações do Componente e Configurações de Widget à direita das listas Componentes e Widgets. As configurações de nível de projeto padrão para componentes e widgets são definidas utilizando a guia Renderização do editor de projeto. Consulte Processamento para obter informações adicionais.

Clique no ícone Configurações Avançadas para Renderização à direita da lista Widgets para especificar opções de renderização avançadas. As configurações de renderização avanças padrão no nível de projeto são definidas utilizando a guia Renderização do editor de projeto. Consulte Processamento para obter informações adicionais.

Para projetos da Web do HATS, clicar em Visualização Completa da Página mostra todos os componentes na página junto com o modelo associado. Esta visualização mostra a página como ela aparecerá para o usuário.

Nota:
Quando inserir um componente do HATS em uma tabela de layout livre de uma transformação, a função Visualização Completa da Página no assistente Inserir Componente do Host sempre mostrará o novo componente na parte superior da tabela de layout livre. A visualização pode estar corrompida, o componente será inserido no local à direita dentro da tabela quando você clicar em Concluir no assistente.

Para projetos rich client do HATS, visualização de página inteira não é suportada no assistente para Inserir Componente do Host. Para ver uma visualização de página completa, utilize as funções de visualização localizadas em uma das seguintes áreas do HATS Toolkit:

Para obter informações sobre as configurações que podem ser customizadas com o assistente Inserir Componente do Host, consulte Configurações de Componente e de Widget. Os widgets disponíveis dependem do componentes do host selecionado. A Tabela 2 lista os componentes do host do HATS e seus widgets correspondentes.

Se o HATS não localizar o componente na região da tela, a janela Visualizar Componente exibirá a mensagem Nenhum componente component_name foi localizado na região especificada, em que component_name é o componente selecionado na lista Componentes. Se esta mensagem for exibida, você pode ter selecionado uma região que não contém o componente completo ou pode precisar utilizar o diálogo Configurações do Componente para modificar as configurações do componente para corresponder à forma como seu aplicativo host exibe o componente. Por exemplo, você pode ter um componente de linha de comandos na região, mas sua linha de comandos utiliza o token >>> em vez de ==>. Você pode alterar o atributo de token do componente de Linha de Comandos para procurar uma linha de comandos com o token correto.

Clique em Concluir quando tiver feito suas seleções de componente e widget.

Editar Componente do Host Apenas Web 

Com o assistente para Editar Componente do Host, você pode selecionar uma tela diferente para procurar componentes da lista suspensa Selecionar uma tela. Você também pode selecionar uma região diferente na tela a partir da qual extrair um componente do host desenhando um retângulo ao redor do texto.

Editar Componente do Host possui os mesmos recursos de Inserir Componente do Host. Ele permite editar uma tag que já foi inserida, tal como uma tag <HATS:Component> já colocada. Para obter informações adicionais, consulte Inserir Componente do Host.

Nota:
Para transformações do rich client, utilize a visualização Propriedades para editar combinações do componente do host.

Inserir Processamento Padrão

Com o assistente Inserir Renderização Padrão é possível selecionar a tela que deseja utilizar na lista suspensa Tela e o conjunto de renderizações na lista suspensa Selecionar um conjunto de renderizações. Ao inserir uma renderização padrão, a área definida renderizará os itens na ordem dos conjuntos de renderizações. Para obter informações adicionais, consulte Renderização Padrão.

Os campos na parte inferior do assistente mostram as linhas iniciais e finais e os números de coluna do retângulo. Você também pode digitar os número de linha e coluna digitando os números nos campos. Você pode destacar certos campos na tela de host selecionando as diferentes opções ao lado de Destacar campos. Se quiser ver onde os campos de entrada estão definidos na tela, selecione a caixa de opções Entrada. Se quiser ver quais campos estão protegidos, selecione a caixa de opções Protegido. Se quiser destacar quaisquer campos ocultos, selecione a caixa de opções Oculto. Para modificar as cores dos campos de entrada, protegidos ou ocultos que estão em destaque, consulte Utilizando Preferências do HATS. Quando você já selecionou a linha inicial e final e os números de coluna da tela, clique em Concluir e a sessão será inserida em sua tela na guia Design.

Editar Processamento Padrão Apenas Web 

Para editar o processamento padrão, clique na seção que deseja editar na guiaDesign, então selecione Editar Processamento Padrão a partir do menu Ferramentas do HATS. Isto ativará o assistente Editar Renderização Padrão, no qual é possível selecionar a tela que deseja editar na lista suspensa Tela e o conjunto de renderizações na lista suspensa Selecionar um conjunto de renderizações. Ao editar uma renderização padrão, a área definida renderizará os itens na ordem dos conjuntos de renderizações. Para obter informações adicionais, consulte Renderização Padrão.

Os campos na parte inferior do assistente mostram as linhas iniciais e finais e os números de coluna do retângulo. Você também pode digitar os número de linha e coluna digitando os números nos campos. Você pode destacar certos campos na tela de host selecionando as diferentes opções ao lado de Destacar campos. Se quiser ver onde os campos de entrada estão definidos na tela, selecione a caixa de opções Entrada. Se quiser ver quais campos estão protegidos, selecione a caixa de opções Protegido. Se quiser destacar quaisquer campos ocultos, selecione a caixa de opções Oculto. Para modificar as cores dos campos de entrada, protegidos ou ocultos que estão em destaque, consulte Utilizando Preferências do HATS. Quando você já selecionou a linha inicial e final e os números de coluna da tela, clique em Concluir e a sessão será inserida em sua tela na guia Design.

Nota:
Para transformações do rich client, utilize a visualização Propriedades para editar as combinações de renderização padrão.

Inserir Pasta Tabulada Apenas Web 

Utilize Inserir Pasta Tabulada para inserir uma pasta com guias em sua página da Web. Pastas tabuladas são úteis na organização de seus widgets e informações para exibir na página da Web. Com Inserir Pasta Tabulada, especifique quantas guias deseja para sua pasta. A combinação da pasta tabulada e da função da tela armazenada permite que você tenha uma pasta com uma tela de host diferente em cada guia. Para cada guia na pasta, também é possível especificar as seguintes configurações:

Em Opções Avançadas da Guia, se você limpar a caixa de opções Utilizar Valores Padrão, poderá especificar as seguintes configurações:

Em Opções Avançadas da Pasta, se você limpar a caixa de opções Utilizar Valores Padrão, poderá especificar as seguintes configurações:

A janela Visualizar mostra como a pasta tabulada aparecerá, com base nas seleções que você faz. Esta visualização não mostra os componentes que foram inseridos na pasta tabulada. Ela apenas exibe as alterações na pasta, como tamanho e cor.

Você pode clicar em Visualizar Página Inteira para mostrar todos os componentes na página juntamente com o modelo associado. Esta visualização mostra a página como ela aparecerá para o usuário.

Clique em OK quando tiver definido todas as opções da pasta tabulada para cada guia na pasta.

Uma vez criada uma pasta tabulada, você não pode voltar no Assistente para Inserir Pasta Tabulada para fazer alterações. Você precisa editar a origem porque a saída está em HTML (e as tags de componente do HATS).

Nota:
Como uma pasta tabulada é composta de várias tags HTML, não é recomendado tentar mover as seções individuais. Se você desejar alterar o local de sua pasta tabulada, selecione a célula que a circunda e mova-a para o local desejado.
Nota:
Para transformações do rich client, para inserir uma combinação para uma pasta tabulada, utilize o widget SWT TabFolder localizado na pasta Contêiners SWT na visualização Paleta.

Inserir Chave de Macro

Com Inserir Tecla de Macro, o usuário pode executar a macro em uma transformação clicando em um botão ou um link ou selecionando a macro a partir de uma lista suspensa. Por exemplo, sua transformação pode apresentar uma tela de logon que também possui um botão para uma macro de logon. Quando o usuário clica no botão, a macro é reproduzida para fornecer um ID de usuário e uma senha e navega para a próxima tela que o usuário precisa ver.

Para incluir uma macro em sua transformação, selecione a macro que deseja incluir. Para projetos da Web, você pode selecionar várias macros dentro da mesma instância do assistente. Para projetos do rich client, é possível selecionar apenas uma macro para cada instância do assistente. Você também deve definir como exibir e iniciar a macro a partir da transformação. Escolha uma das seguintes opções:

Nota:
O HATS utiliza a descrição da macro como o texto inserido na transformação para qualquer uma das opções de renderização mas ainda é possível alterar o nome editando o texto na visualização Origem.

Inserir Variável Global

Inserir Variável Global permite uma das seguintes opções:

Você seleciona uma variável global definida, cujo valor deseja exibir a partir da lista suspensa Nome.

Então, seleciona como deseja que a variável global seja exibida no tempo de execução. Se você selecionar Exibir valor da variável global como texto estático, poderá clicar no botão Avançado e na caixa de opções Variável é indexada. Em seguida, utilize os botões de rádio para especificar se todos os índices ou apenas um único índice foi inserido. Se você clicar no botão de rádio Mostrar todos os índices, selecione o Separador na lista suspensa. Se você clicar no botão de rádio Mostrar um único índice, especifique o número do índice a ser inserido. Selecionando a caixa de opções Compartilhado, a variável global será obtida a partir da lista compartilhada.

Se você desejar solicitar ao usuário que está utilizando uma caixa de entrada, selecione Solicitar Variável Global com Caixa de Entrada. Selecione Configurar Valor Inicial da Variável Global para inserir um valor inicial no campo de entrada. Selecionar Mascarar como Campo Senha irá mascarar o que o usuário insere no campo de entrada.

Inserir Área de Informações do Operador Apenas Web 

Selecione Inserir Área de Informações do Operador para exibir quaisquer informações disponíveis especificadas na guia Renderização das Configurações do Projeto. Para obter informações adicionais, consulte Operator Information Area.

Inserir Teclado Numérico do Host

Os teclados numéricos do host podem ser inseridos de várias maneiras. É possível inserir teclados numéricos do host padrão ou personalizados ou selecionar uma tecla individual para suas transformações.

Teclado Numérico Padrão Apenas Web 

Selecione Inserir Teclado Numérico do Host > Teclado Numérico Padrão para incluir um teclado numérico do host padrão em uma transformação. Um teclado numérico do host inserido é apenas visível nas exibições Visualizar e Design se as configurações de seu projeto estiverem configuradas para exibir o teclado numérico do host padrão em seu aplicativo do HATS. Para configurar seu projeto para mostrar o teclado numérico do host padrão e definir quais teclas incluir, vá para a visualização Projetos HATS, dê um clique duplo em Configurações do Projeto de seu projeto do HATS, selecione a guia Renderização e clique em Teclado Numérico do Host.

Teclado Numérico Personalizado Apenas Web 

Selecione Inserir Teclado Numérico do Host > Teclado Numérico Personalizado para incluir um teclado numérico do host personalizado em uma transformação. Os teclados numéricos de host personalizado utilizam as mesmas teclas especificadas nas configurações de teclado numérico padrão, localizadas em Configurações do Projeto de seu projeto HATS. Com um teclado numérico do host personalizado, é possível editar os atributos de botões ou links de teclado numérico individuais na visualização Design, destacando o botão ou link, clicando com o botão direito e selecionando Propriedades.

Tecla Individual

Utilize esta opção para incluir uma tecla do host individual em sua transformação. No painel Inserir Tecla de Host, selecione qual tecla do host inserir e, se você deseja que seja exibido como um botão ou link, então clique em OK. Para projetos da Web, você pode selecionar várias teclas do host dentro da mesma instância do assistente. Para projetos do rich client, você pode selecionar apenas uma tecla do host para cada instância do assistente. Após a inserção, você pode editar o botão ou link utilizando a guia Propriedades.

Inserir Teclado Numérico do Aplicativo

Os teclados numéricos do aplicativo podem ser inseridos de várias maneiras. É possível inserir teclados numéricos do aplicativo padrão ou personalizado ou selecionar uma tecla individual para suas transformações.

Teclado Numérico Padrão Apenas Web 

Selecione Inserir Teclado Numérico do Aplicativo > Teclado Numérico Padrão para incluir um teclado numérico do aplicativo padrão em um modelo. Para configurar o teclado numérico do aplicativo padrão e definir quais teclas exibir, vá para a visualização Projetos HATS, dê um clique duplo nas Configurações do Projeto de seu projeto do HATS, selecione a guia Renderização e clique em Teclado Numérico do Aplicativo.

Teclado Numérico Personalizado Apenas Web 

Selecione Inserir Teclado Numérico do Aplicativo > Teclado Numérico Personalizado para incluir um teclado numérico do aplicativo personalizado em um modelo. Os teclados numéricos de aplicativo personalizado utilizam as mesmas teclas especificadas nas configurações de teclado numérico padrão, localizadas em Configurações do Projeto de seu projeto HATS. Com um teclado numérico do aplicativo personalizado, é possível editar os atributos de botões ou links de teclado numérico individuais na visualização Design , destacando o botão ou link, clicando com o botão direito e selecionando Propriedades.

Tecla Individual

Utilize esta opção para incluir uma tecla de aplicativo individual em sua transformação. No painel Inserir Tecla do Aplicativo, selecione qual tecla do aplicativo inserir e, se você deseja que seja exibido como um botão ou link, então clique em OK . Para projetos da Web, é possível selecionar várias teclas de aplicativo dentro da mesma instância do assistente. Para projetos do rich client, é possível selecionar apenas uma tecla de aplicativo para cada instância do assistente. Após a inserção, você pode editar o botão ou link utilizando a guia Propriedades.

Inserir Todos os Componentes do Host  Apenas Web 

Selecione Inserir Todos os Componentes do Host quando desejar incluir todos os componentes do host possíveis a partir de uma determinada captura de tela ou personalização para uma transformação. Escolha a tela do projeto apropriada do menu suspenso Selecionar Tela. Você pode destacar certos campos na tela de host selecionando as diferentes opções ao lado de Destacar campos. Se quiser ver onde os campos de entrada estão definidos na tela, selecione a caixa de opções Entrada. Se quiser ver quais campos estão protegidos, selecione a caixa de opções Protegido. Se quiser destacar quaisquer campos ocultos, selecione a caixa de opções Oculto. Para modificar as cores dos campos de entrada, protegidos ou ocultos que estão em destaque, consulte Utilizando Preferências do HATS. Clique em OK depois de fazer suas seleções.

Os componentes do host incluídos utilizarão o conjunto de processamento especificado em Conjuntos de Processamento na guia Processamento das Configurações de Projeto do HATS.

Inserir a Tela Armazenada Apenas Web 

Selecione Inserir Tela Armazenada quando desejar incluir uma tela armazenada em sua transformação. Selecione o nome da tela armazenada e então selecione Todos os campos (não-protegidos e protegidos) ou Compartilhado. Por exemplo, telas armazenadas podem ser combinadas em uma transformação para criar uma tela que consiste em todos os campos de telas.

Para obter informações sobre como combinar várias telas, consulte Combinando Telas.

Visualizando Transformações

Como mencionado anteriormente, você pode visualizar um widget conforme ele é exibido em uma transformação no assistente Inserir Componente do Host ou no assistente Inserir Pasta Tabulada.

Outra maneira de visualizar sua transformação é utilizar capturas de tela. Para cada transformação criada em seu projeto, existe uma captura de tela associada. Você pode ver as capturas de tela expandindo a pasta Capturas de Tela na visualização Projetos HATS. Com um clique duplo no nome da captura de tela, é exibida uma visualização da captura de tela com duas guias, Tela do Host e Visualizar. A guia Tela do Host exibe a tela conforme ela aparece no host. A guia Visualizar exibe como a transformação é renderizada, juntamente com o modelo associado à transformação.

A transformação e o modelo utilizado para gerar a visualização são baseados nas personalizações de tela definidas em seu projeto. A Visualização varre a lista das personalizações de tela ativadas. Quando é encontrada uma customização de tela que corresponde à captura de tela, a primeira ação que aplica uma transformação (juntamente com o modelo associado) é utilizada para renderizar a visualização. Se nenhuma customização de tela correspondente for encontrada, o modelo padrão e a transformação são utilizados para a visualização.

Notas:
  1. A guia Visualizar não processará a Próxima Tela definida no evento de reconhecimento de tela. Para obter informações adicionais, consulte Próxima Tela.
  2. A guia Visualizar não exibirá uma transformação corretamente em um projeto de portlet. As limitações não incluem imagens de exibição e estilos de CSS corretamente. Dependendo do conteúdo da transformação, também podem ocorrer erros do JavaScript™.

Teclado Numérico do Host

O teclado numérico do host inclui botões que representam teclas do host, tais como F1, F2, e Limpar, que são utilizadas para controlar funções na tela do host.

Por padrão, o HATS não exibe o teclado numérico do host. Para exibir o teclado numérico, vá para a visualização Projetos HATS, dê um clique duplo nas Configurações de Projeto de seu projeto do HATS, selecione a guia Renderização e clique no Teclado Numérico do Host. Você terá então a opção de selecionar a caixa de opções para exibir o teclado numérico bem como selecionar quais teclas exibir.

Notas:
  1. Os teclados numéricos customizados e as teclas individuais são definidos utilizando tags individuais ou compostas, como resultado, elas são exibidas no editor de transformação.
  2. O texto na tela do host que descreve as teclas de função é transformado em botões ou links utilizando a transformação padrão. Eles são exibidos na área de tela do host transformada, de forma separada do teclado numérico do host.

Consulte o Modificando um Projeto do HATS para obter informações adicionais sobre as configurações do suporte de teclado e teclado numérico.