Legacy interface: Download and run the offline circulation client

Request a WSKey

1. On the Developer Network homepage, click Manage your API Keys.
2. On the Sign in screen, enter the same user name and password you use to sign into OCLC Service Configuration.
3. On the WSKeys screen, click Request a WSKey.
4. On the Request a WSKey screen, select Request a Custom Key.
5. Fill in the following fields. Click Next after each selection. 
   • Type of Request: Select Production.
   • Select Machine-to-Machine (M2M) App.
   • Services: Select WMS NCIP Service from the list. You may need to scroll through the list.
   • WSKey Name: Enter a name for the WSKey. If you do not enter a name, it will default to "Web Service Key YYYY-MM-DD." The date will be the date the key was requested.
   • What is the reason for this request?: Enter WMS offline circulation.
   • Terms and Conditions: Select to agree with the WorldShare Platform Developer Terms and Conditions.
6. Click Create Request.
7. You will receive an email response to your request within twenty-four to seventy-two hours.

Download the client

1. Sign into OCLC Service Configuration. For information on how to sign in, see Signing In.
2. On the left navigation, click WMS Circulation > Integrations.
3. Select Offline Client.
4. On the Offline Client screen, fill in the fields in the following order:
   • Branch: Select the branch the offline client will be used for. The Offline Circulation client must be downloaded at each branch that needs to use it.
   • User to act as: Search for the user account that will use the client. Click the radio button next to the name to select the account.
     • Select the account used for normal Circulation activities.
     • Make sure the user account has a Circulation role. For more information, see Circulation roles.
   • Password: Enter a password for the account.
     • This password enables use of the Offline client when WorldShare Circulation is unavailable.
     • This password does not need to be the same one used for the user account, above.
     • Make sure the staff who will be using the client know this password.
   • Select WSKey to use: Any WSKey listed can be used. Click the radio button next to the WSKey to select it. If none are listed, you need to request a WMS NCIP Service WSKey. For details, see Step 1: Request a Web Service key (WSKey).
5. Click Download client.
6. Save the client to your workstation. Select a location that is easy to find and known to the staff who will be using the client. To install the client, follow the steps in the Step 3: Install the client section, below.

Problems downloading or starting the Offline client

Occasionally you will see warnings or messages when starting the client. Some problems you may encounter:

• Your version of Java is out of date
  • Solution: Install Java 8. You may have Java configured to automatically download for you, or you may need to contact technical staff to resolve the issue. Consult technical staff if you see a window with the message, "Application Blocked by Security Settings."
• You do not have Java installed
  • Solution: Download the current version of Java at Java SE Runtime Environment 8 Downloads.
• The application is untrusted and a warning occurs
  • Solution: If the application is not trusted you will see a security warning. OCLC recommends you report this issue to OCLC Support and click Cancel rather than continuing. See Offline client support.