Hibaelhárítás és GYIK

Hibaelhárítás és GYIK

Ezen az oldalon

Hol kezdje a keresést#

  1. Hiba Események: a felhasználóknak visszaadott hibák, kérésazonosítóval (Események és naplók).
  2. Naplófájlok, vagy a szerver naplói: docker logs -f worksmarthub, journalctl -t WorkSmartHub -f, illetve a Logs mappa.
  3. Státusz: verzió, adatbázis, felhasználói tár, valamint a saját jogosultságai és csoportjai.

Telepítés és indulás#

Minden oldal a licenc oldalra visz. Az alkalmazásnak nincs érvényes licence (nincs, lejárt vagy sérült). Töltsön fel egy licencfájlt; amíg nincs érvényes licenc, ehhez nem kell bejelentkezni (Licenc).

SECURITY: figyelmeztetések a naplóban induláskor. Valamelyik aláíró kulcs még a gyári értéken van, vagy a PublicBaseUrl üres (Beállítások).

libsodium hiba induláskor Windowson. Hiányzik a Microsoft Visual C++ Redistributable (x64) (Windows (IIS)).

Active Directoryval az alkalmazás nem indul Linuxon vagy Dockerben. Az Active Directory csak Windowson használható. Használjon LDAP-ot, Entra ID-t vagy OAuth-t (Hitelesítés).

A konténer nem érhető el. Állítsa be a HttpSettings__Urls__0=http://+:8080 értéket a -p leképezés konténer oldali portjával.

appsettings.json is read-only a naplóban. Csak tájékoztatás: egy újabb kiadás új beállításai az alapértelmezett értékükkel működnek, amíg fel nem veszi őket a fájlba.

Nem futottak le az ütemezett háttérfolyamatok. A folyamatnak folyamatosan futnia kell. IIS alatt ellenőrizze a Start Mode: AlwaysRunning, az Idle Time-out: 0 és a Preload Enabled beállítást (Windows (IIS)). A futási időpontok a szerver helyi idejében értendők (Dockerben UTC).

Bejelentkezés#

Bejelentkezés után azonnal kijelentkeztet, vagy elveszik a munkamenet. A bejelentkezési süti csak HTTPS-en keresztül megy át. Szolgálja ki az oldalt HTTPS-en; telepített rendszeren ne kapcsolja ki a SecureCookie beállítást.

Egy másik szerveren újra be kell jelentkezni. Minden szervernek ugyanaz az appsettings.json kell, a JWT aláíró kulccsal együtt, és ugyanaz az adatbázis.

Nem érkezik meg az elfelejtett jelszó e-mail. Az oldal ismert és ismeretlen címre is ugyanazt a választ adja, így nem árulja el, létezik-e a fiók. Ellenőrizze az EmailSettings beállítást és a hiba eseményeket. Jelszó-visszaállítás csak lokális és külső felhasználóknak érhető el.

„Bad Request – Header field too long” Active Directoryval. A felhasználó sok csoport tagja; növelje a HTTP.sys fejléckorlátait (Windows (IIS)).

Jogosultságok és láthatóság#

Egy felhasználó nem lát egy menüpontot. Ellenőrizze az alkalmazás jogosultságait és a munkaterület szerepköreit (Jogosultságok és szerepkörök). Az Alkalmazás szakasz oldalai rejtve vannak azok elől, akiknek csak Public joguk van, kivéve, ha az Oldal Láthatóságok kategóriában engedélyezve vannak.

Egy felhasználó nem lát egy munkajegyet. A technikusok és olvasók csak a hozzájuk vagy a csoportjukhoz rendelt munkajegyeket látják. Ellenőrizze a munkajegy Munkát végző felhasználók/csoportok mezőjét és a felhasználó csoportjait (Státusz oldal, Minden csoport).

A technikus nem tud módosítani egy mezőt. A technikus csak a státuszt, a felelősöket, a munkafolyamatokat, a komponenseket és a mellékleteket módosíthatja; a többi mező csak olvasható.

A munkajegy mentése után nem változtak az ügyfél adatai. Az ügyfél adatait munkajegyből csak bizonyos felhasználók módosíthatják; a munkajegy elmentődött, az ügyfél nem (Jogosultságok és szerepkörök).

A munkaterület választó azt írja: „Nincs hozzáférése egyetlen munkaterülethez sem”. A felhasználónak egyetlen munkaterületen sincs szerepköre.

Munkajegyek#

A mentés komponens mennyiségi hibával meghiúsul. Egy komponensből nincs elég a raktárban. Csökkentse a mennyiséget, vagy növelje a készletet a Komponensek oldalon.

„Munkajegy ezzel a névvel már létezik”. A munkajegyek neve munkaterületen belül egyedi.

