Tivoli Service Desk 6.0 Developer's Toolkit - Guia do Criador de Interface

Capítulo 5: Como Criar Recursos Adicionais

Retornar ao Índice


Introdução

Visão Geral

Adicionar avanços, tais como menus, barras de ferramentas, padrões e auxílio online pode tornar seu aplicativo mais útil. Primeiro você deve definir estilos de menu e da barra de ferramentas antes de adicionar esses avanços. Em seguida, renomeie o menu e a barra de ferramentas com o mesmo nome do formulário e eles serão "anexados" automaticamente ao formulário.

Componentes Padrão

O que são padrões?

Padrões são gabaritos para caixas de texto e são utilizados para fornecer dicas visuais aos usuários, com relação ao formato das informações digitadas. Os padrões são especificados como parte da descrição do controle em um arquivo de recurso.

Tipos de padrões

Existem seis possíveis tipos de padrões:

Máscaras de entrada e de exibição

Cada padrão consiste em uma máscara de entrada e de exibição. As máscaras de entrada consistem em espaços em branco e espaços de preenchimento e não aparecem aos usuários, mas limitam o que pode ser digitado. Por exemplo, você pode limitar os usuários para digitarem somente números em um campo de previdência social e somente caracteres alfabéticos para um campo de nomes. As duas máscaras de exibição são definidas através de sinalizadores de caracteres.

As máscaras de entrada são dicas visuais para os usuários sobre o que deve ser digitado em uma caixa de texto, embora um usuário possa digitar qualquer coisa. Por exemplo, uma máscara de entrada para um número de previdência social têm o seguinte aspecto:

nnn-nn-nnn

e uma máscara de entrada para um número de telefone tem o seguinte aspecto:

nnn-nnn-nnnn

Ao contrário das máscaras de exibição, as máscaras de entrada aparecem para os usuários.

Sinalizadores de caracteres

As máscaras de entrada são compostas de sinalizadores de caracteres e definem o que um usuário pode digitar em um padrão. Os sinalizadores de caracteres podem ser um dos seguintes:

Caracteres válidos

Os sinalizadores de caracteres podem ser personalizados através de caracteres válidos. Por exemplo, se você criar um controle em que seja digitado o número da licença do controlador e o número começar com letra maiúscula, será possível selecionar o sinalizador de caractere numérico e personalizá-lo com o caractere válido "A,". Isto permite que o usuário digite uma letra alfa maiúscula na primeira posição, enquanto o resto do campo permanece numérico.

A seguir são apresentados tipos de caracteres válidos:

Sinalizadores de preenchimento

Os sinalizadores de preenchimento consistem em:

Como Formatar Caixas de Texto com Padrões

Como criar padrões

Os padrões predefinidos no Criador de Interface abrangem a maioria dos tipos de controles que serão adicionados a um formulário. No entanto, utilize o seguinte procedimento se preferir criar seus próprios padrões.

Para criar um padrão:

  1. Abra o Criador de Interface.
  2. Abra um arquivo de recurso que contenha um formulário para o qual você deseja definir padrões.
  3. Escolha o separador Padrões.
  4. Escolha Incluir.
    Resultado: Aparece a caixa de diálogo Artista Padrão.
  5. Utilize a tabela a seguir para digitar informações conforme apropriado para seu aplicativo.

    Campo Descrição
    ID do Padrão O nome do novo padrão.
    Descrição A descrição do padrão.
    Máscara de Exibição O formato que controla o que o usuário pode digitar. Por exemplo, se você tiver uma máscara de número de telefone somente com caracteres numéricos, os usuários não conseguirão digitar um outro tipo de caractere que não seja numérico.
    Máscara de Entrada A máscara de entrada aparece no campo, mas não tem controle sobre o que o usuário pode digitar. Por exemplo, uma máscara de entrada para um número de telefone pode aparecer como nnn-nnn-nnnn; no entanto, isto não impediria o usuário de digitar caracteres alfabéticos no campo se a máscara de exibição não estivesse configurada somente para numérico.
    Caracteres Válidos A lista de caracteres válidos é mostrada aqui.
    Caractere de Preenchimento Um caractere que é inserido em uma caixa de texto quando uma entrada de controle está incompleta.
    Padrão de Teste O padrão de teste.
    Caracteres Coloca uma restrição no tipo de dados que os usuários podem digitar no padrão: caracteres AlphabeticNumericAny
    Preenchimento Especifica como os caracteres de preenchimento podem ser inseridos:
    • Reverso insere caracteres da direita para a esquerda.
    • Preencher tudo insere caracteres em todos os espaços de preenchimento.
  6. Escolha Aplicar ou OK.
  7. Associar o padrão a uma caixa de texto no formulário. Para obter mais informações sobre como especificar padrões com controle da caixa de texto, consulte "Como Criar Controles."

