← Automator

İş Akışları

Automator Dokümantasyonu

Automator iş akışlarını oluşturma, yönetme, görüntüleme ve çalıştırma.

AMWorkflow

Sınıf | Automator

*Mac Catalyst 14.0+, macOS 10.4+ sürümlerinde kullanılabilir.*

Uygulamanızda bir Automator iş akışı kullanmanıza olanak tanıyan nesne.

class AMWorkflow

Bir Automator iş akışı, belirli bir görevi yerine getirmek üzere birbirine bağlanmış bir dizi eylemden oluşur. Kullanıcılar Automator uygulamasını kullanarak iş akışları oluşturur; bu iş akışları daha sonra Automator iş akışı dosyaları olarak kaydedilir. Bu sınıf, bir iş akışını uygulamanıza yüklemenizi, eylemlerini incelemenizi ve uygulamanız içinden bir iş akışını çalıştırmanızı sağlar.

Bir Automator iş akışını çalıştırmanın iki yolu vardır:

1. Minimum ek yükle: run(at:withInput:) yöntemi, belirtilen dosyadaki iş akışını çalıştırır, belirtilen girdiyi iş akışındaki ilk eyleme iletir ve son eylemin çıktısını döndürür. 2. Daha fazla kontrolle: İş akışı dosyasını yükleyip yapılandırın, ardından AMWorkflowController kullanarak çalışma zamanını yönetin; bu size çalıştırma, durdurma, duraklatma ve adım adım ilerleme imkânı tanır.

İş Akışı Çalıştırma

  • class func run(at: URL, withInput: Any?) throws -> Any

Belirtilen URL'deki iş akışını çalıştırır ve belirtilen girdiyi ilk eyleme iletir.

İş Akışı Oluşturma

  • init()

Boş bir iş akışı oluşturur.

  • init(contentsOf: URL) throws

Belirtilen URL'deki bir Automator iş akışı dosyasından iş akışı oluşturur.

İş Akışı Kaydetme

  • func write(to: URL) throws

İş akışını belirtilen URL'ye kaydeder.

Eylemleri Yönetme

  • var actions: [AMAction]

İş akışındaki eylemler dizisi.

  • func addAction(AMAction)

İş akışının sonuna bir eylem ekler.

  • func removeAction(AMAction)

İş akışından bir eylemi kaldırır.

  • func insertAction(AMAction, at: Int)

İş akışında belirtilen dizine (index) bir eylem ekler.

  • func moveAction(at: Int, to: Int)

İş akışında bir eylemi bir dizinden diğerine taşır.

Girdi ve Çıktıya Erişme

  • var input: Any?

İş akışına sağlanan girdi.

  • var output: Any?

İş akışının çıktısı.

İş Akışı Değişkenlerine Erişme

  • var variables: [AMWorkflowVariable]?

İş akışındaki değişkenler.

  • func valueForVariable(withName: String) -> Any?

İsmiyle belirtilen bir değişkenin değerini döndürür.

  • func setValue(Any?, forVariableWithName: String) -> Bool

İsmiyle belirtilen bir değişkenin değerini ayarlar.

  • class AMWorkflowVariable

İş akışı değişkenleri.

run(at:withInput:)

Tür Yöntemi

Belirtilen URL'deki iş akışını çalıştırır ve belirtilen girdiyi ilk eyleme iletir.

class func run(at fileURL: URL, withInput input: Any?) throws -> Any

Son eylemin çıktısı.

Parametreler

  • fileURL: Bir Automator iş akışı dosyasının URL'si.
  • input: İş akışına iletilecek girdi.

init()

Başlatıcı

Boş bir iş akışı oluşturur.

init()

init(contentsOf:)

Başlatıcı

Belirtilen URL'deki bir Automator iş akışı dosyasından iş akışı oluşturur.

init(contentsOf fileURL: URL) throws

Parametreler

  • fileURL: Bir Automator iş akışı dosyasının URL'si.

write(to:)

Örnek Yöntemi

İş akışını belirtilen URL'ye kaydeder.

func write(to fileURL: URL) throws

Parametreler

  • fileURL: İş akışının kaydedileceği dosya konumunun URL'si.

actions

Örnek Özelliği

İş akışındaki eylemler dizisi.

var actions: [AMAction] { get set }

Dizi, iş akışının bir parçası olan AMAction örneklerini, iş akışında göründükleri sırayla içerir.

addAction(_:)

Örnek Yöntemi

İş akışının sonuna bir eylem ekler.

