API Docs

Rest Integration Profile

Overview


Alma integrates with external systems such as vendor systems, Enterprise Resource Planning systems, catalog systems, remote storage systems, etc. using standard protocols.
Integration profiles define the way an integration is being performed.

Data Dictionary

Click here to download rest_integration_profile.xsd

integration_profile

Description: Integration profile object.

FieldTypeDescription
idstringIntegration profile ID. This ID can be used in order to find the corresponding job ID. For more information see Working with the Alma Jobs API.
codestringIntegration profile code. Mandatory.
namestringIntegration profile name. Mandatory.
typestring with attr.
The integration profile type.
Possible codes are listed in 'IntegrationTypes' code table.
This field cannot be updated.

The valid values for this parameter are controlled by the code-table: IntegrationTypes. These are the currently defined values for your institution:
CodeDescription
systemstring with attr.
The system with which you are integrating (for informational purposes).mandatory.
Possible codes are listed in 'ExternalSystemTypes' code table.

The valid values for this parameter are controlled by the code-table: ExternalSystemTypes. These are the currently defined values for your institution:
CodeDescription
defaultboolean
Indication whether the profile is a default profile. Default is false.
system_descriptionstringIntegration profile code. Mandatory.
descriptionstring
Deposit profile description.
parametersparameters
List of the profile's related parameters.
These parameters are parallel to the fields in the "Actions" tab of the integration profile in Alma UI.
contact_infocontact_infoThe Integration Profile Contact information.

 

parameters

Description:
List of the profile's related parameters.
These parameters are parallel to the fields in the "Actions" tab of the integration profile in Alma UI.

FieldTypeDescription
parameterparameterSpecific profile's related parameter.

 

parameter

Description: Specific job parameter.

FieldTypeDescription
actionstring with attr. The name of the action the specific parameter is related to.
namestring with attr. The name of the parameter.
valuestringThe parameter value.

 

Samples

XML
JSON
__