Como aplicar padrões a caixas de texto

Você pode aplicar padrões predefinidos e definidos pelo usuário a caixas de texto.

Para aplicar padrões a uma caixa de texto:

  1. Abra o Criador de Interface.
  2. Abra um arquivo de recurso que contenha pelo menos um formulário.
  3. Abra o formulário que deseja utilizar.
  4. Dê um clique duplo sobre a caixa de texto à qual deseja aplicar um padrão.
  5. Escolha o separador Caixa de Texto.
  6. A partir da lista Tipo de Padrão, selecione o padrão que deseja utilizar.
  7. Escolha Aplicar ou OK.

Como desassociar padrões de caixas de texto

Os padrões podem ser desassociados de qualquer caixa de texto, incluindo os que estão nos aplicativos de tempo de execução. Se um padrão for desassociado de uma caixa de texto, qualquer caractere poderá ser digitado na caixa de texto.

Para desassociar um padrão de uma caixa de texto:

  1. Abra o Criador de Interface.
  2. Abra um arquivo de recurso que contenha o formulário.
  3. Abra o formulário que deseja utilizar.
  4. Dê um clique duplo no controle do qual deseja desassociar o padrão.
  5. Escolha o separador Caixa de Texto.
  6. A partir da lista Tipo de Padrão, selecione Nenhum.

Como Criar Menus

Introdução

Geralmente, os menus são utilizados para acessar comandos sem utilizar um prompt de comandos. Esta seção discute como criar menus para formulários que se transformam em janelas.

Nota: O Criador de Interface permite criar menus com submenus, mas primeiro é necessário definir estilos do menu e da barra de ferramentas. Em seguida, renomeie o menu e a barra de ferramentas com o mesmo nome do formulário e eles serão "anexados" automaticamente ao formulário.

Como criar menus da janela

Você pode criar um menu quando cria um novo formulário para uma janela, ou quando trabalha com um formulário existente. Neste caso, as instruções são para um formulário existente.

Nota: Não é necessário associar menus a formulários. Se o separador Menu não aparecer na janela Criador de Interface TDT, selecione Preferências, no menu Opções, clique na caixa de opções Mostrar Página do Menu e clique no botão OK para salvar as alterações.

Para criar um menu:

  1. Abra o Criador de Interface.
  2. Abra um arquivo de recurso que contenha pelo menos um formulário.
  3. Escolha o separador Menu.
  4. Escolha Incluir.
    Resultado: Aparece a caixa de diálogo Criador de Menu.
  5. Dê um clique no nome do menu.
    Resultado: O nome associado ao menu aparece na caixa Nome do Menu.
  6. Escolha o botão de procura Nome do Menu.
  7. Digite um nome de menu exclusivo na caixa de diálogo ID Exclusivo e escolha OK.
    Resultado: A caixa de diálogo ID Exclusivo se fecha e o nome do menu digitado aparece na caixa de texto Nome do Menu na caixa de diálogo Criador de Menu. O nome do menu destina-se apenas ao desenvolvimento e não aparece para os usuários.
  8. Na caixa Texto do Menu, digite o texto que deseja que apareça no menu.
  9. Na caixa do grupo Estilo, selecione a partir dos seguintes estilos:
  10. Escolha Atualizar.
  11. Escolha OK.

