Troubleshoot

1. Forms and other pages in the Enterprise Console does not respond when left idle for a long time.

Resolution:

Log on to the Enterprise Console again.

2. In the Safari browser:

1. Tabbing through the forms controls does not focus on the control and skips controls that are rendered as links.

2. Adding records in the Grid view of a Base Form at run-time by pressing the Tab key from the last focused control of the record does not work.

Resolution:

Edit the advanced settings of the Safari browser and select Press Tab to highlight each item on a webpage check box.

3. Unable to display image using the Image control.

Possible Causes:

In the HTML code, the image src attribute of the image tag takes the computer name instead of the IP address. The image is not displayed if the computer name of the machine is not resolved.

Resolution:

Analyze the HTML code using the developer tool of the browser. If the computer name is not being resolved in the img src attribute, contact your network administrator.

4. Adding values of number controls using the Value script appends the numbers instead of summing them up.

// Adding number values without typecasting the values will append the numbers.

instOne = control.findById("N1").value;

instTwo = control.findById("N2").value;

return instOne + instTwo;

Resolution:

Typecast the values of number controls to numeric values before summing them up.

// Typecast the values of number controls to numeric values to sum the numbers.

instOne = control.findById("N1").value;

instTwo = control.findById("N2").value;

if(instOne != "")

 instOne = Number(instOne);

if(instTwo != "")

 instTwo = Number(instTwo);

return instOne + instTwo;

5. An alert message Unable to get property <column name> of undefined or null reference appears when an item is selected and cleared in the Data Grid control with the Extended Information property set to Yes, and the value in the bound Text control is not cleared.

Resolution:

Script as follows to resolve this issue.

var rowData = control.findById("G1").extendedInformation; // Array

if(rowData.length > 0)

 {

 control.findById("T1").value = rowData[0].ID;

 }

else

 {

 control.findById("T1").value = ""; // Undefined

 }

6. After upgrading from Skelta BPM.NET 2011 to Wonderware Skelta BPM 2014, the maximum transfer size of JSON strings from server to client is restricted to 102400 characters.

Possible Causes:

The default maximum transfer size of JSON strings from server to client is 102400 characters, which is equivalent to 100 KB of Unicode string data.

Resolution:

In the web.config file, edit the maximum length of JSON strings as follows:

<configuration>

 <system.web.extensions>

 <scripting>

 <webServices>

 <jsonSerialization maxJsonLength="4096000"/>

 </webServices>

 </scripting>

 </system.web.extensions>

</configuration>

7. In the On Form Load script, commented statements are executed.

Resolution:

In the JavaScript code, remove the commented statements.

8. In the iOS WorkTask app:

3. Debugger does not work.

4. Form does not render.

Resolution:

In the JavaScript code, remove the debugger statements.

9. In Firefox browser, dialog boxes do not appear after selecting Prevent this page from creating additional dialogs.

Possible Causes:

The Firefox browser provides an option to the user to turn off subsequent dialog boxes if additional dialog boxes are shown within 3 seconds.

Resolution:

Reload the web page and do not select Prevent this page from creating additional dialogs, if it appears again.

10. Data Lookup control shows “T” separator between Date and Time for Date Time data.

Possible Causes:

JSON Date Time data has “T” separator between Date and Time.

Resolution:

Return database column containing Date Time data as string when retrieving date time from the database.

For example, convert LastUpdatedDateTime column from date time to string as follows:

SELECT Id,Name, LastUpdatedDateTime, CONVERT(nvarchar(150), LastUpdatedDateTime,121) AS DisplayUpdatedDateTime FROM Employee

11. When API confirmation message, API Alert message, API Error message, and API warning message are present in one button control, only the first API message is displayed on a surface device.

Possible Causes:

Scripting guidelines to display messages are not followed.

Resolution:

Script as follows to resolve this issue.

