Import file format

KRANXPERT IMPORT FILE FORMAT DESCRIPTION

  • The import file is based on XML with UTF8 encoding structure.
  • The file extension of the format is *.kran.
  • The compressed file extension of the format is *.kranX
  • The decimal seperator for all numbers is a point.

Download sample Tadano Faun ATF 30-2L - 05IIX 051d,e,f,spDS (m).kran

Overview file format:

<?xml version="1.0" encoding="UTF-8"?>
<CraneExportFile>
  <FileVersion>2</FileVersion>
  <Crane Unit="" UUID="" Version="" Manufacturer="" SerialNumber=""
          SourceType="" Source="" Type="" Title="" LoadCapacity=""
          MaxMainBoom="" Colors="" Measurements="" Other="">
    <Load BoomType="" AddOn="" OperationMode="" CounterWeight=""
          CentralCounterWeight="" SuspendCounterWeight=""  WorkingArea=""
          OutriggerBase="" TippingLoad="" MainBoomLength="" Angle=""
          AngleTo="" ExtensionLength="" BoomHeight="" MinHook=""
          AddOnExtensionLength="" AddOnExtensionAngle="" ShortJibAngle=""
          AngleBetween="" AddOnText="" Other="">
      <Telescope CellX="" BoomLength="" TableNumber="" TelescopeNumber="" Telescope="" Other=""/>
      <LoadData CellX="" CellY="" Load="" Pressure="" BoomLength="" Radius="" Other=""/>
    </Load>
    <Hook Title="" Rope="" Load="" Weight="" Height="" Other=""/>
  </Crane>
</CraneExportFile>

Explain structure

XML header information

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

XML root tag <tag begin>

<CraneExportFile>

FILEVERSION

<FileVersion>2</FileVersion>
Version of the file version structure (the current version 2 explain in this document).

CRANE <tag begin>

<Crane Unit="0" UUID="{3262F23F-1362-446D-8F59-732B6C44233C}" Version="1"
    Manufacturer="Tadano Faun" SerialNumber="123456" SourceType="1"
    Source="Source target" Type="0" Title="ATF 000" LoadCapacity="200.0"
    MaxMainBoom="60.0" Colors="16777215;16711680" 
    Measurements="MN:3.50,3.463,2.00;
                  UW:0,10.782,2.73,2.80,1.80,3.50,0.40;
                  OW:1,5.00,6.00,1.90,1.00,3.70,2.73,3.91;
                  AS:1,3.15,5.38,2.85,5.68;
                  RA:0,4,3.002,1.70,2.44,1.70,1.94,;
                  RD:1.60;
                  AB:7.20,6.00,5.00;" 
    Other="">

Unit

Unit="0"	//Unit m/t
Unit="1"	//Unit ft/klbs (1000 bounds)

The used unit of the crane load data and crane dimensioning

UUID

UUID="{3262F23F-1362-446D-8F59-732B6C44233C}" 

A unique key, kranXpert use the Windows API function CoCreateGuid() to create this key. KranXpert use this to identifying the cranes. It must only exist one unique key for each crane. If a import file published and you wish to change crane data as an update, increment the Version attribute, then kranXpert now he must replace the crane in the database.

Version

Version="1" 

It is an increment integer of the version of the crane import data and it is combined with the UUID attribute to make crane data updates possible.

Manufacturer

Manufacturer="Tadano Faun"

Text attribute for the name of the crane manufacturer.

SerialNumber

SerialNumber="123456"

The serial number of the crane. You can use that to build data customer specific data exports.

SourceType

SourceType="0"  //from leaflet
SourceType="1"  //from crane book data
SourceType="2"  //own created or changed

The source type of the crane data

Source

Source="Source target"

Text info to identify from where the crane data come

Type

Type="0"  //Telescope crane
Type="1"  //Lattice boom crane
Type="2"  //Self erecting mobile crane
Type="3"  //Mini crane
Type="4"  //Lorry

Crane type symbolize in kranXpert with images

Title

Title="ATF 000"

