Dave_Kelsey 100000BGBR Visits (1910)
No results found is a common response to a search request, but how do you detect this in your BPM process ?
A “No Results Found” situation causes an exception to be thrown which means you can detect it using an intermediate error event, but you need to be able to handle a real errors as well as a no results found which is a special kind of exception.
Here we have a simple example of a search human service which applies equally to Physical and Virtual MDM Server.
There is an intermediate error event attached to the do search nested service that calls the MDM Search integration service. The gateway decision determines whether it is a no results found or not.
To determine how to configure the decision gateway we need to have a look at the format of the exception we get when a no results found is generated and this differs slightly between virtual and physical MDM Server.
Handling a Virtual MDM Server response
A sample of part of the xml format of the exception is shown here
Here is is the reason code we are interested in. So the decision gateway configuration looks like this
The decision logic being
extracts the reason code and checks for ENOREC.
Handling Physical MDM Response
The implementation remains the same, the test within the decision gateway needs to be altered as the location of the reason code is different to virtual. In this example the reason code that is checked is applicable to a Party or Person Search, however it is possible that the reason code will be different for different types of physical search.
A sample of part of the xml format of the exception is shown here
Here we see the reason code we are interested in is nested under the <errors> tag within an < element>.
So in this case we need the decision logic to be
jtonline 110000B6Y8 Visits (1887)
Before the MDM Developers group got going a few authors from the IBM development team posted on the MDM Workbench blog. Now that this group blog has a few posts as well it makes sense to combine the two, so we won't be posting to the separate MDM Workbench blog in the future.
This blog is for more than just the workbench but the biggest advantage is that it is much easier for anyone to contribute: any member of the group can write a blog post! If you have something to share that you think the community would find useful, give it a try. It's a great way to get early feedback on something that may turn in to a full developerWorks article over time. If you do write a post, just let me know as soon as you are ready for it to be published.
These are just a selection of some of the popular posts from the old blog:
And don't forget, there are still forums available for questions and discussions:
jtonline 110000B6Y8 Visits (1876)
To avoid errors being produced in code generated from module models, the workbench validates the model contents. This post summarises the naming constraints that must be observed in the model to avoid validation errors. This is not intended to be a complete list of constraints but if there are any others that you think are worth being aware of up front, please leave a comment.
The entity name must,
The entity name must not,
Database table name:
The database table name must,
The entity attribute name must,
The entity attribute name must not,
Entity field name:
The entity field name must,
The entity field name must not,
Database field name:The database field name must,
The database field name must not,
The code table name must,
The entity name must not,
Database table name:
The database table name must;
Code Table Attribute
The code table attribute name must,
The code table attribute name must not,
Database field name:
The database field name must,
The database field name must not,
Transient Data Object (TDO)
The TDO name must,
The TDO name must not,
Transient Data Object attribute
The TDO attribute name must,
The TDO attribute name must not,
The transaction name must,
The folder name must,
The folder name must not,
Hub base name:
The hub base name must,
The hub base name must not,
Details on valid Java identifiers can be found in sections 3.8 and 3.9 of the Java language specification however, due to the other naming constraints imposed in the model, the only extra restriction is the use of any of the following reserved words-
The name must not,
vwilburn 100000F865 Visits (1862)
If you're looking for a fast path to installation, try one of our brief cookbooks. Each cookbook limits its pages to a specific scenario for Standard and Advanced Editions. That means each cookbook excludes superfluous pages and speeds you onto a simplified install experience. The following cookbooks cover key MDM scenarios:
As always, if your environment or scenario is more complex than the cookbook ones, you can find the details in the Info
vwilburn 100000F865 Visits (1850)
Skip the fluff and go deep into the technical details of InfoSphere MDM. In a series we're calling MDM Tech TV, several IBM engineers catch you up on technical topics. These informal video demonstrations give you a quick taste of various features.
The three new videos complement the existing MDM videos:
ThomasRogers 270006MA78 Visits (1790)
Whether you're already familiar with the Workbench or completely new to it there are a lot of new changes in v11. So why not check out the MDM
There's also a major new addition to the Wiki if you're looking for more information on installing MDM on Linux head over t
vwilburn 100000F865 Visits (1748)
Currently in an open beta until February 2014, IBM
jaylimburn 2700028UUJ Visits (1684)
Are you attending the IBM IMPACT conference this year?
If you are then be sure to check out the sessions covering MDM and BPM alignment.
The first session hosted by IBM MDM Product Manager Trey Anderson and entitled: Improving Business Processes by Aligning BPM and MDM will cover the value proposition of combing these two technologies and cover a series of easy to obtain business benefits from running a su
Trey, Jay and Allen have been the driving force behind the integrated capabilities now available within IBM BPM and IBM InfoSphere MDM. Take the opportunity to meet with them at IMPACT and discuss your projects and how MDM and BPM alignment can help.
cgriffin 120000CMTR Visits (1577)
With MDM Workbench 9.0.x, you may find that web service deployment classes are not generated for data extensions. This causes runtime errors when invoking web services affected by data extensions, typically a class not found error referring to a class name with suffix _Ser, _Deser, or _Helper. Classes with these names should be generated when you run Prepare for Deployment on WSEJB projects. If these classes are not generated, the web service won't work.
To resolve this error, right-click on PartyWSEJB (you need to repeat this for each affected WSEJB project), select Properties. Select Project Facets. Check the facet: WebSphere EJB (Extended). Save changes, and run Prepare for Deployment on the WSEJB project.
I have added this information to the MDM Workbench FAQ. Thanks to Bark Bakker, for finding the workaround.
If you know of a good solution to a common problem, then please do add it to the MDM Workbench FAQ so that other users can benefit. And if you are having problems, please look at the MDM Workbench FAQ before posting to the MDM Workbench newsgroup, as you may find an answer there.
jtonline 110000B6Y8 Visits (1540)
There are a huge range of topics and speakers on offer at the Information On Demand conference later this month, but what if there's a topic you care about missing from the conference programme? Well this year there is a conference within a conference where you get to set the agenda; you won’t want to miss these sessions!! Check out the unconference site for all the details, including what an unconference is, and how to suggest topics:
Information On Demand Technical Unconference
If you've not been to an IBM unconference before, there's a Worklight demo from the IBM Impact Unconference on YouTube, which may give you some idea of what to expect. Of course, since the participants get to lead the event, every unconference is different!
Nic Townsend 2700051ED4 Visits (1505)
Changing log levels
bakleks 270007PVJ3 Visits (1454)
This document outlines how Physical MDM customisations can be built from source artefacts in an automated build and test system. This document does not aim to be a complete guide on this topic, but rather to point the way to how some detailed steps can be implemented using examples.
The MDM Advanced or Standard editions both include the MDM Workbench. In version 11.0 and beyond the MDM Workbench is used by solution developers to create artefacts which customise the MDM solution for the physical, virtual and hybrid implementation styles. These source code artefacts are typically built into a Composite Bundle Archive (CBA) and deployed to WebSphere where they augment the functionality already available in the MDM Server Enterprise Business Application (EBA).
A good practice amongst MDM solution developers is to create an automated build process such that customisation source code is checked-in to a code control repository, and an automated build process takes those source files and builds the CBA ready for deploying onto post-build test systems, placing built artefacts into a second repository or shared file system.
Some automated systems take this “build” concept further, by automating the deployment of such built artefacts to test systems, which in turn report back on the “health” of the build, how many tests passed and failed, and generally quickly provide valuable feedback to developers whether recent changes broke the solution or not. Project managers overseeing such projects are able to reduce project risk by adopting this continuous delivery processes, and changes to MDM solutions become more reliable and safer as a result.
To add MDM solutions to such a continuous build environment it is necessary to:
This article is mostly concerned with step #7 – building source artefacts.
2. Materials and prerequisites
This article is accompanied by a collection of example scripts. We do not intend that these are used directly, but as an example of how you may wish to implement your own automated build process.
The current solution consists of four main files:
In order for the scripts to work, the machine running the scripts needs to have the following products installed:
To run the Ant scripts the user needs to run mdm_wb_build.xml as a build file.
The script contains only the “runBuild” target.
The target checks that necessary properties, such as Eclipse Home, date and time stamps and output folder prefix are set. Provided these properties do exist, it creates a folder based on OutputFolderPrefix and date and time, within which “logs”, “CBAExport” and “workspace” folders are created.
The logs folder contains “MDM
generateDevProject: BUILD SUCCESSFUL
workspaceBuild: BUILD SUCCESSFUL
exportCBA: BUILD SUCCESSFUL
End of report.
The CBAExport folder contains all of the exported CBAs.
The workspace folder contains a local copy of build artefacts.
After the directories have been created, the script checks which operating system it is running on and sets the isLinux or isWindows property to “true” as appropriate and calls either runAnt.sh or runAnt.bat to run a headless Eclipse process. The relevant file (either the batch or the shell script) should be available by default in the bin directory in the Eclipse installation directory.
The runAnt script then sets up the log files, environment variables and runs a second script “mdm
3. Step breakdown of the automated build and test system
Given that automated building and testing of MDM solutions is a worthwhile goal, the following sections provide some guidance in some of these areas where actions specific to the MDM tools and development/build environment are necessary, and some points of discussion are presented where choices exist.
3.1 Identify the pieces of the solution which represent the “source code” for the solution.
The source code for an MDM solution will be made up of a collection of Eclipse projects and their contents. MDM development, MDM configuration, MDM hybrid mapping, MDM service tailoring, MDM custom interface, MDM metadata and other MDM-specific projects types. CBA projects will add to the list.
MDM Development projects contain a “module.mdmxmi” file, which contains a model of the customizations which the project aims to create. This file should always be considered to be source code.
At some point the mdmxmi file will be used to generate Java, XML, SQL and other file artefacts, and there are a few different approaches you can take for these files:
The current solution is to only consider files which have been manually changed as “source code”, and “generate artefacts” from the mdmxmi model as part of the automated build process itself. This approach demands that the MDM workbench tools are installed as part of the build environment, because the “generate artefacts” process that turns .mdmxmi files into other artefacts will be a necessary part of the build process.
A project “MDM
3.2 Create a source code repository.
There are many choices regarding which product to use as a source code repository and covering them is not the aim of this document.
3.3 Recognize when a consistent set of code has been checked-in, at which point a “build” is started.
This event may be triggered manually, automated overnight, or whenever a change-set is delivered to the code stream. The capturing of this event is often specific to the code control system being used, though some solution teams augment this by adding a web page that enables build requests to be manually requested.
3.4 Create a build environment.
A build environment should include RAD (or RSA) which can be called in a “headless” manner such that functionality within RAD can be used without a user-interface being present.
MDM Workbench will be required in addition to RAD to perform a complete build of “module.mdmxmi” files.
For the list of platforms that MDM Workbench v11.0 and onwards support – refer to the product release documentation.
3.5. The build environment “boot-straps” itself.
A small script is responsible for “boot-strapping” the process by it checking-out the other build scripts which in turn build the artefacts from solution developers.
3.6 The build scripts check out the artefacts from code control to the local file system.
These actions are specific to the code control system so will not be discussed further here.
3.7. The source artefacts are processed, transforming them into built artefacts.
This phase of the automated system typically consists of a hierarchy of Ant files which decomposes the overall build process into many smaller steps and “Ant targets”. The Maven framework is a common choice of technology to oversee this phase.
These Ant files can be categorized into two types:
For a detailed walkthrough of specific implementations of the build process refer to the Ant scripts provided with this blog entry.
3.8. The build process often executes “unit tests” to further validate that the solution artefacts are healthy and do what they are expected to do.
The tools and approaches used to execute unit tests vary widely dependent on technology choice. Simple Java JUnit tests offer one simple solution, which can be invoked with scripts once the tests and tested code are built.
3.9 Built artefacts are published to a repository.
Every build against which build metadata can be gathered and reported is versioned by the publish process. Build logs, unit test results and results of other tests indicating the “health” of the build are gathered and published to the repository as well.
Products such as Rational Asset Manager can be used here, or for a really basic solution a simple shared folder on a network drive may suffice.
3.10 Automated deploy and test health of overall build.
If the build is considered “good” then further automation can be added to deploy the built solution to a test environment, with higher-level tests (functional and end-to-end system tests) exercising the solution further. Such tests can also report back to the build repository on the health of each build.
The automated deployment of entire systems for testing is often one of the most complex areas of the whole continuous development process. Products such as Rational Urban Code Deploy (UCD) can be used for this stage of the process, though for some environments a set of (reasonably complex) scripts might be sufficient.
For the MDM pieces, we are mostly concerned with deploying and un-deploying SQL scripts, depl
Prior to deploying extensions to the server, it is often necessary to modify the database. This is possible using the SQL scripts found in the MDMSharedResources project in the built workspace. Rollback scripts in the same location should be applied once testing is complete to reset the database back to a known good state.
For CBA deployment, Jython scripts can be used to manipulate the WebSphere server. Detailed documentation of these steps can be found in the WebSphere documentation.
RaymondMari 0600011YW5 Visits (1450)
Requirements for Developer Machine
Developers working with the MIH Workbench require a large software stack. This requirement can
have resource implications for the hardware used by the development team. It is recommended that
each developer's machine meet the following specifications:
One of the following;
· Windows 7
· Windows XP
One of the following;
· IBM Rational Software Architect v7.5.4
· IBM Rational Application Developer v7
· InfoSphere Master Information Hub (MIH) Workbench plugin
· InfoSphere Master Information Hub distribution file MIH9
o VMware workstation v8
o One of the following
When possible, it is recommended that developers use a 64-bit version of Windows
running on a Virtual machine with up to 4GB of memory. MIH Workbench can work
with less powerful hardware, but productivity may be impacted by the demands of the
large software stack.
jtonline 110000B6Y8 Visits (1405)
There's a new seri
jaylimburn 2700028UUJ Visits (1225)
I recently found myself in a tricky situation. I had built a demo using a back level version of the MDM Standard Edition engine. I had beautifully created some dummy data specific to the demo, which included a lovely complex set of h
Here are the steps:
This saved me a huge amount of time in my specific scenario and stopped me having to remember how to configure the Individual sample data and link the enti