General
Expand | ||
---|---|---|
| ||
This would be dependent on the nature of functionality that you are putting together. For configuring Apps for Inquiry and Data Visibility close to zero coding knowledge is needed. If you are looking to increase user interaction on the App (like listening to user clicks or taps and handling those), then you would need basic JavaScript knowledge. Canvas comes with an associated Message Hub that provides protocol adapters and message conversion options to handle easy consumption external interfaces. In cases where there is a need for custom logic for data fetch or massaging, related coding knowledge to execute the logic in Java is necessary. For working with transaction forms, additionally would include ability to configure validation rules (XML), database logic (SQL). |
Expand | ||
---|---|---|
| ||
Yes. This is supported. It is possible to have your existing application as a parent and embed “Apps” configured using Canvas Technology into it. If the intent is to have the application created using Canvas Technology as the main application, Canvas provides multiple options for integrating the existing application into the overall scheme of things. |
Expand | ||
---|---|---|
| ||
Yes. This is possible. Canvas provides the ability to configure data capture forms using wide variety of controls as well as ability to create forms out of other pre-created forms (like assembling content). Canvas also provides standard life cycle events within the form to allow for good responsive customer experience while interacting with the form. |
Expand | ||
---|---|---|
| ||
Yes. Canvas follows the Configure Once Run Anywhere principle. As part of the configuration, it supports the ability to target functionality to devices. |
Expand | ||
---|---|---|
| ||
Canvas Technology provides the ability for your application designer to choose between Response or Adaptive design. It does not mandate or enforce only a single UI design approach. |
Expand | ||
---|---|---|
| ||
Yes. Canvas provides the ability to package the configured application as an App that can be distributed through Apple Store or Google PlayStore. |
Expand | ||
---|---|---|
| ||
For most of the scenarios, the answer is No. It is not required to redistribute the App. Canvas uses a unique modeling concept that allows for the UI configuration information to be updated seamlessly into the App without having the need to repackage the App. Having said that, there are few situations like changes to skins, images, logic written through Canvas extensions that would require a repackage. |
Expand | |||||
---|---|---|---|---|---|
| |||||
Check for the following pattern in the error logs:
Solution: Check if any of the configuration in canvas-default-alertschdlrquartz.properties file is updated by comparing with the values in the original file in the CT platform release. If the value of the key org.quartz.jobStore.dataSource is changed, ensure that there is a datasource in that name. |
Expand | |||||
---|---|---|---|---|---|
| |||||
Check for the following pattern in the error logs:
Solution: Include the CTReadyApps.jar from the CT release to the application's dependencies folder. |
Expand | ||
---|---|---|
| ||
Check the following:
|
Expand | ||
---|---|---|
| ||
Scenario: The error message, “We were not able to complete your request due to a system error. As a result, no action is taken. Please contact Customer Support for further assistance. Reference id : be2fa6ca-c84f-4a8d-b7a7-1462cd0f2267” is displayed in a pop up when performing an action in the end application. Solution: Check the network tab of the browser console to verify the parameters passed for the request. Copy the reference number from the pop up and search for it in all the “.log” files within the work folder path to find the reason for the server side exception. |
Expand | ||
---|---|---|
| ||
Refer Adding a New Language in your Application - from Canvas 18.1 onwards. |
Expand | ||
---|---|---|
| ||
Refer Enabling Custom Load Mask. |
Data Rendering or Data Submission
Expand | |||||
---|---|---|---|---|---|
| |||||
Check for the following error pattern in the log file:
Solution: If such date format mismatch occurs, then change the value of the date field to the user-preferred format. |
Expand | |||||
---|---|---|---|---|---|
| |||||
Check for the following error pattern in the log file:
Solution: Request Modeler assigns a random and unique reference number for each request, which needs to be stored in the REFERENCE column in OD_AUDIT table in CT schema. Check in your code if the request data is modified to make the value of REFERENCE_NO column to null. If so, modify the code to make it not null because Request Modeler needs the reference number for internal processing. If you need to use or process a reference for functional logic, use a different column/variable to capture it. |
Expand | |||||
---|---|---|---|---|---|
| |||||
Scenarios:
For above scenarios, check for the following pattern in the error logs:
Solution: For any exception of the above pattern, check the ctdblogs to find the SQL ID of the query that is failing. If the query is related to functional database/schema, fix the query. If the query is within CT or includes a CT table, check if all the incremental scripts were applied properly. Even then if not resolved, inform the CT Platform support team. |
Expand | |||||
---|---|---|---|---|---|
| |||||
Check for the following pattern in the error logs:
Solution: Check if the connectivity to the functional DB is working. |
Expand | |||||
---|---|---|---|---|---|
| |||||
Check for the following pattern in the error logs:
Solution: For any exception of the above pattern, check the ctdblogs to find the SQL ID of the batch insert query that is failing. |
Expand | |||||
---|---|---|---|---|---|
| |||||
Check for the following pattern in the error logs:
Solution: Check if the JNDI is configured as a datasource in the server. |
Expand | |||||
---|---|---|---|---|---|
| |||||
Check for the following pattern in the error logs:
Solution: Check the data passed through the request modeler. It is advised to configure a unique key as the BUSINESS_KEY while creating the request modeler in Studio. The value passed must not be more than 256 characters. |
Expand | ||
---|---|---|
| ||
Refer Amount page for more information. |
Expand | |||||
---|---|---|---|---|---|
| |||||
Check for the following pattern in the error logs:
Solution:
|
Expand | |||||
---|---|---|---|---|---|
| |||||
Check for the following pattern in the error logs:
Solution: Check the stack trace to find the details of the web service that did not return the success response. |
Expand | ||
---|---|---|
| ||
Scenario: Data persistence is sometimes required at every page while moving to next page as end-users of the application can quit the application at any stage and come back to resume the work. Solution: CT Platform does not maintain the state of each form or page. Implementation team must write code to handle persist data across pages or forms for the required functional behaviour in the application. |
Expand | ||
---|---|---|
| ||
Refer Custom Publisher. |
Expand | ||
---|---|---|
| ||
Refer Additional Ready-made Activities supported by Request Modeler. |
Encryption
Expand | ||
---|---|---|
| ||
You can enable encryption for the application built using Canvas by setting the 'ENCRYPT_SERVER_CALLS' property to 'Y' in the 'systempreferences.properties' file.
A sample 'systempreferences.properties' file is available in CTModelHouseResource.jar in the Model House application that comes as part of the Canvas platform package. Note that you must stop and start your application server to enable this feature. After the application server is restarted, access the widgets in the application and check the Network tab in the browser console to verify the encryption. |
Expand | |||||
---|---|---|---|---|---|
| |||||
Check for following error pattern in the log file:
Solution: If such error pattern occurs (line numbers 1, 2, 4, 7-9) in the logs, then check the following:
|
CSS
Expand | |||||
---|---|---|---|---|---|
| |||||
You can explicitly enable horizontal scroll bar for a widget through CSS. Let's consider a grid widget shown in the following screen shot taken from the sample application, ModelHouse. Assume that the ModelHouse application is using the Market theme and the corresponding CSS file is: D:\Canvas\apache-tomcat-7.0.67\webapps\ctmodelhouse\css\style\market\jqtbs\market-jqtbs-ltr.css. To enable horizontal scroll bar for the grid widget, perform the following:
|
Expand | |||||
---|---|---|---|---|---|
| |||||
You can hide the column headers of a grid widget through CSS. Let's consider a grid widget shown in the following screen shot taken from the sample application, ModelHouse. Assume that the ModelHouse application is using the Market theme and the corresponding CSS file is: D:\Canvas\apache-tomcat-7.0.67\webapps\ctmodelhouse\css\style\market\jqtbs\market-jqtbs-ltr.css. To hide the column headers and the filter bar of a grid widget, perform the following:
|
Expand | |||||
---|---|---|---|---|---|
| |||||
You can hide a specific column header in a grid, such as plus icon header column in Grouped Grid through CSS. Let's consider a grid widget shown in the following screen shot taken from the sample application, ModelHouse. Assume that the ModelHouse application is using the Market theme and the corresponding CSS file is: D:\Canvas\apache-tomcat-7.0.67\webapps\ctmodelhouse\css\style\market\jqtbs\market-jqtbs-ltr.css. To hide hide a specific column header in a grid, perform the following:
|
Expand | |||||
---|---|---|---|---|---|
| |||||
You can hide the forms title in form wizard through CSS. Let's consider a form wizard shown in the following screen shot taken from the sample application, ModelHouse. Assume that the ModelHouse application is using the Market theme and the corresponding CSS file is: D:\Canvas\apache-tomcat-7.0.67\webapps\ctmodelhouse\css\style\market\jqtbs\market-jqtbs-ltr.css. To hide the forms title in a form wizard, perform the following:
|
Expand | |||||
---|---|---|---|---|---|
| |||||
You can hide a specific form's title in a form wizard through CSS. Let's consider a form wizard shown in the following screen shot taken from the sample application, ModelHouse. Assume that the ModelHouse application is using the Market theme and the corresponding CSS file is: D:\Canvas\apache-tomcat-7.0.67\webapps\ctmodelhouse\css\style\market\jqtbs\market-jqtbs-ltr.css. Consider that in the form wizard shown in the screen shot you want to hide the "Add Payee" title alone. To hide a specific form's title in a form wizard, perform the following:
|
Expand | |||||
---|---|---|---|---|---|
| |||||
You can adjust the width of the tab panels in a form wizard through CSS. Let's consider a form wizard shown in the following screen shot taken from the sample application, ModelHouse. Assume that the ModelHouse application is using the Market theme and the corresponding CSS file is: D:\Canvas\apache-tomcat-7.0.67\webapps\ctmodelhouse\css\style\market\jqtbs\market-jqtbs-ltr.css. To adjust the width of the tab panels in a form wizard, perform the following:
|
Expand | |||||
---|---|---|---|---|---|
| |||||
You can insert icons for form item labels through CSS. Let's consider a form shown in the following screen shot taken from the sample application, ModelHouse. Assume that the ModelHouse application is using the Market theme and the corresponding CSS file is: D:\Canvas\apache-tomcat-7.0.67\webapps\ctmodelhouse\css\style\market\jqtbs\market-jqtbs-ltr.css. To insert icons for the form item labels, perform the following:
|
Expand | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
Canvas Technology platform supports SASS from 19.1 version. While SASS compiles successfully on Windows servers, in some non-Windows systems (e.g. HP Unix or iOS) SASS compilation fails during deploying the application. In these cases, you must copy the CSS files from the correctly deployed development or testing environment (Windows) and store those in the failed environment (non-Windows). You must then remove the SASS references in the CSSConfig.xml file and use plain CSS instead to successfully deploy the application on non-Windows environments. Perform the following steps:
|
Forms
Expand | ||
---|---|---|
| ||
To insert a form in another form, perform the following steps:
|
Expand | ||
---|---|---|
| ||
To insert a grid in a form, perform the following steps:
|
Expand | ||
---|---|---|
| ||
The mechanism to change the placeholder for displaying error messages for each form field is supported at the application-level, meaning the placeholder can be set for all form items globally across the whole application. By default, Canvas displays the error message for a form field on hovering over the error icon that is adjacent to the form item. However, you can change it to display the error message below the form items. For details of this mechanism, refer Displaying Error Messages below the Form Items. |
Expand | ||
---|---|---|
| ||
Yes. Define filesets in the ondemandjsfile.xml grouping the JS files needed. Use canvas.core.downloadManager object's requireScripts API to fetch this fileset before loading the form. |
Expand | ||
---|---|---|
| ||
Expand | ||
---|---|---|
| ||
Refer Configuring Request Modeler Actions for Self-Designed Forms. |
Expand | ||
---|---|---|
| ||
Refer Form Items Event Wiring. |
Expand | ||
---|---|---|
| ||
Refer Form and Form Item APIs. |
Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
Use the following syntax to use the performance timer:
|
Database
Expand | ||
---|---|---|
| ||
Data can be fetched using Instruction classes (Java class) in Canvas. Canvas uses iBatis library for database access. Callable statements can be used to access Stored Procedures and Functions to get the data.
|
Expand | ||
---|---|---|
| ||
Database details are fetched by Canvas as JNDI lookups (preferred approach). Alternatively, the connection details can be stored in the DB and datasources can be created to point to these connections to fetch data. |
Expand | ||
---|---|---|
| ||
Yes. Canvas can fetch data from multiple databases (either as JNDI lookup or via Connection Details configured). |
Expand | ||
---|---|---|
| ||
Data connection strings are stored on the server in the case of JNDI. The JNDI names are referred in a property file as part of the application WAR file. Alternative approach stores the database details in the Canvas framework's database instance. |
SSO
Expand | ||
---|---|---|
| ||
The authentication token provided by the SSO's authentication provider has to be stored in a Canvas' custom object called SessionInfo, which will be stored in the session object. This will be passed by Canvas to the application code for all requests coming in which can be used by application to do re-authentication/re-authorization as appropriate. This re-authentication is typically done in a SessionFilter, which is attached to all requests. |
Entitlement
Expand | ||
---|---|---|
| ||
Canvas supports multiple criteria values that can be defined at Product-SubProduct-Function level. Each grid column can specify one criteria to be respected. |
Charts
Expand | ||
---|---|---|
| ||
Yes. Chart allows customizations via a configuration (using properties that are exposed by Fusion Charts). |
Expand | ||
---|---|---|
| ||
No. End users are not allowed to change the column titles. However, they can change the filters applied by default and can save those as custom views which will be applicable to those users. |
Session
Expand | ||
---|---|---|
| ||
When a user is logging in, Canvas creates a custom SessionInfo object, loads it with user details, and stores it in session. When the session times out or when the user logs out, session is invalidated and the SessionInfo is cleared. This is orchestrated by a class called SessionManager. Application must call SessionManager's validate session. Each request will be validated for a valid session using SessionFilter. |
Templates
Expand | |||||||
---|---|---|---|---|---|---|---|
| |||||||
Whenever you modify any CTTPL files that comes with CT framework, it is necessary to ensure that the updated template (CTTPL) files are loaded correctly. To load the updated CT framework templates files using etag, add the following code snippet in the CT_Home.jsp page of Canvas Studio:
|
Grids
Expand | ||
---|---|---|
| ||
To enable columns sorting and filtering, and pagination on grid apps that display data from web services, it is necessary to enable the data cache option. Let’s assume that the ACCOUNT DETAILS classic grid app (widget), with a web service data source is already created in Canvas Studio.
|
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
To add new set of records for the Live Scroll Grid with Cache or Paging Grid widgets, perform the following steps:
|
Cookies
Expand | ||
---|---|---|
| ||
By default, in the HTTP response header, the SameSite attribute in the Set-Cookie header element prevents the cookies from being sent to the server in the hybrid mobile apps. For example, if the SameSite attribute has been specified as "SameSite=Strict", ensure that you nullify the SameSite attribute with "None", for instance, "SameSite=None", thereby removing the SameSite attribute from the Set-Cookie header element in the HTTP response.
|