AMWorkflow

AMWorkflow класс позволяет Вам использовать поток операций Automator в своем приложении. Можно вывести на экран поток операций с экземпляром AMWorkflowView и управляйте его работой с экземпляром AMWorkflowController.

Поток операций состоит из одного или более действий (дискретные задачи), который вместе может выполнить сложные задачи автоматизации. Ваше приложение может использовать потоки операций, чтобы упаковать его собственные функции и использовать в своих интересах функции, предоставленные другими приложениями. Вы действия по созданию с XCode, в то время как Вы создаете потоки операций с приложением Automator.

Можно загрузить и выполнить поток операций с минимальными издержками при помощи AMWorkflow метод класса runWorkflowAtURL:withInput:error:. Однако в ситуациях, где Вам нужно большее управление, такое как возможность запустить и остановить поток операций, можно использовать экземпляр AMWorkflowController класс вместо этого. В этом случае необходимо будет создать и инициализировать и поток операций и объект контроллера потока операций.

В любом случае поток операций выполняется в отдельном процессе так, чтобы любые действия, которые это содержит, были выполнены в отдельном пространстве памяти. Это помогает изолировать Ваше приложение от катастрофических отказов, утечек памяти или исключений, которые могли бы произойти от выполнения действий в потоке операций.

Наследование

NSObject
AMWorkflow

NSObject
AMWorkflow

Соответствует

AnyObject
CVarArgType
Сопоставимый
Hashable
NSCopying
NSObjectProtocol
Печатаемый
NSCopying
NSObject

Оператор импорта

Swift

import Automator

Objective C

@import Automator;

Доступность

Доступный в OS X v10.5 и позже.

Выполнение указанного потока операций


    
    runWorkflowAtURL (_: withInput:error:)
    + runWorkflowAtURL:withInput:error:

Загрузки и выполнения указанный файл потока операций.

Объявление

Swift

class func runWorkflowAtURL(_ fileURL: NSURL!, withInput input: AnyObject!, error error: NSErrorPointer) -> AnyObject!

Objective C

+ (id)runWorkflowAtURL:(NSURL *)fileURL withInput:(id)input error:(NSError **)error

Параметры

`fileURL`	URL, указывающий расположение файла потока операций.
`input`	Указывает ввод для первого действия в потоке операций. Передача `nil` если первое действие не должно вводить.
`error`	Если никакой поток операций не найден или если ошибка происходит в инициализации, или выполнение его, по возврату содержит экземпляр `NSError` это описывает проблему.

Возвращаемое значение

На ошибке, возвратах nil. Иначе, возвращает вывод последнего действия в потоке операций. Ваше приложение, возможно, должно преобразовать данные в желаемый тип.

Обсуждение

Используйте этот метод для выполнения потока операций без издержек выполнения отдельного выделения, установки контроллер потока операций, и т.д. В ситуациях, где Вам нужно большее управление, такое как возможность запустить и остановить поток операций, используют экземпляр AMWorkflowController класс вместо этого.

Поток операций выполняется в отдельном процессе так, чтобы любые действия, которые он содержит, были выполнены в отдельном пространстве памяти. Это помогает изолировать приложение от катастрофических отказов, утечек памяти или исключений, которые могли бы произойти от выполнения действий в потоке операций.

Оператор импорта

Objective C

@import Automator;

Swift

import Automator

Доступность

Доступный в OS X v10.5 и позже.

Создание и инициализация потока операций


    
    init (contentsOfURL:error:)
    - initWithContentsOfURL:error:

Создает и инициализирует поток операций на основе содержания указанного файла.

Объявление

Swift

init!(contentsOfURL fileURL: NSURL!, error outError: NSErrorPointer)

Objective C

- (instancetype)initWithContentsOfURL:(NSURL *)fileURL error:(NSError **)outError

Параметры

`fileURL`	URL, указывающий расположение файла потока операций.
`outError`	Если файл потока операций не может быть найден, или если ошибка происходит в инициализации потока операций, по возврату содержит экземпляр `NSError` это описывает проблему.

