This method returns a full landing report record as a string in XML format as defined by the XSD definition for Landing_Report object in landingreport.xsd.
The getLandingReport() takes four arguments: 1.
- String Userid – i.e
...
- "amarx"
...
- String password – i.e.
...
- "A_
...
- marx"
...
- String schemaVersionNumber – i.e.
...
- "2.
...
- 1"
...
- String landingReportID - i.e.
...
- "1046"
In the web service client we might auto generate a data structure by providing the web service URL. In eLandings we use Java – JAX-WS and generated a structure called ReportManager.
ReportManagement ws;
¿
¿ ...
...
String xml = ws.getLandingReport(userid, password, schemaVersionNumber, landingReportID);
So for example, if we clicked on the Report ID 1046 in the eLandings web page:
<IMAGE>
Elandings would call the web service using:
String xml = ws.getLandingReport(¿amarx¿, ¿A_marx¿, ¿2.1¿, ¿1046¿"amarx", "A_marx", "2.1", "1046");
If the web service call was successful you might see a string containing something like:
<CODE_SAMPLE>getLandingReport_results_on_success.txt
This string can then be parsed using the landingreport.xsd definition for a landing_report object into a data object that Java, C#, Visual Basic, etc. can work with in memory.
The eLandings web application can then display the report on the screen.
<IMAGE>
If the web service call was unsuccessful you would receive a string containing XML for a landing_report structure containing one or more messages documenting errors that were encountered when processing your request.
For example, if you passed in a userid=¿CNEMO¿ "CNEMO" instead of ¿AMARX¿ "AMARX" and if ¿CNEMO¿ "CNEMO" does not have rights to view the landing report id = 1046, then you might see something like:
...
eLandings would display this error message as:
<IMAGE>
For the list of potential elandings messages see the elandings codes page and click on Message Codes