The title of the crane

LoadCapacity

LoadCapacity="200.0"

The maximum load capacity of the crane

MaxMainBoom

MaxMainBoom="60.0"

The maximum length of the main boom

Colors

Colors="16777215;16711680"

The Embarcadero TColor (VCL) value of the chassis and superstructure seperated with a semicolon.

Measurements

Measurements="
	MN:3.50,3.463,2.00;
	UW:0,10.782,2.73,2.80,1.80,3.50,0.40;
	OW:1,5.00,6.00,1.90,1.00,3.70,2.73,3.91;
	AS:1,3.15,5.38,2.85,5.68;
	RA:0,4,3.002,1.70,2.44,1.70,1.94,;
	RD:1.60;
	AB:7.20,6.00,5.00;"
MN:
MN:3.50,3.463,2.00;

Main informations in follow order

  1. crane rotation center to the back of the crane
  2. Y of the main boom beginning
  3. X of the main boom beginning from crane rotation center (negative when on the right side)



UW:
UW:0,10.782,2.73,2.80,1.80,3.50,0.40;
UW:0

The next parameters are:

  1. Chassis length
  2. Chassis width
  3. Chassis height
  4. Intermediate height
  5. Intermediate length
  6. Ground clearance

UW:1

The next parameters are:

  1. Chassis length
  2. Chassis width
  3. Chassis height
  4. Ground clearance

UW:2

The next parameters are:

  1. Chassis length
  2. Chassis width
  3. Chassis height
  4. Intermediate height
  5. Cap width
  6. Intermediate left length
  7. Intermediate right length
  8. Ground clearance

UW:3

The next parameters are:

  1. Chassis length
  2. Chassis width
  3. Chassis height
  4. Ground clearance



OW:
OW:1,5.00,6.00,1.90,1.00,3.70,2.73,3.91;
OW:0; //None
OW:1

The next parameters are:

  1. Superstructure front length
  2. Superstructure rear length
  3. Superstructure height
  4. Crane operator cap depth
  5. Left side to rotation center
  6. Superstructure width
  7. Rotation radius

OW:2

The next parameters are:

  1. Superstructure length
  2. Superstructure height
  3. Superstructure width
  4. Left side to rotation center
  5. Rotation radius

OW:3,1.70; //Superstructure building set

The next parameters are:

  1. Superstructure begin Y



OWBase: //Need OW:3
OWBase:0; //None
OWBase:1

The next parameters are:

  1. Color (not used, currently empty)
  2. Position X
  3. Position Y
  4. Width
  5. Length
  6. Height

OWBase:2

The next parameters are:

  1. Color (not used, currently empty)
  2. Position X
  3. Position Y
  4. Width
  5. Length
  6. Height
  7. Width 2
  8. Length 2

OWBase:3

The next parameters are:

  1. Color (not used, currently empty)
  2. Position X
  3. Position Y
  4. Width
  5. Radius
  6. Height



OWCab: //Need OW:3
OWCab:0; //None
OWCab:1 

The next parameters are:

  1. Color (not used, currently empty)
  2. Position X
  3. Position Y
  4. Cab width
  5. Length 1
  6. Length 2
  7. Height 1
  8. Height 2



OWSuspension: //Need OW:3
OWSuspension:0; //None
OWSuspension:1

The next parameters are:

  1. Color (not used, currently empty)
  2. Position X
  3. Position Y
  4. Suspension width
  5. Length 1
  6. Length 2
  7. Length 3
  8. Length 4
  9. Height 1
  10. Height 2
  11. Height 3

OWSuspension:2

The next parameters are:

  1. Color (not used, currently empty)
  2. Position X
  3. Position Y
  4. Suspension width
  5. Length 1
  6. Length 2
  7. Length 3
  8. Length 4
  9. Length 5
  10. Length 6
  11. Length 7
  12. Height 1
  13. Height 2
  14. Height 3
  15. Height 4
  16. Height 5

OWSuspension:3

