HI,
I am using the code example from following URL to get Fax status, https://apiforums.easylink.com/system/files/CS_JobDeliveryStatus_0.txt
I am NullReference error at following line ,
extprop [0] = JDelivery_Result.JobDeliveryStatus [0].JobData[0].DeliveryGroup[0].DeliveryDetail[0].ExtendedDeliveryData[0].ExtProp [0];
please let me know what might be cause for this?
All of the lines with // in front of them have been commented out. They are not needed to get the base JobDeliveryStatus. They show how to get extended properties.
Thanks, how will i get status "success or failure" message from EasyLinkStatusWS.JobDeliveryStatusResult
It will be in the reponse you receive back. This is the URL for the result page in the API doc:
https://apiforums.easylink.com/emapidocs/24/JobDeliveryStatus/JobDeliveryStatusResult.html
You can view the entire API Manaul by clicking it at the top right hand corner on any page.
Tom. Forgot I was logged in as api_support.
Any example code for JobDeliveryStatus available?
See the attached. It is pretty basic and just outputs the StatusCode and StatusMessage. Add it after the catch. It also will serialize the xml to a file. The bottom function handles that.
You will have to enhace your code to handle error messages and any other data you want to collect
I need to provide only jobid to "JobDeliveryStatus" to get the status, Is jobid is unique alway?
Venkat, job numbers can be considered unique when combined with a date. In other words, a job number you receive today may appear again on a future job, as our sequence number server cycles back to the beginning of the sequence, which happens several times annually.
Please note, our Production job numbers are currently issuing as 8 digits (whereas our Test platforms are typically a lower number of digits). Production job number length may grow in future, so please code your application to be flexible if we should expand the number of digits in future. Any further questions, just let us know. Thank you.
You have to supply the XDN, domain name, and the MRN, job number. You receive both of these in your JobSubmit result if the submit was successful.
Thuneke, yes i am passing XDN and MRN to get the status back, but XDN values is always TEST2 (i am using test platform) and MRN is job number,
when job number repeats, how XDN and MRN helps?
The job number is repeating because you are submitting the exact same job multiple times. When the system sees the exact same job it returns the original job number for the first one and does not send the fax again. You can do two things. Ask your Sales/PreSales to have duplicates allowed set in your Profile or change the document in your job each time you submit.
Tom
Please find the following code example, can you please help me to understand more about @ref in following code,
EasyLinkWS.FaxType[] delivery = new EasyLinkWS.FaxType[1]; delivery[0] = new EasyLinkWS.FaxType(); delivery[0].Phone = FaxNo; delivery[0].@ref = Reference;
I am testing sample code to send out faxes, I did passed wrong user name and password to Jobsubmit to capture the exception,
But jobsubmit didn't fail, and i didn't see the send fax details in EasyLink web portal,
Please let me know how it works?
You would only receive an exception on the API call if there were some sort of system error accessing the system (like a SOAP fault, or a failure to connect, something like that).
In this case, you would have received a JobSubmitResult back from the system with a StatusCode that indicated the failure to authenticate.
So your code should take the result and look for the status code to see what happened.
Note that the JobSubmitResult actually has multiple StatusCodes in the result (See https://apiforums.easylink.com/emapidocs/24/JobSubmit/JobSubmitResult.html).
There is an overall Status member for the entire request (found at JobSubmitResult.Status) but also one for each job you submitted (JobSubmitResult.MessageResult.Status). The first of these is for the status of the request as a whole (so your password error would show up there). But the second is for problems with an individual job request (say, you didn't include a document you said you were going to include). So you would need to check both to make sure your job went in.
@ref is a freeform field that you can include in your input recipient list to identify each recipient.
Most of our customers include either a name or an account number in that field.
the field is displayed on most delivery reports, as well as returned with the JobDeliveryStatus result.
I didn't see status code in above URL for success or failure, I received status code "2205" for authentication failure,
do i need to check for all status codes?
Please share if you any sample code for JobSubmitResult.
Generally speaking, the specific error code doesn't mean a whole lot - if it's not 0 (success), then there is some kind of problem. When the error is non-zero, there should be a StatusMessage element as well (JobSubmitResult.Status.StatusMessage). I recommend that you simply write code to check the StatusCode, and if it's non-zero, write the StatusMessage to a log file of some sort for later investigation.
Once your application is fully implemented, those errors shouldn't happen much.
