Reference / r-io suiteProject 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
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 suiteArchives 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
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.