Quick start

Introduction to BPS APIs

WEBCON Business Process Suite is a comprehensive platform to efficiently manage documents and business processes in every company. It is also very expandable thanks to a set of APIs available in the system. BPS provides two different API types. The SDK extensions registered as plugins and run within the system while the workflow is being processed. Second is a Web API that enables running operations on elements within the BPS system from external systems.

Choose the right API

The choice of the right API depends primarily on the type of operation to be performed. As regards modification of workflow elements, both sets offer similar possibilities, however, they differ as to the approach and procedure.

Web API

  • If you integrate BPS with other systems and need the change in the external system to cause a new element to be created, or moved to another step in the BPS system, calling the appropriate method in Web API web service will be the right choice.
  • Also, if you need to get the data of a specific element from BPS to other system, it is best to use Web API for that purpose.
Web API is a SOAP based web service providing the methods for operating on the elements of the BPS system. It allows external systems to run new workflows in the BPS, modify and alter the status of the documents existing in a workflow, and to operate on binary attachments of those elements. It enables the same operations to be performed at the programming level as those performed by the system users with the BPS forms.

WATCH THE VIDEO


Using Web API

 

SDK

  • If, during the integration, it is the BPS that initiates the event, then it is best to use custom actions from SDK to initiate change in a different system.
  • If you want to extend the BPS operation by new types of controls in the form, or change the operation of the currently available ones, it is best to use proper custom controls from BPS SDK.
  • See the possibilities offered by SDK actions, if you want to extend the process in BPS by a behaviour or functionality which BPS does not provide. They allow virtually any system extension and connecting such extension in many points in the workflow.
  • Do you need to generate extra reports or create specific file types based on the elements in the system? The custom actions are best to do that.
  • Do you want to use, in the BPS system, the data available in the structure whose data sources are not supported in the BPS? Use the SDK to create a custom data source that can retrieve data from such structure.
BPS SDK is a set of libraries which make it possible to create plugins allowing full adjustment of the BPS system to the current needs. The extensions are run within the BPS system, so they have to be implemented in the Microsoft .NET Framework technology, for example using the C# language. After registering with the system, they can be used in any process.

WATCH THE VIDEO


Creating an SDK Action


The SDK set comprises several plugin types with different uses. The actions enable execution of the own logic, reading and modifying data of workflow elements, recalling logic from external systems, generation and modification of attachments. The layout and behavior of a form can be changed through custom controls or extensions of the controls to fully adapt it to the user’s needs. With custom data sources, the set of external sources supported in the BPS system can be extended. Print templates allow modification of bar code label printing and creating custom paper prints.

Next topic

See also