Resource descriptor
Every attribute of the generated resource descriptor XML.
A resource descriptor, such as MDR_Plugin_Macrodata Refinement_7199_descriptor.xml, declares a
resource's metadata and its installation paths. CATIA Magic reads it when installing the archive.
Dassault documents the format in
Resource manager descriptor file.
Forge writes this file from the resource.* properties, so a project edits
properties rather than XML. The Rule column below records what
validateGradleProperties enforces on the corresponding property.
The descriptor itself installs under data/resourcemanager/ and is not listed in its own
<installation> node.
Example
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<resourceDescriptor date="2025-11-09 17:27:16" description="The work is mysterious and important." homePage="https://github.lumon.com/macrodata-refinement" id="7199" mdVersionMax="2024x Refresh3" mdVersionMin="2024x Refresh2" name="Macrodata Refinement" restartMagicdraw="true" type="Plugin">
<version human="8.9.27" internal="8009027" resource="80090270"/>
<provider email="mark.s@lumon.com" homePage="https://www.lumon.com" name="Mark S"/>
<edition>Architect</edition>
<edition>Enterprise</edition>
<edition>Magic Software Architect</edition>
<edition>Magic Cyber Systems Engineer</edition>
<edition>Magic Systems of Systems Architect</edition>
<requiredResource id="1488" name="Product Line Engineering">
<minVersion human="2024x Refresh2" internal="202400000"/>
</requiredResource>
<installation>
<file from="modelLibraries/LumonIndustryStandard.mdzip" to="modelLibraries/LumonIndustryStandard.mdzip"/>
<file from="plugins/com.lumon.macrodatarefinement/plugin.xml" to="plugins/com.lumon.macrodatarefinement/plugin.xml"/>
<file from="profiles/Lumon Core Profile.mdzip" to="profiles/Lumon Core Profile.mdzip"/>
<file from="samples/Lumon/Macrodata Refinement Sample.mdzip" to="samples/Lumon/Macrodata Refinement Sample.mdzip"/>
<file from="templates/Lumon/Lumon Project Template.mdzip" to="templates/Lumon/Lumon Project Template.mdzip"/>
</installation>
</resourceDescriptor>Attributes
resourceDescriptor
| Name | Description | Rule |
|---|---|---|
date | Build date | Optional |
description | Description of the resource | Optional |
homePage | URL of the resource, such as its Git repository | URL |
id | Unique resource identifier, forming part of the descriptor file name | Non-negative integer |
mdVersionMin, mdVersionMax | Limit which CATIA Magic installations accept the resource | 20{dd}x [Refresh d] |
name | Resource name, forming part of the descriptor file name and unique across all installed resources | Not empty |
restartMagicdraw | Whether installation requires a restart | Boolean |
type | Kind of resource, driving where the installer lists it | One of Custom Diagram, Sample, Language, Model Library, Plugin, Plugin (commercial), Profile, Template |
version
| Name | Description | Rule |
|---|---|---|
human | Version shown to users | Prefer semantic versioning; free text is accepted |
internal | Version used for internal counting, hidden from users | Positive integer |
resource | Identifies the resource build or release | Positive integer, usually internal × 10 |
provider
| Name | Description | Rule |
|---|---|---|
email | Provider contact address | Email, optional |
homePage | Provider home page | URL, optional |
name | Provider name | Optional |
edition
One element per supported program edition, from Reader, Community, Standard, Personal,
Professional, Architect, Enterprise, Magic Software Architect,
Magic Cyber Systems Engineer, Magic Systems of Systems Architect.
requiredResource
| Name | Description | Rule |
|---|---|---|
id | Identifier of the required resource | Positive integer |
name | Name of the required resource | Not empty |
minVersion human | Minimum version of the required resource | As version human above |
minVersion internal | Internal minimum version of the required resource | Positive integer |
Forge fills these nodes from the catiaMagic dependencies a project declares, resolving them
against registry.json. See Declare dependencies.
installation
One <file> element per file in the archive.
| Name | Description | Rule |
|---|---|---|
from | Path inside the archive | Relative path |
to | Path under the CATIA Magic installation root | Relative path |