Apple Developer Connection
Member Login Log In | Not a Member? Contact ADC

< Previous PageNext Page > Hide TOC

10.5 Symbol Changes

This article lists the symbols added to Automator.framework in Mac OS X v10.5.

Contents:

Classes
C Symbols


Classes

All of the classes with new symbols are listed alphabetically, with their new class, instance, and delegate methods described.

AMAction

Complete reference information is available in the AMAction reference.

Instance Methods

closedInvoked by Automator when the receiving action is removed from a workflow, allowing it to perform cleanup operations.
didFinishRunningWithError:Sent by the receiver to itself when it has finished running asynchronously.
ignoresInputReturns a Boolean value that indicates whether the action acts upon its input or the input is ignored.
initWithContentsOfURL:error:Loads an Automator action from a file URL.
nameReturns the name of the action.
outputReturns the receiver’s output.
runAsynchronouslyWithInput:Causes Automator to wait for notification that the receiver has completed execution, which allows the receiver to perform an asynchronous operation.
willFinishRunningInvoked by Automator when the receiver has essentially completed its run phase.

AMWorkflow (New)

Complete reference information is available in the AMWorkflow reference.

Class Methods

runWorkflowAtURL:withInput:error:Loads and runs the specified workflow file.

Instance Methods

actionsReturns an array of the workflow’s actions.
addAction:Adds the specified action at the end of the receiving workflow.
fileURLReturns a URL that specifies the location of the workflow file.
initWithContentsOfURL:error:Creates and initializes a workflow based on the contents of the specified file.
inputReturns the input data that is passed to the first action in the workflow.
insertAction:atIndex:Inserts the specified action at the specified position of the receiving workflow.
moveActionAtIndex:toIndex:Moves the action from the specified start position to the specified end position in the receiving workflow.
removeAction:Removes the specified action from the receiver.
setInput:Sets the input data that is passed to the first action in the workflow.
setValue:forVariableWithName:Sets the value of the workflow variable with the specified name.
valueForVariableWithName:Returns the value of the workflow variable with the specified name.
writeToURL:error:Writes the workflow to the specified file.

AMWorkflowController (New)

Complete reference information is available in the AMWorkflowController reference.

Instance Methods

canRunReturns a Boolean value that indicates whether the receiver's workflow is able to run.
delegateReturns the receiver's delegate.
isRunningReturns a Boolean value that indicates whether the receiver's workflow is currently running.
run:Runs the associated workflow, after first clearing any results stored by its actions during any previous run.
setDelegate:Sets the receiver's delegate.
setWorkflow:Sets the receiver's workflow.
setWorkflowView:Sets the receiver's workflow view.
stop:Stops the associated workflow.
workflowReturns the receiver's workflow.
workflowViewReturns the receiver's workflow view.

Delegate Methods

workflowController:didError:Invoked when the receiver's workflow encounters an error.
workflowController:didRunAction:Invoked when an action in the receiver's workflow is finished running.
workflowController:willRunAction:Invoked when an action in the receiver's workflow is about to run.
workflowControllerDidRun:Invoked after the workflow is run.
workflowControllerDidStop:Invoked after the workflow stops.
workflowControllerWillRun:Invoked when the workflow is about to run.
workflowControllerWillStop:Invoked when the workflow is about to stop.

AMWorkflowView (New)

Complete reference information is available in the AMWorkflowView reference.

Instance Methods

isEditableReturns a Boolean value indicating whether the workflow view is editable.
setEditable:Sets whether the workflow view is editable.

C Symbols

All of the header files with new symbols are listed alphabetically, with their new symbols described.

AMBundleAction.h

Data Types & Constants

All of the new data types and constants in this header file are listed alphabetically, with links to documentation and abstracts, if available.

IBOutletIdentifier used to qualify an instance-variable declaration so that Interface Builder can synchronize the display and connection of outlets with Xcode.

AMWorkflowController.h

