Troubleshooting Tips

Review the following tips when troubleshooting WebFOCUS App Studio.

Startup Failures

If you encounter issues during the launch of the WebFOCUS App Studio product, click the Start button on the taskbar, and in the list of installed applications, expand the ibi app. Select the WebFOCUS 93 App Studio folder, double-click the WebFOCUS App Studio Utilities folder, and run the product with the WebFOCUS App Studio (Safe Mode) executable.

If WebFOCUS App Studio terminates unexpectedly, the product generates a log file and captures information that you can submit to the Customer Support team for analysis. When this situation occurs, a message displays, with the location where the log file is created.

The name of the WebFOCUS App Studio fault log file is AppStudioFault.log. The file is saved in the My Documents folder.

The My Documents folder is used as a unified location for storing personal data and, by default, is configured to point to the local machine on folder C:\Users\user_ID\Documents\. You can configure this location to point to a different folder, another drive, or another computer on your network. For some organizations, the My Documents folder location may be set by using a group policy, in which case its properties cannot be changed.

Starting ibi WebFOCUS App Studio

If you close WebFOCUS App Studio and then cannot restart it, you may need to manually stop the underlying AppStudio.exe process. To do this:

  1. Press Ctrl + Alt + Delete and choose Task Manager.
  2. Click the Processes tab.
  3. Find and select an AppStudio.exe Image Name if it appears.

    Note: You can click the Image Name column to sort by name.

  4. Click End Process.

You should be able to restart WebFOCUS App Studio if no AppStudio.exe processes appear.

Manual Registration to Enable Multiple Browser Support in ibi WebFOCUS App Studio

Developers can use Chrome™, Firefox®, or Edge® when running reports.

To use Chrome or Firefox, the product requires registration of the IBIWebBrowserDrivers_dotnet_35.dll .NET module that is included with the product.

To register this file, .NET version 4.0 is required. This version of .NET is installed on most machines. If your machine does not have this .NET version, it will be installed during the WebFOCUS App Studio installation process and the module needed to support multiple browsers will get registered.

If the registration of the module fails, the developer is not able to switch browsers. To address this issue, the developer must register the required module manually. To do this, open a Command Window, with the option Run as administrator, and run the following commands: 

%SystemRoot%\Microsoft.NET\Framework64\v4.0.30319\RegAsm
C:\ibi\AppStudio93\bin\ibiwebbrowserdrivers_dotnet_35.dll /u

A message should display that the file unregistered successfully.

Then run: 

%SystemRoot%\Microsoft.NET\Framework64\v4.0.30319\RegAsm
C:\ibi\AppStudio93\bin\ibiwebbrowserdrivers_dotnet_35.dll

A message should display that the file registered successfully.

where:

%SystemRoot%

Is the location of the Windows folder on your machine. This includes the drive and path. It is usually the C drive. For example, C:\Windows.

Note:

  • Adjust the above commands based on location of the WebFOCUS App Studio installation location.
  • The commands in the documentation are shown in two separate lines, but they should be issued as one command.

Updating the Selenium Software and Driver Executables

Selenium is a suite of tools specifically for automating web browsers. Selenium support is included with WebFOCUS App Studio, however, if you install a new browser version it may not work with WebFOCUS App Studio. In this case, the Selenium support modules can be updated manually which may resolve the issue.

    Procedure
  1. Check the version of the browser on your machine.
  2. Download the version of the driver corresponding to the version of the browser on your machine.

    For Google Chrome

    Go to https://chromedriver.chromium.org/downloads and from the Help About, Google Chrome option, check the version of Google Chrome you have on your machine and download the corresponding driver.

    An example of the About Google Chrome dialog box is shown in the following image.

    An example of the Google Chrome Downloads dialog box is shown in the following image.

    For Microsoft Edge

    For Microsoft Edge, if your version of App Studio supports it, go to https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/ and from the Help and feedback, About Microsoft Edge option, check the version of Microsoft Edge you have on your machine and download the corresponding driver.

    An example of the About Microsoft Edge dialog box is shown in the following image.

    An example of the Microsoft Edge Get the latest version dialog box is shown in the following image.

    For Mozilla Firefox

    Go to https://github.com/mozilla/geckodriver/releases and from the Help, About Firefox option, check the version of Mozilla Firefox you have on your machine and download the corresponding driver.

    An example of the About Firefox Browser dialog box is shown in the following image.

    An example of the Mozilla Firefox Assets dialog box is shown in the following image.

  3. Extract the downloaded zip file.

    Depending on your browser, the downloaded zip file will contain one of the following files:

    • For Google Chrome, the chromedriver.exe file.
    • For Microsoft Edge, the msedgedriver.exe file.
    • For Mozilla Firefox, the geckodriver.exe file.
  4. Close App Studio and copy the .exe file into a bin directory of an App Studio installation (for example, C:\ibi\AppStudio93\bin).