Office Launcher Installation

Since codebeamer 7.4.x and newer, editing Working Item Descriptions and Microsoft Office documents can be performed directly in Microsoft Office, however, this feature needs a simple setup on front-end PCs. On front-end PCs, Microsoft Office (on Windows: Office 2007 or higher) must be installed.

Windows

Windows users should download and install the Codebeamer Office launcher.

Linux

How to configure Firefox

• Download cboffice_launcher.sh.
• Ensure that the script is executable with the command below:
  chmod a+x cboffice_launcher.sh
• Enter about:config as shown below and create a New Boolean (right mouse click).
  
• Enter network.protocol-handler.expose.cboffice and select false as value.
• The first time you click on a URL such as cbofffice:// and Firefox asks which script should be used, select the downloaded office / cboffice_launcher.sh.

How to configure Chrome

Download cboffice.desktop and read the instructions.

Troubleshooting

If a selected application does not start and an error screen is displayed, ensure there is an associated application for the selected file type.

Example of a correct association for Microsoft Excel .xlsx files:

C:\Windows> cmd /c assoc .xlsx
.xlsx=Excel.Sheet.12

C:\Windows> cmd /c ftype Excel.Sheet.12
Excel.Sheet.12="C:\Program Files\Microsoft Office\Root\Office16\EXCEL.EXE" "%1"

If there are no associated applications, the commands will return empty results, for example:

C:\Windows> cmd /c assoc .xlsx
File association not found for extension .xlsx

C:\Windows> cmd /c assoc Excel.Sheet.12
File association not found for extension Excel.Sheet.12

A default application for that file type must be selected on the Windows Apps > Default apps panel:

For more information, see the official Microsoft support page on changing default programs: Change default programs in Windows.

Codebeamer Office launcher log files

The cboffice_launcher.log file is created on each PC where the Codebeamer Office launcher tool is installed. It contains the logs from the Codebeamer Office launcher. The logs are useful to troubleshoot issues with opening files when no information is captured in the Codebeamer server logs.

The location of the cboffice_launcher.log file is the following:

%TEMP%\cboffice_launcher.log

On Windows, for example:

C:\Users\<username>\AppData\Local\Temp\cboffice_launcher.log

How to configure Office Edit in Codebeamer

To configure Office Edit in Codebeamer, add the referenced section to Application Configuration: "officeedit" section.