In the previous two episodes in this series we described the position of Java in the Telecommunications industry, Telemanagement Forum and the basics of OSS/J. This episode focuses on the Order Management API (JSR 264), this is one of the OSS/J APIs being developed using the JCP process (proposed final draft 2 will be released May/June ’07). It is also the API we covered during last weeks session at JavaOne.

Order management is a common process and virtually every organization does some sort of order management to ensure that it can process requests from it’s customers and deliver the requested product (for example book, car, drivers license) or service (for example telephony, health insurance, TV). The Order Management API is (as far as we know) the only open and standards based API available for order management and therefore is relevant for many organizations developing an order management solution (not telecommunications only). By using this API as a basis for your order management solution you can reuse the knowledge of others (not reinventing the wheel) and reduce your integration costs.

The key features are:

  • Supports both simple and complex use cases

  • Supports long running transactions

  • Defines the managed entities on which the Order Management operations work (Order, OrderItems, etc). These are extended from the Telemanagement Forums Shared Information/Data Model, the items used from the TMF SID are the non Telecommunications specific ones.

  • Defines the (extendible) state model for Orders.

  • Support for creation, starting, updating and removing Orders.

  • Support for bulk operations to create, update, remove orders. These are available in an atomic (all must succeed) or best effort (failing ones will be reported back) flavor.

  • Support for notification to keep clients informed of progress of an Order (not only clients that submitted an order but also other interested clients).

  • Notifications that requests the client for validation of certain aspects of the order (before it continues processing).

  • Notifications that requests the client for additional input (before it continues processing).

  • Extensibility. The types of orders (and all contents) and the order states can be extended for your specific needs.

  • Flexible query possibilities like query by key, query based on a template and defining named queries (comparable to JDBC Prepared Statements).

  • Support for static and dynamic typing of attributes of an Order.

  • Support meta-operations that (for example) enable a client to discover at runtime what orders are available.

The Order Management API is not bound to telecommunications specific orders. The API allows for definition of your own order types and and thus can be customized to the specific needs of other industries. To ensure that the operations exposed by the Order Management API are not bound to any specific industry, a generic type ‘Request’ is defined. This Request type is the supertype of all Orders and all Order Management API operations operate on Requests. It is possible to define your own Order types as subtype of Request, or as subtype of one of the four predefined Request subtypes: ProductOrder, ServiceOrder, ResourceOrder, WorkOrder (the latter requires human intervention).

“All nice and dandy”, I hear you think, “but can’t I achieve the same with BPEL?”. From a functional perspective you could realize the same functionality with BPEL (or many other technologies), however you would be inventing you own API instead of building on a standards based one. For example, BPEL will not give the standardized information model, state model or set of operations. You would need to define them yourself and thus you’re creating a proprietary solution. The advantage of reduction in integration costs is lost.

