From 8712d25400189996ecb4c9660d8e445660e28d3d Mon Sep 17 00:00:00 2001 From: "Peter.Morton" Date: Thu, 21 Dec 2023 20:50:21 -0600 Subject: [PATCH] updated readme with WebIntegrationURL settings --- README.md | 44 +++++++++++------- ...IntegrationURL_TelephonyContextExample.png | Bin 0 -> 213470 bytes 2 files changed, 27 insertions(+), 17 deletions(-) create mode 100644 screenshots/WebIntegrationURL_TelephonyContextExample.png diff --git a/README.md b/README.md index 70e96e1..2296610 100644 --- a/README.md +++ b/README.md @@ -28,9 +28,9 @@ Parameters prefixed with 'tps:' will fetch values from the Tenant Properties Ser | integrationCardTitle | Title over Integration card | | integrationCardDoc | HTML document for contents of integration card | -# Installing into an Innovation Lab +## Installing into an Innovation Lab -## Prerequisites +### Prerequisites Make sure npm is installed and node us up to date @@ -41,35 +41,45 @@ sudo n stable hash -r ``` -## Build the project +### Build the project Clone this project, install and build. -```sh + cd /opt/em/projects/current/demo/static git clone https://git.mortons.site/verint.com/ca_vue_apps.git cd ca_vue_apps npm install +touch .env +``` + +Edit the .env file to hold the Channel Automation api username & password we cannot use the '__Host-VRNTOTCT' cookie because it is HttpOnly and not passed to browser side javascript. So we use the oidc-token-service to grant us a token using username/password. + +```env +// file .env +VITE_API_USERNAME=apiclient +VITE_API_PASSWORD=apiclient +``` + +Build the distribution + +```sh npm run build ``` -## Proxy Apache to the distribution +The 'static' directory is already served by Apache so this Application is now available. Configure the Web Integration URL to use it. See Screenshot below: -Add the following directive to the apache site configuration: +![WebIntegrationURL](screenshots/WebIntegrationURL_TelephonyContextExample.png) -```apache +## Development -``` - -# Development - -## Install +### Install ```sh npm install ``` -## Running +### Running List options using: @@ -85,7 +95,7 @@ VITE_API_USERNAME=apiclient VITE_API_PASSWORD=apiclient ``` -## CORS Work Around +### CORS Work Around When developing this on localhost against Channel Automation APIs hosted elsewhere, you will need to apply a work around for CORS because the preflight check will fail with a 401 Not Authorized error. @@ -104,15 +114,15 @@ The fix is to use Apache Rewrite on the API host server to respond OK to the pre ``` -# Vue 3 + TypeScript + Vite +## Vue 3 + TypeScript + Vite This template should help get you started developing with Vue 3 and TypeScript in Vite. The template uses Vue 3 `