Definizione ed Acronimi

IYM	InforYou Manager
IYES	InforYou Ecosistema
Directory	Cartella
ver.	Versione
App	Applicazione Mobile
BUS	Business
PRO	Professional
STA	Standard

Introduzione

Il presente documento ha come scopo la definizione della procedura di installazione dell’Ecosistema InforYou EcoSystem (IYES) presso il centro del cliente (palestra, centro sportivo, piscina).

Ambiente

IYES richiede un’istanza di IIS correttamente configurata, esposta all’esterno mediante IP statico, qualora si voglia permettere l’accesso a IYES da Internet, oppure un IP interno alla rete nel caso in cui le applicazioni sviluppate siano utilizzate in rete locale. Il sistema operativo consigliato è Windows Server 2008/2012 con IIS 7.5/8.0. E’ necessaria inoltre un’installazione valida di InforYou, con un database SQLServer configurato ed accessibile.

Installazione

Creare una directory e configurarla come Sito Web all’interno del server. Impostare come si desidera il binding del sito configurando IP, porte (attenzione per le app di Make It App siamo d’accordo di impostare come porta 8586) e application pool (deve usare ASP.NET 4.0). Copiare il contenuto della cartella \Manager\Extra\EcoSystem

Procedere con la configurazione delle stringhe di configurazione del database.

Configurazione

Se è la prima installazione, rinominare il file _web.config in web.config. Aprire il file web.config e modificare la seguente stringa di connessione:

<connectionStrings>
    <add name="GymnasiumDataSource" connectionString="server=SERVERNAME;DATABASE=DBNAME;UID=LOGIN;PWD=PASSWORD"/>    
</connectionStrings>

Sostituire:

SERVERNAME con il nome dell’istanza dove si trova il database di SQL Server di InforYou
DBNAME con il nome del database
LOGIN con la login utilizzata per connettersi al server
PASSWORD con la password utilizzata per connettersi al server

Impostazioni TeamSystem Wellness

L’ultima configurazione da effettuare consiste nell’aggiunta del valore di Secret Key nella tabella impostazioni del database di InforYou (idAzienda = null). Il GUID secret key viene consegnato al cliente e NON deve essere comunicato a nessun altro.

Descrizione: IESKey
IDAzienda: NULL
Valore: IL VALORE CONSEGNATO AL CLIENTE (SecretKey)

Questo conclude la fase di configurazione del sistema presso il centro del cliente.

E’ possibile indicare questo valore in Inforyou → Ritorna a menù principale → Impostazioni → Parametri → Generali → Ecosistema Chiave API

NOTA: Assicurarsi che il valore presente in appSettings\ IYESManagerUrl nel web.config sia impostato su http://iyes.inforyou.it/

NOTA: IYES deve poter comunicare con l’indirizzo web http://iyes.inforyou.it/ per poter definire permessi ed accessi. Assicurarsi che l’accesso a tale indirizzo sia libero da firewall o altri blocchi.

Test

Per verificare il corretto funzionamento del sistema IYES, navigare all’url

http://<URLSITO>/v1/Configuration/echo

Dove URLSITO deve essere sostituito con l’url del sito web dove è stato installato l’ecosistema (ad esempio: iyes.orangepalestre.it, services.downtownpalestre.it etc.) La chiamata fa partire il global.asax che contatta il sistema licenze dell’ecosistema presso inforyou e si scarica la tabella delle configurazioni di app di terze parti e permessi. Se tutto è configurato correttamente dovrebbe uscire

Nel caso di errori con applicazioni di terze parti, è necessario disattivare la visualizzazione dei customError nel caso compaia questa pagina di errore (cercando di effettuare una chiamata verso l’applicazione)

E’ sufficiente quindi editare il file web.config presente nella cartella di installazione dell’Ecosistema ed inserire in qualsiasi punto del nodo <system.web> la voce <customErrors mode=”Off”>.

Impostazione per Pagamenti Digitali

Impostazioni su IIS per WebDav

Se il cliente utilizza TeamSystem Pay è necessario verificare questa configurazione
Accedere a IIS
Accedere al sito EcoSystem
Cliccare su MODULI

Controllare se è presente la voce WebDavModule ed eliminarla

Cliccare su Mapping Gestori
Controllare se è presente la voce WebDavModule ed eliminarla

Impostazioni per TeamSystem Pay

Prerequisiti

Per poter usare l'integrazione TeamSystem Pay è necessario:

aggiornare TeamSystem Wellness almeno alla versione 5.21.100: contattaci per fissare un appuntamento telefonico
Sul pc/server dove è installato Ecosystem per i pagamenti da Web e App è necessario che ci sia la compatibilità con DotNet Core 3.1 quindi:
- per il Sistema Operativo del server:
  - La versione minima deve essere Windows 2012 Server r2
  - la versione consigliata è Windows 2016/2019 Server
