Avoka
Avoka Tools for Adobe LiveCycle
Overview
LiveCycle ES Components
LiveCycle ES Add-ons
Shopping Cart
License Agreement
Contact Avoka

Component: Collection Util

ComponentView
Contains several operations on collections, i.e. Lists and Maps. Adobe provide only limited/XPath techniques for creating and manipulating Lists and Maps.


Operations

Icon Name About Link
NoIcon

Updates names in a list of documents

Updates names in a list of documents with names from a different list.

Why use it
  • You wish to change the file names for each object of the list. Usually this operation is used when you want to provide more end user friendly names compared to auto generated names.
Properties
NoIcon

Clear Collection

Clear Collection. Empty the content of a List or a Map. There is no way to empty a List or Map using SetValue. Note assigning one List to another List variable using SetValue will append rather than overwrite the contents.

Why use it
  • You wish to clear a List or Map variable before re-using that variable for new contents.
  • You wish to clear a List or Map variable that contains large Documents, to reduce bloat in your database.
Properties
NoIcon

Convert List To Map

Convert a List to Map. String values of the list indexes are used as the result map keys. Some Adobe/Avoka components produce Lists as outputs, whereas other components require a Map as input. This operation allows you to covert the output List into a Map.

Why use it
  • The User > assignTask step will save any attachments in a List of Documents. However, the Email > sendWithMapOfAttachments step requires a Map of Documents. This operation will easily convert the List of Attachments to a Map so that you can send them.
Properties
NoIcon

Convert Map To List

Convert a Map to List. Some Adobe/Avoka components produce Maps, whereas other components require a List as input. This operation allows you to covert the output Map into a List. The keys are lost and the order of the list is undefined.

Why use it
  • You may have file contents in a Map variable which you need to use in Assign Task (user) step to show as attachments in workspace.
Properties
NoIcon

Create List

Create a list from an arbitrary set of objects specified by XPath expressions. A custom editor is provided to specify the objects.

Why use it
  • You wish to add a number of items to a list. The items are stored in existing process variables.
Properties
NoIcon

Create Map

Create a Map from an arbitrary set of objects specified by XPath expression with keys specified. A custom editor is provided to specify the objects.

Why use it
  • You wish to create a Map of attachments with file name as key and file content as value. You can use the Email > sendWithMapOfAttachments to specify the files that needs to sent out as email attachments.
Properties
NoIcon

Deletes a directory or a file

Delete file(s) from a given directory. If a directory path is specified then the files will be deleted from the sub tree as well. Use this operation with care - it will recursively delete an entire tree.

Why use it
  • You wish to delete files form a directory in a recursive manner.
  • Note that there is an Adobe-provided operation to delete a single file, but it doesn't delete recursively.
Properties
NoIcon

Get Filename List in Directory

Get a list of filenames in the directory.

Why use it
  • You may need to get file names out of a directory which then gets used to process the files one after another.
Properties
NoIcon

Merge List

Merge a list of objects. Each object in the custom editor could be a single object, or an existing collection (List of Map) of objects. All the resulting objects will be merged into a single List of objects.

Why use it
  • You may have two or more List variables that store the attachments out of a Assign Task (user) step and you wish to merge them to form a new List so it can be used in next Assign Task operation.
  • This is particularly useful for parallel tasks using a Gateway.
Properties
NoIcon

Merge Maps

Merge a number of maps into a consolidated map. Duplicate keys found in the maps specified will cause RuntimeException

Why use it
  • You may have two or more Map variables and you wish to merge that into a single Map to manage the content easily.
Properties
NoIcon

Multiple Files Reader to List

Reads multiple documents from the File System into a List of Documents

Why use it
  • You may need to import few files from file system to form a List. The List would then be presented in a User > assignTask step as a series of attachments. Rather than looping and reading a file at a time this component allows you to read multiple files in one step.
Properties
NoIcon

Multiple Files Reader to Map

Reads multiple documents from different locations into a Map of Document keyed by Document name

Why use it
  • You may need to import few files from file system to form a Map. Rather than looping and reading a file at a time this component allows you to read multiple files in one step.
Properties
NoIcon

Prints List

Prints the list to Standard Out

Why use it
  • You wish to print a List content to a 'Standard Out' logger. Use this operation for debugging purpose only.
Properties
NoIcon

Read Multiple Documents to List

Reads multiple documents from a directory into a List of Document

Why use it
  • You would want to import multiple files into a List. This avoids the lengthy looping and file reading logic in an orchestration.
Properties
NoIcon

Read Multiple Documents to Map

Read multiple files from a directory into a Map of Document keyed by file name

Why use it
  • You would want to import multiple files into a Map. This avoids the lengthy looping and file reading logic in an orchestration.
Properties
NoIcon

Remove Elements

Subtracts from the contents of one list the contents of another list.

Why use it
  • You might have updated attachment content in a different list and you would like to remove the old contents from another list.
Properties
NoIcon

Remove Duplicate Elements

Removes duplicate elements from a list. Most useful for lists of attachments from the User:assignTask operation. If the list contains documents it removes copies of documents with the same filename. Warning: this will remove different documents added by different users that just happen to have the same filename ("wsfilename" attribute). All documents with a null filename will also be considered to be duplicates.

Why use it
  • If you use the User > assignTask step multiple times in a process, and store the attachments in a list variable, the items in the list variable will be duplicated on each step. So after n steps, you will have n copies of all the attachments added in step 1. This operation will remove all the duplicates.
  • A user may have added the same attachment twice for some reason.
Properties
NoIcon

Updates list of documents

Updates a list of documents, overwriting documents with same file name

Why use it
  • You might want to over write a List contents so the latest files coming out of a user step are used subsequently.
Properties
NoIcon

Write List of Documents

Writes list of documents into a directory. Note: It will try to use filename attribute specified in each document (i.e. "wsfilename"), if not specified it will use filename "untitled".

Why use it
  • You wish to write List contents to a directory rather than looping and writting the file one by one in an orchestration.
Properties


 

DOWNLOADS
0
LiveCycle ES Components Installer
File size: 28.4 MB

LiveCycle ES Components only
File size: 18.6 MB

Ver: 8.0.20090422

0

DOCUMENTATION
0
Business Process Techniques and Patterns
0
LiveCycle ES Components
0
Release Notes
0