Get Value

Description

Retrieves information from the flow, the document, or another source and puts it into a variable. If multiple values are retrieved at the same time, they will be in the form of a comma delimited string (e.g., value1,value2,value3). Information in the form of a yes or no answer will be set as the value of a string variable as either True or False.

Works On
Variables in the Flow.
Changes Selection
Does not change the selection.

Location

The Get Value action is located under the Flow actions category

Examples

Getting a Numeric Value

This example returns the width of the selected object

Action Setup

Action Result

Getting a Yes or No Value

This example returns True if the selection is in oversert, and false if it’s not.

Action Setup

Action Result

Getting a Delimited String Value

This example gets a comma delimited string containing all the names of the object in the selection.

Action Setup

Action Result

Parameters

Set Variable Drop-down
The variable to put the information into. If the information being retrieved is a number, it can be put into a variable whose type is number or string.  If it is a string it can only be put into a variable that is type string. If the information being retrieved is a yes or no answer, the variable must be a string variable, which will then be set to either True or False.  If the information you are retrieving contains multiple values (for example, with the Names of Selected Objects option), they will be returned in the form of a comma delimited string (e.g., value1,value2,value3).
Get Drop-down
The information you would like to retrieve.

  • Width Of Selection – Gets the width of the selected objects’ bounding box.
  • Height of Selection – Gets the height of the selected objects’ bounding box.
  • All Selected Frames Empty – If all of the objects in the selection are empty, sets the value of a string variable as True.  If not, sets the variable’s value as False.  Objects with fills and strokes but no content inside them are still considered empty.
  • Is Selection In Overset – If any of the objects in the selection are overset, sets the value of a string variable as True.  If not, sets the variable’s value as False.
  • Selection Left – Gets the horizontal (x) position of the left side of the selected objects’ bounding box.  This value is in the units used by the rules, however does not change when the rules starting point is moved.
  • Selection Top – Gets the vertical (y) position of the top of the selected objects’ bounding box.  This value is in the units used by the rules, however does not change when the rules starting point is moved.
  • Selection Right – Gets the horizontal (x) position of the right side of the selected objects’ bounding box.  This value is in the units used by the rules, however does not change when the rules starting point is moved.
  • Selection Bottom – Gets the vertical (y) position of the bottom of the selected objects’ bounding box.  This value is in the units used by the rules, however does not change when the rules starting point is moved.
  • Width Of Page – Gets the width of the active page.
  • Height Of Page – Gets the height of the active page.
  • Active Page Number – Gets the page number for the active page.
  • Active Layer Name – Gets the layer name for the active layer. If the objects in the selection are on different layers, Fuga will get the layer containing the most selected objects. If the same amount of objects are selected across multiple layers, the lowest layer will be used.
  • Active Version Name – Gets the name of the active version.
  • Number of Selected Objects – Gets the total number of selected objects.
  • Total Number of Pages – Gets the total number of pages in the document.
  • Total Number of Versions – Gets the number of existing versions in the Fuga Versions panel.
  • Number of Rows In Table – Gets the total number of rows in a single table.
  • Number of Columns In Table – Gets the total number of columns in a single table.
  • Names of Selected Object – Gets all the names of the selected objects and sets them as the value of a variable in the form of a comma delimited string.
  • Tags of Selected Objects – Gets all the tags within the selected objects or the objects within a selected Super Group and sets them as the value of a variable in the form of a comma delimited string. If multiple instances of the same tag are found, each instance will be inserted into the string. Objects without tags are ignored.
  • Labels of Selected Objects – Gets all the script labels for the selected objects and sets them as the value of a variable in the form of a comma delimited string. If multiple instances of the same script label are found, all will be inserted into the string. Objects without script labels are ignored.
  • Links in Selected Objects – Gets all the file names for the links (i.e. placed files) inside the selected objects and sets them as the value of a variable in the form of a comma delimited string. If multiple instances of the same link are found, all will be inserted into the string. Objects without placed files are ignored.
  • Name of Active Version – Gets the name of the active version.
  • Names of All Versions – Gets the names of all the versions in the document and sets them as the value of a variable in the form of a comma delimited string.
  • Names of All Leaf Versions – Gets the names of all the leaf versions in the document and sets them as the value of a variable in the form of a comma delimited string. A leaf version is a version that has no derived versions (i.e., no children).
  • Names of Derived Versions – Gets all the derived versions in the document and sets them as the value of a variable in the form of a comma delimited string. Derived versions are the children versions of the current version (this does not include grandchildren).
  • Document File Name – Gets the absolute path of the document.
  • Last Error Message – Gets the text from the last error message.  This might not be the last error message displayed, as when an action generates multiple errors only the first one is shown.  To determine exactly what the last error message was, check the log file.
  • Last Error ID – Gets the ID of the last error message. This might not be the last error message displayed, as when an action generates multiple errors only the first one is shown.  To determine exactly what the last error message was, check the log file.
  • Enter Character – Gets a breaking enter character. Since hidden characters are not displayed in the workshop, this set will not be noticeable until used in the document.
  • Tab Character -Gets a tab character. Since hidden characters are not displayed in the workshop, this set will not be noticeable until used in the document.

Leave a Reply

Your email address will not be published. Required fields are marked *

*

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>