Возвращаемое значение

Инициализированный объект потока операций. На ошибке, ноле возвратов.

Оператор импорта

Objective C

@import Automator;

Swift

import Automator

Доступность

Доступный в OS X v10.5 и позже.

Сохранение изменений в потоке операций


    
    writeToURL (_: ошибка:)
    - writeToURL:error:

Пишет поток операций в указанный файл.

Объявление

Swift

func writeToURL(_ fileURL: NSURL!, error outError: NSErrorPointer) -> Bool

Objective C

- (BOOL)writeToURL:(NSURL *)fileURL error:(NSError **)outError

Параметры

`fileURL`	URL, указывающий расположение файла для записи потока операций.
`outError`	Если файл потока операций не может быть записан по возврату, содержит экземпляр `NSError` это описывает проблему.

Возвращаемое значение

YEStrue если был успешно записан поток операций; иначе NOfalse.

Обсуждение

Вы могли бы хотеть сохранить поток операций, например, потому что Вы внесли изменения в переменную, которую он содержит.

Оператор импорта

Objective C

@import Automator;

Swift

import Automator

Доступность

Доступный в OS X v10.5 и позже.

См. также

+ runWorkflowAtURL:withInput:error:
– initWithContentsOfURL:error:
fileURL

Получение информации о потоке операций

действия действия Свойство

Возвращает массив действий потока операций.

Объявление

Swift

var actions: [AnyObject]! { get }

Objective C

@property(readonly, retain) NSArray *actions

Возвращаемое значение

Массив действий для файла потока операций. Действия являются экземплярами классов такой как AMBundleAction, AMAppleScriptAction, и AMShellScriptAction.

Оператор импорта

Objective C

@import Automator;

Swift

import Automator

Доступность

Доступный в OS X v10.5 и позже.

См. также

– addAction:
– insertAction:atIndex:
– moveActionAtIndex:toIndex:
– removeAction:
fileURL fileURL Свойство

Возвращает URL, указывающий расположение файла потока операций.

Объявление

Swift

@NSCopying var fileURL: NSURL! { get }

Objective C

@property(readonly, copy) NSURL *fileURL

Возвращаемое значение

URL, указывающий расположение файла потока операций.

Оператор импорта

Objective C

@import Automator;

Swift

import Automator

Доступность

Доступный в OS X v10.5 и позже.

См. также

+ runWorkflowAtURL:withInput:error:
– initWithContentsOfURL:error:
– writeToURL:error:
valueForVariableWithName (_:) - valueForVariableWithName:

Возвращает значение переменной потока операций с указанным именем.

Объявление

Swift

func valueForVariableWithName(_ variableName: String!) -> AnyObject!

Objective C

- (id)valueForVariableWithName:(NSString *)variableName

Параметры

variableName

Имя переменной.

Возвращаемое значение

Значение для переменной. Возвраты nil если никакая переменная не найдена с указанным именем.

Оператор импорта

Objective C

@import Automator;

Swift

import Automator

Доступность

Доступный в OS X v10.5 и позже.

См. также

– setValue:forVariableWithName:

Работа с вводом и выводом потока операций

ввод ввод Свойство

Возвращает входные данные, передающиеся первому действию в потоке операций.

Объявление

Swift

var input: AnyObject!

Objective C

@property(readwrite, retain) id input

Возвращаемое значение

Ввод для первого действия в потоке операций. Должен быть тип данных, который действие может использовать, или тип, который может быть преобразован в один, действие может использовать. Использовать setInput: установить входные данные для потока операций.

Оператор импорта

Objective C

@import Automator;

Swift

import Automator

Доступность

Доступный в OS X v10.5 и позже.

См. также

– setValue:forVariableWithName:
вывод
вывод вывод Свойство

Возвращает выходные данные, который предоставлен последним действием в потоке операций.

Объявление