SFU.showConfirmation("Test <b>Confirmation</b>", "Confirmation Details:Do you <b>wish</b> to continue?",

function (val)

{

if (val)

{

SFU.showAlert("Continue", "Confirmation Process will be continued.<br/>Please contact admin for more information.",

function ()

{

SFU.showWarning("Test ,<b>Warning</b>", "Warning Details:Do you <b>wish</b> to continue?",

function (val)

{

if (val)

{

SFU.showAlert("Continue", "Warning Process will be continued.<br/>Please contact admin for more information.");

}

});

});

}

});

12. In a form with Data Grid control, at runtime if you select one record, multiple records are checked automatically. Also, the On Selection Change event gets triggered multiple times.

Possible Causes:

In the Data Grid configuration, the Persist Columns selected are not unique.

Resolution:

Ensure that the Persist Columns are unique.

13. Report Viewer configuration error.

The following error message appears when you try to view a Form that contains a Report Viewer control.

Resolution:

If the web site is created in integrated mode, enter the following entry in the webserver\handler section of the web.config file of the respective Microsoft SharePoint site:

<add verb="*" path="Reserved.ReportViewerWebControl.axd" type="Microsoft.Reporting.WebForms.HttpHandler, Microsoft.ReportViewer.WebForms, Version=11.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91" validate="false" />

14. The error message, depicted in the image below, appears in the following scenarios:

• Design a form with a custom control, take a backup of the repository, and use that repository as an attached data source. Replace the control in a form when the custom control dll is not present in the specific environment.

• Import a form into an environment where the custom control is not present.

Resolution:

Perform the following to ensure that the custom control is present in the environment:

• Ensure that the dll is present in the SOA Folder or GAC.

• Ensure that all the required js and css files are present in the NextGenForms Folder.

• Create a SOA folder with the same name and add the same physical path where the custom control dll is present.

• Create Form Controls with the same name for the imported and exported Forms.

15. The error message, depicted in the image below, appears in the following scenarios:

• Design a form with a custom control, which has an exception.

• Replace a control from Replacement Control Configuration with a custom control, which has an exception.

Resolution:

Perform the following to ensure that there is no error while loading the control:

• Ensure that the dll is present in the SOA Folder or GAC.

• Ensure that custom control is configured in the Forms Control.

• Correct the exception and replace the dll.

16. The error messages, depicted in the below images, appears in the following scenarios:

• When a Form definition is imported, the below error appears from the custom control.

Resolution:

Perform the following to ensure that there is no error while loading the control:

• Ensure that the dll is present in the SOA Folder or GAC.

• Ensure that custom control is configured in the Forms Control.

• Correct the exception and replace the dll.

• Open the XML file and delete the custom control definitions.

17. The JavaScript "debugger;" statement is not present in the Forms script during run time.

Resolution:

As part of performance tuning, we had introduced the minification of the View model when publishing the Form. The debugger works in the preview page, but in Fill Form, Form link, Work Item, or any places other than the preview page, the View model does not have the debugger statement due to minification.

In an environment, you can change this behavior. In the Farm DB, there is a SKRepository table. In the Properties column, there is a property formEnableMinification which has the value True. If changed to False, the minification does not happen for the published Forms and you can debug the Form. After changing the property value in the table for the respective repository, republish the Form for the changes to take effect.

Note: You should not change the property value in the production environment.

18. External URL for Web API, Embed Page, Images, and so on do not load in the Form, and an error gets logged in the Browser Console as "Refused to ... because it violates the following Content Security Policy ..."

Possible Cause:

Loading of the External URL for Web API, Embed Page, Images, and so on depends upon the Content Security Policy for the Enterprise Console Web Application.

Resolution:

This applies to images used in controls like Image, RichText, and so on in Forms and Embed Page control with the URL set to a different domain. The Content Security Policy can be modified as per user requirement and defined accordingly. For more details, refer to Content Security Policy documentation on the W3C website. You can specify the URLs based on the same domain in the Form controls. For images, you can use data-URLs.