n8n Schedule Trigger Nasıl Kullanılır?

n8n Schedule Trigger, bir workflow'u belirli aralıklarla ya da belirli saatlerde kendiliğinden başlatan node'dur. Workflow, n8n'de bir işi otomatik yapan adımların bütünüdür. Node ise workflow'un adımlarından biridir. Workflow'ların kurulup düzenlendiği ekrana n8n editörü denir. Editörün ortasındaki canvas, node'ların eklenip birbirine bağlandığı çalışma alanıdır. Workflow'un ilk node'u olan trigger node, workflow'u belirli bir olayda ya da zamanda başlatır. Temel n8n kavramları n8n nedir yazısında anlatılır.

Schedule Trigger node'u ne yapar?

Belgelere göre Schedule Trigger node'u, workflow'ları sabit aralıklarla ve belirli zamanlarda çalıştırır. Cron, Linux ve macOS gibi Unix benzeri işletim sistemlerinde komutları belirlenen zamanlarda çalıştıran yazılım aracıdır. Belgelere göre Schedule Trigger da Cron'a benzer biçimde çalışır.

Publish, canvas'ın üst kısmında bulunan ve workflow'u canlıya alan düğmedir. Belgelere göre Schedule Trigger ile başlayan bir workflow'un belirlenen zamanlarda çalışması için kaydedilip yayımlanması gerekir.

Örnek: Bir içerik üreticisi, her pazartesi sabahı haftanın video planını ekibine e-postayla gönderen bir workflow kurar. Workflow'un ilk node'u Schedule Trigger'dır. İçerik üreticisi workflow'u yayımladıktan sonra plan her pazartesi kendiliğinden gönderilir.

Schedule Trigger ile kurulan haftalık rapor örneği n8n otomasyon örnekleri yazısında anlatılır.

Schedule Trigger node'u workflow'a nasıl eklenir?

Schedule Trigger node'u boş bir workflow'a şu adımlarla eklenir:

1. n8n'i aç. Karşılama penceresi görünürse "Start from Scratch" düğmesine tıkla. Overview sayfasındaki Workflows listesi görünürse "Create Workflow" düğmesine tıkla. Boş bir workflow açılır.
2. "Add first step" düğmesine tıkla. Trigger node'ları arayıp seçebildiğin node paneli (nodes panel) açılır.
3. Arama kutusuna "Schedule" yaz. Aramayla eşleşen node'lar listelenir.
4. Listeden Schedule Trigger'ı seç. Node canvas'a eklenir ve ayarları açılır.
5. Trigger Interval, workflow'un hangi aralıkla çalışacağının seçildiği alandır. Seçenekler saniye, dakika, saat, gün, hafta, ay ve cron ifadesidir. Bu alandan bir seçenek seç ve altındaki alanları doldur.
6. Node'un ayar penceresini (node details view) kapat. Canvas'a dönersin ve Schedule Trigger, workflow'un ilk node'u olarak görünür.

Belgelerdeki ilk workflow örneğinde node, her pazartesi saat 09.00'da çalışacak biçimde şöyle ayarlanır:

• Trigger Interval alanında Weeks seçilir.
• Weeks Between Triggers alanına 1 yazılır.
• Trigger on Weekdays alanında Monday seçilir.
• Trigger at Hour alanında 9am seçilir.
• Trigger at Minute alanına 0 yazılır.

Örnek: Bir topluluk yöneticisi, haftalık duyuru için yeni bir workflow açar. "Add first step" düğmesiyle Schedule Trigger'ı ekler ve Trigger Interval alanında Weeks seçeneğini seçer. Node, canvas'ta workflow'un ilk adımı olarak görünür.

Schedule Trigger'da Trigger Rules seçenekleri nelerdir?

Trigger Rules, node'un ne zaman çalışacağını belirleyen kurallardır. Belgelere göre node'a birden çok kural eklenebilir ve her kural ayrı bir zamanlama kurar. Her kuralda önce Trigger Interval alanından zaman aralığının birimi seçilir. Diğer alanlar seçilen birime göre değişir.

Trigger at Minute alanına 0 ile 59 arasında bir dakika yazılır. Trigger at Day of Month alanına ise 1 ile 31 arasında bir gün yazılır.

Örnek: Bir ekip lideri, rapor workflow'unun hem her iş günü sabahı hem de her ayın ilk günü çalışmasını ister. Schedule Trigger node'una iki ayrı kural ekler. Workflow iki zamanlamada da kendiliğinden başlar.

n8n Schedule Trigger'da cron ifadesi nasıl yazılır?

Cron ifadesi, bir zamanlamayı boşlukla ayrılmış alanlarla yazan kısa bir metindir. Trigger Interval alanında Custom (Cron) seçildiğinde cron ifadesi Expression alanına yazılır. Belgelere göre ifadede altı alan bulunabilir. İlk alan saniyeyi gösterir ve isteğe bağlıdır. Saniye alanı yazılmasa da node çalışır.

Belgelerdeki örneklerden bazıları şunlardır:

Belgeler, cron ifadesi üretmek için crontab.guru adlı siteyi önerir. Sitede üretilen ifade n8n'deki Expression alanına yapıştırılır.

Örnek: Bir kişi, workflow'unun yalnızca hafta içi sabahları çalışmasını ister. Expression alanına belgelerdeki hafta içi örneğini yazar ve saati kendi işine göre değiştirir. Workflow hafta sonları çalışmaz.

