HubSessions  API ask/objectExists |
|
|
Le service ask/objectExists permet de déterminer si un objet existe sur un site HubSessions, sur base de son identifiant et de son type. HubSessions étant un logiciel orienté objets, le type de l'objet n'est autre que le nom de sa classe.
Type de requête
Requête HTTP GET
Données en entrée
Les paramètres de la requête sont les suivants.
- id (obligatoire) · L'identifiant de l'objet pour lequel vous souhaitez récupérer l'URL.
- className (obligatoire) · Le nom de classe dont l'objet demandé est une instance.
Les classes suivantes sont disponibles.
| Nom |
Description |
| Item |
Un point (en anglais, item) est un sujet ou un dossier devant passer à l'ordre du jour d'une séance afin qu'une décision soit prise le concernant. |
| Meeting |
Une séance est une réunion, planifiée à une certaine date à une certaine heure, rassemblant une série de participants, représentants d'un organe de décision donné; séance au sein de laquelle des décisions vont être prises concernant une série de points. |
| Dossier |
La notion de dossier permet d'aller plus loin que le point pour implémenter un concept permanent et indépendant des discussions en séance. Quand la gestion de dossiers est activée sur un HubSessions, un dossier peut être relié à un point afin d'être discuté dans une séance donnée. Si par exemple, le dossier est abordé au travers du temps au cours de dix séances, il sera relié à 10 points, qui représenteront son historique de passages en séances. |
| Publication |
Lorsqu'un point représente un ou plusieurs textes devant être publié(s) au Moniteur Belge, la notion de publication entre en jeu. Sur base d'un point ayant fait l'objet d'une décision acceptée en séance, il est possible de créer une ou plusieurs publications. Chacune stocke des informations au sujet du processus de publication, en passant par un sous-processus de traduction, jusqu'à la publication finale au Moniteur, ainsi que sur d'éventuels outils internes comme Wallex en Région wallonne. |
| Revenue |
La notion de recette permet de formaliser la notion de déclaration de créance, c'est-à-dire l'inverse d'une facture: il s'agit d'argent que doit percevoir l'entité gestionnaire d'HubSessions de la part d'un tiers. Pour activer cette notion, il faut avant tout activer le pavé budgétaire sur les points, permettant d'encoder les recettes et dépenses concernées. Ces recettes et dépenses peuvent faire l'objet d'une gestion simple, sans sous-objet spécifique; si on veut aller plus loin en matière de gestion, on peut activer la notion de recette et manipuler des sous-objets à part entières, instances de la classe Revenue. |
| Task |
Chaque objet de chaque classe décrite ci-dessus est composé d'une série de champs, aussi appelés métadonnées, qui le caractérisent. Ces objets peuvent également contenir divers sous-objets, instances d'autres classes, qui viennent compléter les métadonnées. La classe Task est l'une d'elles et peut être utilisée pour définir des tâches comme sous-objecs de points ou de dossiers. |
| Annex |
Chaque objet de chaque classe décrite ci-dessus est composé d'une série de champs, aussi appelés métadonnées, qui le caractérisent. Ces objets peuvent également contenir divers sous-objets, instances d'autres classes, qui viennent compléter les métadonnées. La classe Annex est l'une d'elles et permet d'associer des fichiers binaires aux points, séances, dossiers, publications, recettes ou tâches. |
Exemple de requête
<siteUrl>/ask/objectExists?id=12345&className=Item
Données de retour
Le retour est une valeur booléenne marshallée en XML, comme sur l'exemple suivant.
<?xml version="1.0" encoding="utf-8" ?>
<objectExists type="bool">True</objectExists>
Présence de sites d'archives
Si le site HubSessions réquisitionné est lié à un ou plusieurs sites d'archives, ceux-ci ne vont pas entrer en jeu dans le cadre de ce service. Ce service teste uniquement l'existence d'un objet sur le site via lequel l'appel est fait.
|
| | |
|
