We understand that there have been several small changes and inconsistencies between the xml, flat format and the structure guide for outbound tickets and that is has been causing delays in testing. For that we apologize.
Last night, the development team went through, line by line, and resolved any remaining inconsistencies between formats and outputs.
NOTE: There is an inconsistency with the 'seconds' output between the xml and readable text format (showing zeroes) that will be resolved on Monday, Oct. 22)
NOTE: It is possible that there may be one additional field added to the output before launch
(Original Ticket Number). This is dependent on the solution for Corrections, and whether they can keep the same ticket number. Not yet resolved.
Attached below are
WC Data Structure Guide: an Excel document that defines each line of output for both the text (readable) format and the xml format.
Readable Text body email: Sample of the readable text that will be in the body of the email. (NOTE: This text should appear in the body of all outbound ticket emails after Monday, Oct. 22)
onecall.xsd: The schema for programming xml tickets into parsing systems. NOTE: Once we are in production environment, this file will be accessed for each ticket from a link within the xml file itself. (-<onecall:OneCallReferral xsi:schemaLocation="https://www.pelicancorp.com/onecall/bydp.xsd" xmlns:onecall="http://www.pelicancorp.com/onecall" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xlink="http://www.w3.org/1999/xlink">)
This file is provided for system configuration, but ticket management systems should resolve the xml schema directly from the link once we are live, therefore ensuring that the most current schema is always available.
20184200087.xml: Sample of an xml ticket output
20184200087.gif: Sample image file that will be attached to all outbound tickets - screenshot of the dig site polygon drawn by the User.
20184200087.gml: Sample gml file that will be attached to all outbound tickets. This is a geo-data file containing the actual polygon drawn by the User. It is meant to be pulled into mapping software to lay the polygon over member facility maps for comparison/screening purposes. This file is spatially accurate, based on your map projection information. Members using the gml file will have to provide BYPD with preferred projection.
20184200087.pdf: Sample of PDF attachment to be sent with all outbound ticket formats.
NOTE: the statement/advisory sections of the PDF are not final, but the ticket output fields are.
Comments
6 comments
I have concerns regarding the requirement for the XSD to be accessed directly from PelicanCorp for each ticket being processed from AlbertaOneCall:
The reasons for these are as follows:
Other concerns:
(<onecall:OneCallReferral xsi:schemaLocation="https://www.pelicancorp.com/onecall/bydp.xsd" xmlns:onecall="http://www.pelicancorp.com/onecall/2018/10/22" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xlink="http://www.w3.org/1999/xlink">)
I have tried to import the XSD schema into my process but I get an error with the following details:
I took a look at the schema and noticed where the issue is:
There should be either a choice or a sequence element on line 10. I would prefer it to be a sequence as then all the elements need to be in the correct sequence which would make validating the data to the schema easier.
I have posted my version of the schema here in case you want to take a look at it:
Hi Anthony,
We passed along the information to the Pelican Dev Team and are waiting for a response back for you.
Sher
In regards to changes to the schema:
They responded that the xml schema update would not break your parsing, as it would ignore new fields until you parse them.
If there are to be any changes to the schema, we would still be required to give advance notice to our members as to the what and when. I’m sure we can arrange for some testing to be done prior to just updating the schema document.
In regards to downloading the schema:
Currently, testers should be using the separate xsd document provided with the xml format samples. The schema will not be loaded into the target server until later in the process.
In regards to Line 10 - still waiting for a response.
Please sign in to leave a comment.