The next parameters are:

  1. Color (not used, currently empty)
  2. Position X
  3. Position Y
  4. Suspension width
  5. Length 1
  6. Length 2
  7. Length 3
  8. Length 4
  9. Height 1
  10. Height 2
  11. Height 3
  12. Height 4



OWCounterweight: //Need OW:3

OWCounterweight can multiply exist for each counterweight

OWCounterweight:0; //none
OWCounterweight:1 

The next parameters are:

  1. Color (not used, currently empty)
  2. Counterweight
  3. Position X
  4. Position Y
  5. Height 1
  6. Height 2
  7. Stacked (0=false, 1=true)
  8. Stacked length
  9. Stacked height
  10. Width
  11. Radius 1
  12. Radius 2

OWCounterweight:2 

The next parameters are:

  1. Color (not used, currently empty)
  2. Counterweight
  3. Position X
  4. Position Y
  5. Height 1
  6. Height 2
  7. Stacked (0=false, 1=true)
  8. Stacked length
  9. Stacked height
  10. Width
  11. Radius
  12. Length

OWCounterweight:3 

The next parameters are:

  1. Color (not used, currently empty)
  2. Counterweight
  3. Position X
  4. Position Y
  5. Height 1
  6. Height 2
  7. Stacked (0=false, 1=true)
  8. Stacked length
  9. Stacked height
  10. Width 1
  11. Radius 1
  12. Radius 2
  13. Width 2
  14. Length 1
  15. Length 2

OWCounterweight:4 

The next parameters are:

  1. Color (not used, currently empty)
  2. Counterweight
  3. Position X
  4. Position Y
  5. Height 1
  6. Height 2
  7. Stacked (0=false, 1=true)
  8. Stacked length
  9. Stacked height
  10. Width
  11. Length

OWCounterweight:5 

The next parameters are:

  1. Color (not used, currently empty)
  2. Counterweight
  3. Position X
  4. Position Y
  5. Height 1
  6. Height 2
  7. Stacked (0=false, 1=true)
  8. Stacked length
  9. Stacked height
  10. Width 1
  11. Width 2
  12. Length 1
  13. Length 2
  14. Radius



AS:
AS:1,3.15,5.38,2.85,5.68;
AS:0; //Outrigger none
AS:1 //Outrigger straight

The next parameters are:

  1. length right bottom
  2. length left bottom
  3. length right top
  4. length left top

AS:2 //Outrigger star

The next parameters are:

  1. angle
  2. left side
  3. right side

AS:3 //Outrigger front angled and back straight

The next parameters are:

  1. angle
  2. left top and bottom
  3. right top
  4. right bottom

AS:4 //Outrigger straight an in view angled

The next parameters are:

  1. length right bottom
  2. length left bottom
  3. length right top
  4. length left top



RA:
RA:0,4,3.002,1.70,2.44,1.70,1.94,;
RA:0 // wheel

The next parameter is the count of the wheels then come the distances begining from the cap.

RA:1 // chain

The next parameters are:

  1. Chain length
  2. Chain axles
  3. Chain width
  4. Chain height
  5. Chain length between
  6. Use outriggerbase as length (0=false, 1=true) if it's true the parameter 5 is ignored but must exist.



RD:
RD:1.60;

The wheel diameter with ending semicolon


BM:
AB:0.80,0.40;"

First boom width second short jib width.


SL:
AB:10.00,3.00;"

Display of the superlift.
The parameters are:

  1. SL position
  2. SL length



LJib:
LJib:1,10.00,12.00,2.00,85,45;
LJib:0;

no luffing jib

LJib:1,10.00,12.00,2.00,85,45;

LJib:2,10.00,12.00,115;



SEMC:
SEMC:1,##,##,##,##,##;
SEMC:0;

no self erecting mobile crane

SEMC:1,##,##,##,...;

SEMC:2,##,##,##,...;

SEMC:3,##,##,##,...;



AB:
AB:7.20,6.00,5.00;"

All outrigger base distance separated with comma and ending semicolon


Other

Other information currently not used by kranXpert

