Általános tudnivalók

• A régi függvénycsomag (SUPXlsFuncs) VBA/VB6 nyelven íródott és .XLA formátumú, tehát egy makró/munkafüzet fájl.

• Az új függvénycsomag (SUPXlsFuncs.NET) VB.NET nyelven íródott és .XLL formátumú, tehát egy függvénykönyvtár fájl.

• Az új függvénycsomag 64 bites Office környezetben is használható. Az .XLL fájlból 2 verzió van: egy 32 bites és egy 64 bites.

• Mivel a függvények nevei azonosak az új függvénycsomagban, ahhoz, hogy az hibátlanul működjön, az eredeti függvénycsomagot el kell távolítani az Excel-ből.

• Az .XLA -> .XLL cseréje mellett az adatbázis driver fájl (_IBProvider_v3_free_i.dll) is változott (FirebirdSql.Data.FirebirdClient.dll).

• Mivel az új verzió egy sokkal "mélyebben" beépülő technikát alkalmaz, már nem szükséges a függvények nevét teljes elérési úttal kiírni.  Ezért a SUPXlsConverter segítségével a már meglévő Excel táblázatokat migrálni kell.

Az esetekről részletesebb információ található a lentebbi szekciókban.

Az új függvénycsomag telepítése

1. Az új Excel függvénycsomag letöltése után futtatni kell a telepítőt. A telepítés javasolt könyvtára a SUP rendszer az adott gépen található kliensének mappája. Pl.: C:\QSoft\SUP.
   A kliens mappán belül a BIN mappában lesznek megtalálhatók az új Excel függvénycsomaghoz tartozó file-ok: SUPXlsFuncs.NET.Excel32.xll, SUPXlsFuncs.NET.Excel64.xll, FirebirdSql.Data.FirebirdClient.dll, SUPXlsConverter.exe.
   A telepítő a régi verzió fájljait letörli, ha mégis szükséges, előtte el lehet menteni (SUPXlsFuncs.xla, _IBProvider_v3_free_i.dll).
   

    Megjegyzés
   

   A régi Excel függvénycsomaghoz hasonlóan, nem javasoljuk a hálózati meghajtóra történő telepítést. A frissítést minden olyan gépen, ahol korábban az Excel függvénycsomag telepítve volt, végre kell hajtani.

   
   

2. Az Excel-t elindítva egy hibaüzenet fogja közölni, hogy az .XLA fájl nem található. Az Excelben a File | Beállítások | Bővítmények menüpontban, Az 'Excel bővítmények' funkciót megnyitva, ki kell választani a SUPXlsFuncs bejegyzést. Ekkor az Excel lehetőséget ad a bővítmény törlésére.
   Ugyanebben a menüpontban kell regisztrálni az Excelhez az új .NET-es XLL bővítményt, a [Tallózás] nyomógomb használatával. Fontos, hogy az adott gépre telepített 32/64 bites verzióval összhangban kell kiválasztani az .XLL file-t.
   Az aktuális Excel verzió a File | Fiók | Excel névjegye menüpontban kérdezhető le.
   
   

3. A működés ellenőrzése többféleképpen történhet. Pl.: az Excelt elindítása után létre kell hozni egy új munkafüzetet. A szerkesztősorban ki kell választani a függvény szimbólumot: A megjelenő dialógusban a "SUP Excel függvénycsomag" kategóriát választva valamelyik egyszerűbb paraméterezésű függvénnyel lehet tesztelni a megfelelő kapcsolódást a SUP céges adatbázishoz. Ilyen lehet a SUPFokszMegnev(), amely a főkönyvi számhoz kikeresi a nevét.

Excel munkafüzetek konvertálása

Az új verzió sikeres telepítése után a régi SUP függvényeket tartalmazó cellák hibás hivatkozásra mutatnának (pl 'C:\QSoft\Sup\bin\SUPXlsFuncs.xla').
A <SupClientDir>\BIN könyvtárban található SUPXlsConverter programot használva a régi verzióval készült munkafüzeteket migrálni kell.

A SUPXlsConverter használata

A SUPXlsConverter segítségével több módon is egyszerűen migrálhatók a régi SUP függvényeket tartalmazó táblázatok.

Használat:

• Drag & Drop: a konvertálandó táblákat a Windows fájlkezelő ablakainak ikonját használva egyszerűen rá kell dobni a SUPXlsConverter alkalmazásra.
  Hasonló módon teljes mappa is rádobható a konvertálóra. Ez esetben minden benne levő Excel fájl feldolgozásra kerül.
• Parancssor: a CMD parancsot indítva a SUPXlsConverter.exe alkalmazást kell futtatni.
  SUPXlsConverter.exe [path][excelFile]
  Pl.:
  SUPXlsConverter.exe C:\Tablazatok              A megadott könyvtárban minden Excel file-t megvizsgál és konvertál.
  SUPXlsConverter.exe C:\Tablazatok\Próba*.xls*  A megadott könyvtárban minden "Próba" kezdetű Excel file-t megvizsgál és konvertál.
  
  

Rendszerkövetelmények:

• A Microsoft .NET keretrendszer (minimum) 4.0-ás verziója szükséges

• A konvertálási hibák elkerülése végett a konvertálást olyan gépen kell végrehajtani, ahol a frissített Excel függvénycsomag sikeresen telepítve lett, és a megfelelő működés ellenőrzése is megtörtént.

Nagy méretű táblázatok konvertálása:

Több száz KB-os (vagy több MB-os) Excel munkafüzetek esetén, amelyek nagy tömbhivatkozásokat vagy hosszasan ismétlődő (de változó paraméter/cellaértékű) függvényeket tartalmaznak a konvertálás lényegesen több időt vehet igénybe.
Az olyan esetekben, ahol egyetlen függvényt kell meghívni több ezer vagy több tízezer cellán át, érdemesebb kézzel megnyitni a munkafüzetet és átírni/kitörölni az elavult referenciát.

A konvertálás után az adatok esetleges újraszámítása szükséges (aiRecalc). (Ez Excel verziótól függhet.)