Production packages
Access | ARCAD-API Server → Embedded Production Server → Production Packages |
Production packages are sets of promoted web services. They may include a set of web services that are to be managed together as a group or may represent the same 5250 application and provide APIs that cover a coherent set of features. Because you may use ARCAD-API to provide web services for all kinds of miscellaneous internal systems and scenarios, the notion of production packages may help the consumers to clearly choose which services to use.
Another benefit of packaging multiple web services into production sets is the ability to then provide versions. One or multiples web services could be modified according to the evolution of the target system and, in this case, all the related web services must be updated. The package can be redelivered with updated web services under a new version number. In ARCAD-API, the version of a production package is called the version tag.
To avoid forcing the final consumer to keep track of each version of each individual web service used, the standard way of managing such a situation is to create API versions instead of web service versions. In this case, the consumer must only keep track of the version tag of the API ensemble and the URL prefix to use. If a new version of the API is available because one or more web services have been modified, the consumer only needs to change the version tag without needing to know the exact version of each web service.
Production packages cannot be deleted.
Production packages are accessed and managed in the Production Packages view.
Follow the subsequent steps to create a new production package.
Step 1 To access the New Production Package wizard, either click the Create icon in the toolbar, or right-click anywhere in the list and select Create.
Step 2 Define the code and name for the package. These values are required to create a new package but can be edited later.
Step 3 Click Finish.
Result The new package is created and is displayed in the Production packages search view. The package can now be used to accept internal promotions.
For more information about promoting web services to production, refer toPromoting descriptors to the production server and for their use in production, refer to Registered web services.
To edit a production package's details, either right-click on it in the Production packages search view then select Edit, select the item then click the edit icon in the toolbar or double-click it.
Only the packages Code and Name can be modified in the editor.
Save the changes (, Ctrl+S
or File > Save).
An important feature for production packages is the capability to manage the version of the set of web services. The latest version of all the web services that belong to a package will be included in each defined version tag. Only version tags are available for consumption. If you have not created a version tag for a production package, the registered web services in it will not be available.
To display a production package's version tag, right-click on the production package in the list and select Show version tags in the contextual menu.
For more information about version tags, refer to Version tags.