Latest Update: For those of you who don’t have a NWDS yet I’ve added a few more samples as attachments for you to look at instead.

Roll up Roll up get your free Enterprise Integration Pattern models here… ok so now that I’ve got your attention…  most people like free stuff, and we have some free stuff to help those of you who are getting into the wonderful world of SAP NetWeaver Process Orchestration.  Here’s a sample:

Claim_Check_Pattern.jpg

 

What are Enterprise Integration Patterns for?

Enterprise Integration Patterns (EIP) help in solving recurring problems faced in the integration of enterprise applications.

 

What does it take to put Enterprise Integration Patterns in place?

 

Most patterns consist of a mix of SAP NetWeaver PI Integration Flow (iFlow) configurations and SAP NetWeaver BPM process implementations… in other words they rely on the power of SAP NetWeaver Process Orchestration which combines both of these technologies.

Why have these models been created?

We’ve noticed that a lot of customers, partners and even SAP employees who are coming into SAP NetWeaver Process Orchestration are coming from a SAP NetWeaver PI background.  As such, we’re seeing people pick up the Integration Flows fairly quickly – as many of the concepts haven’t changed that much so it’s mostly about getting used to a new, more graphical editor.   However the BPM process models are very different to the old ccBPM models in earlier releases of PI.  Even though the BPMN notation is comparatively straightforward to understand, wrapping your head around how to organize the processes to achieve certain integration goals can take a while.

Now, the guys back in the lab (SAP Labs, that is) do hope to provide working (complete, executable) examples of the patterns as soon as they can, but that’s going to take a little while as a full pattern has many dependencies – WSDLs to create, adapters to be configured, many individual objects to be created and then mapped together, not to mention the server and release dependencies, and there’s the odd other project or two they need to work on in the meantime, such as features for the next release.   We expect the working examples will be offered as a follow up to Abdul-Gafoor Mohamed’s (ably assisted by Prashant Gautam) excellent blogs on the Enterprise Patterns when they are ready.

However in the meantime, having had a few discussions and a bit of back and forth with the guys, and with several reviews from the leading lights in this area especially Volker Stiehl, but also Alexander Bundschuh, Joachim Bayer and Martin Moeller, we’re offering a set of REFERENCE MODELS ONLY that you can import into NWDS to help with getting started with Enterprise Integration Patterns in Process Orchestration or as a quick start for creating your own processes.

The aim of these reference models only is to: 

  • Demonstrate how to build the patterns in BPMN notation
  • Provide some guidance through annotations and step descriptions on details and options
  • Act as a quick start for creating your own executable processes by importing the patterns into your own Process Composer projects

PLEASE NOTE: These are NOT executable models and not intended to be executable – they are reference models only.   To make them into complete executable processes you would need to add your WSDLs, mappings, and integration flows.

What’s included in these models?

All of the Enterprise Patterns released in SAP NetWeaver Process Orchestration 7.3 EHP1 SP04 to SP06 (yes we’ve included the Conditional Start pattern).   We’ve also included variations – e.g. how to control aggregation with a counter vs. controlling aggregation with a timer. 

You’ll notice lots of annotations with explanatory notes – we’ve even indicated where perhaps for simple scenarios you might want to not use a BPMN model at all but handle the pattern entirely in Integration Flows.

In the title of each process pool we’ve indicated the minimum release required.

patterns - release required.JPG

And make sure you read the step descriptions of each step – these contain additional details, such as for Claim Check the specific Service Interface and Operation required to complete the Retrieve Messages from Database step.

Patterns - step additional info.JPG

How do you use the models?

First step is to pull the models into your own NWDS.  The models have been created in NWDS release 7.3 EHP1 SP05 – but because they are models only you should be able to pull them into any NWDS that offers the BPMN import.

  1. Download the zip file of the Enterprise Patterns reference models, unzip it and save the SCA file to your local network
  2. Open your NWDS
  3. Go to the Development Infrastructure Perspective
  4. Using the context menu on LocalDevelopment choose the option Import SC to select and import the SCA file you have downloaded.
  5. The Software Component EAI_PATTERNS will then appear under LocalDevelopment.

The next step is to view the models.

To view the models expand the Software Component EAI_PATTERNS and use the context menu to Create Project for the DC eai_patterns_samples. Most importantly DO NOT go to the Associated Perspective yet. Just create the project.  This is because the associated perspective is the Process Development perspective and because these are models only, if you go there you will see a whole bunch of “please complete me” errors for the processes.

Instead use the menu Window > Open Perspective > Other…  to choose and open  the Process Modeling Perspective.

