Teknisk specifikation Datum 2016-09-30 Version 16.2 Sida 1(9) Teknisk spec Flex Lön och Flex API Programversion: 16.2 sep 2016 Teknisk spec Flex Lön och Flex API 1
Innehåll 1 TEKNISK SPECIFIKATION FLEX LÖN OCH FLEX API... 3 1.1 UTVECKLINGSVERKTYG... 3 1.2 DATABAS... 3 1.3 TECKENUPPSÄTTNING... 3 1.4 E-POST... 3 1.5 PROGRAMVARA... 3 1.6 SÄKERHET... 3 1.7 NÄTVERK... 3 1.8 FLEX API... 4 1.9 ANSVARSOMRÅDE... 4 1.10 HÅRDVARUKRAV ENANVÄNDARSYSTEM... 4 1.11 HÅRDVARUKRAV FLERANVÄNDARSYSTEM - KLIENT... 5 1.12 HÅRDVARUKRAV FLERANVÄNDARSYSTEM - SERVER... 5 1.13 FLEX API... 5 2 INSTALLATION... 7 2.1 FÖRBEREDELSER... 7 2.1.1 Allmänt... 7 2.1.2 Installation via uppkoppling... 7 2.1.3 Exempel på installation... 8 2.2 INSTALLATION AV FLEX LÖN... 9 2.3 INSTALLATION AV FLEX API... 9
1 Teknisk specifikation Flex Lön och Flex API 1.1 Utvecklingsverktyg Visual Studio 6.0 Client/Server (32-bit), tredjepartsverktyg från FarPoint Technologies och Business Objects (Crystal Reports version XI). 1.2 Databas Flex programvaror använder Microsoft SQL Server och vi rekommenderar att den senaste versionen av Microsoft SQL Server används. För dem som inte har en licens av Microsoft SQL Server finns möjligheten att använda en kostnadsfri variant, Microsoft SQL Server Express, som kan hämtas från Microsofts hemsida. Gratisversionen är begränsad till databaser på maximalt 10 GB, 1 CPU samt 1GB tilldelat minne (gäller SQL Server 2008 R2/2012/2014 Express). I övriga systeminstallationer bör Flex användas med Microsoft SQL Server version 2005 eller nyare. I samtliga typer av installationer ansvarar kunden själv för säkerhetshantering och backup av data i Flex databas samt för administration av databasen. 1.3 Teckenuppsättning Teckenuppsättning på databasen bör vara Finnish_Swedish_CS_AS eller Finnish_Swedish_CI_AS. 1.4 E-post Flex Lön använder SMTP enligt RFC 821 och POP 3 enligt RFC 1939. 1.5 Programvara Flex levereras utan källkod. Flex har kopplingar mot tredjepartsprogram ex. Microsoft Excel version 2003/2007/2010/2013/2016. 1.6 Säkerhet Databasen ska konfigureras så att den endast är tillgänglig för användare av Flex. Åtkomst av data ska styras så att det endast blir tillgängligt för användaren genom applikationerna. Behörighetsstyrning är en grundförutsättning för att skydda innehållet i Flex databas från obehörig åtkomst. 1.7 Nätverk Flex Lön är transaktionsintensiv och för att prestandan skall vara tillfredställande krävs en snabb nätverksförbindelse mellan databasserver och övriga servrar och klienter som används för Flex programvaror. Prestandan är speciellt känsligt för Teknisk spec Flex Lön och Flex API 3
latency 1 i nätverket. Ifall nätverket mellan klienter och databasserver inte har tillräcklig prestanda rekommenderas alternativa lösningar som t.ex. att klienten körs på en terminalserver som har en snabb nätverksförbindelse till databasservern. Förutsättningarna bör bedömas från fall till fall i samråd med Flex Applications konsulter. 1.8 Flex API Flex API är en webbaserad komponent som sköter kommunikation mellan olika program och Flex Lön för utbyte av information. I detta dokument utgår vi från att programmet som skall kommunicera med varandra är Flex Lön och Flex HRM. Övriga integrationer mot Flex API omfattas inte av detta dokument. 1.9 Ansvarsområde Kunden ansvarar för att operativsystem, engelsk eller svensk version av Windows 7/8/8.1/10/ 2008/2008R2/2012/2012R2 och för att övriga program, ex. Microsoft Internet Explorer, Microsoft Word, samt att ansluten periferiutrustning så som skrivare, bildskärm, pekdon, modem etc. är installerade på ett korrekt sätt. Flex Applications AB tar inget ansvar för problem och fel orsakade av andra programvaror och support som kan härledas till dessa kommer att debiteras kunden. 1.10 Hårdvarukrav enanvändarsystem Operativsystem: Microsoft Windows 7/8/8.1/10/2008/2008R2/2012/2012R2. Internminne: 1 GB eller mer beroende på den aktuella datorns övriga konfiguration. Processor: 1 GHz (x86 / x64) eller snabbare beroende på den aktuella datorns övriga konfiguration. Diskutrymme för program: Ca 50MB plus ev. utrymme för MDAC/DCOM-filer. Diskutrymme för databas: Från 2 MB beroende på databas, antal personer i databasen mm. Bildskärm: Minst 800x600 bildpunkter och 256 färger, små teckensnitt. Skrivare: Windowskompatibel skrivare som klarar A4. Laser- eller bläckstråle skrivare rekommenderas. Backupsystem: Bandstation eller annat media för större datamängder bör finnas. Övrig utrustning: Tangentbord, mus (eller annat pekdon). 1 Svarstider mellan två punkter i ett nätverk, exempelvis servern för Flex Lön samt databasservern. Mäts i MS
1.11 Hårdvarukrav fleranvändarsystem - Klient Operativsystem: Microsoft Windows 7/8/8.1/10/2008/2008R2/2012/2012R2. Internminne: 1 GB eller mer beroende på den aktuella datorns övriga konfiguration. Processor: 1 GHz (x86 / x64) eller snabbare beroende på den aktuella datorns övriga konfiguration. Diskutrymme för program: Ca 50Mb Bildskärm: Minst 800x600 bildpunkter med 256 färger, små teckensnitt. Skrivare: Windowskompatibel skrivare som klarar A4. Laser- eller bläckstråleskrivare rekommenderas. Backupsystem: Bandstation eller annat media för större datamängder bör finnas. Övrig utrustning: Tangentbord, mus (eller annat pekdon). Rekommenderat nätverksprotokoll för ODBC är TCP/IP. 1.12 Hårdvarukrav fleranvändarsystem - Server Kraven för serverinstallationen är i hög grad beroende av hur många poster som registreras i databasen, antal samtidiga användare mm. Installationen ska alltid föregås av en analys och diskussion tillsammans med leverantören för att på så sätt undvika eventuella prestandarelaterade problem. Nedan följer några hållpunkter. Mjukvara Operativsystem: Microsoft Windows Server 2008/2008R2/2012/2012R2. Databas: Microsoft SQL Server 2005/2008/2008R2/2012/2012R2/2014. Finnish_Swedish_CS_AS eller Finnish_Swedish_CI_AS teckenuppsättning på databasen. Rekommenderat nätverksprotokoll för ODBC är TCP/IP. 1.13 Flex API Webbserver Installationen ska alltid föregås av en analys och diskussion tillsammans med leverantören för att på så sätt undvika eventuella prestandarelaterade problem. Nedan följer några hållpunkter. Endast applikation, databas på annan server Hårdvara Moderkort: Expanderbart för mer minne och flerprocessorer (önskemål). Operativsystem: Windows Server 2008/2008R2/2012/2012R2 Teknisk spec Flex Lön och Flex API 5
Internminne: 1 Gb eller mer. Processor: 1 GHz (x86 / x64) eller snabbare. Diskutrymme: 10MB per applikation. UPS: Beroende på serverns energiförbrukning. Övrigt All ingående hårdvara ska finnas med i Windows HCL (Hardware Compatibility List). Rekommenderat nätverksprotokoll för ODBC är TCP/IP. Mjukvara Serverprogram: Internet Information Server (IIS) 7 eller senare. På 64-bitars servrar måste Flex köras i en 32-bitars Application Pool. Vid användning av 64- bitars operativsystem måste ODBC kopplingar skapas manuellt med 32-bitars odbcad32.exe. För Flex API krävs även att.net 3.5 är installerat samt ASP.NET i IIS. Nätverk: För att kunna använda Flex API över Internet ska webbservern ha en fast publik internetadress eller finnas på företagets interna nätverk för åtkomst direkt via nätverket eller via en tunnlad Internetanslutning. Servern bör alltid skyddas utifrån Internet genom att den placeras bakom brandvägg. Port 80 (HTTP) eller port 443 (HTTPS) är den port som ska vara öppen för att applikationer ska kunna ansluta till Flex API. Webbservern måste också kunna kommunicera mot databasen via TCP/IP (ODBC) vilket innebär att port 1433 eller egenhändigt konfigurerad port måste vara öppen mellan dessa.
2 Installation 2.1 Förberedelser 2.1.1 Allmänt Installation av Flex Applications programvaror skall alltid göras av eller i samarbete med Flex Applications konsulter. För att installationen skall gå så smidigt som möjligt är det bra om det är förberett med alla nödvändiga serveradresser och inloggningar. Ifall det redan finns en installation av MS SQL Server kan denna användas för Flex databas. Om det inte finns någon installerad SQL-server kan en installation av t.ex. MS SQL Server 2012 Express, som är kostnadsfri, göras på programservern. SQL-servern skall vara inställd på att använda SQL Server authentication (Mixed Mode authentication) då programmet behöver en egen inloggning på SQLservern. För att konfigurera SQL servern behöver vi ha tillgång till en administratörsinloggning till SQL-servern samt till SQL Server Management Studio. Flex använder ett eget inloggnings-id till databasen vilket vi skapar. Denna inloggning använder sig av SQL autentisering mot databasen Flex Lön använder en egen databas på databasservern, denna är gemensam för Flex Lön och Flex API. Genomgång av inställningar, bl.a. Collation och rättigheter till den nyskapade databasen. 2.1.2 Installation via uppkoppling Om installationen skall göras via uppkoppling bör förutsättningarna för detta kontrolleras. Vi kan erbjuda uppkoppling med t.ex. TeamViewer. Om uppkoppling skall ske via VPN bör konto för VPN-uppkoppling vara förberett. Inloggningsuppgifter kan gärna skickas till konsulten i förväg så att uppkopplingen kan förberedas. Installation hos kund Ifall det inte är möjligt att göra installationen via uppkoppling görs den på plats hos kunden. Teknisk spec Flex Lön och Flex API 7
2.1.3 Exempel på installation Flex Personalsystem kan installeras som allt från en enkel installation där man har både databas och alla delar av programmet på endast en dator, till en installation där man delar upp så att olika delar av Flex är installerat på olika servrar. I exemplet nedan är uppdelningen gjord så att databasen ligger på en databasserver, program och tjänster på en programserver och Flex API på en webbserver. Vid de tillfällen man kör Flex Lön tillsammans med HRM och väljer att lägga ut driften av HRM på Flex Applications via molntjänst men vill ha Flex Lön i den egna lokala IT miljön är det viktigt att Flex API är tillgängligt från internet för att integrationen mellan Flex Lön och HRM skall fungera.
2.2 Installation av Flex Lön För installation av programvaror behöver vi en inloggning som är lokal administratör till alla de servrar där delar av Flex skall installeras samt att det går att kommunicera med SQL-servern från dessa. Samma gäller för installation av Windowsklienter. Flex använder sig av en ODBC-koppling till databasen vilken vi skapar. Installationsfilerna för Flex Lön och Flex API hämtas från vår FTP-server vid installationen. För att underlätta framtida klientinstallationer konfigureras flexodbc.ini. Därefter görs om möjligt en klientinstallation på servern. Ifall installation av klienten på servern inte är önskvärd behövs tillgång till en klient där klientinstallation kan göras. När klienten är installerad behöver databasen förberedas före användning av Flex. Nu är Flex klart för en första testkörning. Vi sparar inloggning och lösen för databaskopplingen för att underlätta användning, separat inloggning görs för att komma in i Flex. Flex installationsmapp delas ut till de användare/grupper som skall ha tillgång till Flex Windowsklient. 2.3 Installation av Flex API För Flex API behövs en fungerande IIS-server. Om rollen inte finns installerad/aktiverad kan vi hjälpa till med installationen. För att göra installationen av Flex programvaror krävs inloggning som lokal administratör på servern. ASP måste vara aktiverat för IIS och ifall man vill använda sig av Single Sign On måste även Windows autentisering vara aktiverat. För Flex API krävs även att.net 3.5 är installerat samt ASP.NET i IIS. Om installationen skall ligga på en separat server behöver ODBC-koppling till databasen skapas och eventuellt portar i brandvägg öppnas för kommunikation med databasservern. Flex API kan installeras antingen för åtkomst endast internt från LAN eller så kan de installeras på en webbserver i ett DMZ. Om publicering mot internet görs rekommenderas att man använder sig av https och att man har ett giltigt certifikat. Observera att IIS-servern kan behöva stoppas under en kortare tid i samband med installationen. Teknisk spec Flex Lön och Flex API 9