Você pode adicionar outro menu no mesmo nível de menu dando um clique em Adicionar Depois.

Como adicionar submenus

Os submenus aparecem nos menus. Você pode criar submenus para um menu e também aninhar um submenu em um submenu.

Para adicionar um submenu:

  1. Abra um arquivo de recurso que contenha pelo menos um formulário.
  2. Escolha o separador Menu.
  3. Escolha o menu ao qual deseja adicionar um submenu e dê um clique em Atualizar.
    Resultado: Aparece a caixa de diálogo Criador de Menu.
  4. Dê um clique no menu na lista de menus à qual deseja adicionar um submenu.
  5. Escolha Adicionar Abaixo.
    Resultado: Um novo submenu com o nome padrão NEW_ITEM1 aparece abaixo do menu selecionado.
  6. Dê um clique no nome do novo submenu.
    Resultado: As caixas Nome do Menu e Texto do Menu são ocupadas com informações padrão.
  7. Especifique um nome de menu exclusivo, um texto de menu e auxílio (se necessário).
  8. Escolha Atualizar.
    Resultado: O submenu padrão é substituído pelo novo texto do menu, bem como as outras informações especificadas.
  9. Escolha OK.

Você pode adicionar um submenu a um submenu repetindo este procedimento. Para isto, selecione o submenu em vez de um menu antes de dar um clique em Adicionar Abaixo. (Você pode adicionar outro submenu no mesmo nível de submenu dando um clique em Adicionar Depois.)

Como testar menus

Para testar um menu:

  1. Selecione um menu na estrutura da árvore.
  2. Escolha Testar.
    Resultado: Aparece um menu popup com a estrutura do menu e o texto criado.
  3. Dê um clique em qualquer lugar para fechar o menu popup.
  4. Escolha OK.

Como excluir menus

Para excluir um menu:

  1. Dê um clique em um menu ou submenu na estrutura da árvore.
  2. Dê um clique em Excluir.
    Resultado: Se você selecionou um menu ou submenu que seja um "pai" para outros submenus, aparecerá um prompt perguntando se você deseja atualizar as modificações no menu. Caso contrário, o menu selecionado será excluído e removido da lista de menus.
  3. Escolha OK.

Como Criar e Trabalhar com Barras de Ferramentas

Introdução

As barras de ferramentas permitem que os programas se comportem de uma maneira que seja mais "amigável" do que seriam habitualmente. Os botões em uma barra de ferramentas agem como mnemônicos visuais, ou seja, um botão representa um comando de menu do qual o usuário não precisa se lembrar. Os botões também tornam mais acessíveis os comandos freqüentemente utilizados.

Esta seção descreve como adicionar uma barra de ferramentas a um formulário que se torna uma janela.

Nota: Para criar uma barra de ferramentas, selecione Preferências, no menu Opções, clique na caixa de opções Mostrar Página da Barra de Ferramentas e no botão OK para salvar as alterações.

Como Criar Barras de Ferramentas

Uma barra de ferramentas pode ser adicionada a um formulário a qualquer momento.

Para criar uma barra de ferramentas:

  1. Abra o Criador de Interface.
  2. Escolha o separador Barras de Ferramentas.
  3. Dê um clique em Adicionar.
    Resultado: Aparece a caixa de diálogo Propriedades da Barra de Ferramentas. O nome de uma barra de ferramentas padrão, NEW_TOOLBAR1, aparece na caixa de texto Nome da Barra de Ferramentas.
    Nota: Se você selecionou a preferência pelo formulário Folhas de Propriedades Automáticas, a folha de propriedades Propriedades da Barra de Ferramentas aparecerá automaticamente quando for criada uma nova barra de ferramentas.
  4. Escolha o botão de procura Nome da Barra de Ferramentas.
  5. Na caixa de diálogo ID Exclusivo, digite um nome exclusivo para substituir o nome da barra de ferramentas padrão e escolha OK.
    Resultado: A caixa de diálogo ID Exclusivo se fecha e o nome da barra de ferramentas digitado aparece na caixa de texto Nome da Barra de Ferramentas na caixa de diálogo Propriedades da Barra de Ferramentas.

