راهنمای حضور و غیاب
English version
بازگشت به راهنمای کاربران
این راهنما روش ورود لاگهای حضور و غیاب از فایل دستگاه TSV را توضیح میدهد.
برای محاسبه لاگ روزانه، جمعبندی ماهانه و محاسبه مجدد، راهنمای محاسبه لاگ حضور و غیاب را بخوانید.
پیشنیازهای ورود لاگهای حضور و غیاب
پیش از ورود فایل، این تنظیمات را کامل کنید:
- شیفتهای کاری مورد نیاز را بسازید.
- به هر کارمند یک شیفت کاری اختصاص دهید.
- مقدار شناسه دستگاه هر کارمند را برابر شناسه او در دستگاه حضور و غیاب قرار دهید.
- تعطیلات رسمی را ثبت کنید. این تاریخها روی نوع روز و محاسبه ماهانه اثر دارند.
- ساعت شروع و پایان شیفت، وضعیت پنجشنبه، شناوری ورود و حداکثر اضافه کاری خودکار را کنترل کنید.
اگر کارمند شیفت کاری نداشته باشد، بخشهایی از محاسبه که به مقدار پیشفرض نیاز دارند از ساعت 08:00 برای شروع، ساعت 17:00 برای پایان و 480 دقیقه کار روزانه استفاده میکنند.
ورود فایل دستگاه TSV
از مسیر حضور و غیاب > لاگهای حضور و غیاب > ورود گزارش های حضور و غیاب، فرمت دستگاه TSV (جدا شده با Tab) را انتخاب کنید.
حجم فایل میتواند حداکثر 10 مگابایت باشد. هر سطر غیرخالی باید دستکم چهار ستون جداشده با Tab داشته باشد:
| ستون | مفهوم | مقدار قابل قبول |
|---|---|---|
| 1 | شناسه دستگاه | مقدار ثبتشده در فیلد شناسه دستگاه کارمند |
| 2 | تاریخ و ساعت | میلادی با قالب Y-m-d H:i:s، مانند 2026-09-05 08:03:00 |
| 3 | نادیده گرفته میشود | هر مقدار |
| 4 | نوع ثبت | 0 برای ورود، 1 برای خروج و 2 برای رد کردن سطر |
| 5 و ستونهای بعدی | نادیده گرفته میشوند | هر مقدار |
نمونه:
1042 2026-09-05 08:03:00 0 0 0 0
1042 2026-09-05 17:12:00 0 1 0 0
ورود اطلاعات، هر مقدار ستون چهارم بهجز 0 و 2 را خروج در نظر میگیرد. با وجود این رفتار فعلی، فقط از 0، 1 و 2 استفاده کنید.
تبدیل سطرها به لاگ روزانه
ورود اطلاعات در دو مرحله انجام میشود:
- هر سطر بررسی میشود، ستون اول با کارکنان شرکت فعال تطبیق داده میشود، تاریخ و ساعت میلادی خوانده میشود و بازه تاریخ اختیاری اعمال میگردد.
- سطرهای پذیرفتهشده بر اساس کارمند و تاریخ میلادی گروهبندی میشوند. سپس برای هر کارمند در هر روز، یک لاگ ساخته یا بهروزرسانی میشود.
در هر گروه کارمند و روز، آخرین سطر ورود فایل مقدار زمان ورود و آخرین سطر خروج مقدار زمان خروج را تعیین میکند. پس اگر دستگاه برای یک روز چند ورود یا خروج داشته باشد، ترتیب سطرهای فایل مهم است. سیستم اولین ورود یا آخرین خروج زمانی را پیدا نمیکند، بلکه آخرین سطر همنوع را برمیدارد.
سطرهای دارای کمتر از چهار ستون، تاریخ نامعتبر، نوع 2، شناسه دستگاه ناشناخته یا تاریخ خارج از بازه انتخابی رد میشوند. عدد نهایی ردشدهها هم سطرهای منبع ردشده و هم گروههای کارمند و روز بدون تغییر را دربر میگیرد.
پیش نمایش وارد کردن حداکثر 20 سطر پذیرفتهشده را نشان میدهد. تعداد کل در پیشنمایش، تعداد سطرهای پذیرفتهشده فایل است، نه تعداد لاگهای روزانهای که ساخته یا ویرایش میشوند. شناسههای دستگاه ناشناخته در هشدار نمایش داده میشوند و وارد نخواهند شد.
حالت تکراری
اگر در شرکت فعال برای همان کارمند و همان تاریخ لاگی وجود داشته باشد، آن لاگ تکراری محسوب میشود.
| حالت | ساعت موجود و غیرخالی | ساعت موجود ولی خالی | وقتی هیچ فیلدی تغییر نمیکند |
|---|---|---|---|
| نادیده گرفتن، حفظ رکورد موجود | حفظ میشود | در صورت وجود در TSV تکمیل میشود | گروه کارمند و روز رد میشود |
| جایگزینی، بازنویسی رکورد موجود | در صورت وجود در TSV بازنویسی میشود | از TSV تکمیل میشود | فقط وقتی TSV هیچ زمان ورود یا خروج قابل استفادهای نداشته باشد رد میشود |
حالت نادیده گرفتن به این معنی نیست که رکورد موجود هرگز تغییر نمیکند. در این حالت، زمان ورود یا زمان خروج خالی از فایل تکمیل میشود. حالت جایگزینی نیز فقط زمانهایی را تغییر میدهد که فایل در اختیار دارد. نبودن ورود یا خروج در TSV، مقدار موجود را پاک نمیکند.
هر لاگ ساختهشده یا تغییریافته همان لحظه محاسبه میگردد. لاگ تازه واردشده بهعنوان رکورد دستگاه و نه رکورد دستی ثبت میشود. بهروزرسانی لاگ موجود، وضعیت دستی یا دستگاهی فعلی آن را تغییر نمیدهد. ورود فایل، حضور و غیاب ماهانهای را که قبلا ساخته شده است بازسازی نمیکند. پیش از تغییر چنین ماهی، راهنمای محاسبه و محاسبه مجدد لاگ حضور و غیاب را بخوانید.
بررسیهای پس از ورود فایل
- شناسههای دستگاه ناشناخته در پیشنمایش را با مقدار شناسه دستگاه کارکنان مقایسه کنید.
- کارکنانی را که در یک تاریخ چند ورود یا خروج دارند بررسی کنید، چون آخرین سطر همنوع فایل انتخاب میشود.
- لاگهایی را که فقط زمان ورود یا فقط زمان خروج دارند کنترل کنید.
- اگر ماه از قبل رکورد حضور و غیاب ماهانه دارد، ترتیب محاسبه مجدد را انجام دهید.