admin/raven
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

case 4449

Browse Source
This commit is contained in:
John Cardinal
2023-03-06 22:24:27 +00:00
parent a74afaf9a9
commit b48daea683
1 changed files with 20 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
docs/8.0/ayanova/docs/ops-config-report-rendering-api-url-override.md
View File

@@ -4,20 +4,35 @@ The report rendering api override setting is used in situations where report ren
The symptom of this issue is reports failing to render with an error displayed containing text similar to "JobFailed: PuppeteerSharp -> Evaluation failed: TypeError: Failed to fetch at ayPostToAPI"
Reports are rendered by a "headless" web browser running at the AyaNova server which executes the javascript required to render the report. Most report scripts will need to contact the AyaNova API to fetch data like translations or logos. In some scenarios such as some specific configurations when using IIS as the front end for AyaNova the local headless browser is prevented from contacting the AyaNova server due to accessing it via the `localhost` address. In these situations it's necessary to tell the script to use an alternative external address (the same address used by the AyaNova web program used at the browser).
Reports are rendered by a "headless" web browser running at the AyaNova server which executes the javascript required to render the report. Most report scripts will need to contact the AyaNova API to fetch data like translations or logos. In some scenarios such as some specific configurations when using IIS as the front end for AyaNova the local headless browser is prevented from contacting the AyaNova server due to accessing it via the `localhost` address. In these situations it's necessary to tell the script to use an alternative address.
Note that because reports are rendered by a headless browser running _at_ the AyaNova server you can use a regular web browser at that machine for a [diagnostic process](#diagnostic-process) to determine the correct URL override setting. (If you can't run the AyaNova web application locally _at_ the IIS / AyaNova server then reports will not render either until the correct URL is found.)
Most often though the initial setting recommended below will rectify this issue.
## What to do if you need to set this value
This value should be set to the URL that external users on the internet use to connect to the AyaNova web application.
We have seen inconsistent requirements for this setting in production use scenarios so we recommend two possible settings to try first and failing that initiating a diagnostic process _at_ the IIS server to determine a suitable setting.
Note that in each case when making changes to the configuration setting it is necessary to completely restart AyaNova or the setting will not take effect. You can confirm this by examining the AyaNova server log in the AyaNova UI Server Operations section and confirm that the server log shows AyaNova server was rebooted and has logged the new configuration setting you changed.
The first and most likely setting to resolve this issue is to set to the URL that external users on the internet use to connect to the AyaNova web application.
So, for example, if your AyaNova server is normally connected to in a web browser at the url `https://ayanova.example.com` to use the AyaNova web application then you would set this value to exactly that `https://ayanova.example.com`.
## Default
If the above does not work try the _local_ non encrypted (http) address of the AyaNova server itself (NOT the encrypted address configured for external users in IIS) for example:
If no override is specified AyaNova will use the following internal default value:
`http://localhost:7575`
`http://127.0.0.1:{Port}`
(substitute your port number if you didn't take the default 7575)
## Diagnostic process
If neither of the above settings work note that the correct URL to set for the override can be determined by using a browser _at_ the IIS server itself to open the AyaNova web application and attempt to login and use the application.
Since the report generator uses the same API as the AyaNova web application the URL that works in the browser for the AyaNova web application will also work for the report rendering system and will be the setting you need to use in the override URL.
If no combination of url or ports work at the server it's also possible that a firewall configuration is preventing access and should be eliminated as the source of the issue before contacting technical support.
## Overriding