Saltar para o conteúdo principal
Versão: Próximo

Arquitetura de um projeto 4D

Um projeto 4D é composto por várias pastas e arquivos, armazenados numa pasta raiz do projeto (pasta de pacotes). Por exemplo:

  • MyPackage (carpeta raíz del proyecto)
    • Componentes
    • Data
      • Logs
      • Parâmetros
    • Documentation
    • Plugins
    • Project
      • DerivedData
      • Sources
      • Trash
    • Resources
    • Parâmetros
    • userPreferences.username
    • WebFolder

Se o seu projeto tiver sido convertido a partir de uma base de dados binária, poderão existir pastas adicionais. Ver "Conversión de bases en proyectos" en doc.4d.com.

Carpeta Project

A pasta Project contém normalmente a seguinte hierarquia:

  • archivo <applicationName>.4DProject
  • Sources
    • Classes
    • DatabaseMethods
    • Página Métodos
    • Formulários
    • TableForms
    • Triggers
  • DerivedData
  • Trash (si hay)

archivo <applicationName>.4DProject

Arquivo de desenvolvimento do projeto, utilizado para designar e lançar o projeto. Esse arquivo pode ser aberto por:

Nota: nos projetos 4D, o desenvolvimento se realiza com 4D Developer e o desenvolvimento multiusuários se gerencia através das ferramentas de controle de versão. 4D Server pode abrir arquivos .4DProject para fins de teste.

This text file can also contain configuration keys, in particular "tokenizedText": false.

Sources

