Command Reference > infacmd wfs Command Reference > listTasks
  

listTasks

Lists the Human task instances in the workflow database in which you have a role and that meet the filter criteria that you specify. Use the command options to set one or more filters.
If you do not set a filter option, the command returns a list of the first 20 Human task instances in the database in which you have a role. Use the -MaxTasks option to change the number of task instances that the command returns.
You have a role in a task instance in any of the following cases:
The filter options that you set for the command are cumulative. If you set multiple filter options, the command returns a list of the Human task instances that satisfy all of the options that you set.
The command applies the user name that you submit as a filter on the task instances in the workflow database. For example, you run the listTasks command with the user name "Native\Mary" and you set the -FilterByOwner option to "Native\John." The command returns a list of the task instances that John owns and for which Mary is a potential owner or the business administrator.
The infacmd wfs listTasks command uses the following syntax:
listTasks

<-DomainName|-dn> domain_name

<-ServiceName|-sn> service_name

<-UserName|-un> user_name

<-Password|-pd> password

[<-MaxTasks|-max> max_tasks]

[<-FilterByOwner|-ow> e.g. Native\user_name]

[<-FilterByStatus|-st> READY|RESERVED|IN_PROGRESS|SUSPENDED]

[<-FilterByCreationDate|-cd> e.g. 2024-12-31]

[<-FilterByType|-tt> CleanseTask|ClusterTask|CleanseTaskReviewTask|ClusterTaskReviewTask]

[<-FilterByDueDate|-dd> e.g. 2024-12-31]

[<-FilterByID|-tid> e.g. 42]

[<-FilterByName|-tn> e.g. "ExceptionStep {1 - 9}"]

[<-FilterByNameLike|-tnl> e.g. "Step {% - %}"]

[<-TasksOffset|-offset> tasks_offset]

[<-Role> role]

[<-SecurityDomain|-sdn> security_domain]

[<-ResilienceTimeout|-re> timeout_period_in_seconds]
The infacmd wfs listTasks command uses the following syntax:
Option
Argument
Description
-DomainName
-dn
domain_name
Required. Name of the Informatica domain. You can set the domain name with the -dn option or the environment variable INFA_DEFAULT_DOMAIN. If you set a domain name with both methods, the -dn option takes precedence.
-ServiceName
-sn
service_name
Required. Name of the Data Integration Service that runs the workflow instance.
-UserName
-un
user_name
Required if the domain uses Native or LDAP authentication. User name to connect to the domain. You can set the user name with the -un option or the environment variable INFA_DEFAULT_DOMAIN_USER. If you set a user name with both methods, the -un option takes precedence.
Optional if the domain uses Kerberos authentication. To run the command with single sign-on, do not set the user name. If you set the user name, the command runs without single sign-on.
-Password
-pd
password
Required if you specify the user name. Password for the user name. The password is case sensitive. You can set a password with the -pd option or the environment variable INFA_DEFAULT_DOMAIN_PASSWORD. If you set a password with both methods, the password set with the -pd option takes precedence.
-MaxTasks
-max
max_tasks
Optional. Defines an upper limit for the number of Human task instances in the list that the command returns.
By default, infacmd wfs listTasks command returns a list of the first 20 task instances.
You can use the max option in conjunction with the -offset option.
-FilterByOwner
-ow
e.g. Native\user_name
Optional. Filters the list of the Human task instances in the workflow database by the name of the user or group that owns the task.
-FilterByStatus
-st
READY|RESERVED|IN_PROGRESS|SUSPENDED
Optional. Filters the list of the Human task instances in the workflow database by the task status.
-FilterByCreationDate
-cd
e.g. 2024-12-31
Optional. Filters the list of the Human task instances in the workflow database by the creation date of the tasks.
-FilterByType
-tt
CleanseTask|ClusterTask|CleanseTaskReviewTask|ClusterTaskReviewTask
Optional. Filters the list of the Human task instances in the workflow database by the task type.
-FilterByDueDate
-dd
e.g. 2024-12-31
Optional. Filters the list of the Human task instances in the workflow database by the task due date. The due date indicates the current deadline for task completion.
-FilterByID
-tid
e.g. 42
Optional. Filters the list of the Human task instances in the workflow database by the Human task instance ID.
-FilterByName
-tn
e.g. "ExceptionStep {1 - 9}"
Optional. Filters the list of the Human task instances in the workflow database by the Human task instance name that you specify.
Do not use -FilterByName and -FilterByNameLike in the same command.
-FilterByNameLike
-tnl
e.g. "Step {% - %}"
Optional. Filters the list of the Human task instances in the workflow database by the Human task name and allows a wildcard character in the filter string. You can use the percent (%) wildcard character.
Do not use -FilterByName and -FilterByNameLike in the same command.
-TasksOffset
-offset
tasks_offset
Optional. Specifies an offset from the first task instance in the list of task instances that meet the filter criteria.
When you specify an offset, the command skips the task instances that the offset specifies and returns a list that begins with the next task instance that meets the filter criteria.
You can use the -offset option with the -max option to organize the results of successive listTasks commands. For example, if you run infacmd wfs listTasks with a -max value of 50, you return a list of task instances in the range 1 through 50. If you run the command with a -max value of 50 and an -offset value of 51, you return the list of tasks in the range 51 through 100.
-Role
-role
Optional. Filters the list of the Human task instances in the workflow database by the Human task role.
You can enter the following values:
  • - ADMINISTRATORS
  • - ALL
  • - OWNERS
  • - POTENTIAL_OWNERS
If you do not set the option, the command returns task instances for all roles.
-SecurityDomain
-sdn
security_domain
Required if the domain uses LDAP authentication. Optional if the domain uses native authentication or Kerberos authentication. Name of the security domain to which the domain user belongs. You can set a security domain with the -sdn option or the environment variable INFA_DEFAULT_SECURITY_DOMAIN. If you set a security domain name with both methods, the -sdn option takes precedence. The security domain name is case sensitive.
If the domain uses native or LDAP authentication, the default is Native. If the domain uses Kerberos authentication, the default is the LDAP security domain created during installation. The name of the security domain is the same as the user realm specified during installation.
-ResilienceTimeout
-re
timeout_period_in_seconds
Optional. Amount of time in seconds that infacmd attempts to establish or re-establish a connection to the domain. You can set the resilience timeout period with the -re option or the environment variable INFA_CLIENT_RESILIENCE_TIMEOUT. If you set the resilience timeout period with both methods, the -re option takes precedence.