Hoe optimaliseer ik de validatie van Floricode berichten?

De Core Component Library (CCL) van UN/CEFACT is een grote hoeveelheid schema's. Voor iedere validatie worden deze gedownload van de website van UN/CEFACT. Dit kost relatief veel tijd.

De Floricode XML standaarden maken gebruik van de CCl verise 7A. De schema's van UN/CEFACT kunnen eenvoudig lokaal worden opgeslagen. Download hiervoor de CCL versie 7A. Pak dit ZIP-bestand uit op de lokale harde schijf.

1. Maak op dezeflde computer een website aan die luistert naar de virtual host header: www.unece.org. Zorg dat deze website verwijst naar de lokaal uitgepakte bestanden van de CCL.

2. Wijzig je lokale host-file, zodat http://www.unece.org verwijst naar je eigen website. Dit bestand vind je op: c:\Windows\System32\drivers\etc\hosts.

Vanaf nu wordt de CCL niet meer vanaf het Internet gedownload bij iedere validatie.

Hoe converteer ik een afbeelding naar een BASE64 string voor gebruik in het beeldbericht en vice versa?

Base64 encoding is een manier om binaire data, zoals plaatjes, te versturen in een XML-bericht.
De bytes van het plaatje worden vertaald in tekstuele tekens.
Bijvoorbeeld:

<ImageBinary fileName="rhips.jpeg">/9j/4AAQSkZJRgABAgAAZABkAAD/7AARRHVja3kAAQAEAAAAPAAA/+4ADkFkb2JlAGTAAAAAAf/9k=</ImageBinary>

In C#.net gaat dit als volgt:

//Vertalen van een afbeelding naar een Base64 encoded string
System.IO.StreamReader reader = new System.IO.StreamReader(@"c:\temp\plaatje.jpg");
byte[] bytedata = System.Text.Encoding.Default.GetBytes(reader.ReadToEnd());
reader.Close();
string strBase64 = System.Convert.ToBase64String(bytedata);

Terug van een beeldbericht naar een plaatje gaat als volgt:

foreach (ImageLine oImage in PutImages.Body.Images.ImageLine) {
System.IO.FileStream fs = System.IO.File.OpenWrite(@"c:\temp\plaatje.jpg");
fs.Write(oImage.ImageBinary.Value, 0, oImage.ImageBinary.Value.Length);
fs.Close();
}

In VB.net gaat dit als volgt:

'Vertalen van een afbeelding naar een Base64 encoded string
Dim reader As System.IO.StreamReader
Dim bytedata As Byte()Dim strBase64 As String
reader = New System.IO.StreamReader("c:\temp\plaatje.jpg")
bytedata = System.Text.Encoding.Default.GetBytes(reader.ReadToEnd())
reader.Close()
strBase64 = System.Convert.ToBase64String(bytedata)

Wat is de Core Component Library (CCL) van UN/CEFACT?

UN/CEFACT is een afdeling van de United Nations die de elektronische handel aanmoedigt. Ze doen dit door het aanbieden van XML schema's voor standaard componenten zoals een adres, een telefoonnummer, een factuur, enz.

De verzameling componenten worden gepubliceerd door UN/CEFACT als de Core Component Library (CCL). Deze componenten zijn geschikt voor alle industrieen en sectoren.

De componenten uit de CCL zijn nog geen berichten. Floricode stapelt de componenten uit de CCL als blokken op elkaar. Hierdoor ontstaan de Floricode XML-berichten.

De actuele CCL is te downloaden bij UN/CEFACT. Momenteel gebruikt Floricode CCL versie 7A; deze is echter niet meer beschikbaar bij UN/CEFACT en kan vanaf deze website worden gedownload (zie de eerste FAQ hierboven).

Hoe beveilig ik mijn webservices?

Floricode stelt geen eisen aan de beveiling van de bericht-interface.

Indien er gebruik gemaakt wordt van een webservice interface, dan kan er o.a. gebruik gemaakt worden van Basic-authenticatie of NT-authenticatie. De authenticatie wordt dan door de webserver geregeld.

Er kan ook gekozen worden om de toegang alleen op applicatieniveau in te stellen. De Floricode berichten zijn hiervoor geschikt, doordat in de standaard berichtheader ruimte is gereserveerd voor een gebruikersnaam en wachtwoord. Op deze manier kan de webservice implementatie of de onderliggende applicatie de authenticatie utivoeren. Er dient wel rekening gehouden te worden met versleuteling van het bericht (SSL/HTTPS), omdat de inhoud van een bericht afgeluisterd kan worden.

