⏱️ Worker — Zamanlanmış Görevler

Worker, Octo'da arka planda çalışan ve zamanlanmış işleri yürüten bileşendir. Mail gönderimleri, raporların PDF olarak yazdırılması, periyodik stored procedure çalıştırma gibi işler Worker üzerinden yapılır.

bilgi

Bu sayfa Worker'ın kullanımını anlatır (admin / power user). Worker servisinin sunucuya kurulumu için: Worker Kurulumu

Worker Nasıl Çalışır?

SP / kullanıcı görev ekler  →  Worker kuyruğu  →  Worker servisi yoklar  →  Çalıştırır  →  Durumu günceller

• Görev kuyruğa üç farklı yoldan eklenir:
  1. İş süreçleri içinde SP'ler tarafından otomatik — örn. alacak takibi onayı, prim hesaplama, sistem ayar uyarıları (Sp_Rn_Sys_CreateWorkerTask üzerinden)
  2. Ekranlardaki kullanıcı aksiyonu — örn. ekrandaki "Mail Gönder" / "Yazdır" butonları
  3. Yönetim ekranlarından manuel — bu sayfada anlatılan Worker ve Worker - Detay ekranları üzerinden
• Sunucuda çalışan Worker servisi (Octo.Worker.exe) kuyruğu periyodik olarak yoklar.
• Hazır durumdaki görevleri alır, çalıştırır ve sonucunu kayda işler.
• Hata olursa yetkili kişilere otomatik bildirim maili atar.

İki Ayrı Ekran, İki Farklı Senaryo

Octo'da Worker görevlerini yönetmek için iki ekran vardır. İkisi de aynı veriyi gösterir, fark kullanım kolaylığı ve ayrıntı seviyesidir.

1. Worker (Basit Görünüm)

Yol: Yönetim → Worker

Günlük takip için sadeleştirilmiş ekran. Görev durumlarını renkli kartlarla filtreler, tek tıkla yeni görev ekler, çalıştırır veya duraklatırsınız.

Bu ekranda neler var:

Bölüm	İşlev
Durum kartları (Kuyrukta / İşleniyor / Başarılı / Hata / Tümü)	Görevleri durum bazında filtreleme
Arama kutusu	Görev adına göre arama
+ Yeni Görev	Wizard tarzı görev oluşturma
Görev listesi sütunları	GÖREV ADI · TİP · DURUM · ZAMANLAMA · SON ÇALIŞMA
Görev satırı aksiyonları	⚡ Çalıştır · 🕐 Geçmiş · 👁️ Görüntüle · ✏️ Düzenle · ⏸️ Duraklat · 🗑️ Sil

ipucu

Günlük operasyonlarda (görev ekleme, çalıştırma, durum izleme) bu ekran yeterlidir.

2. Worker - Detay (Gelişmiş Görünüm)

Yol: Yönetim → Worker - Detay

Tüm sütunların ve alt sekmelerin göründüğü, master-detay yapısında profesyonel ekran. Görevin parametre map'ini, ek dosyalarını, mail ayarlarını buradan yönetirsiniz.

Araç çubuğu: Yenile · Ara · Tekrarlı Görevler (filtre) · Yeni · Düzenle · Sil · Mail Ayarları

Bu ekranda tüm sütunlar:

Sütun	Açıklama
Görev Tipi	SP / Mail / Print
Durum	Kuyrukta / İşleniyor / Başarılı / Hata
Görev Adı	Görevin adı
Çalışma Zamanı	İlk çalıştırma veya son planlanan çalışma tarihi/saati
Tekrarlı	Görevin tekrarlı olup olmadığı
Duraklatıldı	Görevin duraklatılıp duraklatılmadığı
Tamamlandı	Görevin tamamlanıp tamamlanmadığı
Aralık (sn)	Tekrar aralığı saniye cinsinden
Çalıştırma Zamanı	Bir sonraki planlanan çalışma zamanı
Sonuç	Son çalışmanın sonuç/hata mesajı
Gönderici	Mail görevlerinde gönderici alias
Konu	Mail görevlerinde e-posta konusu
İçerik	Mail görevlerinde e-posta içeriği
Alıcılar	Mail görevlerinde alıcı listesi

Alt sekmeler (seçili görev için):

