Zim 8.x Zim IDE Tutorial

Transcrição

1 I. Inicio.- 1) Para criar objetos recomendamos que instale o Zim completo em sua estação de desenvolvimento ou o ZimTC Lembrando que nas estações dos usuários deve ser instalado o ZimThinClient. 2) Crie uma base de dados para desenvolvimento local executando o comando ziminitw, Comando que se encontra também no diretório onde foi instalado o Zim. Se sugere criar uma base de desenvolvimento local, de preferencia que seja uma replica da base original ou de produção. 3) Após a instalaçao do Zim, verifique e atualize o arquivo zimdb.zim localizado no diretório onde foi instalado o ZIM. No exemplo: - Na primeira coluna, temos o nr.1 que serve para identificar o nr. da base de dados a ser acessada, pois o Zim pode acessar varias bases de dados. - Na segunda coluna, temos o nome lógico definido para representar o nome da base de dados. Este nome será utilizado para fazer conexão com a base de dados. - Na terceira coluna, temos o nome da base de dados que vamos acessar. Cada coluna tem o separador representado por ; (Ponto e vírgula). Zim Technologies do Brasil - Zim Corporation Page 1 of 69

2 4) Inicializar o servidor (Start Zimserver).- Para iniciar o servidor recomendamos que crie um atalho para executar este serviço. Exemplo: A figura mostra o atalho criado. Ao executar este atalho, o zim lê o arquivo zimdb.zim. Se encontrar qualquer anormalidade neste arquivo ou outro problema como porta bloqueada ou a porta não está configurada no padrão (6002) exigido,etc. é gravada uma mensagem no arquivo zimsvlog.zim e abandona a conexão. Se não encontrar problemas abre a janela de Start Zimserver Que deve ficar aberta até o término da sessão Zim. O idel é que esta tela fique minimizada. Zim Technologies do Brasil - Zim Corporation Page 2 of 69

3 Para finalizar ou parar o servidor crie também um atalho como no exemplo a seguir: Ficando o atalho como mostra a figura abaixo. Ao executar este atalho, a janela aberta start zimserver será fechada e o zimserver será desligado. Objetos podem ser adicionados ou alterados somente quando o Zim IDE for invocado. A ZIM disponibiliza a ferramenta Zim IDE ( Zim Integrated Development Environment) para o desenvolvimento de objetos Zim, incluindo um designer de interface gráfica do usuário que permite que você possa atender às suas próprias aplicações individuais. O Zim IDE fornece uma interface fácil de usar, integrado a muitas características Zim 8,21, onde pode criar suas Windows, Menus, Dispalys, Entidades, formulários, etc. A ZIM está comprometida com o desenvolvimento e melhoria contínua de Zim IDE e a linguagem Zim. Como tal, sempre haverá novos recursos e melhorias no Zim IDE, enquanto continuamos a desenvolver e melhorar a sua funcionalidade. Zim Technologies do Brasil - Zim Corporation Page 3 of 69

4 II. O que é Zim IDE? Zim 8.x Zim IDE Tutorial The Zim Integrated Development Environment (IDE Zim) é o novo ambiente de desenvolvimento completo para construir interfaces gráficas de usuário (GUI) para aplicações de banco de dados Zim. Esta ferramenta implementa algumas características importantes no Zim 8.21 que, definitivamente, moderniza ainda mais o Zim em forma geral. Zim IDE combina e estende a funcionalidade de três componentes distintos de desenvolvimento para aplicações Zim: Zim Painter Zim Development Center Dicionário de Dados Navegador 1. -Começando Zim IDE (Starting Zim IDE) Os passos necessários requeridos para iniciar a primeira sessão IDE Zim após a instalação. Zim IDE pode ser iniciado de duas maneiras diferentes: 1.1. Iniciar o Zim IDE de ZimThin Client Você pode invocar Zim IDE diretamente do Zim Thin Client ou Zim QT (ambos apenas no Zim 8.21, na opção Actions): Direto do Zim.- Zim IDE irá inicializar usando a conexão de dados do seu atual Zim Thin Client ou da sessão Zim QT digitando no promt do zim o comando IDE. Zim Technologies do Brasil - Zim Corporation Page 4 of 69

5 1.2. Diretamente do diretório do Zim A partir do diretório de instalação do Zim, executar ou clicar duas vezes sobre o arquivo ZimIDE.exe C:\zim\8.21\ Zim Technologies do Brasil - Zim Corporation Page 5 of 69

6 Alternativamente, você também pode clicar em um atalho Zim: no ambiente de trabalho (Desktop); Que ficará na sua área de trabalho (desktop) como na figura a seguir: O nome ZimIDE 8.21 é um título sugerido, pode escolher outro nome na barra de ferramentas Quick Launch; Zim Technologies do Brasil - Zim Corporation Page 6 of 69

7 seleccionando em Iniciar (Todos os) Programas ZIM Zim 8,21 (ou 7,21 Zim) Zim IDE Zim Technologies do Brasil - Zim Corporation Page 7 of 69

8 1.3. Tela de Conexão a Base de dados. Zim 8.x Zim IDE Tutorial Então Zim IDE não é iniciado de uma sessão Zim Thin Client ou Zim QT existente, toda a informação necessária para a conexão deve ser fornecida. A seguinte janela será apresentada quando o ZimIDE.exe é executado. Onde: User Name (Nome de Nome de Usuário da tabela "users" no banco de dados Zim. "ZIM" é usuário padrão. Usuário) Password (Senha) Senha para o usuário. O usuário Padrão "ZIM" não tem senha. Database (Banco de dados) O nome lógico do banco de dados em que você está se conectando, como está definido no arquivo zimdb.zim, localizado no diretório de instalação ZIM. Port Number (Porta número) Número da porta que Zim Server está escutando. A porta padrão para Zim 8.21 é 6002, a porta padrão para Zim 7.12 é 5001 Driver Host Name Selecione a versão do driver que corresponde à versão de Zim que você está usando. Colocar nome o endereço IP ou nome do computador que está hospedando Zim Server. Você pode usar "localhost" se Zim Server está sendo executado na mesma máquina como Zim IDE. Zim Technologies do Brasil - Zim Corporation Page 8 of 69

