Справочник свойств действия Automator

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

 

Ключи и значения свойства

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

AMAccepts
Словарь, который описывает данные, котрые действие будет принимать. Это обязательное свойство имеет три вложенных:
  • Container - Строка, которая определяет количество входных значений. В данный момент должно иметь значение по умолчанию (List).
  • Optional - Логическое значение, которое указывает, является ли входное значение обязательным для этого действия. Если ваши действия могут нормально функционировать без входа, укажите <true/>, если оно требует вводных данных, следует указать <false/>. Если это свойство не задано, Automator предполагает по умолчанию <false/>.
  • Types - Массив типов идентификаторов с указанием типов данных, которые ваше действие может признать действительными на входе.
В сведениях о допустимых типах идентификаторов, в том числе можно использовать '*', чтобы показать, что действие может принять любой тип данных.
AMApplication
Строка, определяющая основное приложение, которое используется действием для выполнения своей работы. Например, если ваши действия контролирует приложение Finder с помощью команд AppleScript, необходимо указать "Finder" для этого свойства. Automator это свойство использует в качестве фильтра и в качестве критерия поиска. Примеры возможных значений Address Book, iCal и Xcode.
AMCanShowSelectedItemsWhenRun
Логическое значение, которое определяет, будет ли действие позволять выводить отдельные части его пользовательский интерфейса для показа, когда работает функция Show When Run. Если это свойство имеет значение <true/> (по умолчанию), части вида действия (автоматически или вручную сгенерированные) появляются в качестве элементов в табличном представлении выдвигаемым под кнопкой параметры. Если он установлен в <false/>, доступен только флажок "Показать действие в процессе выполнения" (при условии, что свойство AMCanShowWhenRun установлено в <true/>).
AMCanShowWhenRun
Логическое значение, которое определяет, будет ли показываться вид действия конечному пользователю, когда выполняется функция Show When Run.
AMCategory
Строка (или массив строк), которая используется Automator, чтобы сгруппировать действия с подобными действиями с точки зрения их эффектов или объектов с которыми они работают. Automator представляет категории в пользовательском интерфейсе, а также использует категорию действия в качестве критерия поиска.

Кодовые имена AMCategory доступные начиная с OS X версии 10.5:

Кодовое имяКатегория
AMCategoryCalendarCalendar
AMCategoryChatChat
AMCategoryContactsContacts
AMCategoryDeveloperDeveloper
AMCategoryDocumentsDocuments
AMCategoryFilesAndFoldersFiles and folders
AMCategoryFontsFonts
AMCategoryInternetInternet
AMCategoryMailMail
AMCategoryMoviesMovies
AMCategoryMusicMusic
AMCategoryPDFsPDF files
AMCategoryPhotosPhotos
AMCategoryPresentationsPresentations
AMCategorySystemSystem
AMCategoryTextText
AMCategoryUtilitiesUtilities
AMDefaultParameters
Словарь, содержащий значения по умолчанию для элементов пользовательского интерфейса, управляемыми связями Cocoa bindings. Ключи - имена элементов пользовательского интерфейса введены как атрибуты Parameters экземпляра (NSObjectController) в Interface Builder. Значения должны содержаться в элементах идентификации типа данных; boolean используется для флажков, integer для pop-up item index и string для текстовых полей. Это свойство необходимо для действий, которые имеют параметры.
AMDescription
Словарь, который определяет содержание описания действия, которое появляется в левом нижнем виде Automator, когда действие выбрано. Иконка описания и название взяты из AMIconName и AMName, соответственно. В AMDescription словаре имеются следующие ключи (значения которых являются строками):
  • AMDSummary - Краткое описание того, что делает действие. Похоже, непосредственно на название действия. Параметр необязательный.
  • AMDInput - Типы данных, которые действий принимает. Если это подсвойство не указано, по умолчанию используется Automator текст, соответствующий типу идентификатора указанного в AMAccepts.
  • AMDResult - Типы данных, которые действие выдает. Если это подсвойство не указано, по умолчанию используется Automator текст, соответствующий типу идентификатора указанного в AMProvides.
  • AMDOptions - Описывает, что может быть установлено в пользовательском интерфейсе действия. Подзаголовок "Параметры:" предшествует этому тексту отображаемому в описании. Используйте эту подсвойство только для объяснения аспектов пользовательского интерфейса действия, которые не являются очевидными.
  • AMDAlert - Указывает на важное возможное последствие действия, такое как перезапись файла.
  • AMDNote - Дополнительная информация, которую пользователь должен знать (но не так критично, как AMDAlert).
  • AMDRequires - Все, что требуется действию для того, чтобы работать должным образом, какие веб-страницы должны отображаться или локальный принтер должен быть подключен.
  • AMDRelatedActions - Указывает ID bundle-пакетов действий, связанных с этим действием. (Вы можете посмотреть файл Info.plist внутри bundle-пакета действия, чтобы узнать его ID), может быть по крайней мере три вида отношений между действиями, основанными на том, какую функцию они выполняют:
    • Функция связи: действия, вероятно, будут использоваться в том же рабочем процессе, например, новое сообщение и отправить исходящие сообщения.
    • Параллельные функции: действия выполняют те же общие задачи, но в несколько иной манере или с использованием различных приложений, таких как Send Mail Message и Send iChat Message.
    • Противоположные функции: одно из действий, отменяет эффект другого, такие как Подключаться к серверам и Извлечения диска.