Nem tudok szállítási státuszt választani. A Kiszállításra vár, Kiszállítás alatt és Kiszállítva státuszhoz szállításnak kell lennie a munkajegyen.

A „Fájlok kiválasztása” gomb nem aktív. Előbb válasszon fájltárolót, és mentse el a munkajegyet.

A „Késés értesítés küldése” gomb nem aktív. A munkajegy lezárt státuszban van.

Senki nem kapott értesítést. A munkajegyhez nincs értesítési csatorna rendelve, vagy a felhasználók értesítési mezői üresek, illetve a profiljukon leiratkoztak. Próbálja ki a csatornát a Teszt gombbal.

Nem mennek ki az ügyfél e-mailek. Az ügyfél e-mailek az appsettings.json EmailSettings beállítását használják, nem az értesítési csatornákat. Feladó cím (FromEmail) nélkül az e-mailek elmaradnak, a munkajegyek ettől még elmentődnek. A sikertelen küldés figyelmeztetésként kerül a naplóba (Failed to send … to client), és az e-mail nem jelenik meg az Ügyfél Email Események oldalon, amely csak a ténylegesen elküldött e-maileket mutatja.

Fájlok és feltöltések#

A feltöltés 413 Request Entity Too Large hibával meghiúsul. Egy fordított proxy elutasította a kérés törzsét. Engedélyezzen legalább a darabméretnek megfelelő méretet (alapértelmezetten 25 MB): nginxben client_max_body_size 50m;, Kubernetesen az ingress body size annotációja.

Nem tölthető fel komponenskép. Csak PNG és JPEG fogadható el, és csak alkalmazás szintű fájltárolóba.

Módosítás után sikertelen a fájltároló tesztje. Adja meg újra a titkos értéket: egy módosított fájltároló teszteléséhez ez szükséges (Fájltárolók).

A szerver áthelyezése után nem működnek a mellékletek linkjei. A linkek minden kéréskor az aktuális kiszolgáló címével épülnek fel; ha mégsem működnek, megváltozott a linkek aláíró kulcsa. Költözéskor tartsa meg ugyanazokat a kulcsokat.

E-mail csatornák#

Az SMTP teszt bekapcsolt SSL mellett sikertelen. A szervernek STARTTLS-t kell támogatnia, megbízható és a gépnévvel egyező tanúsítvánnyal. A 465-ös port (implicit TLS) nem támogatott; használja az 587-est.

Az SMTP szerver módosítása után a mentés hibát ad. Ugyanabban a mentésben adja meg újra a jelszót: ha megváltozik, hová kerül egy titkos érték, újra meg kell adni.

Számlák#

A végszámlává alakítás „próbálja újra később” üzenettel elutasítva. Éppen rögzítés alatt áll egy fizetés a Számlázz.hu-ban; várjon 2 percet. Sikertelen fizetésrögzítés után előbb a Fizetés rögzítése újra műveletet használja.

Figyelmeztetés szerint megváltozhatott a Számlázz.hu fiók. A Számlázz.hu-ban talált bizonylat nem egyezett a számlával. Ellenőrizze, hogy az API kulcs a megfelelő fiókhoz tartozik-e (Számlák).

Nem készült el automatikusan a számla. Az automatikus számlázás csak akkor fut, ha Munkajegy Admin (nem technikus) teszi a munkajegyet Számlázandó státuszba, ha a munkajegyhez nem tartozik nem sztornózott számla (a sikertelen is ide számít), és ha a számlázás be van kapcsolva. Az elutasítás oka a Hiba Események oldalon és a naplóban látható.

A munkajegyen a Számla kiállítása gomb nem használható. A munkajegy számláinak ablakában az ellenőrzőlista pirossal mutatja, mi hiányzik: az API kulcs, a cégadatok, a számla előtag, az ügyfél neve, címe és városa, vagy a számlázható tételek. Pótolja a hiányzó adatot, és nyissa meg újra az ablakot.

Az Ügyfél neve, címe és városa megadva ellenőrzés piros: az ügyfélnek nincs megadva a városa.

A konfiguráció ellenőrzése sikertelen. A Sikertelen bejelentkezés. Ellenőrizze az API kulcsot. üzenet azt jelenti, hogy a Számlázz.hu elutasította a tárolt kulcsot: adja meg újra a megfelelő fiók agent kulcsát. A Nem sikerült csatlakozni a Számlázz.hu-hoz. üzenet azt jelenti, hogy a szerver nem éri el a Számlázz.hu-t.

Az előnézet elutasítja az áfakezelést. Az ügyfél nem felel meg a választott áfakezelésnek, például magyar ügyfélnél közösségen belüli áfakezelés, vagy magyar adószám nélküli ügyfélnél belföldi fordított adózás esetén. Javítsa az ügyfél országát, közösségi adószámát vagy adószámát, vagy válasszon másik áfakezelést.