- per il Sistema Operativo del pc:
  - La versione minima deve essere Windows 10 Client - Version 1607+
- di seguito la pagina che indica i Sistemi Operativi Server compatibili

Installazione prerequisiti per Hosting Net Core 3.1 in IIS

E’ necessario installare il pacchetto Hosting Bundle presente a questo Link Microsoft

verrà scaricato questo file

eseguire l'installazione seguendo le istruzioni passo passo

Installazione TSWIntegrationsGateway

Di seguito verranno illustrati i passaggi per installare TSWIntegrationsGateway necessario per permettere i pagamenti con la nuova integrazione TeamSystem Pay

Installazione del sito sullo stesso pc/server

Se TSWIntegrationsGateway può essere installato sullo stesso pc/server dove risiede Ecosystem, procedere in questo modo:
- Copiare la cartella \\Manager\Extra\TSWIntegrationsGateway nel percorso desiderato es. C:\inetpub\wwwroot\
- Aprire IIS ed aggiungere un nuovo Pool di applicazioni indicando:
  - Nome: TSWIntegrationsGateway
  - Versione .NET CLR: Nessun codice gestito
  - Modalità pipeline gestita: Integrata

Aggiungere un nuovo sito indicando:
- Nome: TSWIntegrationsGateway
- Pool di applicazioni: TSWIntegrationsGateway
- Percorso fisico: la cartella di installazione del sito
- Indirizzo IP: 127.0.0.1
- Porta: 5000

Abilitare l’accesso al sito solo da localhost

Selezionare Restrizioni indirizzi IP e di dominio nel pannello di configurazione del sito

Selezionare Modifica impostazioni funzionalità

Impostare di default il divieto di accesso a quest’app

Selezionare Aggiungi voce di accesso consentito

Inserire 127.0.0.1 come indirizzo IP autorizzato

Il sito sarà ora disponibile solo per i servizi, come Ecosystem, che lo interrogheranno da localhost

Se non è presente la voce Restrizioni indirizzi IP e di dominio abilitarla su Attivazione o disattivazione delle funzionalità di Windows alla voce Internet Information Services => Sicurezza => Sicurezza IP

oppure

Configurazione ConnectionString

Rinominare i files togliendo _
- _appsettings.Development.json
- _appsettings.json

Aprire appsettings.json e configurare la stringa di connessione

ATTENZIONE: se es l'istanza SQL ha la \ (barra) è necessario inserire \\ (doppia barra) es. SERVER\\SQLEXPRESS

Test di funzionamento

Per testare il corretto funzionamento aprire il browser e nagivare al seguente url http://127.0.0.1:5000/api/help/version

Sistemazione Web.config

Modificare Web.config di Ecosystem compilando la voce IntegrationGatewayUrl: andrà specificato l'indirizzo IP del pc dove è installato TSWIntegrationsGateway

ESEMPIO

<appSettings>
   <add key="webpages:Version" value="2.0.0.0" />
   <add key="webpages:Enabled" value="false" />
   <add key="PreserveLoginUrl" value="true" />
   <add key="ClientValidationEnabled" value="true" />
   <add key="UnobtrusiveJavaScriptEnabled" value="true" />
   <add key="IYESManagerUrl" value="http://iyes.inforyou.it" />
   <add key="IntegrationGatewayUrl" value="http://127.0.0.1:5000"/>
 </appSettings>

Installazione del sito su un altro pc Windows 10

Se TSWIntegrationsGateway deve essere installato su un pc diverso rispetto a quello dove c'è Ecosystem (perchè es. ha un sistema operativo pre Windows Server 2012), procedere in questo modo:
- Copiare la cartella \\Manager\Extra\TSWIntegrationsGateway nel percorso desiderato es. C:\inetpub\wwwroot\
- Aprire IIS ed aggiungere un nuovo Pool di applicazioni indicando:
  - Nome: TSWIntegrationsGateway
  - Versione .NET CLR: Nessun codice gestito
  - Modalità pipeline gestita: Integrata

Aggiungere un nuovo sito indicando:
- Nome: TSWIntegrationsGateway
- Pool di applicazioni: TSWIntegrationsGateway
- Percorso fisico: la cartella di installazione del sito
- Indirizzo IP: Tutti non assegnati
- Porta: 5000

Modificare Web.config di Ecosystem compilando la voce IntegrationGatewayUrl: andrà specificato l'indirizzo IP del pc dove è installato TSWIntegrationsGateway