9 Objetos Zim IDE Graphical User Interface Designer Zim 8.x Zim IDE Tutorial Ao clicar em Ok na tela de conexão a Base de dados, será aberta a interface do ZimIDE com seus componentes iniciais: Na ordem temos a opção Database (Database Viewer Tab Page) é mostrado como default na coluna da esquerda, mas podemos trocar pela visualização da Caixa de Ferramentas (Tool Box). Na coluna a direita é mostrada a opção Properties (propriedades) podendo ser trocada para visualizar o Zim Object Tree View. Na parte central temos a área para editar/criar objetos denomiada de GUI Designer. Ao clicar no nó (caixa + ) em Zim IDE Databases, serão mostradas as Bases de dados abertas no Zim IDE. E Clicando na caixa da base neste caso base_821+localhost abre a lista de objetos do Zim. Zim Technologies do Brasil - Zim Corporation Page 9 of 69

10 O mesmo acontece para mostrar os objetos abertos no Zim IDE. Na coluna a direita de Zim Object Tree View Clique na caixa + Zim IDE Objects Esta opção mostra a árvore de objetos abertos no Zim IDE. As propriedades só serão mostradas quando existir objetos sendo editados no GUI Designer. A seguir uma descrição detalhada de todos os objetos de banco de dados e componentes de interface de usuário disponíveis no Zim IDE, para o desenvolvimento de aplicações de banco de dados Zim baseados em GUI. Zim Technologies do Brasil - Zim Corporation Page 10 of 69

11 2. -Desenvolvimento de Aplicações Zim 8.x Zim IDE Tutorial Uma introdução às operações disponíveis para criar e editar janelas, menus, telas, formulários e campos de formulário Funcionalidades Zim IDE Descrição resumida das principais características e funcionalidades do Zim IDE Características Gerais desenvolvimento de aplicativos local e remotos; desenvolvimento de aplicações multiusuário; Criar e editar forms e displays em ambos os aplicativos TUI e GUI; Criar e editar modelos de relatórios gráficos (em desenvolvimento); Suporta o Zim 7.12 e Zim 8.21 nas plataformas Windows, Linux, etc; Se conecta a vários bancos de dados ao mesmo tempo; Pode navegar no dicionário de dados inteiro, através da exibição Tree View Novos objetos e atributos em Graphical User Interface Designer Novos objetos de interface do usuário para Zim 8.21: Grid Control Projetado para melhorar e modernizar a entrada (input), saída (output) e apresentação da informação em uma tabela ( "grid" ), formato semelhante a planilhas. Isto substitui e amplia o conceito de formas repetidas, agiliza a entrada e saída de informações, moderniza a apresentação e a forma como ele interage com o usuário. Ela pode ser tratada de duas maneiras: Estática: o controle de grade que representa o objeto necessário para o usuário é definido no momento do designer e, posteriormente, utilizado como ele foi originalmente definido. A informação é carregada, modificado e descarregados sempre que houver uma entrada e / ou operação de exibição. Este modo de operação simula directamente a metodologia real formas repetidas em Zim ; Zim Technologies do Brasil - Zim Corporation Page 11 of 69

12 Dinâmica: o controle de grade que representa o objeto necessário para o usuário é definida apenas pelo seu " recipiente", sem qualquer definição de seu conteúdo. Mais tarde, durante a execução, os conteúdos são programaticamente definido em termos de linhas e de colunas, em cada uma das células. Tab Control e Tab Page gerenciados automaticamente pelo cliente (não requer código extra de Zim). A TabControl contém páginas de guia, que são representadas por TabPage objetos adicionados por meio da propriedade TabPages. Tool Strip Novos atributos para form fields: Anchoring (Ancoragem) Docking Os Atributos de Tab Page pode ser configurado para estar sempre visível; Criar e editar vários objetos simultaneamente; moderna interface de desenvolvimento com abas: Cada Form, Display, Window, Menu, e Document permanece aberto em sua própria página guia Editor de documentos (Document Editor) Projetado como um editor especializado embutido para programas aplicativos Zim e outros documentos; O destaque das sintaxes personalizadas para a linguagem Zim; Região de expansão e contração; Database Viewer Tab Page Simultaneamente procurar todos os dados actualmente ligado ao ambiente de desenvolvimento em uma única guia de página. Zim Technologies do Brasil - Zim Corporation Page 12 of 69

13 3. -Requisitos do sistema operacional Os requisitos para instalar e executar Zim IDE em diferentes sistemas operacionais: Zim IDE pode exigir mudanças na configuração do servidor das máquinas cliente e/ou para se conectar ao banco de dados corretamente. Essas alterações podem afetar a memória virtual, as configurações de compatibilidade e segurança destas máquinas. Além disso, existem requisitos específicos para executar Zim IDE, de acordo com a versão da linguagem Zim instalado em cada máquina: 3.1. Zim Na máquina servidor (host) banco de dados; Zim Integrated Server; Licença de ativação do Zim Integrated Server; - Na máquina cliente (desenvolvimento) Zim IDE; Zim 7.12 driver ODBC; Licença de ativação do Zim 7.12 ODBC; Zim Technologies do Brasil - Zim Corporation Page 13 of 69

14 3.2. Zim Na máquina do servidor (host) banco de dados; Zim Server; licença ativada Zim Server; Licença de ativação do Zim 8.21 ODBC; Na máquina cliente (desenvolvimento) Zim IDE; Zim 8.21 driver ODBC; 3.3. Zim Server Sistemas operacionais Server Different Zim requerem diferentes alterações de configuração para executar Zim 8.21 corretamente. Para mais informações sobre como configurar e usar Zim Server (Zim 8.21) ou Zim Integrated Server (Zim 7.12), consulte o Guia de Introdução. Zim Technologies do Brasil - Zim Corporation Page 14 of 69

