Import Opdracht XML

Het XML-bestand met gegevens voor de opdracht kan via userinterface ingelezen worden:
Gebruik hiervoor de opdracht Import ERP in het lint Projectbeheer.
Import Offerte

XML staat voor Extensible Markup Language. Dit is een standaard om gegevens uit te wisselen. Zie ook: Wikipedia artikel XML.

Import via CommandLine

Het XML-bestand met gegevens voor de opdracht kan via de commandline ingelezen worden bij het opstarten van MatrixKozijn Project.
Geef na de commandline parameter “--xml” het pad naar het XML-bestand:


Matrix.MxProject.Win.exe --xml="C:\MxP_Project.xml"

Indeling XML-bestand Opdracht

Het XML-bestand voor het inlezen van gegevens voor een opdracht dient een element <Project> te bevatten.
In het Atribuut target dient de waarde “Project” meegegeven te worden voor een correcte import.

<?xml version="1.0" encoding="utf-8"?>
	<Project target="Project">
		…
	</Project>

 

Het XML-bestand voor het inlezen van gegevens voor een opdracht kan een element voor een deelproject bevatten.
Indien dit element is opgegeven wordt het deelproject aangemaakt.
Is dit element niet opgegeven dan wordt een standaard deelproject aangemaakt.


<Job>
	<Code>A</Code>
	<Description>Omschrijving voor deelopdracht A</Description>
</Job>

Hieronder zijn alle mogelijke elementen in het XML-bestand beschreven. Zie ook de volgende paragraaf voor een voorbeeld.

Bovenliggend elementElementData TypeVerplichtOpmerking
 Project  Element met gegevens van de opdracht
ProjectCodeString(20)JaUnieke code voor de Opdracht.
Indien een al bestaande code wordt doorgegeven wordt geen nieuwe offerte aangemaakt maar de bestaande opdracht geopend.
ProjectOfferCodeString(20)JaIndien een code van een offerte word meegeven wordt de offerte aan de hand van de code opgezocht in Matrix Project.
De offerte wordt toegekend aan de opdracht.
De status van de offerte (voor de opgegeven klant) wordt aangepast naar Geaccepteerd.
ProjectDescriptionString(255)  
ProjectReferenceCustomerString(255)  
ProjectProjectDateDatum
dd-mm-yyyy
JaOpdrachtdatum voor de opdracht.
ProjectDeliveryDateDatum
dd-mm-yyyy
 Leverdatum voor het project.
Indien niet doorgegeven dan wordt de huidige datum gebruikt.
ProjectProjectTypeString(20) Code van het opdrachttype dat toegekend wordt aan de opdracht.
Indien niet opgegeven dan wordt het opdrachttype met de laagste sorteervolgorde toegekend.
ProjectMarketTypeString(20) Code van de product markt combinatie die toegekend wordt aan de opdracht.
Indien niet opgegeven dan wordt de product markt combinatie met de laagste code toegekend.
ProjectAddress_Location  Element met adres voor locatie van opdracht
Address_LocationStreetString(255) Straatnaam van het adres voor de locatie van opdracht
Address_LocationHousnrString(10) Huisnummer van het adres voor de locatie van opdracht
Address_LocationPostalcodeString(10) Postcode van het adres voor de locatie van opdracht
Address_LocationCityString(255)) Plaatsnaam van het adres voor de locatie van opdracht
Address_LocationCountry_ISOCode2String(2) ISO_3166-1_alpha-2 code van het adres voor de locatie van opdracht
Address_LocationGLNString(13) GLN van het adres voor de locatie van opdracht
ProjectContactInfo_DigitalString(255) -mail adres voor de opdracht
ProjectContactInfo_PrimaryString(255) Telefoonnummer voor de opdracht
ProjectContactInfo_FaxString(255) Faxnummer voor de opdracht
ProjectRemark_ExternalString(2147483647) Opmerking bij de opdracht
ProjectCustomer JaKlant welke de opdrachtgever voor de opdracht is.
CustomerSearchnameString(50)JaUnieke zoeknaam voor de organisatie.
Indien een al bestaande zoeknaam wordt doorgegeven zal deze organisatie binnen Matrix Project worden bijgewerkt met de opgegeven gegevens.
CustomerNameString(255) De naam van de klant
CustomerAddress JaElement met adres voor de klant
Customer/AddressStreetString(255) Straatnaam van het adres voor de klant
Customer/AddressHousnrString(10) Huisnummer van het adres voor de klant
Customer/AddressPostalcodeString(10) Postcode van het adres voor de klantcht
Customer/AddressCityString(255)) Plaatsnaam van het adres voor de klant
Customer/AddressCountry_ISOCode2String(2) ISO_3166-1_alpha-2 code van het adres voor de klant
Customer/AddressGLNString(13) GLN van het adres voor de klant
CustomerContactInfo_DigitalString(255) -mail adres voor de klant
CustomerContactInfo_PrimaryString(255) Telefoonnummer voor de klant
CustomerContactInfo_FaxString(255) Faxnummer voor de klant
CustomerRemark_ExternalString(2147483647) Opmerking bij de klant
ProjectProjectManager  Projectleider bij de opdrachtgever voor de opdracht.
Indien de projectleider niet bestaat wordt deze aangemaakt bij de klant.
Indien niet opgegeven dan wordt er geen projectleider aan de opdracht toegekend.
ProjectManagerLastNameString(255)JaAchternaam van de projectleider
ProjectManagerInsertionString(15) Tussenvoegsel van de projectleider
ProjectManagerInitialsString(15) Initialen van de projectleider
ProjectManagerFirstNameString(50) Voornaam van de projectleider
ProjectManagereSex