func addAction(_ action: AMAction)

Parametreler

  • action: İş akışına eklenecek eylem.

removeAction(_:)

Örnek Yöntemi

İş akışından bir eylemi kaldırır.

func removeAction(_ action: AMAction)

Parametreler

  • action: İş akışından kaldırılacak eylem.

insertAction(_:at:)

Örnek Yöntemi

İş akışında belirtilen dizine (index) bir eylem ekler.

func insertAction(_ action: AMAction, at index: Int)

Belirtilen dizin, yeni eylemin iş akışı sırasındaki konumunu belirler. Mevcut diğer eylemler buna göre yeniden konumlandırılır.

Parametreler

  • action: İş akışına eklenecek eylem.
  • index: Eylemin ekleneceği dizi pozisyonu.

moveAction(at:to:)

Örnek Yöntemi

İş akışında bir eylemi bir dizinden diğerine taşır.

func moveAction(at startIndex: Int, to endIndex: Int)

Parametreler

  • startIndex: İş akışının eylem dizisindeki mevcut konum.
  • endIndex: İş akışının eylem dizisindeki hedef konum.

input

Örnek Özelliği

İş akışına sağlanan girdi.

var input: Any? { get set }

Bu özellik, daha önceki bir iş akışı çalıştırmasından gelen girdiyi veya Automator uygulamasında kullanıcının iş akışını başlatmak için sağladığı girdiyi temsil eder.

output

Örnek Özelliği

İş akışının çıktısı.

var output: Any? { get }

Bu özellik, iş akışındaki son eylemin çıktısını temsil eder.

variables

Örnek Özelliği

İş akışındaki değişkenler.

var variables: [AMWorkflowVariable]? { get }

valueForVariable(withName:)

Örnek Yöntemi

İsmiyle belirtilen bir değişkenin değerini döndürür.

func valueForVariable(withName variableName: String) -> Any?

Parametreler

  • variableName: Değişkenin adı.

setValue(_:forVariableWithName:)

Örnek Yöntemi

İsmiyle belirtilen bir değişkenin değerini ayarlar.

func setValue(_ value: Any?, forVariableWithName variableName: String) -> Bool

Değer başarıyla ayarlanırsa true, aksi halde false döndürür.

Parametreler

  • value: Değişkene atanacak yeni değer.
  • variableName: Değişkenin adı.

İlişkiler

Uyumlu Olduğu Protokoller

  • NSCopying

AMWorkflowController

Sınıf | Automator

*Mac Catalyst 14.0+, macOS 10.4+ sürümlerinde kullanılabilir.*

Uygulamanızda bir Automator iş akışını yönetmenize olanak tanıyan nesne.

class AMWorkflowController

Bu sınıf, bir AMWorkflow nesnesi üzerinde çalıştırma, durdurma, duraklatma ve adım adım ilerleme gibi kontrol yöntemleri sağlar. İş akışı çalışırken delege (AMWorkflowControllerDelegate protokolüne uyumlu bir nesne) çalışma zamanı olaylarıyla ilgili mesajlar alır.

Bir AMWorkflowController nesnesi, bir iş akışı görünümü (AMWorkflowView) ile de ilişkilendirilebilir. Bu durumda, iş akışı kontrolcüsü görünüm ile arasında köprü görevi görerek, kullanıcının iş akışıyla etkileşim kurmasını ve görsel olarak iş akışının ilerleyişini takip etmesini sağlar.

İş Akışını Kontrol Etme

  • func run(Any?)

İş akışının çalışmasını başlatır.

  • func stop(Any?)

İş akışının çalışmasını durdurur.

  • func pause(Any?)

İş akışının çalışmasını duraklatır.

  • func step(Any?)

Duraklatılmış bir iş akışında bir sonraki eyleme ilerler.

  • func reset(Any?)

İş akışını ilk durumuna sıfırlar.

İş Akışı Durumunu Kontrol Etme

  • var canRun: Bool

İş akışının çalıştırılabilir olup olmadığını gösteren bir Boolean değeri.

  • var isPaused: Bool

İş akışının duraklatılmış olup olmadığını gösteren bir Boolean değeri.

  • var isRunning: Bool

İş akışının çalışıyor olup olmadığını gösteren bir Boolean değeri.

İş Akışı ve Görünüm Yönetimi

  • var workflow: AMWorkflow?

Kontrolcü tarafından yönetilen iş akışı.

  • var workflowView: AMWorkflowView?