<meta name="GENERATOR" content=" 2.0 (Linux)" /><meta name="AUTHOR" content="Gero Vermaas" /><meta name="CREATED" content="20070329;13524000" /><meta name="CHANGEDBY" content="Gero Vermaas" /><meta name="CHANGED" content="20070514;14401000" /> </p> <style type="text/css"> <!-- @page { size: 8.5in 11in; margin: 0.79in } P { margin-bottom: 0.08in } --> </style> <p style="margin-bottom: 0in">The Order Management API does not attempt to boil the ocean, the following items are out-of-scope and not defined in the API:</p> <ul> <li> <p style="margin-bottom: 0in">Workforce management: Management of staff, schedules etc. is not part of Order Management.</p> </li> <li> <p style="margin-bottom: 0in">Inventory Management: There is a separate Inventory API defining this (JSR 142). Because the will often be a close relation between Order Management and Inventory it can make sense to implement both APIs in one product. Both APIs build on the same OSS/J concepts and interaction is smooth.</p> </li> <li> <p style="margin-bottom: 0in">Order decomposition: This is implementation specific and cannot be defined in the API.</p> </li> </ul> <p style="margin-bottom: 0in">This blog entry roughly covers the first part of the <a href="">presentation </a>we did at JavaOne, the second part was answering the question “How does the Order Management API fit into a Service Oriented Architecture?”. Guess what the subject of the next entry in this series will be…</p> <div class="info-box"> <strong>Do you want to know more about this subject?</strong><br> Look at our consultancy services, training offers and careers below or contact us at <a href=""></a> </div> <div class="links-block"> <div class="links-container"> <h3><a href="">Services</a></h3> <ul> <li><a href="">Digital Transformation</a></li> <li><a href="">Agile Consultancy & Coaching</a></li> <li><a href="">Cloud Services</a></li> <li><a href="">DevOps Consulting</a></li> <li><a href="">Data & AI</a></li> <li><a href="">Digital Assurance</a></li> <li><a href="">Software Development</a></li> <li><a href="">Product Management</a></li> <li><a href="">Security</a></li> </ul> </div> <div class="links-container"> <h3><a href="">Training offers</a></h3> <ul class="sub-nav"> <li><a href="">Agile Methodology & Scaling</a></li> <li><a href="">Product Owner</a></li> <li><a href="">Scrum Master</a></li> <li><a href="">Cloud Technology</a></li> <li><a href="">Data Engineering</a></li> <li><a href="">Data Science</a></li> <li><a href="">DevOps</a></li> <li><a href="">Developer Skills</a></li> <li><a href="">Kanban Method</a></li> <li><a href="">Microsoft</a></li> <li><a href="">Quality & Test Automation</a></li> <li><a href="">Security</a></li> <li><a href="">In-Company Training</a></li> <li><a href="">All Courses</a></li> </ul> </div> <div class="links-container"> <h3><a href="">Careers</a></h3> <ul> <li><a href="">Find a job</a></li> <li><a href="">Working at Xebia</a></li> </ul> </div> </div> <div class="post-nav pagination"> <div class="row"> <div class="col-md-6"><a href="" rel="prev"><h4>← Previous post</h4><p>Xebia Podcast is now live:</p></a></div> <div class="col-md-6 text-right"><a href="" rel="next"><h4>Next post →</h4><p>Podcast episode 2 online: Scrum Introduction part 1</p></a></div> </div> </div> </div> <div id="comments" class="post-comments"> <h3 class="title">Comments</h3> <div class="pingback even thread-even depth-1" id="comment-18100"> <div class="comment-author vcard"> <cite class="fn"><a href='' rel='external nofollow ugc' class='url'>Xebia Blog</a></cite> <span class="says">says:</span> </div> <div class="comment-meta commentmetadata"><a href=""> September 25, 2007 at 9:03 am </a> </div> <p>[…] The Order Management API 1.0 has been released. The Order Management API is (as far as we in the JSR264 Expert Group (EG) know) the only open and standards based API available for order management and is relevant for any organization developing an order management solution. By using this API as a basis for your Order Management solution you can reuse the knowledge of others (not reinventing the wheel), reduce your integration costs and create a flexible Order Management solution. In a previous blog post I already described the features of the API in detail, so I’ll just repeat the most important features: […]</p> <div class="reply"><a rel='nofollow' class='comment-reply-link' href='' data-commentid="18100" data-postid="228" data-belowelement="comment-18100" data-respondelement="respond" aria-label='Reply to Xebia Blog'>Reply</a></div> </div><!-- #comment-## --> </div> <!-- comments --> <div id="respond" class="comment-respond"> <h3 id="reply-title" class="comment-reply-title">Leave a comment on this blogpost <small><a rel="nofollow" id="cancel-comment-reply-link" href="/blog/java-in-telecommunications-%E2%80%93-order-management-api/#respond" style="display:none;">Cancel reply</a></small></h3><form action="" method="post" id="commentform" class="comment-form"><p class="comment-notes"><span id="email-notes">Your email address will not be published.</span> Required fields are marked <span class="required">*</span></p><p class="comment-form-comment"><label for="comment">Comment</label> <textarea id="comment" name="comment" cols="45" rows="8" maxlength="65525" required="required"></textarea></p><p class="comment-form-author"><label for="author">Name <span class="required">*</span></label> <input id="author" name="author" type="text" value="" size="30" maxlength="245" required='required' /></p> <p class="comment-form-email"><label for="email">Email <span class="required">*</span></label> <input id="email" name="email" type="text" value="" size="30" maxlength="100" aria-describedby="email-notes" required='required' /></p> <p class="comment-form-url"><label for="url">Website</label> <input id="url" name="url" type="text" value="" size="30" maxlength="200" /></p> <p class="comment-form-cookies-consent"><input id="wp-comment-cookies-consent" name="wp-comment-cookies-consent" type="checkbox" value="yes" /> <label for="wp-comment-cookies-consent">Save my name, email, and website in this browser for the next time I comment.</label></p> <p class="form-submit"><input name="submit" type="submit" id="submit" class="submit" value="Post Comment" /> <input type='hidden' name='comment_post_ID' value='228' id='comment_post_ID' /> <input type='hidden' name='comment_parent' id='comment_parent' value='0' /> </p><p style="display: none;"><input type="hidden" id="akismet_comment_nonce" name="akismet_comment_nonce" value="8f7d8dd93f" /></p><p style="display: none;"><input type="hidden" id="ak_js" name="ak_js" value="244"/></p></form> </div><!-- #respond --> </article> </div> </div> </div> </div> <footer class="footer" id="contact"> <div class="container"> <a href=""> <div class="label"> <svg version="1.1" id="Laag_1" xmlns="" xmlns:xlink="" x="0px" y="0px" viewBox="0 286 625 220" enable-background="new 0 286 625 220" xml:space="preserve"> <g> <g> <path fill="#FFFFFF" d="M301.6,387.6h-57.1c3.5-12.9,15.2-21.4,27.6-21.4C287.5,366.2,297.7,373.8,301.6,387.6 M244.2,407.2H328 c0-1.8,0-3.5,0-5.3c0-13.8-3.2-24.9-9.7-34.3c-11.1-14.7-27.6-23.7-45.4-23.7c-14.3,0-28.1,6.2-38.7,17.3 c-9.7,10.3-14.7,23.2-14.7,37.8c0,13.8,5.8,28.1,15.6,38.4c10.8,10.8,23.7,16.1,39.3,16.1c23.2,0,41.6-12.9,50.4-35.7h-26.3 c-5,8.5-14.3,12.9-24.9,12.9C256.5,431.3,245.4,421.9,244.2,407.2"></path> <path fill="#FFFFFF" d="M365.8,400c0-17.9,12.9-31.3,29.9-31.3c17,0,30.4,14.3,30.4,30.8c0,17.3-12.9,30.8-31.7,30.8 C379.3,430.4,365.8,417,365.8,400 M364.9,355.4v-41.9h-24v138.3h24v-8.5c9.7,7.6,20.2,11.1,32.5,11.1c13.4,0,24.9-4.4,34.3-12 c12.6-10.8,19.6-26.3,19.6-42.8c0-15.2-6.2-30.4-17.9-40.7c-9.7-9.4-22.3-13.8-36.1-13.8C384.6,344.8,374.3,347.8,364.9,355.4"></path> <path fill="#FFFFFF" d="M468,347.5h23.2v104.3H468V347.5z M468,313.5h23.2v23.2H468V313.5z"></path> <path fill="#FFFFFF" d="M531.9,398.2c0-17,13.4-29.9,29.9-29.9c15.2,0,29.4,13.4,29.4,31.3c0,16.1-13.8,29.9-29,29.9 C545.7,429.5,531.9,416.6,531.9,398.2 M593.9,451.8h23.2V347.5h-23.2V360c-7.1-10.3-17.9-15.2-33.1-15.2c-15.6,0-28.1,5-38.7,16.1 c-9.7,10.3-14.7,23.7-14.7,38.4c0,31.3,23.2,54.8,53.9,54.8c16.1,0,26.7-4.4,32.5-15.2V451.8z"></path> </g> <polygon fill="#FFFFFF" points="6,497.2 69.6,497.2 138.4,428.6 207,497.2 271.4,497.2 170.6,396.4 272.3,294.8 207.9,294.8 138.4,364.4 69.3,294.8 5.1,294.8 106.2,396.4"></polygon> </g> </svg> </div> </a> <div class="contact"> <h3><a href="">Contact</a></h3> <p> Xebia Group<br> Amsterdam HQ<br> The Netherlands<br> <span>E:</span> <a href=""></a><br> <span>T:</span> <a href="tel:+31(0)355381921">+31 (0)35 538 1921</a> </p> <div class="social"> <ul> <li> <a href="" target="_blank"> <svg xmlns="" xmlns:xlink="" x="0px" y="0px" width="64px" height="64px" viewBox="0 0 64 64"> <g> <path d="M61.3,0H2.7C1.2,0,0,1.2,0,2.7v58.7C0,62.8,1.2,64,2.7,64h58.7c1.5,0,2.7-1.2,2.7-2.7V2.7 C64,1.2,62.8,0,61.3,0z M19,54.5H9.5V24H19V54.5z M14.2,19.8c-3,0-5.5-2.5-5.5-5.5c0-3,2.5-5.5,5.5-5.5c3,0,5.5,2.5,5.5,5.5 C19.7,17.4,17.3,19.8,14.2,19.8z M54.5,54.5H45V39.7c0-3.5-0.1-8.1-4.9-8.1c-4.9,0-5.7,3.9-5.7,7.8v15.1h-9.5V24H34v4.2h0.1 c1.3-2.4,4.4-4.9,9-4.9c9.6,0,11.4,6.3,11.4,14.5V54.5z"></path> </g> </svg> </a> </li> <li> <a href="" target="_blank"> <svg xmlns="" xmlns:xlink="" x="0px" y="0px" width="64px" height="64px" viewBox="0 0 64 64"> <g> <path d="M64,12.2c-2.4,1-4.9,1.8-7.5,2.1c2.7-1.6,4.8-4.2,5.8-7.3c-2.5,1.5-5.3,2.6-8.3,3.2C51.5,7.6,48.1,6,44.3,6 c-7.3,0-13.1,5.9-13.1,13.1c0,1,0.1,2,0.3,3C20.6,21.6,10.9,16.3,4.5,8.4c-1.1,1.9-1.8,4.2-1.8,6.6c0,4.6,2.3,8.6,5.8,10.9 c-2.2-0.1-4.2-0.7-5.9-1.6c0,0.1,0,0.1,0,0.2c0,6.4,4.5,11.7,10.5,12.9c-1.1,0.3-2.3,0.5-3.5,0.5c-0.8,0-1.7-0.1-2.5-0.2 c1.7,5.2,6.5,9,12.3,9.1c-4.5,3.5-10.2,5.6-16.3,5.6c-1.1,0-2.1-0.1-3.1-0.2C5.8,55.8,12.7,58,20.1,58c24.2,0,37.4-20,37.4-37.4 c0-0.6,0-1.1,0-1.7C60,17.1,62.2,14.8,64,12.2z"></path> </g> </svg> </a> </li> <li> <a href="" target="_blank"> <svg xmlns="" xmlns:xlink="" x="0px" y="0px" width="64px" height="64px" viewBox="0 0 64 64"> <g> <path d="M61.3,0H2.7C1.2,0,0,1.2,0,2.7v58.7C0,62.8,1.2,64,2.7,64H34V40h-8V30h8v-8 c0-8.3,5.2-12.3,12.6-12.3c3.5,0,6.6,0.3,7.5,0.4v8.6l-5.1,0c-4,0-4.9,1.9-4.9,4.7V30h10l-2,10h-8l0.2,24h17.2 c1.5,0,2.7-1.2,2.7-2.7V2.7C64,1.2,62.8,0,61.3,0z"></path> </g> </svg> </a> </li> <li> <a href="" target="_blank"> <svg version="1.1" xmlns="" xmlns:xlink="" x="0px" y="0px" viewBox="0 0 48 48" xml:space="preserve" width="64" height="64"> <g class="nc-icon-wrapper" fill="#9d92b2"> <path fill="#9d92b2" d="M24,4.324c6.408,0,7.167,0.024,9.698,0.14c2.731,0.125,5.266,0.672,7.216,2.622 c1.95,1.95,2.497,4.485,2.622,7.216c0.115,2.531,0.14,3.29,0.14,9.698s-0.024,7.167-0.14,9.698 c-0.125,2.731-0.672,5.266-2.622,7.216c-1.95,1.95-4.485,2.497-7.216,2.622c-2.53,0.115-3.289,0.14-9.698,0.14 s-7.168-0.024-9.698-0.14c-2.731-0.125-5.266-0.672-7.216-2.622c-1.95-1.95-2.497-4.485-2.622-7.216 c-0.115-2.531-0.14-3.29-0.14-9.698s0.024-7.167,0.14-9.698c0.125-2.731,0.672-5.266,2.622-7.216c1.95-1.95,4.485-2.497,7.216-2.622 C16.833,4.349,17.592,4.324,24,4.324 M24,0c-6.518,0-7.335,0.028-9.895,0.144c-3.9,0.178-7.326,1.133-10.077,3.884 c-2.75,2.75-3.706,6.175-3.884,10.077C0.028,16.665,0,17.482,0,24c0,6.518,0.028,7.335,0.144,9.895 c0.178,3.9,1.133,7.326,3.884,10.077c2.75,2.75,6.175,3.706,10.077,3.884C16.665,47.972,17.482,48,24,48s7.335-0.028,9.895-0.144 c3.899-0.178,7.326-1.133,10.077-3.884c2.75-2.75,3.706-6.175,3.884-10.077C47.972,31.335,48,30.518,48,24s-0.028-7.335-0.144-9.895 c-0.178-3.9-1.133-7.326-3.884-10.077c-2.75-2.75-6.175-3.706-10.077-3.884C31.335,0.028,30.518,0,24,0L24,0z"></path> <path data-color="color-2" fill="#9d92b2" d="M24,11.676c-6.807,0-12.324,5.518-12.324,12.324S17.193,36.324,24,36.324 S36.324,30.807,36.324,24S30.807,11.676,24,11.676z M24,32c-4.418,0-8-3.582-8-8s3.582-8,8-8s8,3.582,8,8S28.418,32,24,32z"></path> <circle data-color="color-2" fill="#9d92b2" cx="36.811" cy="11.189" r="2.88"></circle> </g> </svg> </a> </li> <li> <a href="" target="_blank"> <svg id="Layer_1" data-name="Layer 1" xmlns="" viewBox="0 0 176 124"><defs><style>.cls-1{fill:#9d92b2;}.cls-2{fill: rgb(49,23,46);}</style></defs><title>yt_icon_mono_light