Moet ik XML berichten valideren?

Er moet zoveel mogelijk aan de bron worden gevalideerd, hiermee voorkom je het verzenden van foute berichten. Bij gebruik van webservices wordt aan de ontvangende kant de validatie vaak uitgevoerd door de webservice interface.

 

Why do I have to apply for a subscription on the Floricode message standards?

With a subscription on one or more of the Floricode message sets you get a development license for these messages. This license gives you the ability to implement the message standards in your software for your customers.
In this way Floricode gets the financial support necessary to develop and maintain these standards and to support you as a software developer during the implementation.

What type of standard messages are available?

Floricode has about 8 different sets of standard messages available. It depends on the requirements of your customers which of these sets are useful. Is your customer buying flowers on the auction clock? Is your customer importing flowers and plants from a Dutch wholesaler? Is your customer exporting flowers and plants to countries outside the EU?  Our service desk can help you to answer these questions.

How do I apply?

On this page you can find the ‘Application form Message standards’. Fill it in, send it to us and we’ll give you access to the documentation of the standards. You are always able to expand your license.

What are the components of a message standard?

The documentation of a message set consists of different components:

For the EDIFACT standards:
The technical Convention manual (CM)
The Functional Procedure Description (FPB)
An implementation guideline
Test messages   

For the XML standards:
The XML and XSD schema
Scenario descriptions (process)
The message guide
Implementation guideline
Test messages and/or examples

What is the Floricode Test Center?

Floricode supports you during the implementation of the message standards. We developed a Test Center for the most important sets of message standards like the VMP standards. Here you can test your application during the development. The Test Center checks if your message is technical complete and correct. Even some of the most common codes that must be used is checked like the use of GLN codes. To receive a so called ‘Statement of Conformity’ for your application some predefined scenarios must be passed through successfully. For several implementations of the standards a ‘Statement of Conformity’ is obligatory before your customer can make use of it!

For what can I call the Floricode service desk?

Floricode can help you to arrange the correct subscription on the message sets. We also support you during implementation. We can answer technical questions about the standards and the use of our Test Center. For functional questions we mostly have to forward you to the companies and organisations that are users of the standards like the auctions. In these situations it can be helpful to tune in your customers as well. They know more about the daily processes of the trade of flowers and plants.

How can I get a better understanding of the Floriculture business and the Floricode standard documentation?

Under the page ‘general’ of the SDK you’ll find free available documentation that describes:

    The Floricode documentation methodology
    The ornamental Horticultural Industry and a glossary with definitions of the most important business terms
    The architecture of our standards (4 different documents for codes and messages)
    The technical standard transport protocols  

Frequently Asked Questions (FAQ) codes

   
Where do I need the Floricode code lists for?

Codes play an important role in a standard message. A lot of elements and attributes in a message are filled in with a specific code like a product code, a characteristic code, a company code, a location code, a country code etc. instead of text like the complete product name. Every day and every week new data are added to each code list because new product come to the market, company names change etc.. It’s important that software applications have the functionality to update code lists frequent. It’s possible to automate this update process completely for the users.

What type of code lists does Floricode manage?

The most important code lists that are in use in the ornamental horticultural supply chain are:

    The product codes (in accordance with the LINNEAUS data model)
    The company and location codes (in accordance with the GS1 GLN codes)

Some of the other code lists that are used in the standard messages are: logistic means, auction groups and ISO codes.

Floricode is responsible for maintenance and distribution of these code lists.

How does Floricode distributes the code lists?

We support the users in several ways with this. Some code lists can be seen on our website (like the product codes) both in actual PDF documents as well as by our code search service (see: LINK). Code lists can also been downloaded by hand from our website (see: LINK). To automate the update process of code lists a software developer can apply for access to the Floricode FTP service where all relevant code lists are updated frequent and distributed 7 x 24h. New since 2018 is the API service of Floricode for direct and online access to all master data that Floricode maintains (see: LINK).

How can I get access to the Floricode code lists?

Users and software developers can apply for access to the code lists. On this page you can find the ‘Application form Access to Code lists’. Fill it in, send it to us and we’ll give you access to our website or FTP site. Check our pricelist for an actual overview of our prices.