Troubleshooting Tips

Review the following tips when troubleshooting WebFOCUS App Studio.

Updated Browser Issues

Newer browser versions may not immediately work with WebFOCUS App Studio. In this case, the Selenium support modules included with WebFOCUS App Studio can be updated manually and may resolve the issue. Selenium is a suite of tools specifically for automating web browsers.

  1. Go to the http://seleniumhq.org/download website.
  2. Under the Selenium Client & WebDriver Language Bindings section, locate the C# line, and click the Download link to get the ZIP file.

  3. Unzip the three 3.14.0 .nupkg files:

    • Selenium.Support.3.14.0.nupkg
    • Selenium.WebDriver.3.14.0.nupkg
    • Selenium.WebDriverBackedSelenium.3.14.0.nupkg
  4. Save the .nupkg files as .zip files.
  5. Navigate to the lib/net40 directory to access the dll files.
  6. Extract the dll files from the zip files.
  7. Copy the dll files to the AppStudio82\bin folder.
  8. Restart WebFOCUS App Studio and test the installed browser version. If there is still a problem, open a Customer Support case.
Note: If you are using Microsoft Edge, you may need to get an updated driver from Microsoft which is usually available on the Microsoft web site.

Starting ibi WebFOCUS App Studio

On rare occasions, WebFOCUS App Studio may fail to initialize correctly. If this happens, you can start the product in safe mode, or close the product manually.

Starting in Safe Mode

WebFOCUS App Studio may fail to initialize correctly if a problem occurred during the previous close. In rare cases, a file in the Configured Environments tree can remain persistent when it should have closed. A file in this state will attempt to transact with the server before the application is fully initialized.

Starting WebFOCUS App Studio in safe mode initializes the product with its environments only.

  1. In your windows start menu, navigate to the Information Builders section. Immediately below WebFOCUS App Studio is WebFOCUS App Studio (Safe Mode). Click the Safe Mode option.

    Alternatively, you can navigate to the folder where WebFOCUS App Studio is installed. Open a command prompt and type appstudio-s.

    WebFOCUS App Studio opens with the environments displaying in the Configured Environments tree.

  2. Double-click to expand the environment. Navigate to your content as needed.

    A file that remained persistent after the previous close will be able to transact with the server without conflict. A file in this state will close normally the next time you close WebFOCUS App Studio.

    After starting in Safe Mode, you may work normally in WebFOCUS App Studio. The next time you start WebFOCUS App Studio, you can use the normal WebFOCUS App Studio option.

Closing Manually

If starting WebFOCUS App Studio in safe mode fails to initialize the product, it may be that the underlying AppStudio.exe process did not terminate correctly during the previous close. In this case, you can manually end the AppStudio.exe process.

  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.
  5. Start WebFOCUS App Studio normally.

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 preinstalled 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.

In a few cases, on Windows 8.1 machines where the registration of the module fails, the developer will not be 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\AppStudio82\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\AppStudio82\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 the 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.