Skip to main content
Version: 2.7

What is Metadata?

Introduction​

When developing on the Steedos platform, understanding the role of metadata is crucial. Steedos operates with metadata at its core, facilitating the model of "low-code" and ensuring system adaptability and scalability. This guide will introduce Steedos DX metadata, its importance, and how developers can effectively engage with it.

Understanding Metadata in Steedos​

What is Metadata?​

Metadata in the Steedos environment refers to the data that describes the structure, data model, business logic, and even the UI of your applications. It encompasses a wide range of configurations, such as object definitions, fields, roles, workflows, amongst others.

Why is Metadata Important?​

  1. Consistency and Maintainability: By defining the structures and elements, metadata provides a consistent framework that aids in application development. It makes the system easily maintainable.
  2. Upgradability: Since the configuration is separated from the core platform, updates and migrations become less cumbersome.
  3. Collaboration: Metadata can be version-controlled, making it easier for teams to collaborate, track changes, and maintain a history of configurations.
  4. Rapid Deployment: Changes in metadata are reflected almost immediately, enabling quick iterations for development teams.

Working with Metadata in Steedos DX​

Metadata Structure​

Steedos DX uses a folder-based structure to store metadata, commonly found in the project's root directory. The typical components include:

  • Objects: Contains the definitions for custom objects and fields. Each object would have its own sub-directory.
  • Layouts: Comprises the configuration for UI layouts.
  • Workflows & Triggers: Contains the business logic and automation processes.
  • Permissions: Defines roles and sharing rules.

Best Practices for Handling Metadata​

  • Version Control: Always use version control systems like Git to track changes in metadata. It's essential for collaboration and rollback.
  • Use Descriptive Naming: Name your metadata components in a way that reflects their purpose and context within the application.
  • Organize Metadata: Maintain a logical folder structure and organize the metadata to reflect the system's architecture.
  • Document Changes: Keep comprehensive documentation for custom metadata, including the reason for changes, to understand the evolution of the system components.

Deploying Metadata​

With Steedos DX, you can deploy metadata directly through the command line interface (CLI). It simplifies the process of moving configurations between environments (e.g., from development to production).