Data Types & Constants

All of the new data types and constants in this header file are listed alphabetically, with links to documentation and abstracts, if available.

workflowView

AutomatorErrors.h

Data Types & Constants

All of the new data types and constants in this header file are listed alphabetically, with links to documentation and abstracts, if available.

AMActionApplicationResourceErrorAn application required by the action is not found.
AMActionApplicationVersionResourceErrorAn application required by the action is the wrong version.
AMActionArchitectureMismatchErrorThe action's binary is not compatible with the current processor; actions compiled for PowerPC, for example, would encounter this error on Intel systems.
AMActionErrorKeyUse this key to obtain, from the userInfo dictionary of an instance of NSError, a reference to the action (class AMAction) that caused the error.
AMActionExceptionErrorAn action encounters an exception while running.
AMActionExecutionErrorAn action encounters an error while running.
AMActionFileResourceErrorA file required by the action is not found.
AMActionInitializationErrorAutomator is unable to initialize an action (reason unknown).
AMActionInsufficientDataErrorThe action requires input data to run, but none was supplied.
AMActionIsDeprecatedErrorThe action has been deprecated. Use a replacement action, if available.
AMActionLicenseResourceErrorA license required by the action was not found. The only license currently supported is QuickTime Pro.
AMActionLinkErrorThe action's executable failed to load due to linking issues.
AMActionLoadErrorThe action's executable failed to load; for example, there may have been a problem with a library it depends on.
AMActionNotLoadableErrorThe action's executable is of a type that is not loadable in the current process. If the action uses a custom subclass of AMBundleAction or AMAppleScriptAction, then the most likely problem is that the bundle's executable is missing or the NSPrincipleClass is not set in the Info.plist. Users are likely to be confused by a “missing bundle” error, so Automator presents it as the more generic “action not loadable” error.
AMActionPropertyListInvalidErrorThe property list (Info.plist) for an action is invalid; it could be missing, damaged, or constructed improperly.
AMActionRequiredActionResourceErrorAn action required by the action is not loaded.
AMActionRuntimeMismatchErrorAn attempt was made to load an action that is not compiled in a way that is compatible with the current application; for example, the action may be compiled for 32-bit applications or it may not be compatible with garbage collection.
AMAutomatorErrorDomainThis constant defines the Automator error domain.
AMConversionFailedErrorOccurs when, for example, the converter encounters an error converting data from one type to another.
AMConversionNoDataErrorThe converter determines that a given conversion, though possible, would produce a nil result. Not displayed to the user.
AMConversionNotPossibleErrorThe converter determines that it is unable to convert from one data type to another. Not displayed to the user.
AMNoSuchActionErrorThe action could not be located on the system.
AMUserCanceledErrorThe user cancelled. This error is the same as the AppleScript error userCanceledErr, defined in MacErrors.h. When an Apple Event is canceled by the user, a running action may return this error. Automator ignores the error and stops the workflow gracefully, without displaying the error to the user.
AMWorkflowNewerActionVersionErrorAn action in a workflow is newer than the installed action; this error is presented to the user as a warning.
AMWorkflowNewerVersionErrorAttempt to open a workflow document that was saved with a newer version of Automator.
AMWorkflowOlderActionVersionErrorAn action in a workflow is older than the installed action; this error is presented to the user as a warning.
AMWorkflowPropertyListInvalidErrorAttempt to open a workflow document whose property list (document.wflow) could not be read; the property list document could be missing, damaged, or constructed improperly.


< Previous PageNext Page > Hide TOC


Last updated: 2007-07-25




Did this document help you?
Yes: Tell us what works for you.

It’s good, but: Report typos, inaccuracies, and so forth.

It wasn’t helpful: Tell us what would have helped.
Get information on Apple products.
Visit the Apple Store online or at retail locations.
1-800-MY-APPLE

Copyright © 2007 Apple Inc.
All rights reserved. | Terms of use | Privacy Notice