Nummer:

  • 0 = onbekend
  • 1 = Mannelijk
  • 2 = Vrouwelijk
 Geslacht van de projectleider
ProjectManagerFunction_CodeString(20) Code van de functie die toegekend wordt aan de projectleider.
Indien niet opgegeven dan wordt de functie met de laagste code toegekend.
ProjectManagerContactInfo_DigitalString(255) E-mail adres van de projectleider
ProjectManagerContactInfo_PrimaryString(255) Telefoonnumer van de projectleider
ProjectManagerContactInfo_MobileString(255) Mobiel telefoonnumemr van de projectleider
ProjectManagerRemarkString(2147483647) Opmerking bij de projectleider
ProjectJob  Aan te maken deelopdracht
JobCodeString(20)JaCode voor aan te maken deelopdracht
JobDescriptionString(255) Omschrijving voor aan te maken deelopdracht

 

 

Voorbeeld XML-bestand Opdracht

<?xml version="1.0" encoding="utf-8"?>
<Offer target="Offer">
	<Code>0001</Code>
	<Description>Offer description</Description>
	<OfferDate>30-01-2017</OfferDate>
	<OfferExpireDate>30-03-2017</OfferExpireDate>
	<MarketType>BBB</MarketType>
	<Remark_External>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</Remark_External>
	<Customer>
		<SearchName>XXXXXX</SearchName>
		<Name>Nameoforganisation</Name>
		<Address>
			<Street>Streetname</Street>
			<HouseNr>1111</HouseNr>
			<PostalCode>1111 AA</PostalCode>
			<City>CITYNAME</City>
			<Country_ISOCode2>NL</Country_ISOCode2>
			<GLN>1111111111</GLN>
		</Address>
		<ContactInfo_Digital>email@domain.com</ContactInfo_Digital>
		<ContactInfo_Primary>0000-55555555</ContactInfo_Primary>
		<ContactInfo_Fax>0000-55555555</ContactInfo_Fax>
		<Remark_External>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</Remark_External>
	</Customer>
	<PersonOrganization_SentTo>
		<LastName>xxxxxxxxxxxxx</LastName>
		<Insertion>xxxxxxxxxxxxx</Insertion>
		<Initials>xxxxxxxxxxxxx</Initials>
		<FirstName>xxxxxxxxxxxxx</FirstName>
		<eSex>0</eSex>
		<Function_Code>ABCDE</Function_Code>
		<ContactInfo_Digital>email@domain.com</ContactInfo_Digital>
		<ContactInfo_Primary>0000-55555555</ContactInfo_Primary>
		<ContactInfo_Mobile>0000-55555555</ContactInfo_Mobile>\
		<Remark>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</Remark>
	</PersonOrganization_SentTo>
	<Job>
		<Code>A</Code>
		<Description>Description for job A</Description>
	</Job>
</Offer>