Expand the project [LocalDevelopment] eai_pattern_samples to find all the reference models in the Processes folder under Process Modeling.  You can then double-click on any pattern to view the details.

Finally if you want to use a pattern as a quick start for your own process, just use the context menu on the relevant process pattern to export it in BPMN 2.0 format and store the exported file somewhere on your local network. 

Patterns - exporting.jpg

Then expand your own Process Composer Project, and use the context menu on the Processes folder (in your own project) to import the BPMN 2.0 file into your own project.  Don’t forget to rename the process!

Patterns -importing 2.jpg

BTW because these are reference models they were deliberately created in Draft status.  So before you complete the pattern in your own project, put your cursor anywhere in the drawing area outside the process pool and in the Properties pane General tab you will see the model is in Release Status: Draft.
Press the Release to Build button to take it out of draft status and then you are free to complete the pattern.   Just remember that at this point you will also start seeing all the “please complete me” errors, which will help guide you to what you need to provide to make the process executable.

And Finally…

Remember these are REFERENCE MODELS ONLY – use them to help you understand how the Enterprise Patterns should be described in BPMN and to
quick start your own processes.  Just remember to ignore any errors or warnings you see on the models if you happen to view them using the Process Development perspective, instead of the Process Modeling perspective.

Enjoy!   And please let us know if you find them useful.

To report this post you need to login first.

30 Comments

