M-Files

<< Click to Display Table of Contents >>

Navigation:  Modulonkénti funkcióleírások > Rendszer > Kommunikáció >

M-Files

Previous pageReturn to chapter overviewNext page

A deep program a megfelelő beállításokkal képessé tehető az M-Files dokumentumkezelő programhoz való kapcsolódásra. Alapvetően a Partner (Vevő, Szállító), Pénzügyi számla (fej), Kereskedelmi vevői/szállítói ajánlat, rendelés, előlegszámla, számla (fej) és Fej, valamint Sor dimenzió adatainak szinkronjára van lehetőség, valamint az ezekhez csatolt állományok is szinkronizálhatók.

A funkció használatához licenc szükséges.

 

Menüpont

Megjegyzés

 

Törzsadat

Könyvtár

 

M-Files kapcsolat - Esemény napló

 

Használat

Előfeltétel

A kommunikációhoz szükséges egy eseménykezelő alkalmazás. Ezt külön kell beszerezni a deep.erp forgalmazójától. A létrehozott irattár Konfigurációk/Other Applications menüpontjában kell megadni a deep.erp által használt adatbázis kapcsolatot, felhasználót, céget és az M-Files jellemzők azonosítóját, melyekkel meghatározzuk, hogy a szinkron során mely irattár és adatbázis között történjen meg az adatátvitel. Amennyiben az adatbázis több deep.erp céget is tartalmaz és ezek mindegyike külön irattárra csatlakozik, akkor annyi eseménykezelőt kell feltelepíteni, ahány deep.erp cég és irattár kapcsolat létezik.

Beállítások

A Felhasználói beállítás funkcióban az M-Files szekció alatt lévő részben szükséges rögzíteni a jelszót és a felhasználó nevet a kapcsolódáshoz. Ezt az irattárba felvett Rendszergazda beállítású felhasználót az M-files-ban itt kell felvenni:

Kattints rá!

 - Irattár felhasználó felvétele a deep eléréshez - 

Kattints rá!

 - Új felhasználó - 

Kattints rá!

 - Rendszergazda - 

A Rendszer beállítás funkcióban szabályozható, hogy adott felhasználónak megjelenjenek-e az M-Files szinkronhoz szükséges beállítások, futtatható programok, illetve az ikonok. Valamint be kell állítani az M-Files Törzsadat-okat.

Feladat futtatás (adatátadás)

Az M-Files kapcsolat - Esemény napló funkcióban összegyűjtött elvégzendő feladatokat a Ütemezett feladat funkcióban felvett M-Files feldolgozási sor ütemező feladat indításával tudjuk elindítani. Lehetőség van kézi, vagy ütemezett feladatfuttató használatára is. Nem kötelező beütemezni az adatcserét, de a feladatot vegyük fel, ahonnan kézzel is elindíthatjuk az adatátadást. Mindkét esetben a felületről is indítható az M-Files-ba történő adatküldés a menüsorban található ikonnal. A felületről a sikeres adatszinkron elemeihez tartozó M-Files adatlap is meghívható. Az adatlap megmutatja milyen objektumot szinkronizáltunk és ez milyen adatokat tartalmaz.

M-Files telepítés

Bevezetés

A deep.erp képessé tehető MFiles dokumentumkezelő programmal történő kapcsolattartásra, kétoldali kommunikációra. Jelen dokumentáció ennek a telepítését, beállítását foglalja össze, feltételezve azt, hogy a deep.erp már fel van telepítve működőképes állapotban. Külön fejezetekben ismerteti a dokumentáció az MFiles programban, deep.erp-ben elvégzendő feladatokat, illetve egy törzsadaton keresztül a kommunikáció beállítását.

Telepítés

Az aktuális verziót a https://www.m-files.com/en/download-m-files-online linkről lehet letölteni az Email, Serial number és a 32/64 verzió megadása / kiválasztása után. pl: M-Files_Online_x64_hun_19_3_7499_3_EV.msi

Kattints rá!

 - M-Files szerver telepítése - 

Telepítéskor a program engedélyt kér a használandó port megnyitására.

MFiles programban elvégzendő feladatok

Licencadatok megadása

M_RE_Kommunikacio_MFiles_Admin_ICO

