Articles / Nouvelle technologies

Collaborative Application Markup Language (CAML)

Avant de commencer ma série d'articles sur l'API SharePoint, j'aimerai faire une brève introduction au langage CAML. Celui-ci est basé sur le XML et permet de manipuler les informations de SharePoint. On peut un peu le comparer à du SQL (même s'il n'a pas la même structure).

Le langage CAML est donc du XML formaté par les éléments suivants :

<Query>
   <Where>
     
     <Eq>
        <FieldRef Name="Nom du champs" />
        <Value Type="Type">Valeur</Value>
     </Eq>
   </Where>

   <OrderBy>
      <FieldRef Name="Nom du champ" />
      <FieldRef Name="Nom du champ" />
   </OrderBy>
</Query>

Cette requête CAML est assez facile à expliquer. On définit un élément "Query", dedans nous avons un "Where" (comme en SQL) avec dedans le "FieldRef" qui contient le nom du champ concerné par le "Where" et un élément "Value" qui représente la valeur qui doit être comparée au champ du "FieldRef". Tout ceci contenu dans un "Eq" qui signifie "Egal" ("=" en SQL). Nous avons ensuite la possibilité d'ordonner par valeur. Bien sûr, nous avons aussi dans le OrderBy la possibilité d'utiliser des éléments de comparaison.

Les différents éléments de comparaison

<Contains> : qui contient une string.
<Eq> : égal à.
<Geq> : plus grand ou égal à.
<Gt> : plus grand que.
<Leq> : plus petit ou égal à.
<Lt> : plus petit que.
<Neq> : différent de.
<IsNotNull> : n'est pas null.
<IsNull> : est null.
<DateRangeOverlap> : vérifie si deux dates se chevauchent.

Enfin voilà, vous savez ce qu'est le langage CAML. Vous êtes succeptibles de faire quelques requêtes avec celui-ci car dans le prochain article, j'en ferai une ou deux.

A demain!