Como criar botões da barra de ferramentas

Para adicionar um botão na barra de ferramentas:

  1. Escolha o separador Barras de Ferramentas.
  2. Dê um clique na barra de ferramentas à qual deseja adicionar um botão.
  3. Dê um clique em Atualizar.
  4. A partir da caixa de diálogo Propriedades da Barra de Ferramentas, digite um ID da cadeia na caixa de texto ID do Item para representar o botão para fins de desenvolvimento.
  5. Dê um clique no botão de procura Arquivo do Ícone.
  6. Selecione o arquivo do ícone que você deseja que apareça no botão.
  7. Para criar um texto da descrição de ferramenta, digite o texto na caixa Texto do Auxílio.
  8. Escolha Incluir.
    Resultado: O botão aparece na lista representada pelas informações digitadas sobre o ID do Item, o arquivo do ícone e o texto do auxílio.
  9. Para adicionar mais botões à barra de ferramentas, repita as etapas de 5 a 9 conforme necessário.
  10. Se desejar que os botões fiquem em uma ordem diferente daquela em que os adicionou, utilize os botões Mover para Cima e Mover para Baixo para reorganizar a ordem.
    Nota: O botão na parte superior da lista aparecerá na parte superior da barra de ferramentas, se ela aparecer verticalmente, e o primeiro botão no lado esquerdo, se a barra de ferramentas aparecer horizontalmente.
  11. Escolha Atualizar.
  12. Escolha OK.

Como criar separadores entre botões

Os separadores melhoram a aparência de uma barra de ferramentas porque permitem espaço entre os botões, o que facilita a utilização visual da barra de ferramentas.

Para adicionar um separador a uma barra de ferramentas:

  1. Abra um arquivo de recurso que contenha o formulário com o qual você deseja trabalhar.
  2. Escolha o separador Barras de Ferramentas.
  3. Dê um clique duplo no nome da barra de ferramentas que deseja utilizar.
  4. A partir da caixa de diálogo Propriedades da Barra de Ferramentas, dê um clique no nome do formulário da barra de ferramentas que deseja utilizar.
  5. Escolha Separador.
    Resultado: O separador aparece na parte inferior da lista de barras de ferramentas.
  6. Escolha Mover para Cima ou Mover para Baixo para mover o Separador entre os botões da barra de ferramentas.
  7. Repita as etapas 6 e 7 para adicionar mais separadores.
  8. Se desejar que os botões fiquem em uma ordem diferente daquela em que os adicionou, utilize os botões Mover para Cima e Mover para Baixo para reorganizar a ordem.
  9. Escolha Atualizar.
  10. Escolha OK.

Como Criar Controles de Hipertexto

Introdução

Os controles de hipertexto fornecem informações online para usuários finais e podem incluir texto, som e imagens. Eles também podem ser ligados a programas externos. Os controles de hipertexto não substituem o auxílio online, mas são um método alternativo de exibir informações.

Os controles de hipertexto ficam visíveis se houver um formulário aberto. Eles aparecem como uma caixa de entrada multilinha com texto. O texto pode ser representado como texto colorido ou como um botão.

Tipos de botões de hipertexto

Os botões aparecem com uma cor diferente do texto regular no momento da execução. Quando é dado um clique no botão, aparece o Visualizador de Hipertexto do TSD Developer's Toolkit, contendo o item ligado.

A seguir são apresentados os tipos de botões que podem ser criados:

Como criar botões de hipertexto

Os botões são criados através das marcações da cadeia de hipertexto.