A tálca jobb szélén rezidens programként futó M-en jobbegér, majd a menüből az M-Files Admin programot indítsuk el.

Kattints rá!

 - M-Files Admin - 

Az elindított programban a Művelet / Engedélyek kezelése elindításával megjelenő ablakban tudjuk megadni a licensz adatokat: SERIAL NUMBER , LICENSE CODE , illetve itt tudjuk megnézni, hogy meddig érvényes a már egyszer megadott licenszünk.

Metaadat szerkezet beállítása

Az itt leírt telepítési feladatokat az M-Files program Admin felületén kell elvégeznünk.

A kétoldali kommunikációhoz fel kell vennünk az irattár metaadat szerkezetben 4 új jellemzőt. Miután létrehoztuk a jellemzőket, jegyezzük meg a hozzájuk tartozó azonosítót, mert a későbbiekben erre szükségünk lesz az M-Files eseménykezelőhöz, illetve deep.erp-hez is. A felvett jellemzőket adjuk hozzá metaadat szerkezetben azon típusokhoz, amelyeket a kétoldali kommunikációban használni, szinkronizálni kell.

DeepDataCompanyOid:Ebben a jellemzőben tároljuk a deep.erp cég azonosítóját (adattartalom, tartalom: szöveg)
DeepDataSourceOid:Ebben a jellemzőben tároljuk a deep.erp adatforrás azonosítóját (adattartalom, tartalom: szöveg)
DeepDataSourceType:Ebben a jellemzőben tároljuk a deep.erp adatforrás típust (adattartalom, tartalom: szöveg vagy szöveg (többsoros))
DeepDataModifyingProcessing:Ebben a jellemzőben tároljuk a deep.erp által kezdeményezett módosítási folyamatot (adattípus: logikai)
Kattints rá!

 - M-Files Admin - 

Eseménykezelő beállítás

Az eseménykezelő alkalmazást egy zip file tartalmazza, melyet külön kell beszerezni a deep.erp forgalmazójától.

Amennyiben ugyanazon irattárat több deep.erp cég is használja, akkor annyi eseménykezelőt kell feltelepíteni az irattárra, ahány deep.erp céggel kell kommunikálni. Ehhez a zip file-t másoljuk le a megfelelő példányszámban különböző file nevekkel. A file neve egy GUID, amely megegyezik a zip fileban található appdef.xml file GUID adattagjának értékével, így ezt minden file esetében egyenként kell szerkeszteni, és ennek megfelelően a zip file nevét megadni. Guid generálásra használhatunk interneten található számtalan megoldások egyikét, pl.: https://www.guidgenerator.com/online-guid-generator.aspx

A zip filet az irattáron jobb egér klikkel előhívott helyi menü alkalmazások menüpontjával telepíthetjük az irattárra. Telepítés gombbal tallózzuk ki a zip file-t, majd a megnyitás gombbal az eseménykezelő alkalmazás telepítésre kerül.

Szükség van még az MFiles IIS segítségével interneten keresztül történő elérhetőségre is. Ennek beállítása rendszergazdai feladat, ami valószínűleg az MFiles telepítéskor megtörtént.

Azonosítók

Kattints rá!

 - Deep irattár azonosító mezők - 

Konkrét irattárat lenyitva a Jellemző leírás részről lehet megnézni a szükséges azonosítókat (DeepDataCompanyOID, DeepDataModifyProcessing, DeepDataSourceOid, DeepDataSourceType) és azok (irattáranként változó) értékét.

Konkrét irattáron jobbegér "Alkalmazások" menüpontból lehet kiexportálni az azonosítókat. *.zip fájlba tömörítve kerül ki több fájl, amelyből a config.xml tartalmazza az adatokat:

<?xml version="1.0" encoding="utf-8" ?>

<Config>

 <deepDataTypeProperty ID="1077" />

 <deepDataOidProperty ID="1076" />

 <deepDataModifyProcessing ID="1075" />

 <deepCompanyProperty ID="1074" />

 <User Name="Valaki" />

 <Company Name="Teszt" />

 <ConnectionString Value="Pooling=false;Data Source=JoskaPista\sqlexpress;Initial Catalog=DeepCloudLocal_Sajat;User Id=xy;Password=valami" />

