Process for data driven application integration for B2B6816865Abstract Aspects of the present embodiments provide an eCommerce environment adapted to accept and process various message types (e.g. cXML and mXML). In general, requests are provided from a requesting entity to an application hosting entity. Data from incoming requests are mapped to a format understandable to an appropriate application(s). Responses from the application(s) are then mapped into a response format acceptable by the requesting entity. To this end, embodiments disclosed herein provide processes for the development and execution of a data driven process for mapping multiple request/response message pairs to a single application interface or set of application interfaces. In one embodiment, these processes are driven by development time and run time documents that describe a development time view of the message pairs and the application Interfaces as well as runtime instructions for providing the mappings, respectively. Claims What is claimed is: Description BACKGROUND OF THE INVENTION
TABLE I
001 <!ELEMENT connector (properties, input, output)>
002 <!ATTLIST connector
003 type NMTOKEN #FIXED "programcall"
004 name CDATA #REQUIRED
005 version (1.0) #REQUIRED
006 >
007 <!ELEMENT properties (system, userid, password,
pcmldocument)>
008 <!ELEMENT system (#PCDATA)>
009 <!ELEMENT userid (#PCDATA)>
010 <!ELEMENT password (#PCDATA)>
011 <!ATTLIST password
012 encrypt (yes) #REQUIRED
013 >
014 <!ELEMENT pcmldocument (#PCDATA)>
015 <!ELEMENT input (field*)>
016 <!ATTLIST input
017 type (pcml) #REQUIRED
018 >
019 <!ELEMENT output (field*)>
020 <!ATTLIST output
021 type (pcml) #REQUIRED
022 >
023 <!ELEMENT field EMPTY>
024 <!ATTLIST field
025 ref CDATA #REQUIRED
026 display (yes .vertline. no) #REQUIRED
027 name CDATA #IMPLIED
028 default CDATA #IMPLIED
029 >
The program call access method 414a only supports a PCML interface definition. A business partner or customer who desires to create an instance of the PCML access method 414a to invoke a specific application 412 generates a PCML Document to describe the interface to the specific application. For example, assume an application 412 that is going to be invoked with the program call access method 414a has three input fields and two output fields. A user writes a PCML document that lists the name of the application, the three input fields and the two output fields. Queue Access Method: The queue application access method 414c is used to send and receive messages on a queuing mechanism, such as an MQ Series queue or an iSeries data queue, both available from IBM. The queues can be defined locally or on a remote system. The queue application access method 414c defines the format of the message to be placed on the queue and, illustratively, is a PCML document or an XML document. The message is in a format expected by the receiving application 412. In one embodiment, the queue application access method 414c supports two queue techniques: iSeries 400 data queues and MQ series queues, both available from IBM. The queue application access method 414c may also support two interface specification techniques: PCML and XML. Therefore, in one embodiment, the properties define a sending queue (required, SendQueue) and a receiving queue (optional, ReceiveQueue). The properties defined for one embodiment of the queue application access method 414c are shown in Table II.
TABLE II
001 <!ELEMENT connector (properties, input, output)>
002 <!ATTLIST connector
003 type CDATA #FIXED "DataQueue"
004 name CDATA #REQUIRED
005 connectversion (1.0) #REQUIRED
006 >
007 <!ELEMENT properties
008 (MessageType, DQSendKeyed, DQSendKey,
DQSendQueueName, DQSendLibrary, DQReceiveKeyed,
DQReceiveKey, DQReceiveQueue Name, DQReceiveLibrary,
DQReceiveWaitTime, pcmldocument, system, userid, password)>
009 <!ELEMENT input (docref, field*)>
010 <!ATTLIST input
011 type (pcml .vertline. xml .vertline. all) #IMPLIED
012 >
013 <!ELEMENT output (docref, field*)>
014 <!ATTLIST output
015 type (pcml .vertline. xml .vertline. all) #IMPLIED
016 >
017 <!ELEMENT MessageType (#PCDATA)>
018 <!ATTLIST MessageType
019 proptype CDATA #FIXED "list(pcml; xml; csv)"
020 default CDATA #IMPLIED
021 label CDATA #FIXED "Message Type"
022 >
023 <!ELEMENT DQSendKeyed (#PCDATA)>
024 <!ATTLIST DQSendKeyed
025 proptype CDATA #FIXED "list(yes; no)"
026 default CDATA #IMPLIED
027 label CDATA #FIXED "Keyed Send Queue?"
028 >
029 <!ELEMENT DQSendKey (#PCDATA)>
030 <!ATTLIST DQSendKey
031 proptype CDATA #FIXED "string"
032 default CDATA #IMPLIED
033 label CDATA #FIXED "Send Queue Key"
034 enabledBy CDATA #FIXED "DQSendKeyed(yes)"
035 >
036 <!ELEMENT DQSendQueueName (#PCDATA)>
037 <!ATTLIST DQSendQueueName
038 proptype CDATA #FIXED "string"
039 default CDATA #IMPLIED
040 label CDATA #FIXED "Send Queue Name"
041 >
042 <!ELEMENT DQSendLibrary (#PCDATA)>
043 <!ATTLIST DQSendLibrary
044 proptype CDATA #FIXED "string"
045 default CDATA #IMPLIED
046 label CDATA #FIXED "Send Queue Library"
047 >
048 <!ELEMENT system (#PCDATA)>
049 <!ATTLIST system
050 proptype CDATA #FIXED "string"
051 default CDATA #FIXED "localhost"
052 label CDATA #FIXED "Send-Receive Queue System"
053 >
054 <!ELEMENT userid (#PCDATA)>
055 <!ATTLIST userid
056 proptype CDATA #FIXED "string"
057 default CDATA #FIXED""
058 label CDATA #FIXED "Send-Receive Queue Userid"
059 encrypt CDATA #FIXED "yes"
060 >
061 <!ELEMENT password (#PCDATA)>
062 <!ATTLIST password
063 proptype CDATA #FIXED "string"
064 default CDATA #FIXED""
065 label CDATA #FIXED "Send-Receive Queue Password"
066 encrypt CDATA #FIXED "yes"
067 keyfield CDATA #FIXED "userid"
068 >
069 <!ELEMENT DQReceiveKeyed (#PCDATA)>
070 <!ATTLIST DQReceiveKeyed
071 proptype CDATA #FIXED "list(yes; no)"
072 default CDATA #IMPLIED
073 label CDATA #FIXED "Keyed Receive Queue?"
074 >
075 <!ELEMENT DQReceiveKey (#PCDATA)>
076 <!ATTLIST DQReceiveKey
077 proptype CDATA #FIXED "string"
078 default CDATA #IMPLIED
079 label CDATA #FIXED "Receive Queue Key"
080 enabledBy CDATA #FIXED "DQReceiveKeyed(yes)"
081 >
082 <!ELEMENT DQReceiveQueueName (#PCDATA)>
083 <!ATTLIST DQReceiveQueueName
084 proptype CDATA #FIXED "string"
085 default CDATA #IMPLIED
086 label CDATA #FIXED "Receive Queue Name"
087 >
088 <!ELEMENT DQReceiveLibrary (#PCDATA)>
089 <!ATTLIST DQReceiveLibrary
090 proptype CDATA #FIXED "string"
091 default CDATA #IMPLIED
092 label CDATA #FIXED "Receive Queue Library"
093 >
094 <!ELEMENT DQReceiveWaitTime (#PCDATA)>
095 <!ATTLIST DQReceiveWaitTime
096 proptype CDATA #FIXED "string"
097 default CDATA #IMPLIED
098 label CDATA #FIXED "Receive Queue Wait Time"
099 >
100 <!ELEMENT pcmldocument (#PCDATA)>
101 <!ATTLIST pcmldocument
102 proptype CDATA #FIXED "file"
103 default CDATA #IMPLIED
104 label CDATA #FIXED "PCML Document"
105 enabledBy CDATA #FIXED "MessageType(pcml)"
106 >
107 <!ELEMENT docref (#PCDATA)>
108 <!ELEMENT field (field*)>
109 <!ATTLIST field
110 ref CDATA #REQUIRED
111 display (yes .vertline. no) #REQUIRED
112 label CDATA #IMPLIED
113 type (char .vertline. int .vertline. packed .vertline. zoned
.vertline. float .vertline. byte .vertline. struct) "char"
114 length CDATA #IMPLIED
115 precision CDATA #IMPLIED
116 repeating (Yes .vertline. No) "No"
117 countfield CDATA #IMPLIED
118 default CDATA #IMPLIED
119 >
A business partner or customer who desires to create an instance of the queue application access method 414c to pass a message to their application must define queue identification information and has a choice of specifying the message format as an XML document or as a structured buffer with PCML. Java Access Method: The Java access method 414a is used to call a user written Java method that in turn can call other java programs (local or remote) or access local or remote databases. The data available to this Java method (i.e., the method called by the Java access method 414a) may be defined by either a PCML or XML document, for example. The Java access method 414a is a special case access method that is different from the access methods 414a and 414c described above. The access methods 414a and 414c "drive" the mappings for applications and then invoke the back-end application 412 with a fully-resolved parameter list. This design is successful for those access methods 414 because they provide a consistent, generic way to describe the application interface (either via PCML and/or XML). For the Java access method 414a, this technique does not work because the Java parameters may be objects. Objects are more complex and do not facilitate a consistent generic way to describe the application interface such that all the diverse parameters types could be built. Thus, the Java access method 414a invokes a method that implements a specific Java interface (referred to as the "JavaConnectorInterface"). The method (herein referred to as the "Interface Method") that implements the interface then performs a set of functions allowing it to build the parameters to the targeted back-end application 412. Each Interface Method is configured with very specific "knowledge" of the interface to the targeted back-end application 412. The JavaConnectorInterface will pass in an Object (ConnectorParms) to the Interface Method that will contain methods allowing the Interface Method to get runtime data from/to the request/response messages. The properties for one embodiment of a Java access method 414a are shown in Table III.
TABLE III
001 <!ELEMENT connector (properties, input, output)>
002 <!ATTLIST connector
003 type NMTOKEN #FIXED "Java"
004 name CDATA #REQUIRED
005 >
006 <!ELEMENT properties (classname, pcmldocument)>
007 <!ELEMENT classname (#PCDATA)>
008 <!ELEMENT pcmldocument (#PCDATA)>
009 <!ELEMENT input (alias*)>
010 <!ATTLIST input
011 type (pcml) #REQUIRED
012 >
013 <!ELEMENT output (alias*)>
014 <!ATTLIST output
015 type (pcml) #REQUIRED
016 >
017 <!ELEMENT alias EMPTY>
018 <!ATTLIST alias
019 ref CDATA #REQUIRED
020 display (yes .vertline. no) #REQUIRED
021 label CDATA #IMPLIED
022 >
"Class name" contains the name of the Java class that implements the abstract interface that is defined. The PCML document contains a document that provides the interface specification for the target Java method. The Java access method 414A utilizes an interface class to describe the interaction between the Java access method 414A and a Java method. An illustrative interface class definition is shown in Table IV.
TABLE IV
001 public interface JavaConnectorInterface {
002 public JavaConnectorResult run (ConnectorParms parameters,
String 003 PCMLDocName);
004 }
005
006 public class JavaConnectorResult {
007 public int returncode;
008 public String returnstring;
009 }
An embodiment of the Java method that implements the Java connector interface is shown in Table V.
TABLE V
001 public class GeneralConnector
implements JavaConnectorInterface {
002 public JavaConnectorResult run (ConnectorParms parms, String
003 PCMLDocName {
004 /* get the list of input fields */
005 fields = parms.getinputfieldlist();
006 for (/* each field in the fieldlist */) {
007 /* repeat following section for each field data type */
008 {
009 /* get the field value by passing in the name attribute in the
010 field list entry; data type for field will correspond to
011 data type specified in the field list entry */
012 /* an array of values is returned */
013 For (/*each value in the arrays returned*/) {
014 /* use the value to set a parameter that will be passed
to the
015 target backend application */
016 }
017
018 }/* end for */
019 /* invoke the real back-end application */
020 /* get the list of output fields */
021 fields = parms.getoutputfieldlist();
022 for (/* each field in the fieldlist */) {
023 for (/*loop if multiple values */) {
024 /* get value generated by target application */
025 /* use value to update the field identified by the name attribute
in
026 the field list entry */
027 }/* end for */
028 }/* end for */
029 }
030 }
Specification Development A complete specification for servicing a given type of B2B request using one or more of the existing business application 412 is provided by a specification suite 415. The specification suite 415 is a collection of specification artifacts comprising Application Connector Documents (ACD) 416, Process Flow Models (PFM) 418 and Request/Response Message Formats (RMF) 420. ACDs, PFMs, and RMFs may be created by a variety of methods and entities. In one embodiment, the supplier system 304 includes a tool suite 413 adapted to create one or more of the artifacts included in the specification suite 415. The following description further describes aspects of ACDs, PFMs, and RMFs and describes embodiments for their creation. ACD: An ACD 416 provides an abstract and reusable interface definition for a particular business application 412. A given ACD is unique to a particular application 412, and provides the back-end flow manager the format of the messages and parameters the application 412 expects. Accordingly, the ACD enables use of that application 412 to service one or more types of B2B request. To that end, an ACD describes an access method instance. An "instance" is the coupling of an access method 414 with a description of the data to be processed by that access method 414, i.e., data passed to an application 412 or placed on the queuing mechanism 410. The "description of the data" includes the format of the messages and parameters expected by an application 412. One or more access method instances can be created for each access method 414. In one embodiment, ACDs 416 are XML documents that adhere to the Document Type Definition (DTD) defined for the appropriate access method 414. An ACD DTD exists for each of the supported access methods 414. An ACD for the Java access method 414a and the program call access method 414b indicate the name of the class or program to be called and a description of the parameters the access method expects to be passed. An ACD for the queue access method 414c indicates the name of the queue to use and the format of the message to place on that queue. In a particular embodiment, each ACD includes an ACD name, a type of ACD (i.e., the access method 414 this ACD is associated with), specific properties of the application 412 being accessed (such as system name, user-id and password to use), and the name of documents (referred to herein as input/output documents) that describe the input and output data for the application 412. Illustratively, the input/output documents are PCML or XML documents and may be created using an editor or authoring tool. An exemplary ACD 416 is shown in FIG. 5. The ACD 416 defines an encapsulation of a business application 412 or data source by defining both access method properties 502 and an interface model 504. The access method properties 502 describe how to access the application 412 and the interface model 504 describes what the application 412 expects for input and output. Further, the access method properties are information needed by the particular access method at runtime to invoke a target application. Illustratively, a plurality of properties 506.sub.1, 506.sub.2, . . . 506.sub.N, are shown, each comprising a name-value pair. The interface model 504 comprises an input interface 508 and an output interface 510. Each interface 508, 510 comprises a plurality of fields 512 and sub-fields 514 each, in turn, comprising a name-type pair. In general, the interfaces 508, 510 may be a suitable data schema 512 selected according to the application 412 to be accessed. Illustratively, the interfaces 508, 510 are XML documents or PCML documents. Illustratively, an ACD can specify default values for fields, hide/expose selected fields from/to a user during flow mapping (described in more detail below) and provide alias names for fields. A default value can be used for the contents of a field in the case where explicit mapping is not done as part of the mapping rules in a PFM 418. For example, a default value of 1 could be assigned to the quantity field for a purchase order item, for use when a specific quantity was not supplied with the purchase order request data. The ACD specifies for each field whether the field will be hidden from a user so as not to be confusing to the user. Thus, an ACD allows control over what portions of an application's interface are exposed (i.e., displayed for mapping purposes) in a graphical user interface (GUI). In one embodiment, if a field is to be exposed, alias names are provided for fields within the input/output documents that are modified at runtime (from data received in requests). The alias names provide a convenient expression of fields which is more intuitive than the original format defined by an application. These more intuitive alias names may then be used to advantage in the creation of PFMs 420. Development of an ACD for a particular application 412 may typically be done by a provider of a given application 412 or a business partner. Alternatively, it may be done by a service provider during configuration of a supplier's B2B software environment. Although an ACD can be manually created (e.g., using a text editor or XML editor), one embodiment provides an ACD Creation tool 424 (a component/function of the Business Process Editor 413B) to facilitate creation of ACDs. Regardless of the manner of creation, a completed ACD is then used for flow mapping. In one embodiment, the mapping rules are defined by a Process Flow Model (PFM) and a single ACD can be reused in multiple PFMs. One embodiment of an ACD (formatted as an XML document) for a PCML-based program call access method 414a is shown in TABLE VI.
TABLE VI
001 <?xml version="1.0" encoding="UTF-8"?>
002 <!DOCTYPE connector SYSTEM
003 "file://localhost/C:/B2BDTD/PgmConnector.dtd">
004 <connector name="OrderEntry" type="programcall">
005 <properties>
006 <system>rchas001</system>
007 <userid>rstevens</userid>
008 <password encrypt=yes>pwval</password>
009 <pcmldocument>orderentrypgm</pcmldocument>
010 </properties>
011 <input type="pcml">
012 <docref>orderentrypgm</docref>
013 <field display="yes" name="Item Number" ref="xyz.inum"/>
014 <field display="yes" name="Item
Quantity" ref="xyz.q" default="1"/>
015 </input>
016 <output type="pcml">
017 <docref>orderentrypgm</docref>
018 <field display="yes" name="Item Price" ref="xyz.p"/>
019 </output>
020 </connector>
RMF: An RMF 418 provides an interface definition of a message format given B2B request type (e.g., what are the input and output data flows for the request). In one embodiment, an RMF is an XML document. Regardless of the document type used for an RMF, an RMF generally provides an association (e.g., mapping) between the contents of a request and definitional information provided by the RMF. The association is then used to advantage by access methods 414 which access request and response information contained in the RMF without knowing the physical location of each field in a protocol-specific request. During retrieval and update operations the physical location of data is resolved from an RMF name field by the flow manager 408. Another feature of an RMF is filtering. Filtering refers to providing a view of or subsetting the complete data structure defined for a given B2B protocol. Some B2B protocols define a single request/response data schema for all types of requests supported by the protocol. cXML is an example of a protocol where a single XML DTD is used to describe data associated with all of the requests supported within the protocol. This places a burden on the business application which must determine which fields out of the overall data structure apply to each type of request. To obviate this need, a separate RMF may be defined for each request within a given protocol. The RMFs are configured to identify the specific set of elements and attributes within a given B2B schema that are used to service a particular type of B2B request. For example, the RMF for a purchase order request defines only the fields that apply to a purchase order request and does not include fields associated with other types of requests. In the case of XML-based message formats, a RMF may identify the XML DTD or schema associated with the request type and the subset of fields defined by the DTD or schema that are applicable for B2B requests of this type. Accordingly, RMFs eliminate the need to understand (by an application owner attempting to integrate existing applications with various request formats) which subset of a given request/response data structure applies to each type of request and simplifies the task of extending an existing business application to handle new B2B requests. Unlike back-end applications 412, which may require the knowledge of the owner to gain access, request/response message protocols are widely known (that is, generally known to the public). Thus, RMFs 418 for each B2B response/request type may be provided to the supplier system from a third party who need not be familiar with the implementation of the supplier system 304. FIG. 6 shows a diagram illustrating the structure of two RMFs and their relationship to a business application access method in order to allow for data interchange within a particular B2B protocol context. A schema 600 for an illustrative protocol "X" includes a plurality of Fields 1-4 and Sub-fields 2a-2b and 4a. A first RMF (RMF1) and a second RMF (RMF2) are configured to define particular request types for the protocol "X". In this case, the first is defined for a request type "A" and the second RMF are defined for a request type "B". Illustratively, the protocol "X" may be cXML and the request type A is a purchase order while the request type B is a order status inquiry. The first RMF comprises input definition 604 and output definition 606. Similarly, the second RMF comprises input definition 608 and output definition 610. Each of the input/output definitions map to the appropriate fields and sub-fields of the protocol schema 602. In this manner, a plurality of RMFs may be provided for a single B2B schema. In one embodiment, RMFs also allow more meaningful and intuitive field names to be associated with elements in a B2B request/response. Such a configuration provides a format more understandable to personnel provided with a B2B request/response, thereby facilitating the process of mapping a request/response to/from an existing business application 412. Additionally, RMFs may allow for the definition of a default value to be used for an output field in cases where explicit mapping is not as part of the explicit mapping rules in the PFM 420. Table VII shows one embodiment of an XML DTD which serves as the template for an RMF. Key elements defined in the RMF DTD (Table VII) are described in Table VIII.
TABLE VII
001 <!ELEMENT protocolmessageformat 002
(protocol,requestschema,responseschema)>
003 <!ATTLIST protocolmessageformat
004 version (1.0) #REQUIRED
005 >
006 <!ELEMENT protocol EMPTY>
007 <!ATTLIST protocol
008 name CDATA #REQUIRED
009 protocolversion CDATA #REQUIRED
010 transactiontype CDATA #REQUIRED
011 transactionsubtype CDATA #IMPLIED
012 >
013 <!ELEMENT requestschema (field*)>
014 <!ATTLIST requestschema
015 type (DTD) #REQUIRED
016 name CDATA #REQUIRED
017 >
018 <!ELEMENT responseschema (field*)>
019 <!ATTLIST responseschema
020 type (DTD) #REQUIRED
021 name CDATA #REQUIRED
022 >
023 <!ELEMENT field (field*)>
024 <!ATTLIST field
025 ref CDATA #REQUIRED
026 name CDATA #IMPLIED
027 default CDATA #IMPLIED
028 count (multiple .vertline. one) "one"
029 >
Table IX provides an example of an RMF. Illustratively, Table IX illustrates how a monetary amount may be represented in an RMF. In this case, money is qualified by a given currency and can also be represented in a different amount in another currency. In one embodiment, key components of an RMF field include label, ref, and context. "Label" is the abstract name by which access methods and the flow manager 408 refer to a given request or response field. Label also serves as the name of the field exposed to users through various tools, allowing a more intuitive name to be used for fields that are poorly named or described. "Ref" is the actual, physical location of the field within the request or response data structure supported by a given request type. "Context" indicates whether the field is part of the request or response data structure for the request type.
TABLE IX
001 <field context="Request" count="one" label="Money" ref
002 ="/cXML/Request/OrderRequest/OrderRequestHeader/
Shipping/Money">
003 <field context="Request" count="one" label="@currency" ref
004 ="/cXML/Request/OrderRequest/OrderRequestHeader/
Shipping/Money/@currency"/>
005 <field context="Request" count="one"
006 label="@alternateAmount" ref
007 ="/cXML/Request/OrderRequest/OrderRequestHeader/
Shipping/Money/@alternateAmount"/>
008 <field context="Request" count="one"
009 label="@alternateCurrency" ref
010 ="/cXML/Request/OrderRequest/OrderRequestHeader/
Shipping/Money/@alternateCurrency"/>
011 </field>
Table X provides RMFs supported in one embodiment. Illustratively, only Ariba and Metiom message formats are shown. However, any number of RFMs may be supported.
TABLE X
Ariba cXML message
format Metiom mXML message format
Retrieve ProfileRequest N/A
Server Response =
Capabilities ProfileResponse
New OrderRequest with PurchaseOrderMessage
Purchase type = new Response =
Order Response = Response PurchaseOrderAcknowledgement-
Message
Change OrderRequest with PurchaseOrderChangeRequest-
Purchase type = update or delete Message
Order Response = Response Response =
PurchaseOrderChangeRequest-
AcknowledgementMessage
Remote PunchOutSetupRe- N/A
Catalog quest with type =
Shopping create, edit, inspect
Request Response=
PunchOutSetupRe-
sponse
Shopping PunchOutOr- OrderRequestMessage
Basket derMessage
Content
Invoice N/A InvoiceMessage
PMF: Once an ACD has been defined for an application and an RMF provided for a given B2B request type, they can be referenced by a PFM 418 which serves to map a particular tope of B2B request to the application(s) which will be used to service these requests. Thus, a PFM defines the specific data flow and control flow semantics required to service a particular B2B request type using one or more business applications described by ACDs. In one embodiment, a PFM is an XML document which defines 1) the B2B protocol and type of request to be handled, 2) the business application(s) to be used to service the request (specified by an ACD 416), 3) rules for mapping data provided with the B2B request to input parameters supported by the servicing application(s) and 4) rules for mapping output data generated by the application(s) into the response message format prescribed by the particular B2B protocol/request type. A PFM and the ACDs referenced by a PFM provide a complete specification of the business applications 412 that are defined to service a particular class of B2B request and rules denoting how data is to be mapped between the formats provided with the B2B request to the formats supported by the servicing business applications. The PFMs 420 may be created by the creator of the ACD or others who will include a particular ACD. In one embodiment, the PFM is created using the Process Flow creation tool 426 (a component/function of the Business Process Editor 413B). The Process Flow creation tool 426 helps describe the mapping information by displaying the mappable fields in the incoming transaction requests, as defined by its RMF, and the mappable fields in the ACD and allowing a user to match the appropriate fields together. For example, a user may want to map the "PostalCode" field from the "BillTo/Address" of a cXML "OrderRequest" message to the "ZipCode" parameter of your "New Order" application. Tables XI and XII show an exemplary schema for a PFM and an example of a model defined for mapping order requests to a program call access method 414a, respectively.
TABLE XI
Process Flow Model DTD
001 <!ELEMENT processflowmodel (protocol, connector, inmap*,
outmap*)>
002 <!ELEMENT protocol>
003 <!ATTLIST protocol
004 name CDATA #REQUIRED
005 protocolversion CDATA #REQUIRED
006 transactiontype CDATA #REQUIRED
007 transactionsubtype CDATA #IMPLIED
008
009 >
010 <!ELEMENT connector EMPTY>
011 <!ATTLIST connector
012 acdref CDATA #REQUIRED
013 >
014 <!ELEMENT inmap EMPTY>
015 <!ATTLIST inmap
016 source CDATA #IMPLIED
017 target CDATA #REQUIRED
018 value CDATA #IMPLIED
019 >
020 <!ELEMENT outmap EMPTY>
021 <!ATTLIST outmap
022 source CDATA #REQUIRED
023 target CDATA #REQUIRED
024 >
Once the ACDs and PFMs are in place, the specification suite 415 is deployed to provide a runtime view of the artifacts. Deployment involves association of a PFM and one or more ACDs and occurs before receiving requests. In operation, the deployment of the specification suite 415 results in runtime metadata 422. In one embodiment, the runtime metadata 422 is an XML document and is structured in such a way as to provide efficient runtime processing. Once generated, the runtime metadata 422 is bound to (or associated with) an instance of a flow manager 408. The runtime metadata 422 may then be used by the flow manager to handle incoming requests and outbound responses of specified types. There are multiple pieces of information included in the runtime metadata 422. Illustratively, the runtime metadata 422 includes a request to flow mapping, a connector interface specification, a flow and response creating rules. The request to flow mapping uniquely describes the requests that should be handled by a particular process flow. The connector interface specification is the runtime view of the ACD. The flow consists of multiple steps that can be taken when handling a particular request. The flow also describes the field level mapping rules to be applied to each step. The response creating rules are non-protocol specific rules that allow the flow manager 408 to create a valid response document based on the information in the RMF 420. In one embodiment, the foregoing runtime metadata 422 components are defined as XML elements. FIG. 7 shows a runtime metadata document 700 containing runtime metadata 422 comprising the following XML elements: Selection 702, Flow 704, Steps 706, Connector 708, Property 710, Field 712, Mapin 714, Mapout 716, InsertSpec 718 and ConnectorInterface 720. Arrows denote references from one type of element to another. This represents a relationship between the two elements but does not imply that one element is necessarily contained within another. This allows multiple elements of one type (e.g., the Selection element 702) to reference the same element of another type (e.g., the Flow element 704). In other words, the same Flow element can be used by multiple protocol/request Selections. These elements are described in more detail below with reference to FIG. 11. To create the runtime metadata 422, one embodiment of the B2B environment 400 provides a process deployment tool 413A. Illustratively, the process deployment tool 413A is a component of the tool suite 413. The process deployment tool 413A may be any tool configured to convert the ACDs and PFMs into a runtime format that can be processed by the flow manager 408. In one embodiment, process deployment tool 413A is accessed from a browser session and allows a B2B request that is to be serviced to be uniquely identified. A request can be uniquely identified by the protocol being used (e.g., cXML, mXML), the marketplace it is received from (e.g., Ariba Network, Joe's Fishmarket), the specific Action/Subaction specified (e.g. OrderRequest), the buying organization submitting the request, and the supplier that this request is targeting. The unique request is then associated with a previously built PFM which identifies the ACD to be used and the field level mappings to take place. In one embodiment, a PFM can reference one ACD and therefore one back-end application 412. In another embodiment, a PFM can reference multiple ACDs which constitute a flow. This information is provided to the flow manager 408 as runtime metadata 422 for real-time processing. At this point, the supplier system 304 is ready to accept requests from various trading partners 302, call the appropriate back-end applications 412 and return responses. System Operation Development time, deployment and run time may be illustrated with reference to FIGS. 8-12. Referring first to FIG. 8 a method 800 for development and deployment of ACDs, PFMs, and RMFs is shown. To this end, method 800 shows a series of steps and indicates the data structures utilized in the execution of the steps. Method 800 is entered at step 802 when a user initiates execution of the tools 413. Method 800 then proceeds to step 804 where an ACD is created to define an instance of an access method 414. At step 806, a PFM is created to define a flow using the access method instance. At step 808, the ACD and the PFM are published to (i.e., sent to) a B2B instance server. In one embodiment, steps 804-808 employ the Business Process Editor 413B. At step 810, the PFM is associated with a request type and is then deployed to a B2B instance. That is, a PFM and its associated ACDs are transformed into runtime metadata. In one embodiment, step 810 employs the Process Deployment Tool. The flow manager 408 is now configured with the appropriate runtime metadata to handle a specified request type. The relationship between PFMs and a FlowMetaData document is further illustrated in FIG. 9. FIG. 9 shows a process flow correlating a development view 902 and a runtime view 904. The development view 902 includes a plurality of PFMs 906.sub.1, 906.sub.2, 906.sub.N . . . , each PFM being representative of a particular request type. Illustratively, an order request PFM 906.sub.1 and a punch out PFM 906.sub.2 are shown. A third PFM 906.sub.N indicates that any number of PFMs may be provided for. When deployed, the PMFs produce runtime metadata 908 configured to handle requests received from trading entities (e.g., trading partners). The overall operation of a B2B environment (such as the B2B environment 400 shown in FIG. 4) may be described with reference to FIG. 10. FIG. 10 shows a supplier system 1000 comprising a flow manager 1002, an application 1004 for servicing incoming requests and providing responses and a plurality of specification artifacts 1006. The specification artifacts 1006 comprise RMFs 1006A, PFMs 1006B and ACDs 1006C. The supplier system 1000 is configured to receive a request and provide an appropriate response to a requesting entity (e.g., a trading partner). In general, steps `A-D` represent development and deployment. At step `A` the appropriate RMF 1006A is identified according to a request protocol to be supported by the supplier system 1000. At step `B` an ACD 1006B is created to describe the interface to the application 1004. At step `C` the PFM 1006C correlating the request protocol with the appropriate application 1004 is created. Step `D` represents deployment at which point runtime metadata is generated from the RMF, PFM and ACD. Step `D` may be facilitated by a tool, such as the process deployment tool 413A shown in FIG. 4. The supplier system 1000 is now configured to receive requests. Steps `E-G` represent processing of a request. A request 1008 is received at step `E` and provided to the flow manager 1002 at step `F`. The flow manager 1002 processes the request according to predefined runtime metadata. The runtime metadata describes the sequence of applications to be invoked to handle the request, the access method used to invoke a particular application and how to transform data provided with the request into a format that is supported by each of the applications invoked to handle a request. At step `G` the application 1004 is invoked to process the request 1008. At this point the request is in a format understandable to the application 1004. The operation of the flow manager after being configured with runtime metadata may be illustrated in more detail with reference to FIG. 11 which shows a flow manager method 1100. Reference is also made to FIG. 7 which shows one embodiment a runtime metadata document 700. The method 1100 is entered at step 1102 and proceeds to step 1104 where the back-end flow manager reads a file (e.g. runtime metadata document 700) containing the runtime metadata. At step 1106, the flow manager stands by for a request from the gateway 406. When a request is received, the method takes steps to process the request according to the metadata 422. At step 1108, the flow manager locates a flow to determine what processing to perform for the request. In particular, the flow manager searches a selection element for a corresponding flow description element (Flow element). A flow description element specifies the set of applications to invoke to perform the processing of the request and the generation of the response. A flow description element contains a sequence of step elements. Each step element represents a description of how to invoke the application and indicates the next step to process after the current step is complete. The flow manager utilizes the step element to invoke the application and to locate the next step element when the current step element is complete. Accordingly, at step 1110, the flow manager enters a loop which is repeated for each step of the selected flow description element. At step 1111, the flow manager determines which application to invoke according to the selected flow. At step 1112, the appropriate access method 414 for the application is called. The access method 414 is defined by the ConnectorInterface element 720 (which also describes how to invoke the application). The ConnectorInterface element 720 contains the name of a Java class that implements an access method 414, the properties of the access method 414, a set of data about the input fields of an application 412 and a set of data about the output fields of the application 412. The ConnectorInterface is the part of the Connector element 708 that is specific to the application being invoked. It is the Runtime Metadata form of information found in an ACD. A Connector 708 contains a reference to a ConnectorInterface 720. In addition to this reference, a Connector 708 contains mapping rules which describe how data is mapped into and from the referenced ConnectorInterface 720. This allows a given ConnectorInterface 720 (which represents an ACD) to be used by a number of Connector instances, each with a different set of mapping rules targeting the same application. In other words, the same ConnectorInterface 720 can be used by one Connector 708 describing how data from cXML is mapped to the ConnectorInterface 720 and a second Connector 708 describing how mXML data is mapped to the same ConnectorInterface 720. When processing a step element, the flow manager reads the connector element 708 and invokes the access method (Program Call, Queue or Java) implementation that performs the mapping of the data. The access method implementation will use the Property elements 710 to set up the operating environment for the application. At step 1114, the access method implementation gets a list of input field elements that describe the input parameters (or message fields) that the application requires. At step 1116, the method 1100 enters a process (steps 1118 and 1120) performed for each field element in the list. At step 1118, the access method invokes a Mapin method. The Mapin method will take a Field element and find a corresponding Mapin element. The Mapin element will indicate where the value that this field is looking for is located at (i.e., the field in the request message). The Mapin method will retrieve that value, and perform any data type conversion that is required. Any necessary data type conversion is known because the Field element specifies what data type the application is expecting for this parameter. The Mapin method will return the value from the request message, in the proper data type, to the access method. At step 1120, the access method places the value in the appropriate place for the application to get access to it upon invocation. For example, the program call access method 414B will put the value in memory is a structure that the application will understand. When the program call access method invokes the application, it passes to the application the memory location. The method 1100 then returns to step 1116 to begin processing the next input field element. In this manner, the access method 414 continues processing Field elements, invoking Mapin methods to extract the values, until all the input Field elements have been processed. At step 1122, the access method 414 invokes the application in the access method specific technique. For example, the program call access method 414B will call the application passing in the memory location of the parameters, the queue access method 414C will put a message on a queue, etc. After the application is invoked, the access method 414 gets a list of output Field elements at step 1124. The output field elements provide the location of the output values to be located by the access method. At step 1126, then the access method starts processing the output fields one at a time. At step 1128, the access method then extracts the output value using the technique specific to that access method. Once the value for a field is extracted, the access method will invoke the Mapout method at step 1130. The Mapout method is configured to locate the corresponding Mapout element and the corresponding InsertSpec element. The Mapout element indicates where to store the value in the response message while the InsertSpec element indicates how to insert the value in the response message. The response message has a specific order for the fields that is specific to each B2B protocol. The InsertSpec element contains a specification of the field order of the response message and allows the access method to store output field values in the response message without concern for the order of the fields. Accordingly, the fields can be specified in an order that is independent of the response message. In this way, the Mapout method takes as input the value to store from the access method, then using the Mapout element and InsertSpec element, the Mapout method places the value in the appropriate place in the response message. This process (i.e., steps 1128 and 1130) is repeated for each output field element at which point the access method then returns to the flow manager and the method returns to step 1110. At step 1110, the flow manager then gets the next step to process from the Step element. When all step elements have been processed, the response message is placed on queue, at step 1132, to send to the gateway 404. A particular example of a flow manager operation is described with reference to FIG. 12. FIG. 12 shows supplier system 1200 configured to process a "price check" request. In general, the supplier system 1200 comprises a flow manager 1202, an access method 1204 and an application 1206. Illustratively, the incoming request 1208 is a "price check" formatted according to a protocol that the supplier system 1200 has already been configured to process. To this end, the flow manager 1202 is configured with metadata 1209 used to process the request 1208. Illustratively, the price check request 1208 includes an item field 1210, a quantity field 1212 and a price field 1214. The application 1206 has a corresponding item field 1216, quantity field 1218 and price field 1220. Upon receiving the request 1208, the flow manager 1202 refers to the metadata 1209 to determine a type/format of the request 1208, find the appropriate fields of the request 1208 to be accessed, call the appropriate access plan 1204, and then return information to fulfill the request 1208. Tools As described above, some embodiments employ tools for development and deployment of data structures and other artifacts of a supplier system. The following provides a description of some tools that may be used to advantage. It is understood that the tools described herein are merely illustrative and those skilled in the art will readily identify other methods and tools which may be used to the same end. FIGS. 13-14 show an embodiment of GUIs for the Business Process Editor Tool (BPET) 413B. In one embodiment, the BPET 413B is a Java GUI tool used to create and update information associated with access method instances (e.g., ACDs) and to create and update business process flow information (e.g., PFMs) designed to handle particular B2B requests. Illustratively, the BPET 413B may be configured to run on either a Windows NT or Windows 2000 client and can be used while connected via a TCP/IP network to the host that supports a B2B instance or in standalone mode where no connection exists to the host containing the supplier system runtime environment. A publish operation may be employed to transfer complete ACD or PFM definitions to a host where it can be deployed to a B2B instance running on that host. Illustratively, the BPET 413B is presented as a single GUI panel with separate tabs 1302 and 1304 used to navigate from an application access method edit mode to a process flow edit mode. FIG. 13 shows a BPET GUI 1300 when the when an application access method tab 1302 is selected. The application access method edit tab 1302 is used to capture information required to define an instance of an access method 414, including the properties and input/output fields supported by the access method instance. Table XIII shows information which can be specified using this interface.
TABLE XIII
GUI
Control
Name Description
Access Name associated with this access method instance. Names must be
Method unique since they are used to reference a given access method
Name instance from a business process flow (PFM).
Access Defines the type of access method for this access method
instance.
Method Specific properties and the type of input/output message
formats
allowed for the access method instance are defined by the
access
method. Selection of access method will affect the information
presented in the Properties and Documents sections. When
editing
an existing access method instance definition, the Access
Method
field will be disabled; thereby preventing a user from changing
the
access method for an existing access method instance.
Properties Name/value pairs defining information needed by a particular
access
method to service requests at runtime. The set of name/value
properties is specific to each access method type.
Documents Identifies an XML document or PCML document, for example, which
defines the input and output fields supported by the individual
access method instance. Input document defines the set of
fields
supported as input to the access method instance. Output
document
defines the set of fields that are returned by the access
method
instance. When PCML is used, the same document will typically
appear for both input and output. When document type is XML,
the
element and attribute names defined by the XML document
represent the candidate set of fields supported by the access
method instance. When the document type is PCML, the data and
structure elements defined by the PCML document represent the
candidate field set for the access method instance.
Field ID A hierarchical view showing the set of candidate input and
output fields
supported by the access method instance as defined by the
specified
input and output documents, respectively.
Name Used to assign a more intuitive name (e.g., an alias) to a
particular field
defined in either the input or output document for this access
method
instance. Values specified for Name will be displayed when
mapping B2B
request fields to access method fields on the Process Flow tab
of the
Business Process Editor.
Default Used to assign a default value to a particular field. Default
value is used if
field is not explicitly mapped from data contained in the
incoming B2B
request.
Display Used to control whether a field is displayed when mapping B2B
request
data to fields associated with the access method. Deselecting
display will
cause the field to be treated as "hidden" so that it won't be
displayed on
the Process Flow tab and cannot be the source or target for
data mapped
from the B2B request being handled by this access method
instance.
Table XIV shows illustrative actions that are available as menu options from the BPET GUI 1300 while the application access method tab 1302 is selected and while working with access method instances.
TABLE XIV
Menu Option Action
File -> New Create a new access method instance definition. Only
Name and Access Method will be shown until Access
Method is selected.
File -> Open . . . Bring up browse interface to locate pre-existing
access
method instance file for update.
File -> Save Save changes made to this access method instance.
File -> Save Bring up browser interface to select file name and lo-
As . . . cation to save this access method instance definition
under.
File -> Exit Exit the Business Process Editor.
Edit -> Cut Cuts the selected text to the system clipboard.
Edit -> Copy Copies the selected text to the system clipboard.
Edit -> Paste Pastes current text from a system clipboard to the
current cursor location.
Publish Select a host system and B2B instance to send a
completed PFM and access method instance
definitions to.
A publish operation stores the completed PFM and ac-
cess method instance definition on a B2B server from
which it can be deployed to the runtime environment.
Help Brings up online help for the Business Process Editor.
FIG. 14 shows the BPET GUI 1300 when a process flow edit tab 1304 is selected. The process flow tab 1304 is used to describe a process flow model, including the type of B2B request to be serviced, the ACD to be invoked to handle the request and information describing how data provided with the B2B request is mapped to input fields supported by the ACD and how data returned by the access method instance is mapped to the response data format supported by the particular B2B request. Illustrative information that can be specified using this interface is shown in Table XV. The menu options for the process flow section of the BPET GUI 1300 are the same as those provided when the application access method tab 1302 is active. (See Table XIV).
TABLE XV
GUI
Control
Name Description
Protocol Allows a user to choose the protocol to be serviced by this
process flow
definition.
Action The Action dropdown is based on the selected protocol. Allows a
user
to choose the action to be serviced by this process flow
definition.
Access This dropdown displays the list of available access method
instances.
Method Access method instances are defined using the Application
Access
Name method tab. Allows a user to choose the access method instance
that
will be used to handle B2B requests of the specified protocol
and
action.
Once an action and an access method are selected, the Load
button is
enabled. When the Load button is clicked:
I. The Request Fields and Response Fields in the Input Mappings
and Output Mappings sections are filled with the fields
associated
with the chosen protocol/action.
II. The Access Method Fields in the Input Mappings and Output
Mappings sections are filled with the fields associated with
the
chosen access method instance.
Input Shows the set of fields provided with this type of B2B request
and the
Mappings input fields supported by the specified access method instance.
User
may select a Request Field and an Access Method Field and click
Add
Mapping to indicate that the Request Field is to be mapped to
the
selected Access Method Field at runtime. This data mapping
association is displayed in the Mapping Table at the bottom of
the
Business Process Editor screen.
Output Shows the set of fields returned by the specified access method
and
Mappings the set of fields that make up the response message for this
type of
B2B request. User may select a Response Field and an Access
Method Field and click Add Mapping to indicate that the Access
Method Field is to be mapped to the selected Response Field at
runtime. This data mapping association is displayed in the
Mapping
Table at the bottom of the Business Process Editor screen.
Mapping This table lists all of the data mappings that have been
defined
Table between Request/Response data fields associated with this type
of
B2B request and the input and output fields associated with the
specified access method instance.
To remove a mapping from the table, select the row containing
the
mapping and click Remove.
To remove all mappings from the table, click Remove All. A
warning
message appears to confirm this operation.
FIGS. 15-17 show embodiments of GUIs for the Process Deployment Tool (PDT) 413A. Illustratively, the PDT GUIs are a web-based interfaces used to deploy a complete business process flow (PFM) and associated access method instance definition (ACD) into the runtime environment supporting a particular instance of a B2B server configured to process B2B requests. The PDT 413A runs within the context of a given B2B server instance, allowing the business process flows defined for that instance to be updated or extended. In essence, the PDT 413A will convert one or more PFM/ACD pairs into the runtime metadata format required by the Flow Manager responsible for handling incoming B2B requests within a given B2B server instance. A primary task in the deployment process is the association of a particular PFM with the B2B request the flow is designed to service. In one embodiment, requests can be qualified by B2B marketplace, B2B protocol, transaction type and subtype, buying organization and supplier. Thus, the act of deployment involves (1) user selection of values for all of the B2B request qualifiers (e.g., protocol, protocol version, marketplace, request type, buyer and supplier), (2) user identification of the business process flow (PFM) that will handle these requests, (3) generation of runtime metadata representing these selections and (4)storage of this information in the runtime environment associated with the B2B instance. These four (4) steps are supported by one embodiment of the PDT 413A. In one embodiment, a wizard-like interface is provided to walk a user through the set of selections required to deploy a new PFM or to view the set of current PFM that are currently defined to a B2B instance. An embodiment of the "wizard-like interface" is illustrated with respect to FIGS. 15-17. A protocol selection screen 1500 of the wizard for the PDT 413A, shown in FIG. 15, allows a particular B2B protocol to be selected. Only those protocols supported by a B2B instance will be shown to the user. Illustratively, a protocol selection window 1502 shows Ariba and Metiom as available protocols. Clicking on the "Next" button on the protocol selection screen 1500 will bring up a marketplace selection screen where a particular marketplace supporting the chosen protocol can be selected. An illustrative marketplace selection screen 1600 is shown in FIG. 16. Only those marketplaces for the selected protocol will be shown in the marketplace list on this screen. The available marketplaces may be shown by clicking on a dropdown button 1604 of a marketplace selection window 1602. Once marketplace is chosen, clicking on the "Next" button on the marketplace selection screen 1600 will bring up a market configuration screen. An illustrative market configuration screen 1700 is shown in FIG. 17. The market configuration screen 1700 provides a configuration window 1701 which includes a request list 1702 of B2B requests that are currently supported for the selected marketplace and a PFM column 1704 (titled "Operation (Flow)") identifying the PFM specified to handle each request. For a newly defined marketplace, the request list 1702 initially contains a transaction column 1706 and a subtype column 1708 for the set of B2B transaction types/subtypes defined by the B2B protocol associated with marketplace. Only those transaction types/subtypes enabled for the current B2B instance are shown. Clicking an "Advanced" button displays a buyer column 1712 and a seller column 1714. The columns 1712 and 1714 provide a list of buying organizations and supplier organizations, respectively, that are authorized to conduct commerce within a given marketplace. Accordingly, association of PFMs specific to a given buyer/supplier relationship is provided, thereby allowing definition of one PFM for one buyer/supplier pair and another PFM for another buyer/supplier pair. For example, one PFM may be defined for a large corporate buyer and another PFM may be defined for a sole proprietor. In one embodiment, the buyer and supplier settings will be defaulted to *ALL, and the corresponding PFM entry in the PFM column 1704 will be empty since no business process flows have yet been identified to handle B2B requests from this marketplace. Defaulting to *ALL means the specified PFM will apply to request associated with all buyers and all suppliers. From this initial screen, the user may select a PFM from the PFM column 1704 to handle a given request type. Only those PFMs that have been published to the B2B instance server and which support the selected B2B request type will be shown to the user for selection. Once a PFM has been selected, the user may enable or disable handling of the B2B request by using the checkbox provided in a checkbox column 1710. The Advanced button can be used if the user wishes to qualify the selected PFM based on the buyer organization and/or supplier associated with the B2B request. In one embodiment, only associations between buyer organization and supplier that have been previously specified will be allowed. Specification of specific buyer organization or supplier to qualify a B2B request will result in a new row in the configuration window 1701, allowing a different PFM to be defined for a given buyer organization/supplier pair than that used for similar requests between other buyers and suppliers. Once all changes have been made on this screen, a "Deploy" button is used to deploy these B2B request-to-PFM selections to the runtime environment for the current B2B instance. While the foregoing is directed to the preferred embodiment of the present invention, other and further embodiments of the invention may be devised without departing from the basic scope thereof, and the scope thereof is determined by the claims that follow.
|
Same subclass Same class Consider this |
||||||||||