15 4. -Componentes do Zim IDE 4.1. A Organização do Zim IDE O Zim IDE é composto por oito componentes visuais distintos distribuídos em cinco diferentes painéis. Alguns painéis são ocupados por dois componentes visuais diferentes, das quais apenas uma é apresentada individualmente quando selecionado pelo desenvolvedor. Os componentes visuais de Zim IDE e respectivos painéis de exibição são apresentados a seguir: Componente Area de Display Menu Tool Bar Área de Menu Database Tab Page Left Panel (Painel a esquerda) Tool Box Tab Page Left Panel (Painel a esquerda) GUI Designer Central Panel (Painel central) Document Editor Central Panel (Painel central Properties Tab Page Right Panel (Painel direito) Tree View Tab Page Right Panel (Painel direito) The Field View Panel Field View Panel (Painel de visão do campos) As imagens a seguir mostram como as diferentes áreas do Zim IDE encaixam durante o processo de design de interface de usuário: A Barra de ferramentas menu (The Menu Tool Bar) Principais características de Menu Tool Bar.- contém atalhos para os itens de menu que são usados com freqüência. Há ícones para os seguintes itens de menu: Zim Technologies do Brasil - Zim Corporation Page 15 of 69

16 A barra de ferramentas do menu é dividido nas seguintes áreas de menu: The Main Menu (Menu Principal) The File Menu The Edit Menu The View Menu The Toggle Menu (Menu de Alternancia) The Alignment Menu The Search Menu The Main Menu File Edit Tools View Designer Help Contém operações de arquivos: New, Open, Save, Save As and Close. Contém operações de editar: Cut, Copy, Paste.( Cortar, Copiar, Colar.) Ativa o menu de preferências e do Modo de Teste.( Test View) Ativar ou desativar o modo de exibição de campos. Mostra o Menu de Alinhamento. Esta opção fica disponível após editar qualquer objeto. Conecta-se à Biblioteca da Ajuda Online. Zim Technologies do Brasil - Zim Corporation Page 16 of 69

17 The File Menu (O menu de Arquivo) Criar um novo objeto. Salvar o objeto atual. Salve todos os objetos abertos e modificados recentemente ou no momento. Conectar a outra instância de um banco de dados Zim. Múltiplas conexões simultâneas são suportados. Imprimir a window, form ou display atualmente aberto no the GUI Designer. Zim Technologies do Brasil - Zim Corporation Page 17 of 69

18 The Edit Menu (O Menu Editar) Desfazer a última ação. Refazer a última ação desfeita. Cortar o objeto atual selecionado no GUI Designer e colocá-lo na área de transferência. Copie o objeto atual selecionado no GUI Designer e colocá-lo na área de transferência. Colar o conteúdo da área de transferência na área de trabalho GUI Designer. Excluir o objeto selecionado no espaço de trabalho do GUI Designer. Zim Technologies do Brasil - Zim Corporation Page 18 of 69

19 The View Menu (O menu Exibir) Mostrar a Tool Box Tab Page. Mostrar a hierarquia de objetos na Tree View Tab Page; Mostrar os atributos do objeto selecionado na guia Attributes Tab Page. Mostrar os objetos existentes em todas as bases de dados atualmente conectados na aba da Database Tab Page. The Toggle Menu (O menu de alternância) Repeat Field Repita a seleção atual da caixa de ferramentas (tool box); Atualizar (Refresh) os objetos atualmente na área de trabalho GUI Designer. Zim Technologies do Brasil - Zim Corporation Page 19 of 69

20 The Alignment Menu (O Menu Alinhamento) Alinhar a esquerda todos os objetos atualmente selecionados com o primeiro objeto que foi selecionado. Alinhar a direita todos os objetos atualmente selecionados com o primeiro objeto que foi selecionado. Alinhar acima todos os objetos atualmente selecionados com o primeiro objeto que foi selecionado. Alinhar abaixo todos os objetos atualmente selecionados com o primeiro objeto que foi selecionado. Alinhar Horizontalmente todos os objetos atualmente selecionados com o primeiro objeto que foi selecionado. Alinhar Verticalmente todos os objetos atualmente selecionados com o primeiro objeto que foi selecionado. Se existirem vários objectos sobrepostos, o objecto actualmente seleccionado é trazido para a parte superior da pilha. Se vários objetos são sobrepostos, o objeto atualmente selecionado é empurrado para o fundo da pilha. Horizontalmente vários objetos selecionados são separados por espaços uniformes. Zim Technologies do Brasil - Zim Corporation Page 20 of 69

21 (Ctrl + seta para a esquerda) aumenta ligeiramente o espaço horizontal entre vários objetos selecionados. (Ctrl + seta para a direita) diminui ligeiramente o espaço horizontal entre os objetos selecionados no momento. Verticalmente vários objetos selecionados são separados por espaços uniformes. (Ctrl + seta para cima) aumenta ligeiramente o espaço vertical entre vários objetos selecionados. (Ctrl + seta para baixo) diminui ligeiramente o espaço vertical entre vários objetos selecionados. Múltiplos objectos ficam com a mesma largura que o primeiro objecto que foi seleccionado. Múltiplos objectos ficam com a mesma altura que o primeiro objecto que foi seleccionado. The Search Menu (O Menu de Pesquisa) Find: Procure todos os objetos no banco de dados atual pelo nome. Zim Technologies do Brasil - Zim Corporation Page 21 of 69

22 The Database Tab Page (A página guia de Database). Principais Características do Database Tab Page o Database Tab Page exibe todos os bancos de dados atualmente conectados à sessão atual do Zim IDE. Cada banco de dados conectado é representado como um nó expansível contendo todas as possíveis categorias de objetos de banco de dados. Cada categoria de objeto também é representado como um nó expansível contendo todos os objetos dessa categoria no banco de dados. Para editar um objeto, clique no seu nome para abri-lo no espaço de trabalho do Designer GUI; Para criar um objeto, botão direito do mouse sobre a categoria do objeto que você deseja criar e insira as informações necessárias no diálogo Novo Objeto; Zim Technologies do Brasil - Zim Corporation Page 22 of 69

23 The Tool Box Tab Page (página guia da caixa de ferramentas.). Principais Características do Tool Box Tab Page A Tool Box Tab Page contém uma seleção de objetos GUI disponíveis que podem ser adicionados ao formulário atual. Zim Technologies do Brasil - Zim Corporation Page 23 of 69

24 The Attributes Tab Page Principais Características do Attributes Tab Page Os atributos Tab página lista todos os atributos diferentes para o campo selecionado (s) no Designer GUI. Os valores de todos os atributos estão disponíveis dentro desta página guia. Isto permite que você altere o nome do campo gerado automaticamente para um nome significativo, se desejar, alterar qualquer texto do rótulo associado ao campo, pode modificar alguns ou todos os seus atributos padrão do objeto editado. Special Properties (Propriedades especiais) Campos especializados, tais como a grade ou treeview podem ter ferramentas adicionais para adicionar / editar objetos filho. Zim Technologies do Brasil - Zim Corporation Page 24 of 69

25 The Tree View Tab Page Principais Características do Tree View Tab Page The Tree View Tab Página mostra a hierarquia dos objetos atualmente abertas no Designer GUI. Na Visão em Árvore, objetos de interface do usuário primário, tais como formulários, telas e menus, aparecem como os principais nós. Os formulários são os únicos filhos de displays Todos os outros objetos Zim Technologies do Brasil - Zim Corporation Page 25 of 69

26 The GUI Designer Principais Características do GUI Designer O Designer de Interface Gráfica de Usuário (GUI Designer) é onde as Windows, displays, os forms e os menus são projetados, editados e configurados; O GUI Designer também é usado para edição de documentos e exibir atributos de objetos de banco de dados Vários objetos podem ser editados simultaneamente; Para cada objeto que estiver aberto, um guia, mostrando o nome do objeto, é adicionado à barra superior do espaço de trabalho do Designer GUI. Zim Technologies do Brasil - Zim Corporation Page 26 of 69

27 The Field View Principais Características do Field View O Field View é ativado automaticamente em objetos editados que podem conter campos personalizados editados ou adicionados, como: Entidades; Relacionamentos; Documentos. Os Field View podem ser visíveis ou invisíveis, via controle através do item de menu Exibir no Menu principal. Zim Technologies do Brasil - Zim Corporation Page 27 of 69

28 The Document Editor(O Editor de documentos) Principais Características do Editor de documentos O Editor de documentos é onde documentos, tais como programas de Zim, parâmetros de banco de dados e arquivos de configuração são visualizados e editados. Ocupa a mesma área que o GUI Designer Oferece destaque de sintaxe personalizado para a linguagem de programação Zim. Os documentos podem ser abertos e editados diretamente a partir da página da guia Banco de dados: Clique no nó de documentos sob um dos bancos de dados conectados e selecione o documento que você deseja abrir e editar. Zim Technologies do Brasil - Zim Corporation Page 28 of 69

29 Zim Technologies do Brasil - Zim Corporation Page 29 of 69

30 III. Criando Objetos ZIM. 1) Diretórios.- (dirs) Na coluna Database Tab page selecionamos o objeto Directories. Zim 8.x Zim IDE Tutorial a) Incluir ou adicionar um novo Dir. Com o botão direito do mouse sobre o nome Directories temos a opção de adicionar um novo diretório. Clicando em New, temos o editor do Designer para informar os dados do objetos Directories. Em Identification Properties Altere/informe o nome do diretório. Zim Technologies do Brasil - Zim Corporation Page 30 of 69