Schedule Trigger'da saat dilimi nasıl ayarlanır?

Belgelere göre saat dilimi iki yerde ayarlanır: bütün n8n için ya da tek bir workflow için.

n8n Cloud, n8n şirketinin işlettiği sunucularda çalışan ve tarayıcıdan kullanılan n8n sürümüdür. Belgelere göre n8n Cloud'da genel saat dilimi, belgelerdeki Set the Cloud instance timezone sayfasında anlatılan adımlarla değiştirilir. Ortam değişkeni, bir programın çalışırken okuduğu ve adıyla saklanan bir ayardır. Kendi sunucusunda çalışan n8n'de genel saat dilimi GENERIC_TIMEZONE adlı ortam değişkeniyle belirlenir. Kendi sunucusunda çalışan n8n ile n8n Cloud arasındaki fark n8n kurulumu nasıl yapılır yazısında anlatılır.

Tek bir workflow'un saat dilimi şu adımlarla değiştirilir:

1. Workflow'u canvas'ta aç.
2. Sağ üst köşedeki üç nokta simgesine tıkla.
3. Açılan menüde Settings seçeneğini seç. Workflow'un ayarları açılır.
4. Timezone ayarında kendi saat dilimini seç.
5. "Save" düğmesine tıkla. Workflow'un saat dilimi kaydedilir.

Örnek: Kendi sunucusunda çalışan n8n kullanan bir kişi, sabah raporunu beklediği saatten farklı bir saatte aldığını görür. Workflow'un Settings bölümünde Timezone ayarını kendi saat dilimine çevirir. Rapor bundan sonra kişinin beklediği saatte gelir.

n8n Schedule Trigger'da sık görülen sorunlar nasıl çözülür?

Belgelere göre sık görülen sorunlar ve çözümleri şunlardır:

• Invalid cron expression hatası, n8n'in cron ifadesini anlayamadığını gösterir. İfadeyi belgelerdeki örneklerle karşılaştır. İfadede saniye alanı varsa onu çıkar ve kalan ifadeyi crontab.guru sitesinde dene.
• Workflow yanlış saatte çalışıyorsa n8n'in kullandığı saat dilimini kontrol et. Genel ayar ve workflow ayarı yukarıdaki bölümde anlatılır.
• Cron ifadesinde değişken (variable) kullanılabilir. Değişken, n8n'de bir kez tanımlanıp workflow'larda adıyla kullanılan değerdir. Belgelere göre değişkenin değeri workflow yayımlandığında okunur. Değer sonradan değişirse workflow'u yayından kaldır (unpublish) ve yeniden yayımla.
• Trigger Interval değişikliği, workflow yayından kaldırılıp yeniden yayımlandığında geçerli olur. Yeni zamanlama da yayımlama anından başlar. Belgelerdeki örnekte saatte bir çalışan workflow, 11.30'da iki saatlik aralıkla yeniden yayımlanır ve bir sonraki sefer 13.30'da çalışır.
• Execution, workflow'un her çalışmasının kaydıdır ve workflow'un Executions sekmesinde listelenir. Sunucu kapalıyken kaçırılan execution'ları sonradan çalıştırmak için node'un Settings sekmesindeki If Execution Is Missed seçeneğini kullan. Run the Most Recent Missed Execution değeri, en son kaçırılan execution'ı bir kez çalıştırır ve zamanlamaya devam eder.
• Belgelere göre If Execution Is Missed seçeneği, n8n 2.36 ve üstü sürümlerde, bu sürümden sonra workflow'a eklenen Schedule Trigger node'larında bulunur. Seçenek, n8n kurulumu durable scheduler adlı zamanlama sistemiyle çalıştığında etkili olur. Varsayılan sistem olan in-memory scheduler kaçırılan execution'ları çalıştırmaz. Durable scheduler'ın nasıl açılacağı n8n belgelerinin kurulum yapılandırması bölümünde anlatılır.

Örnek: Bir kişi, Trigger Interval alanında Hours seçeneği yerine Days seçeneğini seçer ama workflow saatlik çalışmaya devam eder. Kişi workflow'u yayından kaldırır ve yeniden yayımlar. Workflow bundan sonra günde bir kez çalışır.

Örnek: Bir ekip, rapor saatini bir değişkende tutar ve cron ifadesinde bu değişkeni kullanır. Rapor saatini değiştirdikten sonra workflow'u yayından kaldırıp yeniden yayımlar ve yeni saat devreye girer.

Örnek: Durable scheduler kullanan bir kişi, sabah raporu workflow'unda If Execution Is Missed seçeneğinde Run the Most Recent Missed Execution değerini seçer. Sunucu rapor saatinde kapalı olsa bile, açıldığında rapor bir kez gönderilir.

Sonraki adım

n8n'de yeni bir workflow aç ve "Add first step" düğmesiyle Schedule Trigger node'unu ekle. Trigger Interval alanında Minutes seç ve Minutes Between Triggers alanına 5 yaz. Workflow'u kaydet ve Publish düğmesiyle yayımla. Executions sekmesini aç; workflow seçtiğin aralıkla çalıştıkça listeye yeni bir execution eklenir. Ardından aralığı kendi işine uygun bir zamanlamaya çevir, workflow'u yayından kaldır ve yeniden yayımla.

Kurduğun bu zamanlanmış workflow, tekrar eden işleri kalıcı bir sisteme dönüştürmenin ilk adımıdır.