LOAD <tag begin>

<Load BoomType="0" AddOn="0" OperationMode="" CounterWeight="5.2"
    CentralCounterWeight="0.0" SuspendCounterWeight="0.0"
    WorkingArea="1" OutriggerBase="7.00" TippingLoad="DIN/ISO/EN"
    MainBoomLength="0.0" Angle="0.0" AngleTo="0.0" ExtensionLength="0.0"
    BoomHeight="0.0" MinHook="0.0" AddOnExtensionLength="0.0"
    AddOnExtensionAngle="0.0" ShortJibAngle="" AngleBetween=""
    AddOnText="" Other="otlu=t;">

BoomType

BoomType="-1"	//None
BoomType="0"	//Main boom
BoomType="10"	//Boom extension
BoomType="11"	//Folding boom extension
BoomType="12"	//Double folding boom extension
BoomType="15"	//Telescopic boom extension
BoomType="20"	//Hydraulic jib under load
BoomType="21"	//Hydraulic boom extension
BoomType="30"	//Jib
BoomType="31"	//Jib hydraulic
BoomType="40"	//Luffing jib
BoomType="50"	//Short jib
BoomType="51"	//Short jib with fixed hook
BoomType="60"	//Self erecting mobile crane

AddOn

AddOn="-50xxxx"	//Power-System PS with variable angle
AddOn="-40xxxx"	//Mega-Wing-Lift with variable angle
AddOn="-30xxxx"	//Y with variable angle
AddOn="-20xxxx"	//SSL with variable angle
Addon="-10xxxx"	//SL with variable angle
AddOn="0"  	//none
AddOn="1"  	//SL
AddOn="2"  	//SSL
AddOn="3"  	//0 SSL
AddOn="4"  	//30 SSL
AddOn="5"  	//60 SSL
AddOn="6"  	//Y
AddOn="7"  	//0 Y
AddOn="8"  	//10 Y
AddOn="9"  	//15 Y
AddOn="10"  	//42 Y
AddOn="11"	//MegaWing

OperationMode

OperationMode="0" 	//locked
OperationMode="1" 	//unlocked extenting
OperationMode="2" 	//unlocked retracting
OperationMode="3" 	//heavy
OperationMode="4" 	//light
OperationMode="5" 	//normal
OperationMode="6" 	//telescopable load
OpertaionMode="rigging counterweight"

in OperationMode you can insert also free text

CounterWeight

CounterWeight=""

-1 = variable weight » weight is used from the chart

CentralCounterWeight

CentralCounterWeight="0.0"

-1 = variable weight » weight is used from the Chart

SuspendCounterWeight

SuspendCounterWeight="0.0"

-1 = variable weight » weight is used from the Chart

WorkingArea

WorkingArea="-30"  //over rear/front variable angle
WorkingArea="-20"  //over front variable angle
WorkingArea="-10"  //over rear variable angle
WorkingArea="0" 	//360°
WorkingArea="1" 	//over rear
WorkingArea="2" 	//over front
WorkingArea="3" 	//over rear and front
WorkingArea="4" 	//270° over rear
WorkingArea="5" 	//90° over front
WorkingArea="6" 	//180° over rear

OutriggerBase

OutriggerBase="-1"	//none
OutriggerBase="-2"	//creep
OutriggerBase="-11"	//14.00 R 25
OutriggerBase="-12"	//16.00 R 25
OutriggerBase="-13"	//18.00 R 25
OutriggerBase="-14"	//23.50 R 25
OutriggerBase="-15"	//26.50 R 25
OutriggerBase="-21"	//14.00 R 25 creep
OutriggerBase="-22"	//16.00 R 25 creep
OutriggerBase="-23"	//18.00 R 25 creep
OutriggerBase="-24"	//23.50 R 25 creep
OutriggerBase="-25"	//26.50 R 25 creep

Positive values are the outriggerbase length

TippingLoad

free Text field with follow kranXpert selects