Kontrolcüyle ilişkili iş akışı görünümü.

  • var delegate: (any AMWorkflowControllerDelegate)?

İş akışı kontrolcüsünün delegesi.

run(_:)

Örnek Yöntemi

İş akışının çalışmasını başlatır.

@IBAction func run(_ sender: Any?)

Bu yöntem, iş akışındaki ilk eylemden başlayarak sıralı olarak her eylemi çalıştırır. Her bir eylemin çıktısı, bir sonraki eylemin girdisi olarak iletilir.

Parametreler

  • sender: Mesajı gönderen nesne.

stop(_:)

Örnek Yöntemi

İş akışının çalışmasını durdurur.

@IBAction func stop(_ sender: Any?)

Parametreler

  • sender: Mesajı gönderen nesne.

pause(_:)

Örnek Yöntemi

İş akışının çalışmasını duraklatır.

@IBAction func pause(_ sender: Any?)

Duraklatılmış bir iş akışı, step(_:) ile adım adım ilerletilebilir veya run(_:) ile çalışmaya devam ettirilebilir.

Parametreler

  • sender: Mesajı gönderen nesne.

step(_:)

Örnek Yöntemi

Duraklatılmış bir iş akışında bir sonraki eyleme ilerler.

@IBAction func step(_ sender: Any?)

Parametreler

  • sender: Mesajı gönderen nesne.

reset(_:)

Örnek Yöntemi

İş akışını ilk durumuna sıfırlar.

@IBAction func reset(_ sender: Any?)

Parametreler

  • sender: Mesajı gönderen nesne.

canRun

Örnek Özelliği

İş akışının çalıştırılabilir olup olmadığını gösteren bir Boolean değeri.

var canRun: Bool { get }

İş akışı çalıştırılabilir durumdaysa true, aksi halde false.

isPaused

Örnek Özelliği

İş akışının duraklatılmış olup olmadığını gösteren bir Boolean değeri.

var isPaused: Bool { get }

isRunning

Örnek Özelliği

İş akışının çalışıyor olup olmadığını gösteren bir Boolean değeri.

var isRunning: Bool { get }

workflow

Örnek Özelliği

Kontrolcü tarafından yönetilen iş akışı.

var workflow: AMWorkflow? { get set }

workflowView

Örnek Özelliği

Kontrolcüyle ilişkili iş akışı görünümü.

var workflowView: AMWorkflowView? { get set }

delegate

Örnek Özelliği

İş akışı kontrolcüsünün delegesi.

var delegate: (any AMWorkflowControllerDelegate)? { get set }

AMWorkflowControllerDelegate

Protokol | Automator

*Mac Catalyst 14.0+, macOS 10.4+ sürümlerinde kullanılabilir.*

Bir AMWorkflowController nesnesi, çalışma zamanı olaylarıyla ilgili mesajları delegesine gönderir.

protocol AMWorkflowControllerDelegate

Delege Yöntemleri

  • func workflowControllerWillRun(AMWorkflowController)

Delegeye iş akışının çalışmak üzere olduğunu bildirir.

  • func workflowControllerWillStop(AMWorkflowController)

Delegeye iş akışının durmak üzere olduğunu bildirir.

  • func workflowControllerDidRun(AMWorkflowController)

Delegeye iş akışının çalışmayı bitirdiğini bildirir.

  • func workflowControllerDidStop(AMWorkflowController)

Delegeye iş akışının durduğunu bildirir.

  • func workflowController(AMWorkflowController, willRun: AMAction)

Delegeye belirtilen eylemin çalışmak üzere olduğunu bildirir.

  • func workflowController(AMWorkflowController, didRun: AMAction)

Delegeye belirtilen eylemin çalışmayı bitirdiğini bildirir.

  • func workflowController(AMWorkflowController, didError: any Error)

Delegeye iş akışı çalışırken bir hata oluştuğunu bildirir.

workflowControllerWillRun(_:)

Örnek Yöntemi

Delegeye iş akışının çalışmak üzere olduğunu bildirir.

func workflowControllerWillRun(_ controller: AMWorkflowController)

Parametreler

  • controller: İş akışı kontrolcüsü.

workflowControllerWillStop(_:)

Örnek Yöntemi

Delegeye iş akışının durmak üzere olduğunu bildirir.

func workflowControllerWillStop(_ controller: AMWorkflowController)

Parametreler

  • controller: İş akışı kontrolcüsü.

workflowControllerDidRun(_:)

Örnek Yöntemi

