new ArchFactoryFilters()
A factory instance that lets you create filters. Filters are used for filtering and matching purposes such as when you want to traverse a flow looking for an object. Do not attempt to create an instance of this class. Architect Scripting will create the factory instance as needed.
Extends
Members
-
static, readonly displayTypeName :string
-
Returns the display type name string 'ArchFactoryFilters'.
-
static, readonly isArchFactoryFilters :boolean
-
Returns true indicating that this is an ArchFactoryFilters instance.
-
readonly logStr :string
-
A logging string for the Architect Factory Filters instance.
- Overrides:
-
readonly logStrTypeOnly :string
-
This is a string suitable for logging information about this object where it's just the object's type. This is normally used when logging errors that occur in constructor parameter checking because the scripting object isn't set up and the normal logging str contents wouldn't be set up.
- Inherited From:
Methods
-
createFilterObject(matchStyleopt) → {ArchFilterObject}
-
This method creates a new filter object.
Parameters:
Name Type Attributes Description matchStyle
string <optional>
this specifies whether the new filter object should use logical and'ing or logical or'ing when processing
match results
of individual filter clauses or filter clause containers contained in this filter. If not specified, the default value is ArchEnums.FILTER_CONTAINER_OPERATORS.and. The string values inArchEnums#FILTER_CONTAINER_OPERATORS
lists valid operator values.Returns:
ArchFilterObject -
createFilterTraverseDefault(wantArchBaseValuesopt) → {ArchFilterObject}
-
This helper method will create a default filter that is configured to match objects that have an isArchBaseAction, isArchBaseFlow, isArchBaseMenu, isArchBaseMenuChoice, isArchBaseMultiActionContainer, isArchBaseVariable or optionally an isArchBaseValue property with a value of true. Loosely translated that means this filter will match any flow, action, menu, menu choice, variable, multi-action container ( i.e. action output, state, task ) and optionally value objects. This is done by creating a new filter, adding
ArchFilterClausePropertyValueEquals
filter clauses via. theArchFilterClauseContainer#addClausePropertyValueEquals
method for each of the "is" properties where the filter is set up to or the match results of the contained clauses. This method is called by theArchBaseCoreObject#traverse
method with the wantArchBaseValues parameter value set to true to supply a default filter to use if no filter is specified when calling traverse.Parameters:
Name Type Attributes Default Description wantArchBaseValues
boolean <optional>
false whether or not to include ArchBaseValue objects in the filter.
Returns:
ArchFilterObject -
isFilterMatch(archFilterObject) → {boolean}
-
Returns whether or not this Architect Scripting object is a match for the supplied ArchFilterObject instance.
Parameters:
Name Type Description archFilterObject
ArchFilterObject the object filter to use to determine if it's a match.
Returns:
boolean- Inherited From:
-
logError(errorStr)
-
Logs an error to the logging service with a log header from this object's
logStr
property value whenArchLogging#logErrors
is true.Parameters:
Name Type Description errorStr
string the error string to log.
- Inherited From:
-
logErrorAndThrow(errorStr)
-
Logs an error to the logging service with a log header from this object's
logStr
property value whenArchLogging#logErrors
is true and then throws the string in the errorStr parameter.Parameters:
Name Type Description errorStr
string the error string to log. This should be a non-blank string.
Throws:
- Throws the submitted error string.
- Inherited From:
-
logNote(noteStr)
-
Logs a note to the logging service with a log header from this object's
logStr
property value whenArchLogging#logNotes
is true.Parameters:
Name Type Description noteStr
string the note string to log. This should be a non-blank string.
- Inherited From:
-
logNoteVerbose(noteStr)
-
Logs a note to the logging service with a log header from this object's
logStr
property value whenArchLogging#logNotesVerbose
is true.Parameters:
Name Type Description noteStr
string the note string to log. This should be a non-blank string.
- Inherited From:
-
logWarning(warningStr)
-
Logs a warning to the logging service with a log header from this object's
logStr
property value whenArchLogging#logWarnings
is true.Parameters:
Name Type Description warningStr
string the warning string to log. This should be a non-blank string.
- Inherited From: