<sb-error></sb-error>

Provided by module: CMS: Tags

Returns its content if an error occured in a previous tag. This tag can investigate errors from the following plugins and tags:

<if sb-user-op>, <emit sb-stationeries>, <emit sb-log>, <emit sb-file-languages> and all subtags within <sb-edit-area>.

  <sb-edit-area>
    <sb-commit file="page.xml.html" message="Page created."/>
    <sb-error>
      A "&_.type;" error occured during "&_.operation;" on the
      file "&_.sbobj;". The reason is: "&_.reason;".
    </sb-error>
  </sb-edit-area>

If any of these errors occurs during the commit operation, the operation will be halted and an apropriate message will be returned.

<catch>
  <sb-edit-area>
    <define container="sb-handle-error">
      <sb-error><throw preparse="preparse">
        A "&_.type;" error occured during "&_.operation;" on the
        file "&_.sbobj;". The reason is: "&_.reason;".
      </throw></sb-error>
    </define>

    <sb-set-metadata file="page.xml.html" name="template">common.xsl</sb-set-metadata>
    <sb-handle-error />

    <sb-commit file="page.xml.html" message="Changed the template."/>
    <sb-handle-error />
  </sb-edit-area>
</catch>

This example defines a tag that manages all the error output. Together with the <catch> and the <throw> tags the error management is made more powerful. The newly defined tag, <sb-handle-error> will in this example halt the operation and return the error messages if any errors are found in the metadata, i.e. the commit operation will not be performed. The same will happen if any errors occurs during the commit operation.

&_.operation; (provided by CMS: Tags)

Returns what kind of operation was performed, i.e. what operation inside SiteBuilder failed.

&_.reason; (provided by CMS: Tags)

Returns the reason to why the error occurred.

&_.sbobj; (provided by CMS: Tags)

Returns all information about the file, including state and user.

&_.state; (provided by CMS: Tags)

Returns the file's state, e.g. if it was locally modified, etc.

&_.type; (provided by CMS: Tags)

Returns the type of error, e.g. "invalid file", "invalid language code" etc.

&_.vcobj; (provided by CMS: Tags)

Compatibility. Same as sbobj.