Sekme	İşlev
Attachments	Göreve bağlı ekler (SP referansı, rapor template'i) — sütunlar: Name, PrinterName, Oluş. Tar., AddUser
Parameters	Ek başına filtre / parametre tanımları — sütunlar: FieldName, FilterOperatorType, Value

ipucu

Parametreli rapor, mail eki, çoklu ek, özel filtreler gibi gelişmiş senaryolarda bu ekranı kullanın.

Görev Tipleri

Tip	Ne işe yarar
Mail	E-posta gönderimi — sistem bildirimleri, kullanıcı tetikli mailler, raporlu mail
Print	Rapor yazdırma — bir raporu seçili yazıcıya PDF/fiziksel çıktı olarak gönderme
SP	Stored Procedure çalıştırma — periyodik kontroller, prim hesaplama, cache yenileme

Ekrandaki örnekler:

Görev Adı	Tip
Günlük Kullanım İstatistikleri Raporu	SP
Günlük SQL Performans Raporu	SP
Sistem Ayarları Kontrol	SP
Nesne Yenile	SP

Yeni Görev Oluşturma

Yönetim → Worker ekranını açın. Sağ üstte + Yeni Görev butonuna tıklayın. Açılan wizard 3 adımdan oluşur.

Adım 1 — Tip Seçimi

Görev tipini seçin: Mail (E-posta gönderimi), Print (Rapor yazdırma) veya SP (Stored Procedure).

Adım 2 — Detaylar

Tipe göre doldurulacak alanlar:

• Mail: Görev Adı · Gönderen (varsayılan: Sistem) · Konu · Alıcılar (TO — virgülle ayrılır) · CC · BCC · İçerik
• Print: Görev Adı · Rapor adı · Yazıcı · Kopya sayısı
• SP: Görev Adı · Çalıştırılacak SP'ler (+ SP Ekle ile eklenir; her SP için SP Adı ve Parametreler girilir)

Adım 3 — Zamanlama

• Başlangıç Zamanı: İlk çalıştırma tarih/saatini girin.
• Tekrar edilsin: İşaretlenirse görev otomatik olarak tekrarlanır. Bu durumda ek alanlar görünür:
  • Her: Tekrar aralığının sayısal değeri (örn. 1, 5, 24)
  • Birim: Saniye / Dakika / Saat / Gün

Kaydet butonuna basın. Görev Kuyrukta durumuyla listeye düşer; Worker servisi sıraya geldiğinde çalıştırır.

bilgi

Mail görevlerinde alıcılar virgül (,) ile ayrılır, noktalı virgül (;) DEĞİL. Bu Worker'ın SMTP standardına bağlı bir kısıtlamadır.

Görev Durumları

Durum	Ne demek
🟠 Kuyrukta	Görev kayıtlı, Worker'ın alıp çalıştırmasını bekliyor
🔵 İşleniyor	Worker servisi şu an çalıştırıyor
🟢 Başarılı	Tamamlandı, sonuç loglandı
🔴 Hata	Çalışırken hata aldı; bildirim maili gönderildi

ipucu

Hata kartına tıklayıp ilgili görevin geçmişini (🕐 ikonu) açın — hata mesajı sonuç alanında loglanır.

Tekrarlı Görevler

Tekrarlı görev (örn. her gece prim hesaplama):

1. Yeni Görev wizard'ında Tekrar edilsin kutusunu işaretleyin.
2. Her alanına aralık değerini, Birim alanına zaman birimini girin:
   • 5 dakika → Her: 5, Birim: Dakika
   • 1 saat → Her: 1, Birim: Saat
   • 1 gün → Her: 1, Birim: Gün

Worker, görevi tamamladıktan sonra bir sonraki çalıştırmayı otomatik planlar.

bilgi

Tekrarlı görev durdurulmak istendiğinde Duraklat (⏸️) ile devre dışı bırakılabilir; Sil ile tamamen kaldırılabilir.

Mail Ayarları

Worker'ın mail görevlerini gönderebilmesi için SMTP ayarlarının yapılmış olması gerekir. Worker - Detay ekranındaki Mail Ayarları butonundan (Tb_Rn_Sys_MailSettings tablosuna açılan pencere) kontrol edilir.

Gerekli alanlar:

• Host (örn. smtp.gmail.com)
• Port (587 — TLS)
• EnableSsl ✅
• UserName (gönderici e-posta)
• Password (Gmail için App Password zorunlu)

bilgi

Mail ayarları doğru olmadan hiçbir mail görevi çalışmaz ve hata bildirimleri de iletilemez. Yeni kurulumlarda ilk yapılması gereken adımdır.

Sorun Giderme

Belirti	Olası Sebep	Yapılacak
Görev sürekli Kuyrukta kalıyor	Worker servisi sunucuda çalışmıyor	Kurulum sayfası → Adım 7
Görev Hata veriyor (mail)	SMTP ayarları yanlış / App Password eksik	Mail Ayarları butonu
Görev Hata veriyor (SP)	SP'de runtime hatası	Geçmişten hata mesajını okuyun, SP'yi DB'de manuel test edin
Hata bildirim maili gelmiyor	ErrorNotification yapılandırması veya SMTP bozuk	appsettings.json ve Tb_Rn_Sys_MailSettings kontrolü
Rapor eki PDF gelmiyor / boş	Rapor template'inde gömülü connection string stale	Raporu Octo Web designer'dan açıp tekrar kaydedin

ipucu

Bir görevin teknik detayı (parametreler, ek dosyalar, durum geçmişi) için Worker - Detay ekranındaki ilgili görev satırına tıklayıp alt sekmelere (Attachments / Parameters) bakın.

İlgili Sayfalar

• Worker Kurulumu — Worker servisinin sunucuya kurulumu (sysadmin)
• Yetkilendirme — Worker ekranlarına erişim yetkilerinin yönetimi