Het XML-bestand met gegevens voor de opdracht kan via userinterface ingelezen worden:
Gebruik hiervoor de opdracht Import ERP in het lint Projectbeheer.
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 element | Element | Data Type | Verplicht | Opmerking |
|---|---|---|---|---|
| Project | Element met gegevens van de opdracht | |||
| Project | Code | String(20) | Ja | Unieke code voor de Opdracht. Indien een al bestaande code wordt doorgegeven wordt geen nieuwe offerte aangemaakt maar de bestaande opdracht geopend. |
| Project | OfferCode | String(20) | Ja | Indien 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. |
| Project | ProjectDate | Datum dd-mm-yyyy |
Ja | Opdrachtdatum voor de opdracht. |
| Project | DeliveryDate | Datum dd-mm-yyyy |
Leverdatum voor het project. Indien niet doorgegeven dan wordt de huidige datum gebruikt. |
|
| Project | ProjectType | String(20) | Code van het opdrachttype dat toegekend wordt aan de opdracht. Indien niet opgegeven dan wordt het opdrachttype met de laagste sorteervolgorde toegekend. |
|
| Project | MarketType | String(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. |
|
| Project | Address_Location | Element met adres voor locatie van opdracht | ||
| Address_Location | Street | String(255) | Straatnaam van het adres voor de locatie van opdracht | |
| Address_Location | Housnr | String(10) | Huisnummer van het adres voor de locatie van opdracht | |
| Address_Location | Postalcode | String(10) | Postcode van het adres voor de locatie van opdracht | |
| Address_Location | City | String(255)) | Plaatsnaam van het adres voor de locatie van opdracht | |
| Address_Location | Country_ISOCode2 | String(2) | ISO_3166-1_alpha-2 code van het adres voor de locatie van opdracht | |
| Address_Location | GLN | String(13) | GLN van het adres voor de locatie van opdracht | |
| Project | ContactInfo_Digital | String(255) | -mail adres voor de opdracht | |
| Project | ContactInfo_Primary | String(255) | Telefoonnummer voor de opdracht | |
| Project | ContactInfo_Fax | String(255) | Faxnummer voor de opdracht | |
| Project | Remark_External | String(2147483647) | Opmerking bij de opdracht | |
| Project | Customer | Ja | Klant welke de opdrachtgever voor de opdracht is. | |
| Customer | Searchname | String(50) | Ja | Unieke zoeknaam voor de organisatie. Indien een al bestaande zoeknaam wordt doorgegeven zal deze organisatie binnen Matrix Project worden bijgewerkt met de opgegeven gegevens. |
| Customer | Name | String(255) | De naam van de klant | |
| Customer | Address | Ja | Element met adres voor de klant | |
| Customer/Address | Street | String(255) | Straatnaam van het adres voor de klant | |
| Customer/Address | Housnr | String(10) | Huisnummer van het adres voor de klant | |
| Customer/Address | Postalcode | String(10) | Postcode van het adres voor de klantcht | |
| Customer/Address | City | String(255)) | Plaatsnaam van het adres voor de klant | |
| Customer/Address | Country_ISOCode2 | String(2) | ISO_3166-1_alpha-2 code van het adres voor de klant | |
| Customer/Address | GLN | String(13) | GLN van het adres voor de klant | |
| Customer | ContactInfo_Digital | String(255) | -mail adres voor de klant | |
| Customer | ContactInfo_Primary | String(255) | Telefoonnummer voor de klant | |
| Customer | ContactInfo_Fax | String(255) | Faxnummer voor de klant | |
| Customer | Remark_External | String(2147483647) | Opmerking bij de klant | |
| Project | ProjectManager | 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. |
||
| ProjectManager | LastName | String(255) | Ja | Achternaam van de projectleider |
| ProjectManager | Insertion | String(15) | Tussenvoegsel van de projectleider | |
| ProjectManager | Initials | String(15) | Initialen van de projectleider | |
| ProjectManager | FirstName | String(50) | Voornaam van de projectleider | |
| ProjectManager | eSex | Nummer:
|
Geslacht van de projectleider | |
| ProjectManager | Function_Code | String(20) | Code van de functie die toegekend wordt aan de projectleider. Indien niet opgegeven dan wordt de functie met de laagste code toegekend. |
|
| ProjectManager | ContactInfo_Digital | String(255) | E-mail adres van de projectleider | |
| ProjectManager | ContactInfo_Primary | String(255) | Telefoonnumer van de projectleider | |
| ProjectManager | ContactInfo_Mobile | String(255) | Mobiel telefoonnumemr van de projectleider | |
| ProjectManager | Remark | String(2147483647) | Opmerking bij de projectleider | |
| Project | Job | Aan te maken deelopdracht | ||
| Job | Code | String(20) | Ja | Code voor aan te maken deelopdracht |
| Job | Description | String(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>