CARL Source offers a certain number of XML interfaces as standard.

A few examples of import files accepted by these interfaces with the currency concept are given below.

These examples illustrate how the currency attribute works and is updated based on the content of files:

• The currency is entered at the level of an entity with an attribute of the "Amount" type.
• The currency is not entered at the level of an entity with an attribute of the "Amount" type.
• The currency is not entered for an entity with an attribute of the "Amount" type but we want to force the currency.

Importing skills with the SKILL_IN interface and an XML file and a defined currency

<?xml version='1.0' encoding='UTF-8'?>

<entities actor="DEMO" timezone="Europe/Paris" exchangeInterface="SKILL_OUT">

   <skill>

      <skill_description>Electricity skill with a CHF currency</skill_description>

      <skill_code>ELECTRICITE</skill_code>

      <skill_labourCost>120.0</skill_labourCost>

      <skill_billRate>1.0</skill_billRate>

      <skill_costType>LABOUR</skill_costType>

      <skill_currencyCode>CHF</skill_currencyCode>

   </skill>

</entities>

DESCRIPTION

• The <skill_labourCost> attribute having the value 120.0 is a field of the "Amount" type.
• The <skill_currencyCode> attribute, related to the ELECTRICITY skill, defines the currency of the <skill_labourCost> attribute for this skill.
      → The ELECTRICITY skill has an hourly cost of CHF 120.

Importing skills with the SKILL_IN interface and an XML file and an undefined currency

<?xml version='1.0' encoding='UTF-8'?>

<entities actor="DEMO" timezone="Europe/Paris" exchangeInterface="SKILL_OUT">

   <skill>

      <skill_description>Carpentry skill without a currency</skill_description>

      <skill_code>MENUISERIE</skill_code>

      <skill_labourCost>120.0</skill_labourCost>

      <skill_billRate>1.0</skill_billRate>

      <skill_costType>LABOUR</skill_costType>

   </skill>

</entities>

DESCRIPTION

• The <skill_labourCost> attribute having the value 120.0 is a field of the "Amount" type.
• The <skill_currencyCode> attribute, associated with the CARPENTRY skill, is not present i.e. the currency is not defined.
  
  → In this particular case, the currency is initialized with the value of the context currency of the user who initiated the interface running job.

Importing skills with the SKILL_IN interface and an XML file and an undefined currency in the header

<?xml version='1.0' encoding='UTF-8'?>

<entities actor="DEMO" timezone="Europe/Paris" exchangeInterface="SKILL_OUT" currencyCode="USD">

   <skill>

      <skill_description>Painting skill</skill_description>

      <skill_code>PEINTURE</skill_code>

      <skill_labourCost>120.0</skill_labourCost>

      <skill_billRate>1.0</skill_billRate>

      <skill_costType>LABOUR</skill_costType>

      <skill_currencyCode>CHF</skill_currencyCode>

   </skill>

   <skill>   

      <skill_description>Plumbing skill without a currency</skill_description>

      <skill_code>PLOMBERIE</skill_code>

      <skill_labourCost>55.0</skill_labourCost>

      <skill_billRate>1.0</skill_billRate>

      <skill_costType>LABOUR</skill_costType>

   </skill>

</entities>

DESCRIPTION

• The currencyCode attribute is present in the <Entities> tag and has the value USD.
• The <skill_labourCost> amount type attribute for the PAINT skill has the value 120.0.  It has the <skill_currencyCode> attribute defined for the PAINTING skill.   
  → The PAINTING skill has an hourly cost of CHF 120.
  
• The <skill_labourCost> amount type attribute for the PLUMBING skill has the value 55.0.  It does not have the <skill_currencyCode> attribute defined for the PLUMBING skill.
  → In this case, the skill currency is initialized with the currency present in the file header.
  → The skill has an price of USD 55.