r-io suiter-io suitereference docs
← Documentation home
Reference / r-io suite

Project archives & shared resources

Understand what an export preserves, what remains in shared packages, and how to interpret the comparison report.

01

What the export warning means

In r-ioga, Export project compares the project’s SHARE instances with the packaged shared-resource projects from which they were copied. These shared instances are not included in the project archive: editing their copy does not update its source package.

The dialog groups added, deleted and modified nodes and relations by their shared project. It shows property values, status and geographic changes. Missing source projects are listed separately: their instances could not be compared. Cancel to preserve and reconcile the changes in the appropriate source project, or choose Export anyway knowing those shared edits will not be carried by this archive. There is no automatic merge back into the shared package.

02

What is compared

IncludedDeliberately ignored
Properties, status and geographic points, outlines and stylesNeutral values and effective metamodel defaults; sensor currentValue
Relations between shared instances: additions, removals, endpoints and propertiesPositions in modelling diagrams
Source packages recursively, in loading order; the last definition of an id winsGeographic rounding below 1 cm
Unknown shared-source projects are reportedAn instance replaced by a local non-SHARE instance is not reported as a lost shared edit; it is exported locally

If comparison itself fails, the current interface falls back to the usual export confirmation. The absence of a warning is therefore not proof that all dependencies and shared changes are preserved. The time-series export option is offered to administrators.

03

Portable files, not a running deployment

Project instance ── local models + resources + scenarios ──→ ZIP
Shared packages ── references remain dependencies ───────→ load separately
Shared edits ───── warning; not merged into that ZIP

Resource URLs in model and scenario XML are normalised to remove the source collaboration segment, including relation icons, so importing into another collaboration does not point back to the old one. Scenario folders retain their datasets and media with relative references; see Scenario timelines. Imported solutions remain deduced, not deployed or supervised.

Implementation: RIOGAFunctions, ExportProjectComponent, ProjectResource.sharedModifications and SharedInstancesDiff. SharedInstancesDiffTest covers default/runtime exclusions, status, geometry, additions/removals and relations; ProjectResourceExportTest covers URL portability. Consult the API reference.

Référence / r-io suite

Archives de projet et ressources partagées

Comprendre ce que conserve un export, ce qui reste dans les paquets partagés et comment lire le rapport de comparaison.

01

Comprendre l’avertissement d’export

Dans r-ioga, Export project compare les instances SHARE du projet aux paquets de ressources partagées dont elles proviennent. Ces instances partagées ne figurent pas dans l’archive du projet : modifier leur copie ne met pas à jour le paquet source.

La boîte regroupe les nœuds et relations ajoutés, supprimés et modifiés par projet partagé. Elle présente valeurs des propriétés, statuts et changements géographiques. Les projets sources introuvables sont signalés séparément : leurs instances n’ont pas pu être comparées. Annulez pour préserver et réconcilier les changements dans le projet source approprié, ou choisissez Export anyway en sachant que cette archive ne transportera pas ces modifications partagées. Aucune fusion automatique vers le paquet partagé n’est effectuée.

02

Périmètre de la comparaison

ComparéVolontairement ignoré
Propriétés, statuts, positions, contours et styles géographiquesValeurs neutres et valeurs par défaut du métamodèle effectif ; currentValue des capteurs
Relations entre instances partagées : ajouts, suppressions, extrémités et propriétésPositions dans les diagrammes de modélisation
Paquets sources parcourus récursivement dans l’ordre de chargement ; la dernière définition d’un identifiant primeArrondis géographiques inférieurs à 1 cm
Projets sources partagés inconnus signalésUne instance remplacée par une instance locale non SHARE n’est pas signalée comme modification partagée perdue ; elle est exportée localement

Si la comparaison elle-même échoue, l’interface actuelle revient à la confirmation d’export habituelle. L’absence d’avertissement ne prouve donc pas que toutes les dépendances et modifications partagées sont préservées. L’option d’export des séries temporelles est proposée aux administrateurs.

03

Des fichiers portables, pas un déploiement actif

Instance du projet ── modèles locaux + ressources + scénarios ──→ ZIP
Paquets partagés ──── références conservées comme dépendances ─→ charger séparément
Modifications SHARE ─ avertissement ; pas de fusion dans ce ZIP

Les URL de ressources des XML de modèles et scénarios sont normalisées pour retirer le segment de la collaboration source, y compris pour les icônes des relations : importer dans une autre collaboration ne doit pas renvoyer vers l’ancienne. Les dossiers des scénarios conservent leurs jeux de données et médias avec des références relatives ; voir les Chronologies de scénario. Les solutions importées restent déduites, sans déploiement ni supervision.

Implémentation : RIOGAFunctions, ExportProjectComponent, ProjectResource.sharedModifications et SharedInstancesDiff. SharedInstancesDiffTest couvre exclusions des valeurs par défaut/d’exécution, statuts, géométrie, ajouts/suppressions et relations ; ProjectResourceExportTest couvre la portabilité des URL. Consultez la référence API.