ConteúdosDescriçãoFormato
catalog.4DCatalogDefinições de tabelas e camposXML
catalog_editor.jsonCustom positions and colors of tables, fields, and links in the Structure editor. Depende de un parámetro de compatibilidad en los proyectos convertidosJSON
folders.jsonDefinições de pasta do ExplorerJSON
menus.jsonDefinições de menusJSON
roles.jsonPrivileges, permissions and other security settings for the projectJSON
settings.4DSettingsPropiedades de la base Structure. No se tienen en cuenta si se definen parámetros de usuario o parámetros de usuario para datos (ver también Prioridad de los parámetros. Atención: en las aplicaciones compiladas, la configuración de la estructura se almacena en el archivo .4dz (de sólo lectura). Para las necesidades de despliegue, es necesario habilitar y utilizar parámetros usuario o parámetros usuario para datos para definir parámetros personalizados.XML
tips.jsonDicas definidasJSON
lists.jsonListas definidasJSON
filters.jsonFiltros definidosJSON
dependencies.jsonNomes de componentes a serem carregados no projetoJSON
HTTPHandlers.jsonCustom HTTP request handlers defined for the web serverJSON
styleSheets.cssFolhas de estilo CSSCSS
styleSheets_mac.cssFolhas de estilo css para Mac (de um banco de dados binário convertido)CSS
styleSheets_windows.cssFolhas de estilo css em Windows (de um banco de dados binário convertido)CSS

DatabaseMethods

ConteúdosDescriçãoFormato
databaseMethodName.4dmMétodos de projeto definidos na database. Um ficheiro por método base de dadostext

Página Métodos

ConteúdosDescriçãoFormato
methodName.4dmMétodos de banco definidos na database. One file per database methodtext

Classes

ConteúdosDescriçãoFormato
className.4dmMétodo de definição de classe usuário, que permite instanciar objetos específicos. Um arquivo por classe, o nome do arquivo é o nome da classetext

Formulários

ConteúdosDescriçãoFormato
formName/form.4DFormDescrição do formulário projetojson
formName/method.4dmMétodo formulário projectotext
formName/Images/pictureNameImagem estática do formulário projetopicture
formName/ObjectMethods/objectName.4dmMétodos objecto. Um arquivo por método objetotext

TableForms

ConteúdosDescriçãoFormato
n/Input/formName/form.4DFormDescrição do formulário de entrada da tabela (n é o número da tabela)json
n/Input/formName/Images/pictureNameImagens estáticas do formulário de entrada da tabelapicture
n/Input/formName/method.4dmMétodo do formulário de entrada da tabelatext
n/Input/formName/ObjectMethods/objectName.4dmMétodos objeto do formulário de entrada. Um arquivo por método objetotext
n/Output/formName/form.4DFormDescrição do formulário de saída da tabela (n é o número da tabela)json
n/Output/formName/Images/pictureNameImagens estáticas do formulário de saída da tabelapicture
n/Output/formName/method.4dmMétodo do formulário de saída da tabelatext
n/Output/formName/ObjectMethods/objectName.4dmMétodos objeto do formulário de saída. Um arquivo por método objetotext

Triggers

ConteúdosDescriçãoFormato
table__n_.4dmMétodos trigger definidos na database. Um arquivo de acionamento por tabela (n é o número da tabela)text

Note: The .4dm file extension is a text-based file format, containing the code of a 4D method. É compatível com as ferramentas de controlo da versão.

Trash

A pasta Trash contém métodos e formulários eliminados do projeto (se existirem). Pode conter as seguintes pastas:

  • Página Métodos
  • Formulários
  • TableForms

Dentro destas pastas, os nomes dos elementos eliminados estão entre parênteses, por exemplo, "(myMethod).4dm". La organización de las carpetas es idéntica a la carpeta Sources.

DerivedData

A pasta DerivedData contém dados em cache usados internamente por 4D para otimizar o processamento. É criado ou recriado automaticamente quando necessário. Você pode ignorar essa pasta.

Libraries

Esta pasta é utilizada apenas no macOS.

La carpeta Librairies contiene el archivo resultante de una compilación con el compilador Silicon en macOS.

Resources

A pasta Resources contém todos os arquivos e pastas de recursos personalizados do projeto. Nesta pasta, pode colocar todos os ficheiros necessários para a tradução ou personalização da interface da aplicação (arquivo imagem, arquivo texto, arquivo XLIFF, etc.). 4D usa mecanismos automáticos para trabalhar com o conteúdo desta pasta, em particular para a manipulação de ficheiros XLIFF e imagens estáticas. Para utilizar no modo remoto, a pasta Recursos permite-lhe partilhar arquivo entre o servidor e todas as máquinas clientes. Ver el manual 4D Server.

ConteúdosDescriçãoFormato
elementoArquivos e pastas dos recursos do banco de dadosvários
Images/Library/itemImagens da biblioteca de imagens como arquivo separados(*). Os nomes destes itens tornam-se nomes de arquivo. Se existir uma duplicação, é acrescentado um número ao nome.picture

(*) apenas se o projeto tiver sido exportado de um banco de dados binário .4db.

Data

A pasta Data contém o ficheiro de dados e todos os arquivo e pastas relacionados com os dados.

ConteúdosDescriçãoFormato
data.4dd(*)arquivo de dados que contém os dados introduzidos nos registos e todos os dados pertencentes aos registos. Quando abre um projeto 4D, a aplicação abre o arquivo de dados atual por defeito. Si cambia el nombre o la ubicación de este archivo, aparecerá la caja de diálogo Abrir un archivo de datos para que pueda seleccionar el archivo de datos a utilizar o crear uno nuevobinary
data.journalCriado apenas quando a base de dados utiliza um ficheiro de registo. O arquivo de registo é utilizado para garantir a segurança dos dados entre cópias de segurança. Todas as operações efectuadas sobre os dados são registadas sequencialmente neste arquivo. Por conseguinte, cada operação sobre os dados provoca duas acções simultâneas: a primeira sobre os dados (a expressão é executada normalmente) e a segunda no ficheiro de registo (é registada uma descrição da operação). O arquivo de registo é construído de forma independente, sem perturbar ou atrasar o trabalho do utilizador. Uma base de dados só pode trabalhar com um único arquivo de registo de cada vez. O arquivo de registo regista operações como adições, modificações ou eliminações de registos, transacções, etc. É gerado por defeito quando é criada uma base de dados.binary
data.match(interno) UUID correspondente ao número da tabelaXML

(*) Quando o projeto é criado a partir de uma base de dados binária .4db, o arquivo de dados não é alterado. Assim, pode ter um nome diferente e ser colocado noutro local.

Settings (datos del usuario)

This folder contains user settings for data used for application administration.

Estos parámetros tienen prioridad sobre los parámetros de usuario y los parámetros de estructura. Ver también Prioridad de los parámetros.

ConteúdosDescriçãoFormato
directory.jsonDescrição de os grupos e usuários de 4D e seus direitos de acesso quando o banco for lançado com este arquivo de dados.JSON
Backup.4DSettingsParámetros de copia de seguridad de la base de datos, utilizados para definir las opciones de copia de seguridad cuando la base se lanza con este archivo de datos. Las llaves relativas a la configuración de la copia de seguridad se describen en el manual Backup de las llaves XML 4D.XML
settings.4DSettingsPropriedades personalizadas de o banco de dados para este arquivo de dados.XML

Logs

A pasta Logs contém todos os arquivos de registo utilizados pelo projeto. Os arquivos de registro incluem, em particular:

  • conversão da base de dados,
  • pedidos do servidor Web,
  • registro de actividades de backup/restitución (Backup Journal[xxx].txt, ver Historial de backup)
  • depuração de comandos,
  • 4D Pedidos do servidor (gerados em máquinas clientes e no servidor).

Una carpeta Logs adicional está disponible en la carpeta de preferencias del usuario del sistema (carpeta 4D activa, ver el comando Get 4D folder) para los archivos de registro de mantenimiento y e

Settings (usuario)

Essa pasta contém configurações de usuário usadas para a administração de aplicações.

Estos parámetros tienen prioridad sobre el archivo de parámetros de estructura. Sin embargo, si existen parámetros de usuario para los datos, tienen prioridad sobre los parámetros de usuario. Ver también Prioridad de los parámetros.

ConteúdosDescriçãoFormato
directory.jsonDescrição dos grupos e usuários de 4D para o banco de dados, assim como seus direitos de acessoJSON
Backup.4DSettingsParámetros de copia de seguridad de la base de datos, utilizados para definir las opciones de copia de seguridad) cuando se lanza cada copia de seguridad. Este archivo también puede utilizarse para leer o definir opciones adicionales, como la cantidad de información almacenada en el diario de backup. Las llaves relativas a la configuración de la copia de seguridad se describen en el manual Backup de las llaves XML 4D.XML
BuildApp.4DSettingsArchivo de parámetros de generación, creado automáticamente cuando se utiliza la caja de diálogo del generador de aplicaciones o del comando BUILD APPLICATIONXML
settings.4DSettingsDefinições personalizadas para este projeto (todos os arquivos de dados)XML
logConfig.jsonArchivo de configuración de historial personalizadojson