AMIconName
Начиная с OS X 10.5, строка c именем иконки может ссылаться на файл изображения в любом из основных форматов, которые поддерживает Cocoa, такие как Icon файл, TIFF, JPEG и PNG, со всеми стандартными вариациями расширением (.icns, .tiff, .tif, .jpg, .jpeg и т.д.). Вы не включаете расширение в часть имени иконки. Вы можете поставить и 16 на 16 и 32-на-32 пикселя значок в один файл изображения.
AMKeywords
Массив строк, который дает Automator ключевые слова для идентификации действия в поиске. Ключевые слова не отображаются в пользовательском интерфейсе автоматизатора но используются при поиске. Обратите внимание, что Automator автоматически использует слова в названиях действий в качестве ключевых слов, так что нет никаких причин, чтобы повторять их в этом свойстве.
AMName
Строка, указывающая имя действия, которое будет отображаться в интерфейсе пользователя Automator. Это свойство является обязательным. Пример имен "Добавление вложений в начало Сообщения", "Копирование файлов".
AMProvides
Словарь, который описывает данные, которые действие будет генерировать на выходе. Это обязательное свойство имеет два вложенных:
  • Container - строка, которая определяет сколько выходов передается. В данный момент должно иметь значение по умолчанию (List).
  • Types - Массив типов идентификаторов с указанием типов данных, которые ваше действие может обеспечить действительными на вход.
AMRequiredResources
Массив словарей, которые описывают приложения, файлы и другие ресурсы, требуемые действию для правильной работы. Если указанный ресурс недоступен, когда bundle-пакет загружен, Automator предупреждает пользователя. Если ресурс недоступен, когда рабочий процесс выполняет действие, Automator предлагает пользователю найти недостающие ресурсы. Если пользователь не находит ресурс, рабочий процесс прекращает выполнение. Это свойство имеет четыре подсвойства для каждого словаря:
  • Display Name - Строка, определяющая имя ресурса, как показано в Finder, например, "iPhoto". Оставьте поле пустым, если ключ Type имеет значение "file".
  • Resource - Строка, определяющая требуемый ресурс. Формат ресурса указывает подсвойство Type (см. примечание ниже).
  • Type - Строка, указывающая тип идентификатора ресурса данного в качестве значения Resource: "application", "creator code" или "file".
  • Version - Строка, определяющая минимальную требуемую версию ресурса в формате n.n.n (например, "4.0.1").
AMWarning
Если действие потенциально может потерять данные, указанные в этом словаре набор подсвойств вынуждают Automator выводит на экран предупреждение, когда действие добавляется в рабочий процесс. Информация в предупреждении исходит от подсвойств AMWarning. Дополнительно, это свойство может позволить пользователю вставлять другие действия перед этим для защиты от потери данных. Обычно предупреждения в Automator добавляет операцию копирования файлов перед текущим действием. В результате, действие изменяет копий файлов, а не оригиналы. Это свойство является обязательным, но только значение для ключа Level должно быть указано (установлено в значение по умолчанию 0 в шаблоне проекта).
  • Action - Строка, которая определяет bundle идентификатор действия для вставки (если пользователь соглашается) в рабочем процессе перед этим действием. Оставьте поле пустым, если вы просто хотите предупредить пользователя. Если вы не укажете значение этого ключа, строка ApplyButton используется для названия кнопки, а IgnoreButton игнорируется.
  • ApplyButton - Строка, подписи к кнопке, которая добавляет предлагаемые действия или, если действие не указано, чтобы продолжался рабочий процесс. Примеры "Добавить" и "Продолжить".
  • IgnoreButton - Строка, подписи к кнопке для отказа от предлагаемого действия или, если действие не указано, для отмены процесса. Примеры "Не добавлять" и "Отмена".
  • Level - Целое число, которое определяет уровень предупреждения:
    1. Безопасная операция (по умолчанию).
    2. Делает обратимые изменения, например Flip Images.
    3. Делает необратимые изменения, например, для Crop Images.
  • Message - Строка, которая является предупреждением представленным ​​пользователям.
 
 
homeЗаметили ошибкукарта сайта 
   Made on a Mac