BotreamDokümanlar Web sitesi English v0.1.1

Zamanlamalar

Bir zamanlama, bir görevi belirlenen zamanlarda otomatik olarak; bir ajanda, bir ajan grubunda veya herhangi bir boştaki ajanda, seçtiğiniz girdilerle çalıştırır. Bir dosya veya posta geldiğinde, başka bir sistem Botream'i çağırdığında ya da biri bir tuşa bastığında görev başlatmak için bir tetikleyici kullanın.

Zamanlama nasıl çalışır

Zamanlamalar Botream veritabanında tutulur ve sunucunun kendisi tarafından tetiklenir; kurulması gereken ek bir bileşen yoktur. Her zamanlamanın bir cron zamanı vardır ve o zaman geldiğinde sunucu bir çalıştırma başlatır:

  • Zamanlar sunucunun saat dilimini kullanır.
  • Bir zamanlama, görevin geçerli genel sürümünü çalıştırır. Bir görevi zamanlamadan önce gönderin (push); hiç gönderilmemiş görevler seçilemez. Bkz. Sürümler ve çalışma alanları.
  • Bir çalıştırma, zamanlamayı oluşturan kullanıcı adına başlatılır; bu nedenle görevin okuduğu kimlik bilgilerine o kullanıcının kasa erişim izinleri uygulanır.
  • İki sunucu aynı veritabanını paylaşsa bile bir çalıştırma hiçbir zaman iki kez başlatılmaz.

Zamanlama oluşturma

Schedules'ı açın ve New schedule'a tıklayın. Şunları doldurun:

Alan Açıklama
Name Örneğin Morning invoice import.
Task Çalıştırılacak görev. Genel sürümü olmayan görevler devre dışıdır.
Runs on Any available agent, bir ajan grubu (Agent groups altında) veya tek bir ajan (Agents altında). Çevrimdışı veya onaylanmamış ajanlar işaretlenir.
When Aşağıdaki seçeneklerle oluşturulan yineleme.
INPUTS Görevin girdileri için değerler; görev girdi bildiriyorsa gösterilir. Varsayılanı olmayan zorunlu girdiler doldurulmalıdır.
If no agent is free at the time Skip the run (varsayılan) veya bir ajan için Wait up to 15 dk … 24 sa. Bkz. Ajan beklemek.
Wake the machine (Wake-on-LAN) Zamanı geldiğinde çevrimdışıysa ajanın makinesini veya grubun çevrimdışı makinelerini uyandırır. Any available agent için kullanılamaz. Bkz. Ajan makinelerini uyandırmak.
If a run is missed Skip it veya Run once when back (within 24 h).
Active Zamanlamanın tetiklenip tetiklenmediği.

Create'e tıklayın.

Yineleme seçenekleri

When alanı şunları sunar:

Seçenek Ayarlar Örnek cron
Every few minutes 1, 2, 5, 10, 15, 20 veya 30 dakikada bir */15 * * * *
Every hour 0–59. dakikada 5 * * * *
Every day belirli bir saatte 0 8 * * *
Weekdays (Mon–Fri) belirli bir saatte 0 8 * * 1-5
Certain days of the week günler (Pzt … Paz) ve bir saat 30 7 * * 1,3,5
Once a month 1–31. gün ve bir saat 0 6 1 * *
Custom (cron expression) 5 alanlı herhangi bir cron ifadesi 0 8-18/2 * * 1-5

Özel bir ifadenin beş alanı vardır: dakika saat ayın-günü ay haftanın-günü (0 = Pazar). Alanın altında düz dilde bir açıklama, ifadenin kendisi ve sonraki üç çalıştırma zamanı görünür. Geçersiz bir ifade, nedeniyle birlikte kırmızı renkte gösterilir.

İpucu: Önce en yakın hazır ayarı seçin: Custom (cron expression) seçeneğine geçtiğinizde alan, hazır ayarın ifadesiyle başlar.

Nerede çalışacağını seçme

Çalıştığı yer Davranış
Bir ajan O ajanda çalışır. Ajan çevrimdışı veya meşgulse çalıştırma atlanır ya da onu bekler (aşağıya bakın).
Bir ajan grubu Grubun ilk boştaki, çevrimiçi ve onaylı üyesinde çalışır.
Any available agent İlk boştaki, çevrimiçi ve onaylı ajanda çalışır.

Gruplar yöneticiler tarafından Administration → Agents → Groups altında yönetilir; bkz. Ajanlar.

Ajan beklemek

Görevi çalıştıracak makine zamanlanan saatte açık, ajanı da bağlı olmalıdır. O anda çalıştırmayı alabilecek bir ajan yoksa (ajan çevrimdışı, meşgul veya onay bekliyor):

  • Skip the run seçiliyse çalıştırma atlanır ve zamanlama bir sonraki zamanında devam eder.
  • Wait up to … seçiliyse çalıştırma bekler. Last run alanında Waiting for an agent ve nedeni görünür. Sunucu 15 saniyede bir yeniden dener; bir ajan bağlandığında veya bir çalıştırmayı bitirdiğinde hemen dener. Böylece bir ajan çalıştırmayı alabildiği anda başlar. Last run o zaman örneğin Run on Robot-1 after waiting 4 min der.
  • Süre içinde hiçbir ajan boşalmazsa çalıştırma No agent became free within 30 min ile atlanır.