31 No exemplo vamos colocar Dir_novo, no nome do Dirname. Em Object Properties informamos o DirId e se o Diretório é estrangeiro ou não. Note que na criação deste objeto não temos propriedades na coluna Properties. Zim Technologies do Brasil - Zim Corporation Page 31 of 69

32 Temos tres opções para salvar um objeto: File/Save, Save e Close/X Zim Technologies do Brasil - Zim Corporation Page 32 of 69

33 Save File:Salvar, Salvar todos ou Salvar como. Zim Technologies do Brasil - Zim Corporation Page 33 of 69

34 Pelo Close ou X. Nesta opção o sistema pergunta se quer Salvar (Sim), Sair e não Salvar (Não) ou Cancelar esta ação e ficar no editor sem salvar. Quando invoca um objeto e não faz nenhuma alteração, pode clicar no Close (X) para desistir do mesmo e sair da lista de objetos na página guia. Zim Technologies do Brasil - Zim Corporation Page 34 of 69

35 b) Editar e alterar um dir. Podemos editar o objeto Diretório de duas formas: 1.- Duplo clique com o mouse sobre o nome do diretório que desejamos editar. 2.- Clicar com o botão direito do mouse sobre o nome do diretório, onde serão mostradas as opções: Edit, Delete e Copy como mostrado na figura a seguir. Clique na opção Edit. O diretório será mostrado na área do editor do GUI Designer. Agora é só alterar as propriedades do diretório, como o nome, DirId e Foreign e salvar as alterações seguindo os procedimentos sugeridos na inclusão de objetos, ou seja, as tres opções para salvar um objeto: File/Save, Save/Figura e Close/X Zim Technologies do Brasil - Zim Corporation Page 35 of 69

36 c) Editar excluir um diretório. Clicar com o botão direito do mouse sobre o nome do diretório, onde serão mostradas as opções: Edit, Delete e Copy como mostrado na figura a seguir. Clique na opção Delete. Aqui será a mostrada uma tela de confirmação: Clique na opção Sim, para concluir a operação de exclusão do diretório. O diretório vai continuar aparecendo na lista de objetos, só vai sair da lista quando sair do editor GUI Designer e fechar o objeto Directories. Zim Technologies do Brasil - Zim Corporation Page 36 of 69

37 d) Algumas considerações sobre Diretórios Zim. Um diretório é um objeto do aplicativo. Diretórios de aplicativos são usados para organizar os objetos definidos no Dicionário de Objetos para a aplicação. Diretórios ZIM ZIM 8 proporciona uma melhor manipulação de diretórios ZIM (local e estrangeiro), aumentando o número de diretórios disponíveis Estabelecer um diretório de aplicativo No IDE, selecionar diretórios dos objetos no menu drop-down, e usar as ferramentas do IDE para definir o diretório desejado. Campos do objeto Diretórios atributos Descrição DirName Localização de diretório de aplicativos da constante OwnerDirName Localização de diretório de aplicativos do diretório assunto DirId Um identificador numérico para o diretório (2-240) DirId - O identificador numérico para o diretório. Valores válidos - Um valor na faixa de 0 a 254 (default = 0) Observações - Cada diretório acessado por um aplicativo deve ter uma DirId único. Se você escolher um DirId de 0, o ID interno do diretório é definido para corresponder ao número atribuído ao arquivo correspondente do sistema operacional (ou seja, ZIMnnnn onde nnnn é tipicamente um número entre 0100 e 9999). Dentro de cada aplicação, a identificação interna de todos os diretórios de aplicativos acessados ao mesmo tempo deve ser exclusivo. Se o item foreign (estrangeiro) é definido como YES, o DirId deve conter o valor 2 a 254. Se foreign é definido como NO, mas se o diretório irá ser exportado como um diretório estrangeiro para outros bancos de dados, DirId ainda deve estar entre 2 a 254. Zim Technologies do Brasil - Zim Corporation Page 37 of 69

