topic Re: Return parameters for operation results in Active IQ Unified Manager Discussions

Return parameters for operation results

MPARDINIRTP — Thu, 08 May 2014 16:26:37 GMT

I'm working on a custom command in WFA for polling two controllers for option differences. I have the results in an array, but I'm having a hard time figuring out how to get that output to the workflow user. I see the return parameters tab in the workflow results window and I'm wondering how I can get the results into that tab so the user can see the differences. Any ideas?

Re: Return parameters for operation results

paragp — Fri, 09 May 2014 05:07:16 GMT

This is possible in WFA 2.2RC and onwards. If you are using powershell commands you will need to add this line in your command

Add-WfaWorkflowParameter -Name volumeOptions -Value $volOptions -AddAsReturnParameter

and for perl it is

my $wfaUtil = WFAUtil->new();

$wfaUtil->addWfaWorkflowParameter(‘volumeOptions’, $volOptions, 1);

The Add-WfaWorkflowParameter and Get-WfaWorkflowParameter are primarily used for transferring information between commands during execution. The last parameter -AddAsReturnParameter adds the value as a return parameter to the workflow

Re: Return parameters for operation results

sinhaa — Fri, 09 May 2014 06:50:02 GMT

Add-WfaWorkflowParameter -Name volumeOptions -Value $volOptions -AddAsReturnParameter

-Value takes only a string argument, and as you said you have an Array, you can't use the array object directly. I suggest you join the array object to a string and then use it in the above command.. Something like below.

# Joining on a colon :

$volOptions = $volArray -join ":"

Add-WfaWorkflowParameter -Name volumeOptions -Value $volOptions -AddAsReturnParameter

Re: Return parameters for operation results

MPARDINIRTP — Fri, 09 May 2014 15:50:45 GMT

Thanks for the info. I'll run an upgrade and try it out!

Re: Return parameters for operation results

francoisbnc — Tue, 19 Jul 2016 07:49:40 GMT

Is there any improvements in wfa 4.0 version with Add-WfaWorkflowParameter.

Francois

Re: Return parameters for operation results

abhit — Thu, 18 Aug 2016 10:40:10 GMT

No.

Anything specific you are looking for?

Regards

Abhi

Re: Return parameters for operation results

francoisbnc — Mon, 05 Sep 2016 15:20:29 GMT

I think the main missing thing is add-wfaworkflowparameter accept only [string] type. Array of objects will be great.

François

Re: Return parameters for operation results

sinhaa — Tue, 06 Sep 2016 06:10:48 GMT

@francoisbnc

It may not be possible for the WFA cmdlets to accomodate other data types like array or hash etc.

But there is a simple way to get this done. You can easily use join and spilt methods to join the elements of an array to form a string.

$a= @("1","2","3")

$value = [System.String]::Join("~",$a) #Choose a separator which you are sure not an element in the array. Typically ~ or _ can work,

Add-WfaWorkflowParameter -Name "MyArray" -Value $Value

-----

In the next command where you want this array, get the value and call split on it.

$value = Get-WfaWorkflowParameter -Name "MyArray"

$a = $value.Split("~")

Now you got your Array as you wanted.

Similar methods are available in Perl for the WFA command in perl.

sinhaa

Re: Return parameters for operation results

sinhaa — Tue, 06 Sep 2016 07:01:12 GMT

@francoisbnc

I think you wanted array of Objects and not just an array, did you?

This is not possible with cmdlet, the cmdlet writes this dynamic name-value pair into a file and then fetches this data back to you.

The same join-split can help you in this case too.

sinhaa

Re: Return parameters for operation results

francoisbnc — Tue, 06 Sep 2016 07:38:45 GMT

Yes it is.

Many return values is difficult to read and maintain, a simple objet or array of objects would simple to manage.

Re: Return parameters for operation results

sinhaa — Wed, 07 Sep 2016 07:01:50 GMT

@francoisbnc

If you want to pass an object or even a array of objects between WFA commands, powershell itself provided you ways to do it.