Bir zamanlama en fazla bir çalıştırmayı bekletir: bir çalıştırma hâlâ beklerken sonraki zamanı gelirse ikisi tek çalıştırma sayılır. Zamanlamayı kapatmak ya da görevini veya ajanını değiştirmek bekleyen çalıştırmayı düşürür. Run now hiçbir zaman beklemez; hemen başlar ya da neden başlayamadığını söyler.

Ajan makinelerini uyandırmak

Wake the machine (Wake-on-LAN) açıkken sunucu, zamanlanan saatte çevrimdışı olan hedef makineleri uyandırır: seçilen ajanın makinesini veya seçilen grubun çevrimdışı makinelerini. Makineler uykuda, hazırda bekletmede veya kapalı olabilir. Çalıştırma beklerken Wake-on-LAN paketleri 5 dakikada bir yeniden gönderilir.

Uyanan bir makinenin Windows'u başlatması, oturum açması ve ajanını bağlaması birkaç dakika sürer; bu yüzden çalıştırmanın beklemesine izin verin: bu seçeneği açtığınızda bekleme Skip the run ise 30 dakikaya ayarlanır. Gözetimsiz robot makineleri oturumu kendileri açar; makinenin neye ihtiyaç duyduğu için bkz. Ajan kurulumu. Yöneticiler çevrimdışı bir ajanı Administration → Agents altından elle de uyandırabilir (satır menüsü → Wake (Wake-on-LAN)).

Zamanlama listesi

Schedules sayfası her zamanlamayı şunlarla gösterir:

  • Schedule: adı ve çalıştırdığı görev.
  • When: yinelemenin sözcüklerle ifadesi ve cron ifadesi.
  • Agent: ajan, grup ((group)) veya Any available.
  • Next run: örneğin in 25 min (tam zaman için üzerine gelin) veya zamanlama etkin değilken Paused.
  • Last run: Started, Skipped, Failed veya Waiting for an agent ve ne zaman olduğu. Nedeni için üzerine gelin.
  • Active: zamanlamayı etkinleştirmek veya devre dışı bırakmak için bir anahtar.

Bir zamanlamayı Run now (görevi, zamanlama etkin olmasa bile hemen başlatır), Edit veya Delete ile yönetmek için satır düğmelerini kullanın. Bir zamanlamayı silmek, görevi ve geçmiş çalıştırmaların kaydını korur.

Son çalıştırma sonuçları

Sonuç Anlamı
Started Çalıştırma başladı; Executions altında takip edin. Bir zamanlama tarafından başlatılan çalıştırmalar Started by altında zamanlamanın adını gösterir.
Skipped Çalıştırma başlamadı: (bekleme ayarlıysa bekleme süresi içinde) boşta ajan yoktu, seçilen ajan çevrimdışı veya meşguldü ya da bu zamanlamanın önceki çalıştırması hâlâ sürüyordu. Zamanlama bir sonraki zamanında yeniden dener.
Waiting for an agent Zamanında çalıştırmayı alabilecek ajan yoktu; If no agent is free at the time ayarına göre bekliyor.
Failed Çalıştırma başlatılamadı; örneğin görev silindiği için.

Last run, çalıştırmanın nasıl bittiğini değil, başlayıp başlamadığını söyler. Görevin kendisinin başarılı olup olmadığını görmek için onu Executions bölümünde açın.

Kaçırılan çalıştırmalar

Zamanlanan saatte sunucu çalışmıyorsa bir çalıştırma kaçırılmış olur (sunucu, iki dakikadan fazla gecikmiş çalıştırmaları fark eder):

  • Skip it (varsayılan): kaçırılan çalıştırmalar yok sayılır; zamanlama bir sonraki zamanında devam eder.
  • Run once when back (within 24 h): kaçırılan zaman 24 saatten daha yakınsa, sunucu geri geldiğinde bir çalıştırma başlar.

Zamanlayıcı çalışmadığında

Sunucu veritabanına ulaşamazsa Schedules sayfası The scheduler is not working gösterir. Zamanlamalar korunur, ancak zamanlayıcı düzelene kadar tetiklenmez; zamanlayıcı kendiliğinden düzelir. Administration → System health zamanlayıcının durumunu ve son hatasını gösterir; bkz. İzleme ve yönetim.

Hata durumunda e-posta

Botream, bir zamanlama tarafından başlatılan bir çalıştırma başarısız olduğunda kişilere e-posta gönderebilir. Bir yönetici, Bildirimler altındaki Email when a scheduled run fails alanına virgülle ayrılmış adresleri girer ve Ayarlar bölümünde Mail (SMTP) altında posta sunucusunu yapılandırır.

E-posta (konusu Scheduled run failed: ve ardından görev adı) zamanlamayı, ajanı, başlangıç zamanını, çalıştırma numarasını ve hatayı içerir. Elle başlattığınız çalıştırmalar ve atlanan tetiklemeler e-posta göndermez.

Zamanlamaları kimler kullanabilir

Yetki Erişim
Manage schedules (varsayılan olarak Admin, Developer) Schedules sayfası ve API: zamanlama oluşturma, değiştirme, silme ve çalıştırma.
Bu yetki olmadan (varsayılan olarak Runner, User) Erişim yok.

Zamanlanmış bir çalıştırma, zamanlamayı oluşturan kullanıcı adına çalışır: onun kasa erişimi geçerlidir. Bkz. Kullanıcılar ve roller.

Bir zamanlamanın oluşturulması, değiştirilmesi, silinmesi ve hemen çalıştırılması denetim kaydına işlenir.

Botream 0.1.1 · Oluşturulma 2026-10-14