You must be Logged on to comment or reply to a post.

  1. Susan Keohan

    Great stuff, Jocelyn!  The steps for importing these reference pattern models are excellent – I am sure many SCN folks will find this really useful.

    Keep up the great work!
    Sue

    (0) 
    1. Jocelyn Dart Post author

      Thanks Sue. Appreciate the vote of confidence. I always figure if something is confusing for me I’m probably not alone (Deferred event gateway still does my head in). Volker was very generous with his help and its great to have the opportunity to pay it forward.

      (0) 
      1. deva Gembali

        Dear Jocelyn,

             Looks Great but i am unable to find the proper pattern for my scenario. We are using SP4, There is one conditional Process start, is this pattern useful if two conditional based files coming from  source and map to target side (n:1 mapping).

        In BPM, i couldn’t find any proper functions in mapping like look-ups, remove-context, split-by-value , udf s , etc …..

        What is the use of this edition ?

        Regards,

        Deva

        (0) 
  2. Jason Scott

    Great stuff Jocelyn. Next we just need these into the ‘Create new iFlow’ wizard in NWDS.   😉

    Maybe one day the modelling of BPM Processing and iFlows will be combined so that you can see the one consolidated view for your integration.

    (0) 
    1. Jocelyn Dart Post author

      Hey Jason, Thanks for the feedback! And again I say * Idea Place *

      Actually the iFlows do have some wizard-like options already – when you create one from scratch you get options for using templates such as point-to-point, dynamic routing, etc.

      But yes it would be pretty cool to be able to see all 3 architecture layers – as recommended by Volker Stiehl – in the one place… hmmm perhaps a job for the Composite Designer?   Or at least a template PI to BPM, BPM to PI which sets up the XI 3.0 and SOAP settings for you.

      Feel free to suggest it in * Idea Place * and let me know and I’ll vote it up!

      (0) 
      1. Manish Singh

        Hi Jocelyn

        Very good stuff, the one thing i would like to add a error handling framework, Netweaver BPM has this shortcoming eg generating an event on mapping error etc.

        (0) 
        1. Jocelyn Dart Post author

          Thanks Manish, that’s a nice idea. You can usually just do that through a boundary event if you really want to model exceptions.  There’s often also a case for sending errors to a forward error handling framework.

          However I agree when it comes to mapping it would be useful to be able to capture mapping exceptions rather than just have the process fail – particularly for null pointer exception errors.

          Would you please raise your idea in the Idea Place and send us the link so we can vote on it.

          Thanks again

          Jocelyn

          (0) 
  3. Matt Harding

    Hi Jocelyn,

    Where do you find the link to the latest version file for these patterns?  i.e. Or does SAP update this link directly continually?

    Or put another way, where would I go about finding this if it wasn’t for this blog?

    I’m hoping this is not a once off set of patterns that aren’t enhanced over time.

    Cheers,

    Matt

    (0) 
  4. Jocelyn Dart Post author

    Hi Matt, As the patterns are all modelling patterns – and not executable – they are not release dependent.

    There were some internal roadmap discussions about building fully executable templates directly in NWDS for some of these patterns , but that would depend on a number of factors, including whether this is something being requested by customers via idea places and the like.

    So for now they are once-off but as they are modelling only it is something we can update over time without much effort if people see value in that. 

    Rgds,

    Jocelyn 

    (0) 
    1. Matt Harding

      Hi Jocelyn,

      Thanks for the info. I wasn’t really concerned about runtime versions of these, but more that it seems the only place you can find these patterns is within this blog.

      My thinking is that if this was published “louder” within the PO software area, and expanded upon, then we could see better implementations of BPM, especially within middleware scenarios. And updates to the patterns obviously would be useful as more features are implemented (e.g. Technical errors were only introduced a year ago I believe and could potentially be used within a pattern to highlight correct reusable usage).

      Cheers,

      Matt

      (0) 
      1. Jocelyn Dart Post author

        Thanks for the suggestion Matt. Believe we did put it in Featured Content at the time, but I’ll discuss with our space editor Mariana, and see what we can do.

        (0) 
  5. Shyam Viswanathan

    Hi,

    When i try to download the .sca file and under local development i do not see the DC components.I only see the context object “EAI_PATTERNS” and nothing underneath.

    Can someone help me figure out the reason?

    My NWDS is 7.31 SP8.

    (0) 
    1. Jocelyn Dart Post author

      Hi Shyam, Did you use Import SCA… option?  And did you accept the version suggestions in the pop-up window?

      If you do that it should come in and then you can use Sync Project to get it to assign the correct associated perspective.

      Rgds,

      Jocelyn

      (0) 
  6. divyesh vasani

    Dear Jocelyn,

    Earlier I was able to see models after importing SCA file.

    Due to some issue, I had to remove NWDS and extracted again NWDS.

    I am not able to view models under process after importing SCA file.

    Steps I have done as per your blog only:

    Saved sca file on local machine,

    Import SCA file in localdevlopments in “devlopment Infra” perspective.

    Any more steps required?

    —Divyesh

    (0) 
    1. Jocelyn Dart Post author

      Hi Divyesh, Yes in the Development Infrastructure perspective you need to use the context menu on the development components to sync the projects and get NWDS to assign the associated perspective.  Once that’s done you should be able to view them in the Process Composer perspective.

      Rgds,

      Jocelyn

      (0) 
  7. Carlos Ocampos

    Dear Jocelyn,

    I have followed all steps but I cannot see DC inside EAI_PATTERNS SC.

    There is a warning saying that Cannot update build status of DC eai_patterns. DC not found in model.

    Same error for the second DC: Cannot update build status of DC eai_patterns_samples. DC not found in model.

    As you can see below there is no DC under EAI_PATTERNS

    eai_patterns_error2.GIF

    Here you can see warnings.

    eai_patterns_error.GIFI’m using

    SAP NetWeaver Developer Studio

    SAP Enhancement Package 1 for SAP NetWeaver Developer Studio 7.3 SP14 PAT0001

    Thanks.

    Kind regards

    (0) 
    1. Carlos Ocampos

      Dear Jocelyn,

      I have reinstalled a previous version of NWDS:

      SAP Enhancement Package 1 for SAP NetWeaver Developer Studio 7.3 SP14 PAT0000


      and now everything working fine.

      Looks like there is a problem with the latest version.


      Thanks

      Kind regards

      (0) 
  8. Rashmi Joshi

    I followed the same process I can see EAI pattern in Perspective –> Development Infrastructure. But ALL my objects under my comp are vanished (MyComponents[demo.sap.com)…..

    Please let me know how to retrieve them back pleaseeeee….

    BR,

    Rashmi

    (0) 
    1. Jocelyn Dart Post author

      Hi Rashmi, If you are having issues please raise them as a discussion post in the Process Orchestration forum. By all means include a link to the blog or thread.

      However blog comments are not an appropriate place to resolve issues.

      Rgds,

      Jocelyn

      With my SCN Moderator hat on.

      (0) 
    1. Jocelyn Dart Post author

      Hi Andrey

      Unfortunately it seems to be lost with the SCN upgrade.

      And apologies I no longer have a copy myself…  this is 4 years ago now and no longer an area I am working in.

      They were just diagrams… you will probably find more useful and up-to-date suggestions in the current SAP Help for Process Orchestration.

      Rgds,

      Jocelyn

       

      (0) 
  9. Andrey Petin

    Jocelyn, I found your file (EAIPATTERN00_3.sca) on my hard disk. It appears that I downloaded it last year 🙂

    If needed, I can send it or upload to some storage.

    Best regards,

    Andrey

    (0) 
    1. Jocelyn Dart Post author

      Hi Andrey

      I have it thank you and I’ve passed it on to some who have been asking. Finding a place to put it is more of a challenge.  I’m currently pursuing the Process Orchestration wiki…

      Jocelyn

      (0) 

Leave a Reply