2019-06-22 - NewFormat AB


 V10 XML PICADOR interface

https://www.treedim.com/en/update-registry
https://www.treedim.com/en/update-registry/209-v10-xml-picador-interface


V10 provide a solution to interface directly Picador with ERP/MIS solution.

Documentation : http://www.treedim.com/DL/integration/xml/PicadorBatchXMLProcessing_en.pdf

xml schema : http://www.treedim.com/DL/integration/xml/xmlCommands.xsd 

---> send data from the ERP/MIS to create the technical datasheet of a design
<--- receive results of calculation : lengths, superficies, format, number of items
---> change attributes of type lines
<--- export in various format in the indicated path


------------------------------------------------------

xml schema : www.treedim.com/DL/integration/xml/xmlCommands.xsd



<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
    targetNamespace="http://www.treedim.com/PicGEOM"
    xmlns:pg="http://www.treedim.com/PicGEOM"
    elementFormDefault="qualified"
>
  <!-- BEGIN PICGEOM XML FORMAT SCHEMA -->
  <xs:annotation>
    <xs:documentation>
      PicGEOM XML Schema
      Version 10.0.6.0 (2018)
    </xs:documentation>
  </xs:annotation>
  <!--Primitive types -->
  <xs:simpleType name="string">
    <xs:restriction base="xs:string"/>
  </xs:simpleType>
  <xs:simpleType name="bool">
    <xs:restriction base="xs:boolean"/>
  </xs:simpleType>
  <xs:simpleType name="int">
    <xs:restriction base="xs:int"/>
  </xs:simpleType>
  <xs:simpleType name="float">
    <xs:restriction base="xs:float"/>
  </xs:simpleType>
  <xs:simpleType name="dateTime">
    <xs:restriction base="xs:dateTime"/>
  </xs:simpleType>
  <xs:simpleType name="ListOfFloats">
    <xs:list itemType="xs:float"/>
  </xs:simpleType>
  <xs:simpleType name="float2">
    <xs:restriction base="pg:ListOfFloats">
      <xs:minLength value="2"/>
      <xs:maxLength value="2"/>
    </xs:restriction>
  </xs:simpleType>
  <!-- path types-->
  <xs:simpleType name="pathType">
    <xs:annotation>
      <xs:documentation>
        File or Directory.
      </xs:documentation>
    </xs:annotation>
    <xs:restriction base="xs:string">
      <xs:enumeration value="FILE">
        <xs:annotation>
          <xs:documentation>File path</xs:documentation>
        </xs:annotation>
      </xs:enumeration>
      <xs:enumeration value="DIR">
        <xs:annotation>
          <xs:documentation>Directory path</xs:documentation>
        </xs:annotation>
      </xs:enumeration>
    </xs:restriction>
  </xs:simpleType>
  <!-- file format -->
  <xs:simpleType name="fileFormat">
    <xs:annotation>
      <xs:documentation>
        File format
      </xs:documentation>
    </xs:annotation>
    <xs:restriction base="xs:string">
      <xs:enumeration value="DES">
        <xs:annotation>
          <xs:documentation>Picador2D</xs:documentation>
        </xs:annotation>
      </xs:enumeration>
      <xs:enumeration value="CF2">
        <xs:annotation>
          <xs:documentation>Common File Format</xs:documentation>
        </xs:annotation>
      </xs:enumeration>
      <xs:enumeration value="DXF">
        <xs:annotation>
          <xs:documentation>Drawing eXchange Format</xs:documentation>
        </xs:annotation>
      </xs:enumeration>
    </xs:restriction>
  </xs:simpleType>
  <!-- PenType -->
  <xs:simpleType name="penType">
    <xs:annotation>
      <xs:documentation>
        Available pen types
      </xs:documentation>
    </xs:annotation>
    <xs:restriction base="xs:string">
      <xs:enumeration value="CUT"/>
      <xs:enumeration value="PERFO-CREASE"/>
      <xs:enumeration value="CONSTRUCTION"/>
      <xs:enumeration value="PERFO"/>
      <xs:enumeration value="HALF-CUT"/>
      <xs:enumeration value="CREASE"/>
      <xs:enumeration value="AXIS"/>
      <xs:enumeration value="DIMENSION"/>
      <xs:enumeration value="REVERSED-CREASE"/>
      <xs:enumeration value="ANTI-CUT"/>
      <xs:enumeration value="STRIPPING"/>
      <xs:enumeration value="TEXT"/>
      <xs:enumeration value="AREA"/>
      <xs:enumeration value="ORIGIN"/>
      <xs:enumeration value="GRID"/>
      <xs:enumeration value="BRIDGES"/>
    </xs:restriction>
  </xs:simpleType>
  <!-- PathItem -->
  <xs:element name="PathItem">
    <xs:annotation>
      <xs:documentation>
        Defines a file/directory as a path.
      </xs:documentation>
    </xs:annotation>
    <xs:complexType>
      <xs:attribute name="pathID" type="xs:ID" use="required"/>
      <xs:attribute name="path" type="pg:string" use="required"/>
      <xs:attribute name="type" type="pg:pathType" use="required"/>
    </xs:complexType>
  </xs:element>
  <!-- PathRef -->
  <xs:element name="PathRef">
    <xs:annotation>
      <xs:documentation>
        Refers to a file/directory.
      </xs:documentation>
    </xs:annotation>
    <xs:complexType>
      <xs:attribute name="pathID" type="xs:IDREF" use="required">
        <xs:annotation>
          <xs:documentation>
            Refers to a Path.
          </xs:documentation>
        </xs:annotation>
      </xs:attribute>
      <xs:attribute name="role" type="pg:string" use="optional">
        <xs:annotation>
          <xs:documentation>
            Defines the role during the task.
          </xs:documentation>
        </xs:annotation>
      </xs:attribute>
      <xs:attribute name="deleteAfterUsing" type="pg:bool" use="optional" default="false">
        <xs:annotation>
          <xs:documentation>
            Delete the file/directory after processing the task?
          </xs:documentation>
        </xs:annotation>
      </xs:attribute>
    </xs:complexType>
  </xs:element>
  <!-- Attribute element -->
  <xs:element name="Field">
    <xs:annotation>
      <xs:documentation>
        Field description (Used to set field)
      </xs:documentation>
    </xs:annotation>
    <xs:complexType>
      <xs:attribute name="name" type="pg:string" use="required"/>
      <xs:attribute name="value" type="pg:string" use="optional"/>
      <xs:attribute name="readonly" type="pg:bool" use="optional"/>
    </xs:complexType>
  </xs:element>
  <!-- Pen length-->
  <xs:element name="PenLength">
    <xs:annotation>
      <xs:documentation>
        Pen length
      </xs:documentation>
    </xs:annotation>
    <xs:complexType>
      <xs:attribute name="type" type="pg:penType"/>
      <xs:attribute name="length" type="pg:float"/>
    </xs:complexType>
  </xs:element>
  <!-- Model data -->
  <xs:element name="ModelData">
    <xs:annotation>
      <xs:documentation>
        Model data
      </xs:documentation>
    </xs:annotation>
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="pg:PenLength"/>
      </xs:sequence>
      <xs:attribute name="boundingBox" type="pg:float2" use="optional"/>
      <xs:attribute name="sawingLength" type="pg:float" use="optional"/>
      <xs:attribute name="noPositions" type="pg:int" use="optional"/>
      <xs:attribute name="noBendings" type="pg:int" use="optional"/>
      <xs:attribute name="filetLength" type="pg:float" use="optional"/>
      <xs:attribute name="area" type="pg:float" use="optional"/>
    </xs:complexType>
  </xs:element>
  <!-- Group data -->
  <xs:element name="GroupData">
    <xs:annotation>
      <xs:documentation>
        Group data
      </xs:documentation>
    </xs:annotation>
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="pg:PenLength" minOccurs="0" maxOccurs="unbounded"/>
      </xs:sequence>
      <xs:attribute name="groupId" type="pg:int" use="required"/>
      <xs:attribute name="noPositions" type="pg:int" use="required"/>
      <xs:attribute name="noBendings" type="pg:int" use="required"/>
      <xs:attribute name="boundingBox" type="pg:float" use="required"/>
      <xs:attribute name="area" type="pg:float" use="required"/>
    </xs:complexType>
  </xs:element>
  <!-- Result data-->
  <xs:element name="DrawingData">
    <xs:annotation>
      <xs:documentation>
        Drawing Data
      </xs:documentation>
    </xs:annotation>
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="pg:ModelData" minOccurs="0" maxOccurs="1"/>
        <xs:element ref="pg:GroupData" minOccurs="0" maxOccurs="unbounded"/>
      </xs:sequence>
      <xs:attribute name="formatCardboard" type="pg:float2" use="optional"/>
      <xs:attribute name="formatWood" type="pg:float2" use="optional"/>
      <xs:attribute name="noModels" type="pg:int" use="optional"/>
      <xs:attribute name="sawingLength" type="pg:float" use="optional"/>
     </xs:complexType>
  </xs:element>
  <!-- inputs -->
  <xs:element name="Pathes">
    <xs:annotation>
      <xs:documentation>
        Defines the list of files or directories used in tasks.
      </xs:documentation>
    </xs:annotation>
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="pg:PathItem" minOccurs="0" maxOccurs="unbounded"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
   <!-- subtask -->
  <xs:complexType name="subTask" abstract="true">
    <xs:attribute name="ID" type="xs:ID" use="required"/>
    <xs:attribute name="filter" type="xs:string" use="optional"/>
  </xs:complexType>
  <!-- subtaskExport -->
  <xs:complexType name="subTaskExport">
    <xs:annotation>
      <xs:documentation>
        SubTask : Export file.
      </xs:documentation>
    </xs:annotation>
    <xs:complexContent>
      <xs:extension base="pg:subTask">
        <xs:sequence>
          <xs:element name="Output">
            <xs:annotation>
              <xs:documentation>
              </xs:documentation>
            </xs:annotation>
            <xs:complexType>
              <xs:attribute name="pathRef" type="xs:IDREF" use="required"/>
              <xs:attribute name="format" type="pg:fileFormat" use="required"/>
            </xs:complexType>
          </xs:element>
        </xs:sequence>
      </xs:extension>
    </xs:complexContent>
  </xs:complexType>
  <!-- subTaskReplacePenAttribute-->
  <xs:complexType name="subTaskReplacePenAttribute">
    <xs:annotation>
      <xs:documentation>
        SubTask : Replace pen attribute.
      </xs:documentation>
    </xs:annotation>
    <xs:complexContent>
      <xs:extension base="pg:subTask">
        <xs:sequence>          
        </xs:sequence>
        <xs:attribute name="penFrom" type="pg:penType" use="required"/>
        <xs:attribute name="penTo" type="pg:penType" use="required"/>
      </xs:extension>      
    </xs:complexContent>
  </xs:complexType>
  <!-- subTaskRemoveTechnicalSheet -->
  <xs:complexType name="subTaskRemoveTechnicalSheet">
    <xs:annotation>
      <xs:documentation>
        SubTask : Remove technical sheet
      </xs:documentation>
    </xs:annotation>
    <xs:complexContent>
      <xs:extension base="pg:subTask">
        <xs:sequence>
        </xs:sequence>
      </xs:extension>
    </xs:complexContent>
  </xs:complexType>
  <!-- subTaskInsertTechnicalSheet -->
  <xs:complexType name="subTaskInsertTechnicalSheet">
    <xs:annotation>
      <xs:documentation>
        SubTask : Insert technical sheet
      </xs:documentation>
    </xs:annotation>
    <xs:complexContent>
      <xs:extension base="pg:subTask">
        <xs:sequence>
        </xs:sequence>
        <xs:attribute name="technicalSheetPathRef" type="xs:IDREF" use="required"/>
      </xs:extension>
    </xs:complexContent>
  </xs:complexType>
 <!-- subTaskUpdateTechnicalSheetData -->
  <xs:complexType name="subTaskUpdateTechnicalSheetData">
    <xs:annotation>
      <xs:documentation>
        SubTask : Update technical data
      </xs:documentation>
    </xs:annotation>
    <xs:complexContent>
      <xs:extension base="pg:subTask">
        <xs:sequence>
          <xs:element ref="pg:Field" minOccurs="0" maxOccurs="unbounded"/>
        </xs:sequence>
      </xs:extension>
    </xs:complexContent>
  </xs:complexType>
  <!-- subTaskExtractTechnicalSheetData -->
  <xs:complexType name="subTaskExtractTechnicalSheetData">
    <xs:annotation>
      <xs:documentation>
        SubTask : Extract technical sheet data
      </xs:documentation>
    </xs:annotation>
    <xs:complexContent>
      <xs:extension base="pg:subTask">
        <xs:sequence>
        </xs:sequence>
      </xs:extension>
    </xs:complexContent>
  </xs:complexType>
  <!-- subTaskCollectDrawingData -->
  <xs:complexType name="subTaskCollectDrawingData">
    <xs:annotation>
      <xs:documentation>
        SubTask : Collect drawing data
      </xs:documentation>
    </xs:annotation>
    <xs:complexContent>
      <xs:extension base="pg:subTask">
        <xs:sequence>
        </xs:sequence>
      </xs:extension>
    </xs:complexContent>
  </xs:complexType> 
  <!-- subTaskInsertCropMarks-->
  <xs:complexType name="subTaskInsertLayoutFormat">
    <xs:annotation>
      <xs:documentation>
        SubTask : Insert layout format
      </xs:documentation>
    </xs:annotation>
    <xs:complexContent>
      <xs:extension base="pg:subTask">
        <xs:sequence>
          <xs:element name="Center" minOccurs="1" maxOccurs="1">
            <xs:complexType>
              <xs:attribute name="gap" type="xs:float" use="required"/>
              <xs:attribute name="length" type="xs:float" use="required"/>
              <xs:attribute name="width" type="xs:float" use="required"/>
              <xs:attribute name="diameter" type="xs:float" use="required"/>
            </xs:complexType>
          </xs:element>
          <xs:element name="Corner" minOccurs="1" maxOccurs="1">
            <xs:complexType>
              <xs:attribute name="gap" type="xs:float" use="required"/>
              <xs:attribute name="length" type="xs:float" use="required"/>
            </xs:complexType>
          </xs:element>
          <xs:element name="Fold" minOccurs="1" maxOccurs="1">
            <xs:complexType>
              <xs:attribute name="length" type="xs:float" use="required"/>
            </xs:complexType>
          </xs:element>
        </xs:sequence>
        <xs:attribute name="Pen" type="pg:int" use="required"/>
      </xs:extension>
    </xs:complexContent>
  </xs:complexType>
  <!-- task -->
  <xs:element name="Task">
    <xs:complexType>
	    <xs:annotation>
        <xs:documentation>
          Generic task.
          It contains a list of subtasks.
        </xs:documentation>
	    </xs:annotation>
      <xs:sequence>
        <xs:element name="SubTask" type="pg:subTask" minOccurs="0" maxOccurs="unbounded"/>
      </xs:sequence>
      <xs:attribute name="taskID" type="xs:ID" use="required"/>
      <xs:attribute name="inputFileID" type="xs:IDREF" use="required"/>
      <xs:attribute name="outputFileID" type="xs:IDREF" use="required"/>
    </xs:complexType>
  </xs:element>
  <!-- tasks -->
  <xs:element name="Tasks">
    <xs:complexType>
      <xs:annotation>
        <xs:documentation>
          List of tasks
        </xs:documentation>
      </xs:annotation>
      <xs:sequence>
        <xs:element ref="pg:Task" minOccurs="0" maxOccurs="unbounded"/>
      </xs:sequence>
      <xs:attribute name="quit" type="xs:boolean" default="false" use="optional"/>
    </xs:complexType>
  </xs:element>
  <!-- taskStatus -->
  <xs:simpleType name="taskStatus">
    <xs:annotation>
      <xs:documentation>
        An enumerated type specifing task results.
      </xs:documentation>
    </xs:annotation>
    <xs:restriction base="xs:string">
      <xs:enumeration value="SUCCESS"/>
      <xs:enumeration value="FAILED"/>
      <xs:enumeration value="SKIPPED"/>
    </xs:restriction>
  </xs:simpleType>
  <!-- error -->
  <xs:element name="error" type="pg:string"/>  
  <!-- subTaskResult-->
  <xs:element name="subTaskResult">
    <xs:annotation>
      <xs:documentation>
        Sub task result (Status, time start, time end, error message, Field)
      </xs:documentation>
    </xs:annotation>
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="pg:Field" minOccurs="0" maxOccurs="unbounded"/>
      </xs:sequence>
      <xs:attribute name="subTaskID" type="xs:IDREF" use ="required"/>
      <xs:attribute name="status" type="pg:taskStatus" use="required"/>
      <xs:attribute name="errorMessage" type="pg:string" use="optional"/>
      <xs:attribute name="timeStart" type="pg:dateTime" use="required"/>
      <xs:attribute name="timeEnd" type="pg:dateTime" use="required"/>
    </xs:complexType>
  </xs:element>
  <!--taskResult-->
  <xs:element name="TaskRes">
    <xs:annotation>
      <xs:documentation>
        Desfines a task result in output file.
      </xs:documentation>
    </xs:annotation>
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="pg:subTaskResult" minOccurs="0" maxOccurs="unbounded"/>
      </xs:sequence>
      <xs:attribute name="taskID" type="xs:IDREF" use="required"/>
    </xs:complexType>
  </xs:element>
  <xs:element name="Results">
    <xs:annotation>
      <xs:documentation>
        Defines a list of task results.
      </xs:documentation>
    </xs:annotation>
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="pg:TaskRes" minOccurs="0" maxOccurs="unbounded"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <!-- XmlForPicador -->
  <xs:element name="XmlForPicador">
    <xs:annotation>
      <xs:documentation>
        XML for picador file root node
      </xs:documentation>
    </xs:annotation>
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="pg:Pathes" minOccurs="0" maxOccurs="1"/>
        <xs:element ref="pg:Tasks" minOccurs="0" maxOccurs="1"/>
        <xs:element ref="pg:Results" minOccurs="0" maxOccurs="1"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>