38 Diretórios estrangeiros Cada banco de dados Zim tem seu próprio dicionário de objetos. Todos os objetos (conjuntos de entidades ou seja, formas, variáveis e assim por diante) que são descritas no dicionário de objetos são criados em um diretório Zim. Normalmente, um desenvolvedor de aplicativo cria os diretórios Zim que são usados dentro de um banco de dados particular. Um diretório estrangeiro, por outro lado, é um diretório Zim, que é definida por um banco de dados, mas é usado por outros bancos de dados. Ao acessar um diretório estrangeiro, você ganha acesso a todos os objetos criados nesse diretório. Dirs.zim Arquivo de configuração igual que as versões anteriores do ZIM. Ele descreve os diretórios estrangeiros que está sendo acessado por esta aplicação. Se existente, ele está localizado no <path absoluto> (em outras palavras, cada <path absolut> pode ter um arquivo dirs.zim); Por que usar um diretório estrangeiro? Há muitas situações em que um diretório estrangeiro pode ser útil. Um exemplo comum é a caixa de ferramentas, um banco de dados contendo programas aplicativos que são úteis, e, portanto, compartilhado entre, muitos bancos de dados diferentes. Por exemplo, ao desenvolver um aplicativo, você pode ter criado um diretório contendo programas utilitários. Estes utilitários podem ser úteis em outras situações, mas você não quer recriá-las para cada novo banco de dados. Seguindo os procedimentos descritos abaixo, o diretório de utilidade pode ser definida como estrangeiros em outros bancos de dados. O diretório pode ser usado em outros bancos de dados do que aquele em que ela foi criada. Zim Technologies do Brasil - Zim Corporation Page 38 of 69

39 Como os diretórios estrangeiros são usados. O procedimento descrito abaixo é uma visão geral de como os diretórios estrangeiros são usados. O restante desta seção descreve isso com mais detalhes. Em geral, o uso de um diretório de um banco de dados (banco de dados de host) dentro de outro banco de dados (banco de dados de conexão) envolve cinco etapas: 1) No Dicionário de Objetos do banco de dados host, definir o diretório de destino, incluindo um número ID especial do diretório. Crie o diretório, usando o comando CREATE. 2) No Dicionário de Objetos do banco de dados de conexão, definir o diretório de destino novamente. Esta definição deve ser idêntico ao que no banco de dados host, exceto que o diretório deve ser definido como estrangeiros. 3) No banco de dados de conexão, criar o diretório, usando o comando CREATE. 4) No prompt do sistema operacional, va para o diretório do sistema operacional que contém o banco de dados de conexão. Use seu editor de texto para editar o arquivo diretórios estrangeiros (chamados dirs.zim), adicionando uma entrada que dá a localização do diretório de estrangeiros no sistema de arquivos. 5) Voltar para o banco de dados de conexão. Use o comando ACCESS para acessar o diretório estrangeiros. Um banco de dados de conexão poderá acessar muitos diretórios estrangeiros em simultâneo, desde que cada diretório tem um número de identificação único diretório. Um único diretório pode ser acessado como um diretório estrangeiros simultaneamente por muitos bancos de dados. Zim Technologies do Brasil - Zim Corporation Page 39 of 69

40 Definição de um Dicionário Estrangeiro - o Descrição detalhada. Zim 8.x Zim IDE Tutorial Um diretório estrangeiro consiste em dois componentes. O primeiro componente é o diretório original criado no banco de dados host. É nesse diretório que é acessado por usuários de outros bancos de dados. O segundo componente é um diretório que é criado como estrangeiro no banco de dados de conexão. o No banco de dados host. Se um diretório específico deve ser usado de dentro de outros bancos de dados, o diretório deve ser criado no banco de dados host, utilizando o procedimento descrito abaixo. O diretório é criado, essencialmente, de uma forma normal, no entanto, ele deve ser atribuído um número de identificação especial diretório. 1) Adicionar um registro para EntitySet Diretórios no Dicionário de Objetos. Este registro deve ser definido assim: - DirName = nome do diretório - DirId = número de ID de diretório. Este número deve estar entre 2 e 254. O DirId não deve entrar em conflito com a DirId de qualquer outro diretório para o qual um usuário pode se conectar ao mesmo tempo. - Foreign = NO 2) Crie o diretório da forma normal, usando o comando CREATE. Se os diretórios estrangeiros arquivo (dirs.zim) pertencentes ao banco de dados host contém uma entrada que corresponda DirId deste diretório, o arquivo do sistema operacional que corresponde a esse diretório é transferida para essa entrada. Nota: O diretório raiz (ou seja, Zim) não pode ser usado como um diretório estrangeiro. Você deve assumir que o diretório a ser usado em outros bancos de dados é um sub-diretório. Zim Technologies do Brasil - Zim Corporation Page 40 of 69

41 o No banco de dados Conexão. Para permitir que usuários de um outro banco de dados se conectem a um diretório (estrangeiro) existente, continue o procedimento acima com os seguintes passos: 1) No banco de dados conectado, adicionar um registro para Diretórios conjunto de entidades no Dicionário de Objetos. Este registro deve definir - DirName ao nome do diretório estrangeiros - DirId a ID de diretório do diretório estrangeiros - Foreign para YES 2) Crie o diretório da maneira normal. Porque o campo estrangeiro no registro de diretórios tem sido definida como Yes, não são criados arquivos para este novo diretório. Nota: O DirName e DirId do diretório estrangeiro deve ser o mesmo que o DirName e DirId no banco de dados host. Zim Technologies do Brasil - Zim Corporation Page 41 of 69

42 A nível do Sistema Operacional Antes que um usuário do banco de dados de conexão possa empregar o comando ACCESS para se conectar a um diretório estrangeiro, o banco de dados de conexão deve conter uma diretório estrangeiro (dirs.zim) arquivo com uma entrada descrevendo a localização de cada diretório estrangeiro. Para criar este arquivo, use um editor de texto no nível do sistema operacional. O arquivo deve ser armazenado no diretório do sistema operacional que contém o banco de dados de conexão. Cada entrada no arquivo de diretórios estrangeiros tem o formato: dirid file# path onde: dirid é o dirid do diretório estrangeiro. file# é o número do arquivo que corresponde ao diretório no banco de dados host (ou seja, a zimnnnn nnnn). Para determinar o arquivo#, execute o utilitário ZIMFILES no banco de dados host ou use o comando: out $filename (nome do diretório) ou $filepath(objname) Por exemplo, a entrada: \usr\tools significa que o diretório cujo dirid = 11 pode ser encontrada no arquivo \usr\tools\zim0126. Zim Technologies do Brasil - Zim Corporation Page 42 of 69

