CAML Queries

Query Syntax:

1. Joins lógicos:

a.        And: Ej. <And><expression1><expression2></And>

b.      OR: Ej.<OR><expression1><expression2></OR>

2. Operador de comparación

a.       BeginsWith:  busca por un string al inicio de una columna.

<BeginsWith><FieldRef Name = “ColumnName”/><Value Type = “Value”/><XML /></BeginsWith>

b.      Contains: busca por un string en cualquier parte de una columna.

<Contains><FieldRef Name = “ColumnName”/><Value Type = “Value”/><XML /></Contains>

c.       Neq: Operador aritmético que significa “no igual a”

<Neq>  <FieldRef Name = “Field_Name”/>  <Value Type = “Field_Type”/>  <XML /> </Neq>

d.      Eq: Operador aritmético que significa “igual a”

<Eq> <FieldRef Name = “Field_Name”/>  <Value Type = “Field_Type”/>  <XML /></Eq>

e.      In: Especifica un item de lista especificado por el campo FieldRef es igual a un conjunto de valores

<In><FieldRef Name = “Field_Name”/><Values><Value Type = “Field_Type”/></Values><XML /></In>

f.        Gt: Operador aritmético que significa “más grande que”

<Gt><FieldRef Name = “Field_Name”/><Value Type = “Field_Type”/><XML /></Gt>

g.       IsNotNull: Retorna ítems que no tienen valores nulos

<IsNotNull><FieldRef Name = “Field_Name”/><Value Type = “Field_Type”/><XML /></IsNotNull>

h.      IsNull: Retorna ítems que tienen valores nulos o vacíos

<IsNull><FieldRef Name = “Field_Name”/><Value Type = “Field_Type”/><XML /></IsNull>

i.         Includes:Si el campo especificado es un campo de lookup que permite varios valores, se especifica que elemento de valor está incluido en el elemento de la lista para el campo especificado por el elemento FieldRef.

<Includes><FieldRef    Name = “Field_Name”/><Value    Type = “Field_Type”/><XML /></Includes>

j.        Lt : Operador aritmético que significa “más chico que”

<Lt><FieldRef Name = “Field_Name”/><Value Type = “Field_Type”/><XML /></Lt>

k.       NotIncludes: Si el campo especificado es un campo de lookup que permite varios valores, se especifica que elemento de valor está EXCLUIDO en el elemento de la lista para el campo especificado por el elemento FieldRef.

<NotIncludes><FieldRef    Name = “Field_Name”/><Value    Type = “Field_Type”/><XML /></NotIncludes>

3. Group Operators

a.       GroupBy: permite agrupar la info devuelta

<GroupBy  Collapse = “TRUE” | “FALSE”><FieldRef Name = “Field_Name”/></GroupBy>

b. OrderBy: determina el orden de la consulta  

<OrderBy  Override = “TRUE” | “FALSE”  UseIndexForOrderBy = “TRUE” | “FALSE”>

<FieldRef     Ascending = “TRUE” | “FALSE”    Name = “Text” />

</OrderBy>

4. Value Elements

a. Month: Se utiliza en el elemento DateRangesOverlap para recuperara partir de un calendario de todas las instancias de un evento recurrente que se producen dentro de un mes.

<DateRangesOverlap>  <FieldRef Name= “EventDate” />  <FieldRef Name= “EndDate” />  <FieldRef Name= “RecurrenceID” />  <Value Type=\”DateTime\”>    <Month />  </Value></DateRangesOverlap>

b. Now: Devuelve la fecha y hora actuales.

<Now></Now>

c. Today: Presenta la fecha actual en el formato que sea relativa a la zona del servidor, hora local. Para los servidores en los Estados Unidos, el formato es DD / MM / AAAA (por ejemplo,01/21/2001).

<Today  Offset = “Integer”></Today>

d. UserId: Contiene el número único de identificación del usuario autenticado actualmente de un sitio, tal como se define en la tabla UserInfo de la base de datos de contenido.

<UserID></UserID>