CARL Source propose en standard un certain nombre d'interfaces xml.

Voici quelques exemples de fichiers d'import acceptés par ces interfaces avec la notion de devise.

Ces exemples illustrent le fonctionnement et la mise à jour de l'attribut devise en fonction du contenu des fichiers :

• La devise est renseignée au niveau d'une entité possédant un attribut de type "Montant".
• La devise est non renseignée au niveau d'une entité possédant attribut de type "Montant".
• La devise est non renseignée au niveau d'une entité possédant un attribut de type "Montant" mais on souhaite forcer la devise.

Import de spécialité avec l'interface SKILL_IN et un fichier xml et une devise renseignée

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

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

   <skill>

      <skill_description>Spécialité électricité avec une devise CHF</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

• L'attribut <skill_labourCost> possédant la valeur 120.0 est un champ de type "Montant".
• L'attribut <skill_currencyCode>, lié à la spécialité ELECTRICITE, définit la devise de l'attribut <skill_labourCost> pour cette spécialité.
      → La spécialité ELECTRICITE possède un coût horaire de 120 CHF.

Import de spécialité avec l'interface SKILL_IN et un fichier xml et une devise non renseignée

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

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

   <skill>

      <skill_description>Spécialité menuiserie sans devise</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

• L'attribut <skill_labourCost> possédant la valeur 120.0 est un champ de type "Montant".
• L'attribut <skill_currencyCode>, lié à la spécialité MENUISERIE, n'est pas présent c'est à dire que la devise n'est pas renseignée.
  
  → Dans ce cas précis, on initialise la devise avec la valeur de la devise de contexte de l'utilisateur ayant lancé le traitement d'exécution de l'interface.

Import de spécialité avec l'interface SKILL_IN et un fichier xml et une devise renseignée en entête

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

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

   <skill>

      <skill_description>spécialité peinture </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>spécialité plomberie sans devise</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

• L'attribut currencyCode est présent dans la balise <Entities> et possède la valeur USD.
• L'attribut de type montant <skill_labourCost> pour la spécialité PEINTURE possède la valeur 120.0. Il possède l'attribut <skill_currencyCode> renseigné pour la spécialité PEINTURE.   
  → La spécialité PEINTURE possède un coût horaire de 120 CHF.
  
• L'attribut de type montant <skill_labourCost> pour la spécialité PLOMBERIE possède la valeur 55.0. Il ne possède pas l'attribut <skill_currencyCode> renseigné pour la spécialité PLOMBERIE.
  → Dans ce cas, on initialise la devise de la spécialité avec la devise présente en entête du fichier.
  → La spécialité possède un prix de 55 USD.