43 Acessar um diretório Estrangeiro Uma vez que um diretório estrangeiro foi definido e criado no host e nos bancos de dados de conexão, e o arquivo de diretório estrangeiro existe com a entrada apropriada, o diretório estrangeiro é acessível a partir do banco de dados de conexão. Para acessar o diretório estrangeiro, use o seguinte procedimento: 1) Entre no Zim no banco de dados de conexão. 2) Use o comando ACCESS para acessar o diretório estrangeiro pelo nome, como mostrado no exemplo a seguir: access Utilities read. Este comando Abre um diretório de aplicativos Zim, permitindo o acesso aos objetos nele criados. sintaxe ACC dirname [READ UPDATE] parâmetros dirname É o nome de um diretório Zim que deve ser colocado na lista de diretórios. READ Indica que o diretório será acessado somente para leitura,não sendo permitidas alterações. Este é o valor assumido, se nenhum dos dois for informado (valor padrão). UPDATE Especifica que o diretório será acessado tanto para leitura como para alterações(create, ERASE,ADD,CHANGE ou DELETE). comentários Diretórios estrangeiros são sempre acessados como READ, ou seja, em modo de leitura. exemplo Para acessar ProjectControl diretório em modo somente leitura, use: access ProjectControl read ou simplemesmente access ProjectControl Para acessar o diretório pessoal no modo de atualização, use: access Pessoal update Todos os objetos definidos no diretório estrangeiro estão agora disponíveis a partir do banco de dados de conexão. Zim Technologies do Brasil - Zim Corporation Page 43 of 69

44 A localização de arquivos associados a um diretório Estrangeiro. O arquivo dirs.zim especifica a localização do sistema operacional (OS) de arquivo que corresponde ao diretório estrangeiro. Mas onde é que o sistema deve ver os arquivos que correspondem aos conjuntos de entidades, relacionamentos, programas e assim por diante que são definidas no diretório estrangeiro?. Por padrão, o Zim procura por esses arquivos no caminho especificado no arquivo dirs.zim para o arquivo do diretório estrangeiros em si. É possível, no entanto, para distribuir esses arquivos para outras partes do sistema de arquivos usando um arquivo de áreas com nomes de documentos de arquivo especial no banco de dados host. O procedimento para utilizar um arquivo de áreas em um banco de dados host é exatamente como descrito para bancos de dados independentes na distribuição de arquivos de banco de dados. Exemplo Para ilustrar, vejamos um exemplo da base Utilities. Considere as informações apresentadas a seguir: - O diretório utilitários no banco de dados host é definido no diretório do sistema operacional D:\UTILPROG. A ID do diretório Utilities é No diretório Utilities, três documentos são definidos como mostrado abaixo: > List all docs Docname FileName DirName ======== ======= ======= DictReport dict.rep Utilities ReportOut )Utilitários report.out UserLog "user.log Utilities - No diretório Utilities, dois conjuntos de entidades são também definidas como mostrado abaixo: UtilEnt1 (armazenado no arquivo do sistema operacional ZIM0129) UtilEnt2 (armazenado no arquivo do sistema operacional ZIM0130) Zim Technologies do Brasil - Zim Corporation Page 44 of 69

45 - No banco de dados host tem um arquivo associado que está localizado, com diretório Utilities, no diretório do sistema operacional D:/UTILPROG. O arquivo areas.zim contém a entrada de: 129 C:\UTZIM - O banco de dados de conexão, no arquivo dirs.zim contem uma entrada associado ao diretório estrangeiro: D:\UTILPROG. - O diretório de trabalho do usuário que se conecta é C:\APPLDIR\USER1. Dada esta situação, os bancos de dados de conexão e host, ambos contêm um arquivo de áreas.zim que realoca os arquivos associados a conjuntos de entidades. No banco de dados de conexão, um arquivo de diretórios estrangeiro D:\UTILPROG estabelece como o local padrão para todos os arquivos associados a objetos no diretório estrangeiro Utilities. O objeto estrangeiro ReportOut (um documento) é definida como sendo localizado no diretório de trabalho de conexão do usuário, similarmente, UserLog é definido como sendo localizado no diretório do banco de dados de conexão do usuário. Acessando Entidades estrangeiras Ao se conectar a um diretório estrangeiro, você ganha acesso aos dados das Entidades e dos relacionamentos com campos que são definidos nesse diretório. Para obter acesso Read/write a campos de banco de dados estrangeiro, você pode declarar esses arquivos como não-compartilhado nas áreas de arquivo associado com o banco de dados do host. Por exemplo, para obter acesso leitura/gravação para um EntitySet estrangeiro chamado UtilEnt cujo arquivo correspondente do sistema operacional tem o nome ZIM0185, você colocaria a entrada: 185 D:\UTILPROG % Este é um exemplo Zim em Windows. 185 /usr3/utilprog/ % Este é um exemplo Zim em UNIX. nas áreas de arquivo associado com o banco de dados do host. No Zim 8, as bases de dados estrangeiras pode ser de leitura ou gravação (read/write) como qualquer banco de dados normal. Zim Technologies do Brasil - Zim Corporation Page 45 of 69

46 Limitações de Diretórios Extrangeiros. As seguintes limitações se aplicam ao uso de diretórios estrangeiros: Zim 8.x Zim IDE Tutorial 1) Cada diretório acessado por um aplicativo deve ter um ID de diretório único entre todos os diretórios que está sendo acessado ao mesmo tempo. Diretórios, neste caso, incluir sub-diretórios de diretórios estrangeiros. 2) Um banco de dados não podem se conectar ao diretório raiz (diretório Zim) de outro banco de dados (ou seja, o diretório raiz não pode ser um diretório estrangeiro). 3) Diretórios estrangeiros não podem ser atualizados usando o COMPILE, UNCOMPILE, CREATE, ERASE, permissão ou comando RENAME. Você não pode atualizar a definição de objetos definidos em um diretório estrangeiro. 4) Um banco de dados de conexão não pode se conectar aos diretórios estrangeiros definidos dentro do diretório estrangeiro do banco de dados host. 5) Arquivos de banco de dados estrangeiro que foram criptografados com um comando ENCRYPT pode ser acessado a partir de um banco de dados conectando somente se as bases de dados de conexão e de acolhimento foram ambos inicializados usando a mesma chave de criptografia. A chave de criptografia é especificado quando o utilitário ZIMINIT é executado para inicializar um novo objeto Dictionary. ZimServer Agora aceita os mesmos diretórios estrangeiros a ser referenciado por mais de um arquivo dirs.zim, ou seja, mais de um banco de dados têm as mesmas referências do diretórios estrangeiros. Zim Technologies do Brasil - Zim Corporation Page 46 of 69

