This content applies solely to Appian Portals, which may require an additional license purchase. |
A portal can consist of many different objects, connections, and configurations, any of which can experience issues. If you experience an error with a portal, it is likely that it will either happen in the Portal Publishing Manager or in the portal itself.
This page provides information about error logs, as well as some of the most common errors you may run into, including initial steps you can take to address the errors. Note that it is not a comprehensive list of all possible errors or issues.
The error messages on this page are examples. Your actual error message may be different.
Errors related to your portal, processes, and actions can be found in a few places:
If you're having trouble finding cause of the error, start by looking at the objects, connections, and configurations that may be implicated by the error.
If the error is about connecting back to Appian, integrations, databases, or APIs, check out the server log for your environment, external system, or database.
If your error doesn't have to do with one of those, check your portal log file. For instructions on downloading the portal log file, see Manage Portals.
Error message:
"Expression evaluation error in rule 'apdm_fm_createnewportalapp': An error occurred while executing a save: Expression evaluation error at function fn!error: Could not export interface dependencies. A service account must be provided."
Where will you see the error:
Portal Publishing Manager
Next steps:
Check that the service account you selected has permission to the data source(s) referenced in your interface. Also, ensure that no data stores are unintentionally referenced in your portal objects (for example, querying a data store for test data).
Error message:
"[title=The requested URL cannot be found, message=The external system did not find the requested URL or is refusing to allow access, detail=HTTP/1.1 404 Not Found]"
Where will you see the error:
Portal
There are two different ways to view this error:
error
field of the dictionary returned.fv!error
in the onError
parameter of the integration rule.Next steps:
Error message:
"Authentication failed. Please check your credentials and try again."
Where will you see the error:
Portal
Next steps:
Check that the service account used when publishing your portal has permission to upload documents to the target document folder.
Error message:
"Expression evaluation error at function a!queryEntity: The data store entity does not exist, has been deleted, or you do not have sufficient privileges to access its data."
Where will you see the error:
Portal
Next steps:
This can be caused by scenarios such as invalid database/data store entity, wrong credentials in properties file, or data store entity not verified.
Error message:
Varies based on function or component used. Example:
"Expression evaluation error at function a!userRecordLink: Invalid function a!recordlink (not available as [])"
Where will you see the error:
Portal
Next steps:
Ensure all functions and components used in the interface are compatible with Appian Portals.
Error message:
"HTTP Code: 404
Could not find portal interface with uuid: _a-0000e827-7a29-8000-9bd3-011c48011c48_11234"
Where will you see the error:
Portal
Next steps:
The most likely cause of this error is if you deployed the application from a lower environment. Ensure there are no missing precedents of the interface being published in the current environment. All interface precedents must be present in the environment being used to publish the interface.
Error message:
Varies depending on error from Google. Example:
"API key not valid. Please pass a valid API key."
Where will you see the error:
Portal—as the value of fv!error
in the onError
parameter of a!verifyRecaptcha()
Next steps:
See Testing, monitoring, and troubleshooting reCAPTCHA for more information.
Error message:
"Error. Portal creation failed"
Where will you see the error:
Portal Publishing Manager
Next steps:
Error message:
"Error. Portal cannot exceed 15MB limit. Package size was 20MB. Reduce the total size of documents referenced by constants in your interface and try again."
Where will you see the error:
Portal Publishing Manager
Next steps:
Reduce the total size of images or other documents referenced by constants in your interface.
Error message:
"Expression evaluation error in rule 'apdm_fm_createnewportalapp' : An error occurred while executing a save: Expression evaluation error at function fn!error : Could not export interface dependencies. Invalid data source(s). Ensure the connected system(s) and credentials are configured correctly."
Where will you see the error:
Portal Publishing Manager
Next steps:
Make sure you have your import customization file in the correct format, and that your credentials are correct.