Delegeye iş akışının çalışmayı bitirdiğini bildirir.

func workflowControllerDidRun(_ controller: AMWorkflowController)

Parametreler

  • controller: İş akışı kontrolcüsü.

workflowControllerDidStop(_:)

Örnek Yöntemi

Delegeye iş akışının durduğunu bildirir.

func workflowControllerDidStop(_ controller: AMWorkflowController)

Parametreler

  • controller: İş akışı kontrolcüsü.

workflowController(_:willRun:)

Örnek Yöntemi

Delegeye belirtilen eylemin çalışmak üzere olduğunu bildirir.

func workflowController(_ controller: AMWorkflowController, willRun action: AMAction)

Parametreler

  • controller: İş akışı kontrolcüsü.
  • action: Çalışmak üzere olan eylem.

workflowController(_:didRun:)

Örnek Yöntemi

Delegeye belirtilen eylemin çalışmayı bitirdiğini bildirir.

func workflowController(_ controller: AMWorkflowController, didRun action: AMAction)

Parametreler

  • controller: İş akışı kontrolcüsü.
  • action: Çalışması biten eylem.

workflowController(_:didError:)

Örnek Yöntemi

Delegeye iş akışı çalışırken bir hata oluştuğunu bildirir.

func workflowController(_ controller: AMWorkflowController, didError error: any Error)

Parametreler

  • controller: İş akışı kontrolcüsü.
  • error: Oluşan hata.

AMWorkflowView

Sınıf | Automator

*Mac Catalyst 14.0+, macOS 10.4+ sürümlerinde kullanılabilir.*

Uygulamanızda Automator iş akışlarını görüntüleme ve düzenleme.

class AMWorkflowView

AMWorkflowView, bir NSView alt sınıfıdır. Bir Automator iş akışı görünümü ve iş akışı kontrolcüsü (AMWorkflowController) kullanarak, iş akışını uygulamanızda görüntüleyebilir ve kullanıcının düzenlemesine izin verebilirsiniz.

Uygulamanızda bir iş akışı görünümü kullanmak için, Interface Builder'da pencerenize bir AMWorkflowView nesnesi ekleyin ve onu bir AMWorkflowController nesnesine bağlayın.

Özellikleri Ayarlama

  • var isEditable: Bool

İş akışı görünümünün düzenlenebilir olup olmadığını gösteren bir Boolean değeri.

  • var workflowController: AMWorkflowController?

İş akışı görünümüyle ilişkili iş akışı kontrolcüsü.

isEditable

Örnek Özelliği

İş akışı görünümünün düzenlenebilir olup olmadığını gösteren bir Boolean değeri.

var isEditable: Bool { get set }

true ise kullanıcı iş akışına eylem ekleyebilir, kaldırabilir ve yeniden düzenleyebilir. false ise iş akışı yalnızca görüntüleme amaçlıdır.

workflowController

Örnek Özelliği

İş akışı görünümüyle ilişkili iş akışı kontrolcüsü.

var workflowController: AMWorkflowController? { get set }

İlişkiler

Miras Aldığı Sınıf

  • NSView

AMWorkspace

Sınıf | Automator *(Kullanımdan kaldırıldı)*

*Mac Catalyst 14.0+, macOS 10.5+ sürümlerinde kullanılabilir.*

Bir Automator iş akışını çalıştırmak için çalışma alanı.

class AMWorkspace

Paylaşılan Çalışma Alanına Erişme

  • class var shared: AMWorkspace

Paylaşılan çalışma alanı nesnesi.

İş Akışı Çalıştırma

  • func runWorkflow(atPath: String, withInput: Any?) throws -> Any

Belirtilen yoldaki iş akışını, verilen girdiyle çalıştırır.

shared

Tür Özelliği

Paylaşılan çalışma alanı nesnesi.

class var shared: AMWorkspace { get }

Uygulamanız için paylaşılan AMWorkspace örneğini döndürür. Birden fazla AMWorkspace örneği oluşturmak yerine, iş akışlarını çalıştırmak için her zaman bu paylaşılan örneği kullanın.

runWorkflow(atPath:withInput:)

Örnek Yöntemi

Belirtilen yoldaki iş akışını, verilen girdiyle çalıştırır.

func runWorkflow(atPath path: String, withInput input: Any?) throws -> Any

İş akışındaki son eylemin çıktısı.

Parametreler

  • path: İş akışı dosyasının dosya sistemi yolu.
  • input: İş akışının ilk eylemine iletilecek girdi.