47 Configuration Files. A relação entre os arquivos de configuração é o seguinte: ZIMDB.ZIM descreve onde os bancos de dados estão. Cada banco de dados contém um arquivo zimconfig.zim, além de um DIRS.ZIM opcional e um AREAS.ZIM opcional. Cada entrada no DIRS.ZIM aponta para um diretório estrangeiro que por sua vez (o diretório estrangeiro) pode ter um AREAS.ZIM. Observação: - Nas versões do Zim 7.11 e anteriores, o DIRID para Diretórios estrangeiros era definido com valor igual o maior a 10000, agora o valor varia de 1 a 254 para todos os tipos de diretórios. - Comentários colocados no final das linhas no arquivo dirs.zim serão interpretados como parte do caminho do caminho do banco de dados Zim; - Consultar: $ProgramFileName, $filepath() Zim Technologies do Brasil - Zim Corporation Page 47 of 69

48 Exemplo prático: A) No banco de dados estrangeiro (chamado neste exemplo como C:\baseteste ) entre no Zim e crie um diretório local, caso não esteja criado. - Add dirs let dirname= Dirteste Ownerdirname= ZIM DirId=3 foreing= no - Create dir Dirteste - Out $filepath(dirteste) C:\baseteste\zim0100 B) Na base Local (chamado neste exemplo como C:\baselocal ), entre no zim e crie o diretório estrangeiro. - Add dirs let dirname= Dirteste Ownerdirname= ZIM DirId=3 foreing= Yes - Create directory Dirteste C) Sair do Zim na base local e nesta mesma base de dados crie o arquivo dirs.zim com as seguintes informações: C:\baseteste Onde, 3 é o Nr DirId dos dirs em ambas as bases 100 é o Nr. do arquivo externo do dir. da base estrangeira baseteste C:\baseteste é o local e nome da base estrangeira. D) Execute Stop Zimserver E) Execute Start Zimserver F) Entre no zim em ambas as bases de dados (baseteste e baselocal) G) Na base Local execute: acc Dirteste Read Observação: o nome dos diretórios (Dirteste) e o Nr DirId (3) tem que ser iguais em ambas as bases. O diretório estrangeiro criado na base local, é criada como "zim0000", não tendo nenhum arquivo externo relacionado com ela, o que significa que a criação de mais de um diretório externo, sempre vai criar internamente como "zim0000", como é diretório estrangeiro, localmente não precisa destes arquivos de diretórios. Zim Technologies do Brasil - Zim Corporation Page 48 of 69

49 2) Entidades Define um nome único para um arquivo de banco de dados onde a estrutura do registro é descrito por uma série de campos. Para incluir entidades no Zim via Zim IDE, Clique com o botão direito do mouse sobre a opção Entity Sets, e em seguida na opção New como mostra a figura. O editor do GUI Designer mostra os dados originais para incluir uma entidade, podemos informar os dados de identificação do objeto e dados das propriedades do objeto. Note que podemos adicionar fields, mas será necessário manipular a tela, arrastrando a linha separadora horizontal dos fields para cima. Podemos também manupular as linhas separadoras verticais, para ajustes de maior aproveitamento do espaço a ser trabalhado. Zim Technologies do Brasil - Zim Corporation Page 49 of 69

50 Na área para adicionar fields. Clique na opção Add cada vez que incluir um novo field. Zim Technologies do Brasil - Zim Corporation Page 50 of 69

51 3) Roles.- Zim 8.x Zim IDE Tutorial Define nomes alternativos para conjuntos de entidades, relacionamentos ou subconjuntos membros de um objeto. Atributos Descrição RoleName Nome do Role OwnerName Nome do objeto a que pretence o Role RoleCondition A condição do Role DirName O nome do diretório Zim em que o Role é criado Incluir e alterar Roles segue os mesmos principios da inclusão de entidades. Zim Technologies do Brasil - Zim Corporation Page 51 of 69

52 4) Relacionamentos Define um nome único para uma condição de associação entre um conjunto de entidades. Zim Technologies do Brasil - Zim Corporation Page 52 of 69

53 5) Documentos Para criar deocumentos novos existe outras opções, além da forma explicada até agora, ou seja, com o botão direito do mouse sobre o objeto, selecionar New. Pedemos também selecionar a opção File ou a figura New na barra de ferramentas: Zim Technologies do Brasil - Zim Corporation Page 53 of 69

54 Alem de atualizar as propriedades de identificação e as propriedades de objetos do doumento, podemos escrever o conteúdo do documento, ou seja, uma procedure, ou mesmo um programa completo no editor do IDE ou GUI Designer. Campos de documentos serão definidos ou adicionados selecionando a opção View na barra de menus, e a seguir selecione a opção Field View. Zim Technologies do Brasil - Zim Corporation Page 54 of 69

55 6) Forms As tres opções disponíveis para adicionar forms apresenta a tela New Object para informar o nome do form no campo Object Name. Para editar forms ja existentes, basta expandir os forms, execute duplo clique sobre o nom Forms ou clique na caixa + do objeto Forms, selecione o form com duplo clique. Zim Technologies do Brasil - Zim Corporation Page 55 of 69

