Friday Dec 09, 2011

Introducing the UPK 11 Online Documentation Library on Oracle Technology Network (OTN)

The documentation team has created a new UPK 11 Online Documentation Library. This new library is available now on Oracle Technology Network (OTN).  This new library provides a comprehensive onlne resource for all of your UPK documentation needs for UPK/UPK Professional. For those of you who are familiar with Simulation help, you will also find hundreds of simulations in this content demonstrating how to effectively use the Developer and Knowledge Center components of the product. This new library is published to the UPK Player format, so you can take advantage of the new features introduced in UPK 11 such as the Share feature and See Also links.

This content also provides useful links to additional resources such as the Getting Started content, Technical Specifications, the UPK Blog, and the UPK Resource Library.

You can access the UPK 11 Online Documentation Library at any time using the following URLs:

  • UPK Documentation Launch Page:

We recomend that you add these links as favorites or bookmarks in your browser for quick access.

The following link to a short one-question survey is provided so you can tell us what you think of the new documentation library.

You can also access the survey from the feedback section within the online documentation library.

As always, we appreciate your valuable feedback on the UPK documentation so we can best meet your needs.

Friday Oct 29, 2010

Oracle Tutor 14 - Converting Visio files to Tutor procedures

Note - the toolbar button is titled "Import Model," not "Convert" as is described below.

Visio diagrams provide the greatest opportunity for time saved in redeveloping BPM oriented content into Oracle Tools because there are so many of them in the organizational environment. At the same time, Visio diagrams are the greatest challenge to convert because templates may not resemble BPMN or may not be used at all, and the flexibility inherent in Visio allows for non-standard model development. A customer maintained mapping file has been provided which improves the ability to map from non-standard symbols used in Visio diagrams, but models to be converted should be reviewed carefully to assure a clean and efficient conversion.

Source Model Preparation
Make sure the Visio Model conforms to the following rules:

  • Ungroup all model objects
  • Flow connectors are placed between all appropriate model objects, and are connected to the symbol
  • Symbol text is associated with the symbol and is not a Text Box grouped to the symbol
  • Symbols created with non-standard templates have been mapped to OBPC (See Customizing OBPC below)
  • All process symbols contain text
  • Swimlanes contain named roles or actors

General Conversion Issues
Some symbols, which are BPMN 2.0 compliant, will not be converted, especially if they are dropped on tasks to turn them into different types of tasks or sub processes. The table VisioMasterMap.xml is provided and can be maintained by the customer. See Appendix 2: Visio Import technical Details for more information. Excluded Master symbols which map to null currently include:

  • Ad Hoc processes
  • Loop processes
  • Detail
  • Title Block
  • Guide
  • Activity Looping
  • Multiple Instance

Incoming Visio models may contain undefined symbols, which appear to map to process objects but do not. If these objects are placed within the sequence flow they will be converted to tasks. If these objects are erroneously converted to tasks, the customer can add the objects to the mapping file. If the customer has licensed BPA or BPM, a more efficient approach is to import the Visio files into BPA or BPM, clean up the resulting models to valid BPMN standards, and then export them to Tutor.

Visio Model to Tutor
How to Use this Feature
Open a Tutor Document, and click on the Convert button on the Tutor toolbar. From the Tutor Convert dialog, browse to the folder containing the desired Visio file and click OK to convert the file. Note that the Convert button is the same for both Visio and XPDL files, and the .vdx or .xpdl file extension drives the conversion.


Expected Results
Visio models contain a wide variety of symbols, which conform to a varying degree to BPMN notation. The general symbol conversion rules found in Appendix 1 will apply, but customers can map their own symbols as described in the Customizing OBPC section.


Model Converted to Tutor Procedure
Below is the task section of the procedure. The conversion notes and opening sections are not shown.

Conversion Issues
Some models use complex numbering schemes for task identification. When converted to Tutor, only Tutor numbering will be provided, unless the task number is part of the task name. In that case, revision of the content in Tutor is advised.
Tutor currently cannot present text associated with Start or End events, and this text will not be converted.

This information is from the Oracle Business Process Converter user manual and was written by Chuck Jones, Consulting Director, Oracle Tutor.


The authors of this blog are members of the UPK product development, management, and marketing teams. On this blog, you'll find UPK news, tips/tricks, upcoming events, and general information on UPK - the easy-to-use, comprehensive content development, deployment, and maintenance platform for increasing project, program, and user productivity.


« July 2016