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

    Upload Electronic Holdings from Project MUSE

    You can both import and continuously update Project MUSE electronic holdings by automatically retrieving the institution-specific holdings using an integration profile.

    When uploading holdings using the Project MUSE Upload Electronic Holdings integration profile, multiple Excel lines of the same ISSN and with different coverages are concatenated and uploaded as one portfolio with multiple coverages. 

    The autoholdings integration with Project Muse includes purchased material, gratis and EBA. It does not include open access content. To enable some or all of open access content, use the following Community Zone collections:

    Project MUSE Open Access Books 614330000000001179
    Project Muse Open Access Journals 615420000000000140


    Prior to running a Project MUSE integration profile job, you need to activate certain electronic collections. See Activating the Project MUSE Electronic Collections from the Alma Community Zone for more information.

    Creating the Project MUSE Integration Profile

    To configure automatic uploading of electronic holdings for Project MUSE:
    1. Obtain an institution token from Project MUSE. You can create a Project MUSE token using the Project MUSE admin tool. For more information, contact the Project MUSE helpdesk for assistance.
    2. Confirm that the Project MUSE collections for which you are updating holdings are active collections in Alma. See Activating the Project MUSE Electronic Collections from the Alma Community Zone for more information.
    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.
      Integration profile upload Project MUSE
      Configuring Upload Electronic Holdings Integration Profile, Part 1
    4. In the Integration type field, select Upload Electronic Holdings. The other fields on the page change to reflect your selection.
    5. In the Provider field, select Project MUSE.
    6. Add a description (optional) and select Next. The second page of the wizard appears.
      Configuring Upload Electronic Holdings for Project MUSE
      Configuring Upload Electronic Holdings Integration Profile, Part 2
    7. Complete the Upload Electronic Holdings configuration section using the information in the table below.
      Upload Electronic Holdings Section
      Parameter Description


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

      PM Institution Id

      Enter the institution token ID that you received from Project MUSE.

      File format

      Select the KBART file format.


      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 Project MUSE integration profiles. When you have obtained multiple Project MUSE token IDs from Project MUSE, you may want to create multiple integration profiles using that identification information.

      Note that when you have more than one active Project MUSE integration profile with one or more multi-campus selections made for the Group parameter, any additional active Project MUSE 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 Project MUSE integration profile job is run and multi-campus group information was configured, the multi-campus group information appears in the job report.


      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 Project MUSE integration profiles, the first scheduling option that you select and save applies to all the subsequent, active Project MUSE integration profiles that you create. Note that when the scheduled job begins to run, all of the Project MUSE integration profiles that are set to Active are handled together by the job run. Any Project MUSE 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 Project MUSE integration profile, all of the Project MUSE integration profiles that are set to Active are run as part of the job request. Any Project MUSE 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 Project MUSE 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. In order to have a Project MUSE integration profile run, it needs to be set to Active.

    Activating the Project MUSE Electronic Collections from the Alma Community Zone

    The Community Zone provides the following Project MUSE electronic collections:
    • Project MUSE: Universal journals - (Community Zone Electronic Collection ID = 615450000000005146)
    • Project MUSE: Universal books - (Community Zone Electronic Collection ID = 615450000000005144)
    • Project MUSE: EBA books (automated holdings baseline) - (Community Zone Electronic Collection ID =615450000000005145)
    Search Alma to locate these electronic collections in the Community Zone and activate them prior to running the Project MUSE integration profile.
    Note that 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.

    If the Project MUSE integration profile is being used, do not use auto-active = yes in the service level. If this field is set to yes, it will lead to incorrect portfolios being activated.

    Preserving Previous Project MUSE Acquisition Details

    If prior to the use of Upload Electronic Holdings from Project MUSE, you managed Project MUSE titles in different Community Zone electronic collections 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 Project MUSE electronic collections.
    To do this, use the following steps:
    1. Create a set of the content type electronic collections that includes the previous electronic collections in which you managed the Project MUSE 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 collection Project MUSE Universal Books or Project MUSE Universal Journals.
    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?