Integration Server 10.3 | Built-In Services Reference Guide | Assets Folder | Summary of Elements in this Folder | pub.assets:getChecksums
 
pub.assets:getChecksums
WmPublic. Retrieves the checksums for assets, specifically namespace elements, on Integration Server. You can calculate the checksum for specific assets or all of the assets in a package. A checksum is a digest for an asset that is generated using all the properties and contents of the asset. Each asset on Integration Server has a unique checksum. Two assets on different Integration Servers have the same checksum if the assets are identical.
Input Parameters
packages
String List Optional. Names of the packages for which you want to get the checksum of each asset in the package. A package must be enabled and loaded for Integration Server to get checksums for the assets. If a package is partially loaded, Integration Server gets checksums for the loaded assets only.
You must specify a value for packages or assets. If you specify a value for both packages and assets, Integration Server uses the packages value and ignores assets. If you specify neither, the pub.assets:getChecksums service ends with an exception.
assets
String List Optional. List of the fully qualified names of the specific assets for which you want to get the checksum.
You must specify a value for packages or assets. If you specify a value for both packages and assets, Integration Server uses the packages value and ignores assets. If you specify neither, the pub.assets:getChecksums service ends with an exception.
Output Parameters
checksums
Document List List of checksums for the assets in the specified packages or the specified assets.
Key
Description
package
String Name of the package containing the asset.
name
String Fully qualified name of the asset.
checksum
String Checksum for the asset.
The checksum value is null for an asset listed in assets if the specified asset does not exist on Integration Server.
Usage Notes
The pub.assets:getChecksums service ends with an exception if a package identified in packages does not exist or is not enabled.
The checksums/checksum output parameter contains a null value if an asset specified in assets does not exist.
If you do not have List access to a particular asset, the service returns only the asset name. The package and checksum values for the particular asset are null.
You can only compare packages and assets from the same version of Integration Server. Comparison of assets across different versions of Integration Server is not supported. Internal changes in assets from one release to another might result in functionally identical assets being reported as different.