OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

trans-ws message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: RE: [trans-ws] RE: Translation Web Services Update


Title: Translation Web Services Update
Hi Kevin, all,
 
Thanks for this. I will not be able to look at this until tomorrow morning. I will try and resolve these issues then.
 
Thanks,
 
Peter.


From: Kevin.Bargary [mailto:Kevin.Bargary@ul.ie]
Sent: 07 November 2005 12:18
To: Reynolds, Peter; Kevin.Bargary; azydron@xml-intl.com; trans-ws@lists.oasis-open.org
Cc: Michael.J.Bourke; Kevin.Bargary; Reinhard.Schaler@ul.ie
Subject: RE: [trans-ws] RE: Translation Web Services Update

 
Hi Peter,

Here are a few things I spotted when browsing through the spec and the updated schema. I'll be able to give more detailed feedback when I start generating the code etc..
 
"purchaseOrderUri" with the attribute "uri" is not reflected in the TransWSTypes schema

For example "resource" with the attribute "uri" is reflected by

<xsd:element name="resource">
<xsd:complexType>     
<xsd:attribute name="uri" type="anyURI" use="required" />   
</xsd:complexType> 
</xsd:element>

purchaseOrderUri needs to have something similar to this in schema also.
quoteUri is the same...

One more thing I am not familiar with how XML deals with spacing but if only for consistency "retrieveResource Information Response" should be "retrieveResourceInformationResponse". The spacing occurs in both specification and the schema.

Finally in the service "UploadFile" specifically in FileUploadResponse there is a reference to
types:uri
 
This is no uri type in the schema..Actually on second look, "UploadFile" is not in the schema at all...I don't know if this is supposed to be omitted or not? Plus, in the spec, the request for the service "UploadFile" is fileUpload, it should be fileUploadRequest to match the fileUploadResponse
 
 requestQuote Job ticket created by publisher. Meta data sent about the job. The location of a file can be indicated using a URI. Quote information returned
 
This is a snippet from the specification...I have bolded somthing which is confusing, what file is being referred to in a requestQuote?
 

I hope this helps.. and apologies if any of the points made are invalid...I'll let you know if I find anything else..
Best Regards,
Kevin


From: Reynolds, Peter [mailto:Peter.Reynolds@bowneglobal.ie]
Sent: 07 November 2005 09:50
To: Reynolds, Peter; Kevin.Bargary; azydron@xml-intl.com; trans-ws@lists.oasis-open.org
Cc: Michael.J.Bourke; Kevin.Bargary; Reinhard.Schaler@ul.ie
Subject: RE: [trans-ws] RE: Translation Web Services Update

Hi all,
 
I hope you all had a good weekend.
 
I have attached the latest version of specification following our discussions on Thursday. Can you review and get back to me if there are issues.
 
Thanks,
 
Peter.


From: Reynolds, Peter [mailto:Peter.Reynolds@bowneglobal.ie]
Sent: 31 October 2005 12:26
To: Kevin.Bargary; azydron@xml-intl.com; trans-ws@lists.oasis-open.org
Cc: Michael.J.Bourke; Kevin.Bargary; Reinhard.Schaler@ul.ie
Subject: [trans-ws] RE: Translation Web Services Update

Hi all,
 
I have edited the specification in the light of Kevin's comments. The updated spec is attached. Please also see my responses to Kevin's mail below. We can use this mail and edited specification for our meeting on Thursday.
 
Thanks,
 
Peter.


From: Kevin.Bargary [mailto:Kevin.Bargary@ul.ie]
Sent: Thu 20/10/2005 15:53
To: Reynolds, Peter; azydron@xml-intl.com
Cc: Michael.J.Bourke; Kevin.Bargary; 'Reinhard.Schaler@ul.ie'
Subject: Translation Web Services Update

Hi Peter & Andrzej,

At this stage I feel I should point out some issues with the TWS specification that is currently preventing any further progress.

As we discussed in our last meeting, file transfer would be via URI. However this cannot yet be implemented until this is reflected in the schemas.

retreiveQuote - it was said that the quote should be sent via URI. This is not indicated in either the specification or the schemas. There is a method in the specification called Resource which is a URI. Should this be included as a parameter in the "Returned" section of the retreiveQuote service? This would make the passing back of the quote very easy and automated.

Peter: I have added a Quote URI to the return pararmerts of retreiveQuote.
I have also edited the transtype XSD files. We seem to have two files doing the same thing WSTransTypes.xsd and TransWSTypes.xsd. I have edited them both.

acceptQuote - One input for this service is a purchase order. PurchaseOrder only contains the PO number, should PurchaseOrder also contain a URI locating the physical PO?

Peter: I have added an optional parameter for the Purchase Order URI where the actual PO can be located.

submitJob - Again the same issue as above, PurchaseOrder is an input but with no URI containing PO location.

Peter: Same as acceptQuote

retrieveJobInformation - The same issue with PurchaseOrder as above

Peter: Same as acceptQuote

retrieveJobInformation - In the "Returned" parameters under the History section, Date is referred to and when compiled with AXIS it is assigned to be of type java.util.Date (which has been depreciated since version 1.1 of the API). Maybe it could be change to a Calendar type (which replaced the functionality of java.util.Date)?

Peter: Lets discuss on Thursday.

suspendJob & resumeJob & cancelJob -  Something small here but all of these services are relatively similar in their requests and responses. This is not reflected in the specification where:

suspendJob = Passed-In  resumeJob = Passed-In                           cancelJob = Passed-In
                Job Ticket                      Job Ticket                                      Job TIcket
                  Returned                      Returned                                               Returned
                Job Ticket                      Job Ticket                                      Job Ticket
                Succeeded                       Success Indicator                               Success Indicator
                Info                            Additional Information                          An information message

Peter: I have changed these so that the documentation has the same text. The schema was already the same.

An important issue to be addressed is that the specification for associateResource and what is in the schema do not conform.

i.e. In the specification the inputs are Job Ticket, Resource URI and Purpose, the returned values are Job Ticket,  Success indicator and Resource URI.

The schema on the other hand is as follows:

<xsd:element name="associateResourceRequest">
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element ref="types:ticket" />
        <xsd:element ref="types:resource" />
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
  <xsd:element name="associateResourceResponse">
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element ref="types:ticket" />
        <xsd:element ref="types:succeeded" />
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>

As you can see from the above snippet, The input Purpose and the output Resource URI are ommitted from the schema. As I am working from these schemas, this needs to be addressed.

Peter: I have fixed this.

disassociateResource - The returned value on the specification documen for this servicet is "Acknowledgement", however in the schema, the return values are of type Job Ticket and Succeeded. The document needs to be edited to reflect this.

Peter: I have changed the documentation to match the schema.

Finally and probably most importantly the following two services are in the specification but not in the schema; retrieveResourceInformation & retrieveFullResourceList. As AXIS generates code using TransWSTypes.xsd and if they are not in it, the code will not be generated!

Peter: Lets talk on Thursday.

I hope that some of this is of use and can be fixed, let me know what you think.

Best Regards,

Kevin

++++++++++++++++++
Kevin Bargary BSc.
Research Assistant,
Localisation Research Centre,
University of Limerick,
Ireland.
Email: Kevin.Bargary@ul.ie
Telephone: 061-213557
++++++++++++++++++



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]