Jump to content

Collaborative Application Markup Language

From Wikipedia, the free encyclopedia

CAML (Collaborative Application Markup Language) is an XML based markup language used with Microsoft SharePoint technologies (Windows SharePoint Services and Office SharePoint Server). Unlike plain XML, CAML contains specific groups of tags to both define and display (render) data.

Elements

[edit]

Developers can use CAML to both construct and display data. Microsoft refers to elements that construct data as "definition" elements and elements that display data as "rendering" elements.

Data definition elements

[edit]

Data definition elements define lists and sites in the same style as basic XML (but with a limited set of keywords). A simple definition of the fields in a list might look like:

   <Fields>
     <Field Type="Counter" Name="ID"/>
     <!-- other field definitions -->
   </Fields>

A specific set of tags exists to compare and branch on data within CAML as well:

   <IfEqual>
      <Expr1>
         <Field Name="CheckedOutUserId" />
      </Expr1>
      <Expr2 />
      <Then />
      <Else>
        <!-- Some more CAML -->
      </Else>
   </IfEqual>

There are also specialized tags provided for database queries.

Data rendering elements

[edit]

CAML allows for the generation of HTML based on specific sets of tags. For example, the following example loops through some data and generates an HTML drop down menu of choices:

   <ForEach Select="CHOICES/CHOICE">
     <HTML>fld.AddChoice(</HTML>
     <ScriptQuote>
        <Property Select="."/>
     </ScriptQuote>
     <HTML>, </HTML>
     <ScriptQuote>
   </ForEach>

Using in SharePoint products

[edit]

In general, almost all XML files in a SharePoint installation utilize CAML. Specifically CAML is very important in site and list definitions, via the ONET.XML files as well as other corresponding XML files. Here the CAML defines what elements exist on an instance of a site, and the display of these sub-elements, while the ASPX files define how to arrange and display those elements to form the site.

Software developers can use CAML to query against SharePoint lists and views, when programming against the SharePoint API (CAML is supported by SharePoint Web Services and by the SharePoint Object Model).

CAML query syntax can be created graphically from an existing SharePoint list by using the U2U CAML Generator tool and at https://web.archive.org/web/20131029200611/http://www.camlgenerator.com/.

CAML can be used to perform the query based operations like filtering the data in lists and library

[edit]