userPreferences.<userName>

Esta pasta contém arquivos que memorizam as configurações do usuário, por exemplo, o ponto de ruptura ou as posições das janelas. Pode simplesmente ignorar esta pasta. Contém, por exemplo:

ConteúdosDescriçãoFormato
methodPreferences.jsonPreferências do utilizador atual do Editor de códigoJSON
methodWindowPositions.jsonPosição da janela do usuário atual para os métodosJSON
formWindowPositions.jsonPosição da janela do usuário atual para os formuláriosJSON
workspace.jsonLista de janelas abertas; no macOS, ordem das janelas do separadorJSON
debuggerCatches.jsonChamadas aos comandosJSON
recentTables.jsonLista ordenada de tabelasJSON
preferences.4DPreferencesRota de dados atual e posições da janela principalXML
CompilerIntermediateFilesarquivos intermédios resultantes da compilação do Apple SiliconFolder

Componentes

Folder containing components that are embedded in the project (must be stored at the same level as the Project folder). These components have priority over any other locations.

info

Você também pode usar os arquivos dependencies.json e (opcionalmente) environment4d.json para declarar componentes.

Plugins

Esta pasta contém os plug-ins que devem estar disponíveis no projeto de aplicação. Deve ser armazenado ao mesmo nível que a pasta Project.

Documentation

Esta pasta contém todos os arquivo de documentação (.md) criados para os elementos do projeto, tais como classes, métodos ou formulários. Os arquivo de documentação são geridos e apresentados no Explorer 4D.

Para más información, consulte Documentar un proyecto.

WebFolder

Pasta raiz padrão do servidor Web 4D para páginas, imagens, etc. É criado automaticamente quando o servidor Web é iniciado pela primeira vez.

Archivo .gitignore (opcional)

Ficheiro que especifica quais os ficheiros que serão ignorados pelo git. Puede incluir un archivo gitignore en sus proyectos utilizando la opción Crear un archivo .gitignore en la página General de las preferencias. To configure the contents of that file, see Create .gitignore file.