Les catalogues et le partage
Quatres entités sont concernées par les notions de visibilité, catalogue ou partage :
- Les livraisons
- Les données stockées
- Les offres
La visibilité
La visibilité est un attribut de ces entités, choisi et modifiable par l'entrepôt propriétaire. Elle peut prendre trois valeurs :
PRIVATE: l'entité n'apparaît pas dans le catalogue et peut être partagée avec un entrepôt pour qu'il puisse l'utiliser.REFERENCED: l'entité apparaît dans le catalogue mais doit être explicitement partagée avec un entrepôt pour qu'il puisse l'utiliser.PUBLIC: l'entité apparaît dans le catalogue et n'a pas besoin d'être explicitement partagée avec un entrepôt pour qu'il puisse l'utiliser.
Les catalogues
Les catalogues correspondent à des API, permettant d'accéder aux listes de ces 4 entités, inter-entrepôt, selon leur visibilité (REFERENCED ou PUBLIC) et leur statut.
| Entité | API du catalogue | Statut de l'entité | Filtre |
|---|---|---|---|
| Livraison | /catalogs/uploads |
CLOSED ou CHECKING |
Type de livraison |
| Donnée stockée | /catalogs/stored_data |
GENERATED ou MODIFYING |
Type de donnée stockée |
| Offre | /catalogs/offerings |
PUBLISHED |
Type d'offre |
Un quatrième catalogue existe : celui des communautés publiques. Une communauté possède un attribut précisant si celle ci est publique ou non. Si elle est publique, elle apparaît dans le catalogue accessible via l'API /catalogs/communities.
Pour ces quatre catalogues, les entités sont listées avec une adresse de contact pour demander plus d'informations, un partage ou pouvoir rejoindre la communauté.
Le partage
Partager une entité avec un autre entrepôt va lui permettre d'accéder à certaines informations et de l'utiliser "en lecture". Une entité à la visibilité PUBLIC n'a pas besoin d'être partagée pour être lisible par n'importe quel autre entrepôt.
| Entité | Possibilité liée au partage |
|---|---|
| Livraison | Utilisation de la livraison en entrée d'une exécution de traitement |
| Donnée stockée | Utilisation de la donnée stockée en entrée d'une exécution de traitement |
Le partage est possible pour toutes ces entités, quelle que soit leur visibilité.
L'accès aux informations d'une entité partagée se fait via son propre entrepôt et non via celui propriétaire de l'entité. Prenons un exemple : la livraison 12 appartient à l'entrepôt 4. Des membres de cet entrepôt peuvent y accéder via l'appel /datastores/4/uploads/12 et ainsi voir toutes les informations. En supposant que cette livraison 12 ait une visibilité public, ou qu'elle ait été partagée avec l'entrepôt 7, un membre de ce dernier pourra accéder aux informations partagées sur la livraison via l'appel /datastores/7/uploads/12