</Config>

 

Konkrét irattáron jobbegér "Alkalmazások" menüpontból lehet visszaimportálni a módosított azonosítókat.

Kattints rá!

 - Export / Telepítés - 

Konkrét irattáron jobbegér "Tulajdonságok" menüpontból lehet kimásolni az "Egyedi azonosító"-t. Ezt kell beírni az M-Files irattár funkció Azonosító mezőjébe a deep-pel való megfeleltetésre.

deep.erp programban elvégzendő beállítások

Felhasználói beállítások

A deep.erp felhasználói beállításokban az M-Files szekció alatt lévő beállításokban, az irattárhoz tartozó jelszót és felhasználó nevet kell rögzítenünk.

Kattints rá!

- Felhasználói beállítás -

Rendszer beállítások

Az M-Files kapcsolat mező értékének „Igaz”-ra állításával szabályozható, hogy adott felhasználónak megjelennek-e az M-Files szinkronhoz szükséges beállítások, futtatható programok illetve az ikonok. A beállítások megadása után újra kell indítani a programot.

 

Kattints rá!

- Rendszer beállítás -

M-Files log fájl:Annak a könyvtárnak és fájlnak az elnevezését kell itt megadni, ahova szeretnék, hogy a program lementse a logfájlokat szinkron esetén. Manuálisan és az ütemezett szolgáltatás használatával is létre jön a log fájl. Minden esemény logolásra kerül, a sikeres és sikertelen hívások és válaszok is.
M-Files kapcsolati URL:Webes (internetes elérés) URL címe
M-Files kapcsolat jelszó:Irattárat kezelhető felhasználó jelszava (Felhasználói beállításokban kell megadni)
M-Files kapcsolat felhasználónév:Irattárat kezelhető felhasználó jelszava (Felhasználói beállításokban kell megadni)

 

Kommunikáció beállítás lépésről lépésre

M_RE_Kommunikacio_MFiles_IrattarSzerkezetSzinkron_ICO

Irattár szinkron: Sikeres irattár felvitel után az irattár szerkezetet szinkronizálni kell, amit a listás áttekintőn lévő "Szerkezet szinkronizálása" művelettel lehet megtenni. Ez azért szükséges, hogy a későbbiekben a struktúra típus és az objektum típus adatok megjelenjenek a deep.erp-ben, valamint a különböző – az M-Files és a deep.erp-ben tárolt - mezőket ki tudjuk választani a mező megfeleltetés összerendelésekor. Amennyiben a használat során az irattárban levő rögzítő felületen új mezőket hozunk létre és ezeknek az adatát szinkronizáltatni szeretnénk a deep.erp-be, minden esetben le kell futtatni az Irattár szinkront.

M-Files kapcsolat - Mező megfeleltetés: A menü pontban adjuk meg az egyes rendszereknek megfelelő adatok kapcsolatát, vagyis hogy a két program között mely mezők adatait szinkronizáljuk és mely mezőkbe íródjanak át.

M-Files kapcsolat - Figyelő: Itt rögzíthetjük, hogy mely feltétel teljesülése esetén kell kommunikálnia egymással a két programnak.

M-Files felsorolás érték megfeleltetés: A partner típusok milyen értéknek feleljenek meg a két program közötti adatátvitel során.

 

Folyamatok követése és javítása

M-Files kapcsolat - Eseménynapló: ezen az áttekintő felületen követhető figyelemmel a kommunikáció a programok között, ugyanis mind a deep.erp, mind az M-Files program ebbe a közös eseménynaplóba gyűjti az elvégzendő és elvégzett feladatokat. Itt ellenőrizhető, hogy a szinkron sikeres volt-e, hiba esetén megtekinthető a konkrét hiba üzenet, javítás után pedig a szinkron újra futtatható.

 

Csatolt fájl kezelés

Felkészítettük a deep.erp-t csatolt fájlok tárolására és ezek szinkronjára. A deep.erp-ben is lehetőség van fájlok csatolására és szinkronizálásra a partner törzsadatoknál, és a pénzügyi számlánál is. Az M-Files programban szintén lehetőség van csatolt állomány kezelésére, azonban ezek a csatolmány nem szinkronizálódnak át a deep.erp-be, de az érintett fő adatnál (partner, pénzügyi vagy kereskedelmi bizonylatok) megtekinthetők a dokumentum kezelőben tárolt csatolmányok.