Para criar um botão de hipertexto:

  1. Abra um arquivo de recurso que contenha o formulário que deseja utilizar.
  2. Abra o formulário que deseja utilizar.
  3. A partir da Paleta de Controles, dê um clique no botão Hipertexto.
  4. No formulário, dê um clique com o indicador do mouse onde deseja que o botão apareça e arraste o indicador do mouse até que o contorno do botão esteja com o tamanho desejado.
    Nota: Se você selecionou a preferência pelo formulário Folhas de Propriedades Automáticas, a folha de propriedades Propriedades do Controle aparecerá automaticamente quando for criado um novo controle.
  5. Dê um clique com o botão direito do mouse no controle de hipertexto.
  6. Escolha Propriedades.
  7. Define as propriedades do separador Base ou Auxílio conforme necessário.
  8. Escolha o separador Hipertexto.
  9. Selecione um estilo a ser aplicado ao botão de hipertexto.
  10. Utilize a tabela a seguir para digitar a marcação de hipertexto apropriada na caixa Texto Inicial.
    Nota: Em cada exemplo de marcação de hipertexto, Nome do Botão representa o que o usuário verá.

    Marcação Objetivo Sintaxe Opções de Estilo
    Botão Alfabético Transmite um ID alfabético para um programa Developer's Toolkit [[Nome do Botão|RÓTULO texto do rótulo]] N/A
    Arquivo externo Cria um link para um arquivo externo [[Nome do Botão|ARQUIVO ATRIBUTOS de nome do arquivo]]
    • Sem quebra de linha significa que o usuário deve utilizar os retornos de carro fixos para quebrar texto manualmente para a próxima linha.
    • Sem Formatação provoca a quebra de linha automática.
    • Nenhum não possui formatação da linha.
    Programa externo Cria links para programas externos. O arquivo executável do programa deve ter uma extensão .exe. Os argumentos especificados são transmitidos como argumentos do prompt de comandos para o programa. [[Nome do Botão|EXECUTAR ARGUMENTOS de nome do programa]] N/A
    Link de hipertexto Cria um link de hipertexto para uma URL. O link inicia o navegador da Internet especificado na variável de ambiente WebBrowser. O nome da URL pode ser http, ftp e news. [[texto | nome da URL]] O texto aparece como um bloco azul.
    Imagem Cria um botão da imagem [[Nome do Botão|ATRIBUTOS do nome do arquivo de IMAGEM]]
    • Rolar cria barras de rolagem na janela do hipertexto.
    • Limite corta a imagem para que caiba na moldura.
    • Escala faz com que a imagem caiba totalmente na janela de hipertexto.
    Marcação Saltar Pesquisa a lista de marcações em busca de um marcador que corresponda ao texto depois do salto. Se for encontrada uma correspondência, a linha que contém o marcador será posicionada na parte superior do visualizador. Além disso, a exibição de hipertexto processa EventJump para manter uma lista de marcadores utilizados em um arquivo. [[texto | Nome do marcador de salto]] N/A
    Marcação do marcador Coloca um marcador invisível no texto [[texto | Marcador nome do marcador]] N/A
    Botão Numérico Transmite um botão numérico para um programa TSD Script [[Nome do Botão|ID id_number]] em que Nome do Botão o texto é exibido para o usuário N/A
    Cadeia de pesquisa Procura o texto especificado em um visualizador de hipertexto [[Nome do Botão|PESQUISA texto de pesquisa]] N/A
    Arquivo de som Cria links para arquivos de som [[Nome do botão|REPRODUZIR nome do arquivo]] N/A


  11. Quando terminar de definir as propriedades, escolha Aplicar ou OK.
    Nota: Dando um clique no link exibe o Visualizador do TSD Developer's Toolkit.

Como Criar Auxílio Online

Introdução

Você pode criar auxílio online dependente de contexto para controles e formulários de duas formas:

Os arquivos de auxílio ligados ao seu formulário devem residir em uma das seguintes áreas:

Como adicionar o auxílio online

Para adicionar o auxílio online:

  1. Dê um clique duplo no controle ou formulário para exibir suas propriedades.
  2. Escolha o separador Auxílio.
  3. Execute uma das seguintes ações:
  4. Escolha Aplicar ou OK.
    Nota: Você só pode utilizar as marcações de texto do auxílio do Developer's Toolkit em seu formulário.

Tivoli Service Desk 6.0 Developer's Toolkit - Guia do Criador de Interface

Retornar ao Índice

Copyright