Swift

var output: AnyObject! { get }

Objective C

@property(readonly, retain) id output

Возвращаемое значение

Вывод для для последнего действия в потоке операций.

Оператор импорта

Objective C

@import Automator;

Swift

import Automator

Доступность

Доступный в OS X v10.6 и позже.

См. также

ввод

Управление потоком операций


    
    setValue (_: forVariableWithName:)
    - setValue:forVariableWithName:

Устанавливает значение переменной потока операций с указанным именем.

Объявление

Swift

func setValue(_ value: AnyObject!, forVariableWithName variableName: String!) -> Bool

Objective C

- (BOOL)setValue:(id)value forVariableWithName:(NSString *)variableName

Параметры

`value`	Значение для установки для именованной переменной.
`variableName`	Имя переменной для установки значения для.

Возвращаемое значение

YEStrue если variableName был найден и его значение установлено; иначе NOfalse.

Обсуждение

Этот метод ничего не делает если переменная, указанная variableName не найден.

Оператор импорта

Objective C

@import Automator;

Swift

import Automator

Доступность

Доступный в OS X v10.5 и позже.

См. также

– valueForVariableWithName:

Управление действиями потока операций

addAction (_:) - addAction:

Добавляет указанное действие в конце потока операций получения.

Объявление

Swift

func addAction(_ action: AMAction!)

Objective C

- (void)addAction:(AMAction *)action

Параметры

action

Действие для добавления.

Обсуждение

Поток операций сохраняет действие, но не копирует его.

Оператор импорта

Objective C

@import Automator;

Swift

import Automator

Доступность

Доступный в OS X v10.5 и позже.

См. также

действия
– insertAction:atIndex:
– moveActionAtIndex:toIndex:
– removeAction:


    
    insertAction (_: atIndex:)
    - insertAction:atIndex:

Вставляет указанное действие в указанной позиции потока операций получения.

Объявление

Swift

func insertAction(_ action: AMAction!, atIndex index: Int)

Objective C

- (void)insertAction:(AMAction *)action atIndex:(NSUInteger)index

Параметры

`action`	Действие для вставки.
`index`	Позиция в получателе, в котором можно вставить действие. Если позиция недопустима, этот метод ничего не делает.

Обсуждение

Поток операций сохраняет действие, но не копирует его.

Оператор импорта

Objective C

@import Automator;

Swift

import Automator

Доступность

Доступный в OS X v10.5 и позже.

См. также

действия
– addAction:
– moveActionAtIndex:toIndex:
– removeAction:


    
    moveActionAtIndex (_: toIndex:)
    - moveActionAtIndex:toIndex:

Перемещает действие от указанной позиции запуска до указанной позиции конца в потоке операций получения.

Объявление

Swift

func moveActionAtIndex(_ startIndex: Int, toIndex endIndex: Int)

Objective C

- (void)moveActionAtIndex:(NSUInteger)startIndex toIndex:(NSUInteger)endIndex

Параметры

`startIndex`	Позиция запуска действия для перемещения.
`endIndex`	Позиция конца для перемещенного действия.

Обсуждение

Если любой индекс недопустим, этот метод ничего не делает.

Оператор импорта

Objective C

@import Automator;

Swift

import Automator

Доступность

Доступный в OS X v10.5 и позже.

См. также

действия
– addAction:
– insertAction:atIndex:
– removeAction:

removeAction (_:) - removeAction:

Удаляет указанное действие из получателя.

Объявление

Swift

func removeAction(_ action: AMAction!)

Objective C

- (void)removeAction:(AMAction *)action

Параметры

action

Действие, которое будет удалено.

Обсуждение

Действие получает AMAction closed сообщение прежде чем быть выпущенным.

Оператор импорта

Objective C

@import Automator;

Swift

import Automator

Доступность

Доступный в OS X v10.5 и позже.

См. также

действия
– addAction:
– insertAction:atIndex:
– moveActionAtIndex:toIndex: