Skip to main content
OCLC Support

Update Connexion client

Find out how to update Connexion client.

Update Connexion client to version 3.0

Introduction

During the Connexion client 3.0 project, OCLC stabilized and refreshed the Connexion client technology by:

  • Modernizing the build, compiler and distribution process​
  • Upgrading components to 64-bit (as much as possible)​
  • Resolving security issues​
  • Repairing high priority bugs and UI changes
  • Decommissioning obsolete features
  • Collecting usage metrics to inform future changes​
  • Moving all Help to OCLC website​
  • Better display of non-Latin scripts
  • Allow you to run the client or macros on your PC without being an Admin.
     Note: You do need to be an Admin to install Connexion client 3.0.

Improvements 

Upgrades to Connexion components 

Connexion client components have been upgraded to be compatible with the 64-bit version of Windows 10.  This means that the system now supports only the 64-bit version of Windows 10. 

Additionally, the client has been configured so that users no longer need to be Administrator on their computers to run the software and/or macros. Macros are being moved to a different directory to support this change. (Elevated privileges are still required to install the client). 

Macros were previously installed to:  X:\Program Files (x86)\OCLC\Connexion\Program\Macros and are being copied to: X:\Users\<user>\AppData\Roaming\OCLC\Connex\Macros (Where X is the letter of your hard drive and <user> is your Windows user name).   

Because of this upgrade, a change was needed to existing macros in order to function properly.  Within each macro, every instance of CreateObject("Connex.Client") must change to: GetObject(,"Connex.Client").  A conversion process will run automatically whenever the client is launched.  [Note the comma after the open parentheses] 

Original, unconverted macros will continue to reside in their original location. 

User Interface changes

Select changes have been made to the client user interface in conjunction with decommissioned features and in support of OCLC initiatives. 

The decommissioned Message of the Day has been replaced with a Welcome screen.  The new dialog will continue to provide Support information and inform the user of their level of cataloging authorization. 

Connexion client will also sport a newly redesigned splash page when the client is launched. 

Finally, in support of OCLC’s commitment to advancing equity, diversity and inclusion, the following changes are being made within the user interface of Connexion client: 

  • The term “master record” has been replaced with “WorldCat record.” 
  • The authorization mode formerly called “master mode” has been renamed “quality mode.”

Decommissioned obsolete features 

The following obsolete features have been removed from the Connexion client user interface: 

  • Message of the Day 
  • GLIMIR features 
  • Institution Records functionality 
  • Harvest Web Content 
  • Extract Metadata 
  • Attach Digital Content 
  • Embedded Connexion Client Help (moved to online support site)  

Usage metrics to inform future changes 

For select features for which we previously did not collect metrics, OCLC will be leveraging Google Analytics to inform future Connexion client releases.  

Connexion help revisions 

With the decommissioning of the embedded Connexion client help system, all documentation for the client has been reviewed, revised, and moved to OCLC’s support site.  Links and Help buttons within the client will now guide users directly to the online documentation.  This allows for ease of searching and more timely and efficient updates. 

Macros updates 

  • Macros are being relocated in Connexion client 3.0.
    • Currently, macros are installed to X:\Program Files (x86)\OCLC\Connexion\Program\Macros, where X is the letter of your hard drive​.
    • In Connexion client 3.0, macros will be copied to X:\Users\<user>\AppData\Roaming\OCLC\Connex, where X is the letter of your hard drive and <user> is your Windows user name.
  • Within each macro, every instance of CreateObject("Connex.Client") must change to GetObject(,"Connex.Client"). This conversion will run automatically when the client is launched.
  • Original macros will remain in the old directory.
  • OCLC and Dewey macro books shipped with client 3.0 are already converted and will be installed in the new location. 
Better display of non-Latin scripts

Client 3.0 uses the Microsoft .NET Framework 4.7.2 which enables use of non-Latin scripts that previously required fonts to be downloaded to view and use in the client. 

Bug fixes

Admin to run Connexion client is no longer required 

Previously, a change to the registry was needed to set the client run permissions down to user access.  This was required for the use of macros, access to network drives and network printers, and access to third party application such as Macro Express.   

This registry change is no longer needed, and users can now run as a standard user without encountering the above issues. 

False “Unidentified publisher” system warning in Windows 7, 8/8.1 and Windows 10 upon startup of client 

Previously, if you use version 2.63 of the Connexion client in Windows 7, 8/8.1, or Windows 10, you receive a Windows User Account Control (UAC) system warning each time you start the client.  

A new certificate has been used with version 3.0 which has eliminated the “unidentified publisher” system warning.  

Macros now working in users groups 

Previously, anything related to macros would cause severe errors when running the client in the users group. This has been resolved. 