You can use Powershell cmdlet Export-Clixml to save the object into the file in comamnd-1

and Import-Clixml to retrieve that object from the above file in command-2

See how to use them here. If you need assistance in using this cmdlets, I can help as well.

sinhaa

Re: Return parameters for operation results

francoisbnc — Wed, 07 Sep 2016 09:14:52 GMT

I will have a try. Many thanks.

Re: Return parameters for operation results

sinhaa — Fri, 09 Sep 2016 11:44:03 GMT

@francoisbnc

It works like this:

In command-1

===

#Have an object parameter. Not string but a Powershell Object. You can have any data type, strings, arrays, array of objects.

$Date = Get-Date

Export-Clixml -Path ".\date.xml" -InputObject $Date

#It will create a file date.xml in the WFA temp directory. You can choose any other path as well

=====

In command-2

$Date = Import-Clixml -Path ".\date.xml"

#The date object is obtained successfully. Now you can call all methods on this obtained object as you could.

$Date.day

====

sinhaa

Re: Return parameters for operation results

francoisbnc — Mon, 03 Oct 2016 15:56:36 GMT

@sinhaa

Your workaround looks good thanks, but just in case of simultaneous run of same workflow, I have to manage to name of the export file that cannot be the same.

I can add a random number at the end, pass it to the next command with add-wfaparameter, not so simple to have a clear overview of the workflow at the first look.

Re: Return parameters for operation results

mbeattie — Mon, 03 Oct 2016 23:08:47 GMT

Hi @francoisbnc

Assuming you want to pass an array of variables between WFA commands within a workflow (without using the Add-WfaWorkflowParameter cmdlet) and you are exporting those variables to file locally on your WFA server, then the file name would need to be constant to ensure all the commands in your WFA workflow read the content from the same file name. To achieve that you might consider using the workflow ID as the file name as this is a unique identifier. EG

$workflowID = $(Get-WfaRestParameter "workflowId")

Also you might consider using a system environment variable or reading the registry to determine the file path (or the install location of WFA) as a path to save any temporary files.

Something like this:

