Projects
rEve API publique get/activityTags

Le service get/activityTags permet de lister les tags pouvant être associés à chaque activité.

L'URL du service a le format suivant et n'accepte aucun paramètre.

{siteUrl}/get/activityTags

Voici un exemple de résultat. Chaque tag y est décrit par un identifiant logique (tag id), un identifiant technique (iid, signifiant integer id), un nom court et une description optionnelle. Le nom court et la description contiennent un texte simple en cas de contenu unilingue (avec des passages à la ligne possibles pour la description), ou une structure de données plus complexe en cas de contenu bilingue (ce qui est le cas de l'exemple).

<activityTags type="list" count="2">
 <e type="object" className="Object">
  <id>cinema</id>
  <iid type="int">7711</iid>
  <title type="dict">
   <entry type="object">
    <k>fr</k>
    <v>Cinéma</v>
   </entry>
   <entry type="object">
    <k>nl</k>
    <v>Bioscoop</v>
   </entry>
  </title>
  <description/>
  <code/>
  <codeTitle/>
 </e>
 <e type="object" className="Object">
  <id>culture</id>
  <iid type="int">7712</iid>
  <title type="dict">
   <entry type="object">
    <k>fr</k>
    <v>Culture</v>
   </entry>
   <entry type="object">
    <k>nl</k>
    <v>Cultuur</v>
   </entry>
  </title>
  <description/>
  <code>4</code>
  <codeTitle type="dict">
   <entry type="object">
    <k>fr</k>
    <v>Facture mensuellE</v>
   </entry>
   <entry type="object">
    <k>nl</k>
    <v>Maandelijkse factuur</v>
   </entry>
  </codeTitle>
 </e>
</activityTags>

Vous aurez remarqué 2 champs additionnels: code et codeTitle. Ce code (aussi appelé code externe) est défini dans le contexte d'une activité dont les paiements sont externalisés, c'est-à-dire gérés par une tierce partie, en dehors de rEve. Les informations au sujet des paiements à déléguer de la sorte sont envoyées régulièrement au tiers via des feuilles de calcul produites durant la nuit. Parmi ces infos, il peut être requis de définir un code, représentant la plupart du temps une catégorie financière. C'est ce code qui est défini ici, sur un tag. Il peut être accompagné d'un libellé, codeTitle, pouvant être différent du libellé standard du tag (title). Le tag codeTitle, à l'instar du nom court et de la description, peut se décliner en contenu unilingue ou multilingue (dans l'exemple, il est multilingue, voir le second tag). Le service create/activity s'assurera qu'une activité avec paiements externalisés ne pourra être liée qu'à un seul tag disposant d'un tel code.