Skip to main content
ExLibris
  • Subscribe by RSS
  • Ex Libris Knowledge Center

    Upload Electronic Books Holdings from Sage

    Translatable
    You can update Sage electronic holdings by automatically retrieving the institution-specific holdings using an integration profile.
    Prior to running a Sage integration profile job, you need to activate certain electronic collections. For more information, see Activating the Sage Electronic Collections from the Alma Community Zone.

    Creating the Sage Integration Profile

    To configure the Sage integration profile for uploading electronic holdings: 
    1. Obtain an institution token ID from Sage, see Obtaining token ID from Sage.
    2. Confirm that the Sage electronic collection for which you are updating holdings is an active collection in Alma. For more information, see Activating the Sage Electronic Collection from the Alma Community Zone
    3. On the Integration Profile List page (Configuration Menu > General > External Systems > Integration Profiles) select Add Integration Profile to open the External System wizard for configuring an integration profile. 
    4. For the Integration Type parameter, select Upload Electronic Holdings

    5. For the Provider parameter, select Sage

    6. Add a description (optional) and select Next.

    7. Complete the Upload Electronic Holdings configuration section using the information in the table below.
      Upload Electronic Holdings Section
      Parameter Description

      Active

      Select Active to make this an active profile. The default setting is Inactive.

      Institution token ID Enter the institution token ID that you obtained from Sage.

      File format

      Select the KBART file format.

      Group

      Use this parameter to select one or more groups from the list of multi-campus options in the drop-down list. This parameter is optional, so you may also choose to leave it blank. 

      The Group parameter appears when you have the multi_campus_inventory_management customer parameter set to true. 

      With the multi_campus_inventory_management customer parameter set to true, you can have multiple Sage integration profiles. When you have obtained multiple Sage token IDs from Sage you may want to create multiple integration profiles using that identification information. 

      Note that when you have more than one active Sage integration profile with one or more multi-campus selections made for the Group parameter, any additional active Sage integration profiles must have one or more multi-campus selections made. In this situation, the Group parameter may no longer be left blank. 

      When the Sage integration profile job is run and multi-campus group information is configured, the multi-campus group information appears in the job report.

      Schedule

      Select the scheduling option that you prefer to have the integration profile job run automatically. 

      When you have the multi_campus_inventory_management customer parameter set to true, and multiple Sage integration profiles, the first scheduling option that you select and save applies to all the subsequent, active Sage integration profiles that you create. Note that when the scheduled job begins to run, all of the Sage integration profiles that are set to Active are handled together by the job run. Any Sage integration profiles set to Inactive are not handled as part of the scheduled job run.

    8. Save the profile using one of the following options:
      • Select Save. The integration profile is scheduled and appears in the list of scheduled jobs (see Viewing All Scheduled Jobs).
      • Select Save and Run Now. This saves your profile settings and immediately queues the upload to run. The Save and Run Now button also appears on the Actions tab when you edit the profile. Note that when you edit your saved profile, the button appears as Run Now, and you can choose to manually run the upload job.
    When you press Save in a specific Sage integration profile, all of the Sage integration profiles that are set to Active are run as part of the job request. Any Sage integration profiles set to Inactive are not run as part of selecting Save. Selecting Save from an Inactive integration profile does not run the job for that integration profile or any other Sage integration profiles set to Inactive, but runs only for the Active profiles.
    This behavior of Save is different from other integration profiles where selecting Save and Run Now runs the job request for integration profiles set to Inactive. This is a known issue. To have a Sage integration profile run, it needs to be set to Active.

    Activating the Sage Electronic Collections from the Alma Community Zone

    The Community Zone provides the following Sage electronic collections:
    • Sage Books: Collection ID = 614920000000005760
    • Sage Complete: Collection ID= 61111092947545000

    Search Alma to locate this electronic collection in the Community Zone and activate it before running the Sage integration profile.

    Only the electronic collection and its service need to be activated (select the Activate this electronic collection service and Make service available Full Text Service options). There is no need to activate any portfolios (select the Manual activation - activate electronic collection and manually select portfolios Activation Type option). The activation of the portfolios is done by the upload electronic holdings integration process.

    Obtaining Token ID from Sage

    To obtain your ID please log in to your Secure Center account and follow the instructions we’ve provided in our FAQ Knowledgebase. If you don’t have a Secure Center account and/or credentials please reach out to your Sage Account Support representative or libsupport@sagepub.com. If you have specific KBART questions, please reach out to tech support at onlinesupport@sagepub.co.uk. URL for the “FAQ Knowledgebase”: https://sagepub.libanswers.com/product/faq/400407.

    Preserving Previous Sage Acquisition Details

    If before the use of Upload Electronic Holdings from Sage you managed Sage titles in a different collection(s) and you want to preserve the acquisition details associated with those titles (such as PO lines and licenses), you can use the Move electronic portfolio information job to move PO lines and licenses to the collection. 
    To do this, use the following steps:
    1. Create a set of the content type electronic collections that includes the previous collections in which you managed the Sage titles. 

    2. Open the Run a Job - Select Job to Run page (Admin > Manage Jobs and Sets > Run a Job), and search for the Move electronic portfolio information job

    3. Select the Move electronic portfolio information job and select Next

    4. Select the set that you created above and select Next

    5. For the Target electronic collection, select the relevant Sage collection. 

    6. Select the Move PO lines and Move licenses options and complete the required information as needed. 

    7. Select Next and review/confirm the job summary information.

    8. Select Submit.
    • Was this article helpful?