TippingLoad="DIN/ISO/EN"
TippingLoad="DIN/ISO"
TippingLoad="DIN 15019"
TippingLoad="EN 13000"
TippingLoad="75% DIN/ISO"
TippingLoad="SAE"
TippingLoad="SAE J765"
TippingLoad="85%"
TippingLoad="66 2/3"

The follow attributes are different used by the BoomType

MainBoomLength=""
Angle="" 
AngleTo=""  
ExtensionLength="" 
BoomHeight="" 
MinHook="" 
AddOnExtensionLength="" //currently unused  
AddOnExtensionAngle="" //currently unused  
ShortJibAngle="" 
AngleBetween="" 
AddOnText=""

BoomType=“0” Main Boom
No other attributes needed. The main boom length get from the tag LoadData from BoomLength

BoomType=“10” Boom extension
BoomType=“11” Folding boom extension
BoomType=“12” Double folding boom extension
BoomType=“21” Hydraulic boom extension

MainBoomLength=""
Angle=""



BoomType=“20” Hydraulic jib under load

MainBoomLength=""
Angle=""
AngleTo=""
AddOnExtensionLength=""
AngleBetween="" *(2



BoomType=“30” Jib
BoomType=“31” Jib hydraulic

MainBoomLength=""
Angle=""
ExtensionLength=""
AngleBetween="" *(2



BoomType=“40” Luffing jib

MainBoomLength=""
Angle=""
AngleTo=""
ExtensionLength=""
AngleBetween=""  *(2



BoomType=“50” Short jib

MainBoomLength=""
ShortJibAngle="" *(1



BoomType=“60” Self erecting mobile crane

Angle=""
BoomHeight=""	
MinHook=""			 	



*(1 can have more angle separated with semicolon

*(2 It used for angle the luffing extenion after a fixed length.

AngleBetween="26.0,12.0;32.0,16.0" 

The 26.0 is the complet lenght of the luffing extension and after 12.0 unit angled the luffing
The 32.0 is the complet lenght of the luffing extension and after 16.0 unit angled the luffing
The complet lenght of the luffing extension must the same in tag LoadData from BoomLength

Other

Other="otlu=kN;"

otlu=kN; Outrigger load unit: kN, daN*1000 etc.

TELESCOPE

<Telescope CellX="1" BoomLength="11.1" TableNumber="" TelescopeNumber="" Telescope="0;0;0;0;0;;" Other=""/>

CellX

CellX="1"

table cell number x

BoomLength

BoomLength="11.1"

main boom length or the extension boom length it's different by boom type

TableNumber

TableNumber="" 

table number of the origin information

TelescopeNumber

TelescopeNumber="" 

telescope code number

Telescope

Telescope="0;0;0;0;0;;" 

telescope slide positions spaced by semicolon

Other

Other=""

Other information currently not used by kranXpert

LOADDATA

<LoadData CellX="0" CellY="1" Load="0.0" Pressure="0.0" BoomLength="0.0" Radius="3" Other=""/>

CellX

CellX="0"

table cell number x, 0 = only radius

CellY

CellY="1"

table cell number y

Load

Load="0.0"

maximum load capacity

Pressure

Pressure="0.0"

maximum outrigger load

BoomLength

BoomLength="0.0"

main boom length or the extension boom length it's different by boom type

Radius

Radius="3"

radius of the load

Other

Other=""

Other information currently not used by kranXpert

LOAD <tag end>

</Load>

HOOK

<Hook Title="100.0" Rope="19" Load="100.0" Weight="1.0" Height="0.0" Other=""/>

Title

Title="100.0"

the title of the hook block

Rope

Rope="19"

rope count

Load

Load="100.0"

load capacity

Weight

Weight="1.0"

weight of the hook

HeightD

HeightD="0.0"

height of the min distance to boom “D”

Other

Other=""

Other information currently not used by kranXpert

CRANE <tag end>

</Crane>

XML root tag <tag end>

</CraneExportFile>

en/develop/import_file_format.txt · Last modified: 2013/06/24 10:28 by markus
Back to top
chimeric.de = chi`s home Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0