A deep.erp-ben egy partnerhez vagy bizonylathoz több fájlt is csatolhatunk és csatolásonként megadhatjuk, hogy átszinkronizáljuk-e M-Files irattárba. A csatolt adatok lehetnek többféle formátumúak: pdf, excel, word, kép fájlok. Adatokon kívül elérési útvonal megadására is van lehetőség.

A csatol fájlok teljes listáját, az Információs központ modulban, a Csatolt fájl menü pontban találjuk. A fájlok mellett megjelenítjük, hogy milyen adattípushoz lettek csatolva, ezek iktatószámát, valamint egyéb rögzítéskor megadott adatokat, melyekre kereshetünk, szűrhetünk.

Kattints rá!

- Csatolt fájl szinkron -

Kategória:A csatolt dokumentumok kezelésére kategóriákat lehet létrehozni, melyre az áttekintőn keresni, illetve szűrni lehet.
Tárolás:Jelölni kell, hogy adatot, vagy elérési útvonalat szeretnénk szinkronizálni.
Fájl:Adat esetén ki kell választani a szinkronizálandó fájlt. Amennyiben fájl elérést választunk, itt az elérési útvonalat kell kiválasztani.
Küldés:A csatolt állomány csak abban az esetben kerül szinkronizálásra, ha a mezőben jelöljük az M-Files szinkront.
Kapcsolt tulajdonságok:Meg kell adni, hogy mely adathoz kapcsolt (pénzügyi számla, partner) dokumentációt rögzítünk.
Kulcsszó 01...05:A csatolt állományra jellemző kulcsszavakat rögzíthetünk, melyek a későbbiekben megkönnyítik a keresést, szűrhetünk rájuk.

 

M-Files adatbázis létrehozása (kliensgépre telepített M-Files szerver)

 

A tálca jobb szélén rezidens programként futó M-en jobbegér, majd a menüből az M-Files Admin programot indítsuk el.

Kattints rá!

 - M-Files Admin - 

Irattár visszaállítás menüpontot válasszuk a megfelelő szerver/irattáron állva. (Helyi gépen az Irattáron)

Kattints rá!

 - Irattár visszaállítás... - 

 

Kattints rá!

 - Visszaállítási adatok - 

 

Kattints rá!

 - Letiltás / Hagyjuk változatlanul - 

 

Kattints rá!

 - A visszatöltés rendben befejeződött. - 

IIS szolgáltatások bekapcsolása:

Vezérlőpult / Programok és szolgáltatások-ban Windows-szolgáltatások be- és kikapcsolása részen az IIS alatti pipák bepipálása.

Kattints rá!

 - Programok és szolgáltatások - 

Kattints rá!

 - IIS beállítások - 

 

Az M-files adminban le kell okézni a Webes és mobil beállításokban a konfiguráló ablakot, majd a deep újraindítása után lehet az M-Files szerkezetet szinkronizálni az M-Files irattár funkcióban.

Kattints rá!

 - Web-es és Mobil beállítások - 

 

Kattints rá!

 - Webes hozzáférés ablak leokézása - 

 

Specialitás

Amikor kizárólag a Deep->M-Files irányú pl: a Szállító szinkronja, abban az esetben lehet alkalmazni ezt a módszert: A Szállító típus akkor fog megjelenni az M-Files struktúra - Típus funkcióban, ha ideiglenesen a kisalkalmazásban bepipáljuk a "A felhasználók készíthetnek ilyen fajta dokumentumot" pipát (lásd lenti kép) és ezután szinkronizáljuk az irattárat. Utána pedig vegyük ki innen ezt a pipát (és ne szinkronizáljunk). Kizárólag szerkezet változáskor, az irattár szinkronkor kell megtenni ezt az oda/vissza módosítást.

Kattints rá!

 - Ideiglenes pipa irattár szinkronkor - 

Ezt jogosultsággal is meg lehet oldani, ha az M-Files technikai user jogosultságát a kisalkalmazásban beállítjuk a Szállító funkcióra, hogy csak ő tudjon létrehozni szállítót.