Client will now halt a batch session for Update Holdings or Delete Holdings if the session is inadvertently terminated 

Previously, if a batch session was terminated, the request to the Connexion host resulted in an HTTP 503 error (Service unavailable) being returned to the client because the session no longer existed.  The client continued sending the remainder of the commands in the batch but shouldn't. This resulted in thousands of 503 errors at times. 

This issue has been resolved for batch sessions that Update Holdings or Delete holdings.  In a future release, we will work on other batch processes (Submit for Review, Replace Record, etc.) 

Security issues due to HKey_Local_Machine\OCLC resolved 

Windows registry issues have been resolved as part of the effort to remove the requirement to be Admin to run Connexion client.    

Known issues

Client 3.0 not compatible with unsupported version of Microsoft Office 

Connexion client 3.0 is not compatible with versions of Microsoft Office that are no longer supported by Microsoft.  If you are using an older, 32-bit version of Microsoft Office that is out of support, we suggest that you either upgrade your Microsoft Office to a newer, supported version; or, that you do not upgrade to Connexion client 3.0, but instead continue to use version 2.63. 

Help icon in the Connexion macro editor is no longer supported 

In the Connexion macro editor and debugger, there is a question mark icon that would previously take users to macro specific help.  This icon utilized a feature that is no longer supported by Microsoft.  Due to the nature of the language used to code the macro editor, we are unable to remove this icon from the user interface.  There are two additional options for getting to the macro help: 

  1. Click on the Help menu above the toolbar, and then click Macro Help 
  2. Press the F1 key on your keyboard – this will open a window to Macro Help, and it will also open a Microsoft error page that we are unable to change, but can be ignored. 

Both options will take you to the OCLC Macro support site. 

Running multiple instances of Connexion is not supported 

We are aware that in the past, some Connexion client users opened more than one instance of Connexion client to support their workflows.  In our Windows 10, 64-bit environment, this is no longer supported.  Going forward, running multiple instances of Connexion client is not possible without utilizing multiple virtual machines (VMs).   

Cannot maximize/restore (redisplay) Connexion client from a minimized position in the task bar

When you minimize the Connexion client, it becomes an icon in the task bar on your desktop, and you should be able to maximize/restore (redisplay) it by clicking the icon. If you are unable to maximize the client from the task bar icon, use one of the following workarounds.

Click the Connexion client icon in the task bar, and then press and hold the Windows key (Windows key) on your keyboard while you click the <Up arrow> key or use Shift+Ctrl and right-click on the icon, then click Restore. 

Caution: May need to uninstall and reinstall the Cataloging Label Program

Users may need to uninstall and reinstall the Cataloging Label Program when upgrading to Connexion client 3.0 if they are unable to successful create or print labels using the Cataloging Label Program. 

A full list of known issues including issues reported in previous versions of the client that still appear in Connexion client 3.0 are available on the Connexion client known issues page.

System requirements

Connexion client 3.0 requires:

  • Windows 10, 64-bit, version 1803 or newer
  • Microsoft .NET Framework 4.7.2
  • 4 GB RAM minimum
  • 2 GB of available hard-disk space

 Note: While you do not need to have Admin privileges to run Connexion client 3.0, you will need them to install the client. This is due to components that need to be installed and registrations needed with the operating system.

 Caution: Connexion client 3.0 is not compatible with versions of Microsoft Office that are no longer supported by Microsoft.  If you are using an older, 32-bit version of Microsoft Office that is out of support, we suggest that you either upgrade your Microsoft Office to a newer, supported version; or, that you do not upgrade to Connexion client 3.0, but instead continue to use version 2.63.

Install/uninstall the client

We recommend backing up your existing profiles and macros before installing the new version:​

  • Existing profiles:   ​
    • X:\Users\<user>\AppData\Roaming\OCLC\Connex\Profiles​ (where X is the letter of your hard drive and <user> is your Windows user name.)
  • Macros: 
    • X:\Program Files (x86)\OCLC\Connexion\Program\Macros​ (where X is the letter of your hard drive.)
    • %LocalAppData%\VirtualStore\Program Files (x86)\OCLC\Connexion\Program\Macros (if applicable)

When upgrading from 2.63 to 3.0, Windows will do an upgrade and not force you to uninstall the previous version. If you are prompted to remove previous versions, follow these steps:

  1. Navigate to Control Panel > Programs and Features > Uninstall a program.
  2. Select OCLC Connexion client from the list of programs.
  3. Click Uninstall.
  4. Click Yes to confirm.

 Note: If you upgraded to client 3.0 and decide to move back to client 2.63, you will need to uninstall client 3.0 before installing client 2.63. Having both versions of client on your computer at the same time would cause macro and other system failures.

 

  • Was this article helpful?