56 Exemplo: Objetos de campo de formulário serão definidos ou adicionados apos o FORM ser editado ou visualizado, estes objectos de campo são adicionados directamente dentro do editor do painter ou Gui Designer que é considerado área de cliente (isto é, a área no interior), a janela de Painter. Um objeto de campo de formulário é adicionado primeiro clicando no ícone da página guia da caixa de ferramentas (tool Box Tabe Page) que representa o campo de formulário tipo de objeto desejado. O cursor aparece como uma imagem de esboço do ícone do objeto campo de formulário selecionado. Mova o cursor para a localização aproximada dentro da janela (ou form), onde você gostaria que o campo de formulário para ser posicionado e clique no botão esquerdo do mouse. O campo de formulário selecionado aparece no local. Inicialmente, tem dimensões padrão, o texto da etiqueta padrão (se houver) e os atributos padrão. Exceto para os campos do formulário de etiquetas e gráfico, a caixa de atributos (Attributes Tab Page) propriedades é apresentado. Isto permite que você altere o nome do campo gerado automaticamente para um nome significativo, se desejar, alterar qualquer texto do rótulo associado ao campo de formulário e, assim, podemos modificar alguns ou todos os seus atributos padrão. Você também pode modificar qualquer um dos atributos do campo de Zim Technologies do Brasil - Zim Corporation Page 56 of 69

57 formulário em um momento posterior, exibindo o diálogo específico campo do formulário de edição para o tipo de campo de formulário acrescentado. Zim Technologies do Brasil - Zim Corporation Page 57 of 69

58 Importação de forms ou campos de forms Zim 8.x Zim IDE Tutorial Há também outras maneiras de adicionar campos de formulário. Você pode importar os campos do formulário a partir de um form cuja definição existe no Dicionário de Dados. Você pode colar os campos do formulário que foram cortados ou copiados de outra form (ou o mesmo). Você também pode duplicar os campos do formulário. A opção IMPORT (acessado a partir do menu File) é usado para importar os campos de forms existentes ou forms para o form que está sendo criado. A opção IMPORT oferece várias opções. Você pode importar um campo de formulário existente selecionando um campo de form a partir de uma lista de forms que você deseja importar. Uma cópia do campo do form é então adicionada no form de destino. Outra opção é importar um formulário inteiro. Se usar FORM DEFINE para acessar o Painter do IDE, os campos do formulário na forma de código fonte são importados como novos campos no formulário que está sendo desenhado. Zim Technologies do Brasil - Zim Corporation Page 58 of 69

59 Exemplo de atributos de campo de formulário e objetos disponíveis na Tool Box tab page Em esta imagem, o form fexitdialog está sendo editado no espaço de trabalho GUI Designer. Um botão está selecionado e seus atributos são mostrados na guia Attributes Tab Page. A Tool Box Tab Page também é visível, mostrando os objetos disponíveis de interface de usuário que podem ser adicionados ao formulário. Zim Technologies do Brasil - Zim Corporation Page 59 of 69

60 7) Displays a. Criar Display O Display Mostra os forms contidos nele, a exposição funciona como um "container" para os objetos que os formulários possuem. O painter aceita a criação de associações entre as janelas, menus e telas, para que possam ser visualizados e/ou editados como um grupo. Podemos criar forms novos no display ou importar forms existentes. Seguindo os mesmos procedimentos explicados anteriormente para criar/editar objetos temos a tela New Object para criar objetos novos. Zim Technologies do Brasil - Zim Corporation Page 60 of 69

61 b. Criar novo form direto no Display. O objeto de formulário será adicionado primeiro clicando no ícone da página guia da caixa de ferramentas (tool Box Tabe Page), selecione o objeto Form com o botão direito do mouse. O cursor aparece como uma imagem de esboço do ícone do objeto selecionado. Mova o cursor para a localização aproximada dentro da janela (Display), onde você gostaria que o formulário seja posicionado e clique no botão esquerdo do mouse. O formulário vazio aparece no local. Inicialmente, tem dimensões padrão, o texto da etiqueta padrão (se houver) e os atributos padrão. Na caixa de atributos (Attributes Tab Page) são apresentadas as propriedades do form. Isto permite que você altere a identificação, a apariencia e diversos atributos do form gerado. Zim Technologies do Brasil - Zim Corporation Page 61 of 69

62 Aqui podemos mover e redimendionar o form dentro do display. Para incluir objetos dentro do form, siga os pasos explicados no item 6) Forms. c. Importar forms no Display. Na página Database, expanda os forms clicando no nó de forms (caixa + ), selecione o form a importar com o botão direito do mouse e ckique em Import. O form será importado para o Display na linha 1 coluna 1. Posicione este form no lugar desejado dentro do display. Zim Technologies do Brasil - Zim Corporation Page 62 of 69

63 8) Menus O atributo visual de um objeto de menu é o menu "bar" localizado na parte superior da área cliente de uma janela. A linguagem Zim inclui um amplo conjunto de comandos para modificar dinamicamente tanto o visual e as características comportamentais dos itens de menu de propriedade de menus. Seu principal objetivo é mostrar as opções disponíveis de um sistema aplicativo. Menus formam a maior parte da interface de utilizador, que proporciona os meios para selecionar as operações que se aplicam para a janela corrente ou navegar para outras partes do sistema. Menus são também definidos no Editor com seus respectivos atributos e transferidos para o dicionário de dados automaticamente. O objeto do menu é também um objeto de contêiner e consiste de menu e itens de menu. Selecionando a opção Menus a partir do menu na lista de Objectos do IDE, você ativa o editor de tela para desenhar os seus menus. Você também pode usar o comando DEFINE MENU para criar menus. Os menus são sempre desenhados dentro de uma janela do editor do IDE. A estrutura do menu sempre inclui uma barra de menu principal (que aparece na borda superior de uma janela, sob a legenda da janela). Submenus pode, então, cair para baixo a partir da barra principal, e outros submenus em cascata podem ficar horizontalmente a partir dos menus drop-down. O comportamento do menu é determinada principalmente pelos itens do menu. Um item de menu apresenta uma opção para o usuário final. Os itens do menu são coletados em menus de apresentação. Zim Technologies do Brasil - Zim Corporation Page 63 of 69

64 Na primeira linha (barra horizontal) são definidos os nomes de titulos de menus de um aplicativo, ao clicar na caixa para informar o nome do menu, (Arquivos), automaticamente abre o campo para informar outro titulo de menu (horizontal) e campo para informar um sub-menu ou item de menu na vertical e em cascata. Zim Technologies do Brasil - Zim Corporation Page 64 of 69

65 9) Windows Ver itens anteriores de como criar objetos. Tela Gui Designer do IDE para criar novas windows. Zim Technologies do Brasil - Zim Corporation Page 65 of 69