A Közösségen belüli szolgáltatás áfakezelés csak másik EU-tagállambeli ügyfélnek választható, az ügyfél magyarországi.

Az euró vagy dollár számlát az alkalmazás árfolyam nélkül elutasítja. Ha a számla pénzneme eltér az árpénznemtől, meg kell adni a cég által a teljesítés napjára alkalmazott árfolyamot. Írja be az Árfolyam mezőbe.

A HUF árakból EUR számla csak árfolyammal készülhet: az Árfolyam mező kitöltése kötelező.

A helyesbítés árfolyamot kér. Az euró vagy dollár számlán nincs tárolt árfolyam. Írja be az eredeti számlán feltüntetett árfolyamot; nélküle a helyesbítő számla nem állítható ki.

Az E-UCFXX-2026-127 számla EUR pénznemű, és nincs eltárolva az árfolyama.

A Számlázz.hu elutasította a számlát. A számla Sikertelen állapotban tárolódik, és a sora mutatja a Számlázz.hu hibakódját és üzenetét. Szüntesse meg az okát, törölje a sikertelen számlát, és állítsa ki újra. A példában a beállításokban megadott számla előtag nem létezik a Számlázz.hu fiókban.

202: Ez a számlaszám előtag nem létezik vagy nincs engedélyezve.

A Számlázz.hu nem válaszolt. A számlán ez áll: A Számlázz.hu nem adott értékelhető választ a számla kiállítására, a kimenetel ismeretlen. 5 percig nem indítható új kísérlet (Az előző számla kiállítására a Számlázz.hu nem adott értékelhető választ, és néhány percig még elkészülhet.). Utána az újrapróbálás előbb megkeresi a bizonylatot a Számlázz.hu-ban, és ha megvan, eltárolja; az állapotszinkronizáló háttérfolyamat a következő futásakor ugyanezt teszi. A Számlázz.hu-t nem kell kézzel ellenőriznie.

Az előző számla kiállítására a Számlázz.hu nem adott értékelhető választ, és néhány percig még elkészülhet.

Nem készül el a helyesbítő számla. A helyesbítés előtt a WorkSmartHub frissíti a számla fizetési állapotát a Számlázz.hu-ból. Ha a Számlázz.hu nem válaszol, az üzenet így végződik: A helyesbítő számla nem készült el; néhány perc múlva próbálja újra. Ha a Számlázz.hu-ban a számla számán másik bizonylat van, ellenőrizze az API kulcsot.

Az alkalmazás elutasítja a második számlát. A munkalaphoz már tartozik ilyen típusú érvényes vagy kiállítás alatt álló bizonylat. A munkajegynek már van ilyen típusú nyitott bizonylata, vagy egy másik felhasználó ugyanabban a pillanatban kiállította. A munkalapra az elmúlt 5 percben már készült bizonylat: az elmúlt 5 percben már készült bizonylat a munkajegyre. Frissítse az oldalt, és nézze meg a munkajegy számláit.

Mentéskor az alkalmazás elutasítja az áfakulcsot vagy a pénznemet. Bekapcsolt számlázásnál az áfakulcs 27, 18, 5 vagy 0, az árpénznem HUF, EUR vagy USD lehet (Számlák).

GYIK#

Használható a WorkSmartHub telefonon? A webes felület asztali képernyőre készült. Telefonon a mobil alkalmazást használja, amelyet a Mobil Alkalmazás menüpont QR kódjával lehet aktiválni (Mobil alkalmazás).

Módosíthatók az e-mailek szövegei? Igen, a szerveren lévő sablonfájlok szerkesztésével (Értesítések).

Megjeleníthető a felület angolul? Nem, a felület magyar nyelvű.

Az ügyfél törlése a munkajegyeit is törli? Igen. Törlés helyett inkább állítsa az ügyfelet Inaktív állapotúra.

A munkajegy törlésekor visszakerülnek a komponensek a készletbe? Igen, a törölt munkajegy összes komponense visszakerül a raktárkészletbe.

Hogyan látom, ki módosított egy munkajegyet? Az Események oldalon, típusra és felhasználóra szűrve. A munkajegy lista időpontjai fölé víve az egeret az is látszik, ki hozta létre és ki módosította utoljára az adott munkajegyet.

Használhatja több csapat ugyanazt a telepítést úgy, hogy ne lássák egymás munkáját? Igen, erre valók a munkaterületek (Munkaterületek).

Nem találta, amit keresett?

Írjon nekünk, vagy foglaljon időpontot. Válaszolunk a funkciókkal, a telepítéssel és a licenceléssel kapcsolatos kérdésekre.

Kapcsolat