Collaborative Application Markup Language

From Wikipedia, the free encyclopedia
Jump to: navigation, search
For the programming language, see Caml.

CAML (Collaborative Application Markup Language) is an XML based markup language used with the family of 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]

CAML allows developers to both construct and display data. Microsoft refers to elements used to construct data as "Definition" elements and elements used to display data as "Rendering" elements.

Data definition elements[edit]

Data definition elements are used to 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 something like this:

  <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 is used to define what elements exist on an instance of a site, and the display of these sub-elements, while the ASPX files are used to define how to arrange and display those elements to form the site.

CAML can be used by software developers 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 http://www.camlgenerator.com/.

External links[edit]