#'------------------------------------------------------------------------------
#'Enumerate the WFA install path from the registry
#'------------------------------------------------------------------------------
[String]$registryPath = "hklm:\system\currentcontrolset\services\na_wfa_srv";
[Int]$workflowID      = $(Get-WfaRestParameter "workflowId")
Try{
   [System.Object]$result  = Get-ItemProperty -Path $registryPath -ErrorAction Stop
   [String]$wfaExeSpec     = $result.ImagePath.Split("/")[0].Trim() -Replace("""", "")
   [String]$wfaServicePath = $wfaExeSpec.SubString(0, $wfaExeSpec.LastIndexOf("\"))
   [String]$installPath    = $wfaServicePath.SubString(0, $wfaServicePath.LastIndexOf("\"))
   Get-WFALogger -Info -Message "Enumerated WFA installation Path from Registry key ""$registryPath"" as ""$installPath"""
}Catch{
   Get-WFALogger -Error -Message $("Failed Reading Registry Path ""$registryPath"". Error " + $_.Exception.Message)
   Throw "Failed Reading Registry Path ""$registryPath"""
}
#'------------------------------------------------------------------------------
#'Ensure the workflows XML file exists.
#'------------------------------------------------------------------------------
[String]$fileSpec = "$installPath\$workflowID.xml"
If(Test-Path -Path $fileSpec){
   Get-WFALogger -Info -Message "Reading WFA workflow XML file ""$fileSpec"""
}Else{
   Throw "The WFA workflow XML file ""$fileSpec"" does not exist"
}
#'------------------------------------------------------------------------------

Assuming you are creating custom WFA commands, each command can enumerate the current workflow ID and hence read from the correct configuration file which will ensure a uniquie file is created and read from for each workflow in the scenario where the workflow is being executed multiple times as the ID will always be unique.

Hope that helps

/Matt

Re: Return parameters for operation results

francoisbnc — Tue, 04 Oct 2016 07:52:11 GMT

Did you speak of workflow id or runtime id?

Because, as we gave the WFA console to multiple users, workflows can be launched at the same time with a potential of multiple RW access on file.

Re: Return parameters for operation results

jauling_chou — Fri, 31 Mar 2017 13:25:17 GMT

Hi,

Is this the best way to properly generate the output when listing snapshots for a specific volume?

Since OCUM6 and OCUM7 don't have volume snapshots anymore, I've resorted to querying volume snapshots via WFA4 workflows. We toyed with using a datasource job in WFA4 to do it, but it takes multiple hours for each job run, and puts a strain on our vservers.

My workflow command basically runs the following (I've purposefully omitted error-handling code, so keep this paste simple):

Connect-WfaCluster $Cluster

$vol = Get-NcVol -Name $VolumeName -Vserver $VserverName
$snaplist = $vol | Get-NcSnapshot

Get-WFALogger -Info -message $("Vserver: " + $VserverName + " Volume: " + $VolumeName + " Snapshots:" + $snaplist)

Add-WfaWorkflowParameter -Name "SnapList" -Value $snaplist -AddAsReturnParameter $true

The Get-WFALogger command only shows the snapshot name for some reason. I had assumed it would show all the default columns. Anyone know why this is?

The Add-WfaWorkflowParameter obviously fails, and gives me the following error:

ERROR [get volume snapshot list] Cannot convert 'System.Object[]' to the type 'System.String' required by parameter 'Value'. Specified method is not supported.
ERROR [get volume snapshot list] Failed executing command. Exception: Cannot convert 'System.Object[]' to the type 'System.String' required by parameter 'Value'. Specified method is not supported.

Re: Return parameters for operation results

sinhaa — Fri, 31 Mar 2017 15:31:44 GMT

Is this the best way to properly generate the output when listing snapshots for a specific volume?

-----

No.

But the error that is being thrown : Cannot convert 'System.Object[]' to the type 'System.String' required by parameter 'Value'. Specified method is not supported.

Is NOT generated at the Get-WfaLogger cmdlet. This error is being thrown by Add-WfaWorkflowParameter

Your code has problems at the 2 cmdlets.

Re: Return parameters for operation results

jauling_chou — Fri, 31 Mar 2017 15:42:20 GMT

@sinhaa wrote:

Is this the best way to properly generate the output when listing snapshots for a specific volume?

-----

No.

But the error that is being thrown : Cannot convert 'System.Object[]' to the type 'System.String' required by parameter 'Value'. Specified method is not supported.

Is NOT generated at the Get-WfaLogger cmdlet. This error is being thrown by Add-WfaWorkflowParameter

Your code has problems at the 2 cmdlets.

Hi @sinhaa

Apologies if I misstated myself. I absolutely understand that the two errors are regarding the workflow parameter code. It doesn't like the fact I'm passing an Object[] as a String. I need to somehow take the snapshot list output, and massage it into a String in order to successfully pass it as a WfaWorkflowParamter, correct?

A secondary issue is that the Get-WfaLogger, when I test the WFA cmd, only shows me the snapshot name, which to me seems a bit odd, since Get-NcSnapshot -Template shows 3 columns of data. I'm thinking that might just be how its outputted when it tries to print a table in WfaLogger, not exactly sure.

Re: Return parameters for operation results

sinhaa — Fri, 31 Mar 2017 16:48:50 GMT

@jauling_chou

Use the below code. Powershell is a great language, it can do virtually anything.

This will work.

Connect-WfaCluster $Cluster

$vol = Get-NcVol -Name $VolumeName -Vserver $VserverName
$snaplist = $vol | Get-NcSnapshot | Out-String

Get-WFALogger -Info -message $("Vserver: " + $VserverName + " Volume: " + $VolumeName + " Snapshots:" + $snaplist)

Add-WfaWorkflowParameter -Name "SnapList" -Value $snaplist -AddAsReturnParameter $true

sinhaa