Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Adds an order to a workflow in the a JS7 Controller

SYNTAX

Add-JS7Order [-OrderNameWorkflowPath] <String> [[-WorkflowPathOrderName] <String>] [[-ArgumentsVariables] <Hashtable>] [[-At] <String>] [[-AtDate] <DateTime>] [[-Timezone] <String>] [[-StateBlockPosition] <String>] [[-StartPosition] <String>] [[-EndStateEndPositions] <String[]>] [[-Tag] <String[]>] [-ForceJobAdmission] [[-ControllerId] <String>] [[-BatchSize] <Int32>] [[-RunningNumber] <Int32>] [[-AuditComment] <String>] [[-AuditTimeSpent] <Int32>] [[-AuditTicketLink] <Uri>] [<CommonParameters>]

...

Creates a temporary order for execution with the specified workflow.

The following REST Web Service API resources are used:

* /orders/add

PARAMETERS

WorkflowPath

-WorkflowPath <String>
Specifies the path and/or name of a workflow for which an order should be added.

Required?true
Position?1
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

OrderName

-OrderName <String>
Specifies the name of an order. The JOC Cockpit web service will consider the order name
when creating unique order iDs from Order IDs with the pattern #<YYYY-MM-DD>#<qualifier><timestamp>-<order-name>
such as with #2020-11-22#T072521128-Some_Order_Name.

* YYYY-MM-DD: Date for which the order is scheduled
* qualifier: one of T(emporary), P(lan), F(ile), created by AD(D) Order Instruction
* timespan: time specified in milliseconds
* order-name: the value of the -OrderName parameter

Required?truePosition?1Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

WorkflowPath

...

Required?true
Position?2
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

Variables

-Arguments Variables <Hashtable>
Specifies the arguments variables for the order. Arguments Variables are created from a hashmap,
i.e. a list of names and values. Values have to be specified according to the
variables declaration of the workflow and include use of the data types:

* string: $orderVariables = @{ 'arg1' = 'value1' }
* number: $orderVariables = @{ 'arg2' = 3.14 }
* boolean: $orderVariables = @{ 'arg3' = $true }

Example:
$orderArgs $orderVariables = @{ 'arg1var1' = 'value1'; 'arg2var2' = 3.14; 'value2var3' = $true }

Consider that a workflow can declare required variables that have to be added to an order.

Required?false
Position?3
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

-At <String>
Specifies the point in time when the order should start. Values are added like this:

* now
** specifies that the order should start immediately
* now+1800
** specifies that the order should start with a delay of 1800 seconds, i.e. 30 minutes later.
* yyyy-mm-dd HH:MM[:SS]
** specifies that the order should start at the specified point in time.
* never
** specifies that the order is added without a desired start time. Users have to manually modify the start time
of such orders to make them start.

Required?false
Position?4
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

Required?false
Position?6
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

BlockPosition

-State BlockPosition <String>

Required?false
Position?7
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

StartPosition

-EndState <String>
StartPosition <String>
Specifies the label of an instruction in the workflow that the order will be started for.

The top-level instructions in a workflow are allowed start positions. If an instruction inside some block Instruction
should be used as the start position, then the -BlockPosition argument can be used to specify the label of the block
and the -StartPosition argument can be used to specify the label of an instruction inside the block.

Required?false
Position?8
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

EndPositions

-EndPositions <String[]>
Specifies the labels of instructions in the workflow at which the order will leave the workflow.
The order will not execute the related instruction.

Required?false
Position?9
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

Tag

-Tag <String[]>

Required?false
Position?10
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

ForceJobAdmission

-ForceJobAdmission <SwitchParameter>
Specifies that job admission times should not be considered. The order will execute all jobs in the workflow
without waiting for specified admission times.

Required?false
Position?named
Default valueFalse
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

ControllerId

-ControllerId <String>
Optionally specifies the identification of the Controller to which the order is added.

Required?false
Position?11
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

BatchSize

-BatchSize <Int32>
As this cmdlet accepts pipelined input a larger number of orders can be added at the same time.
This is particularly true if the Invoke-JS7TestRun cmdlet is used.

Larger numbers of orders are split into individual calls to the REST API according to the batch size.
This is required as larger batches could exceed the size of HTTP post requests that frequently
is limited to 4MB if an HTTP proxy is used.

Required?false
Position?912
Default value100
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

-RunningNumber <Int32>
This parameter is implicitely implicitly used when pipelining input to the cmdlet as e.g. with

1..10 | Add-JS7Order -WorkflowPath /some_path/some_workflow

Required?false
Position?1013
Default value0
Accept pipeline input?true (ByValue, ByPropertyName)
Accept wildcard characters?false

...

-AuditComment <String>
Specifies a free text that indicates the reason for the current intervention,
e.g. "business requirement", "maintenance window" etc.

The Audit Comment is visible from the Audit Log view of the JOC Cockpit.
This argument is not mandatory, however, JOC Cockpit can be configured
to enforece enforce Audit Log comments for any interventions.

Required?false
Position?1114
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

-AuditTimeSpent <Int32>
Specifies the duration in minutes that the current intervention required.

This information is visible with shown in the Audit Log view. It can be useful when integrated
with a ticket system that logs the time spent on interventions with JS7.

Required?false
Position?1215
Default value0
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

-AuditTicketLink <Uri>
Specifies a URL to a ticket system that keeps track of any interventions performed for JobSchedulerJS7.

This information is visible with shown in the Audit Log view of JOC Cockpit.
It can be useful when integrated with a ticket system that logs interventions with JobSchedulerJS7.

Required?false
Position?1316
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

...

PS > $orderId = Add-JS7Order -OrderName Test -WorkflowPath /sos/reporting/Reporting -At "2038-01-01 00:00:00" -Timezone "Europe/Berlin"

Adds the indicated order andorder for a later date that is specified for the "Europe/Berlin" time zone.

...

PS > $orderId = Add-JS7Order -WorkflowPath /sos/reporting/Reporting -At "now+3600" -Arguments Variables @{'param1var1'='value1'; 'param2var2'=3.14; 'value2var3'=$true}

Adds an order to the indicated workflow. The order will start one hour later and will use the arguments variables as specified by the -Arguments parameterVariables parameter.

-------------------------- EXAMPLE 6 --------------------------

PS > $orderId = Add-JS7Order -WorkflowPath /ProductDemo/ParallelExecution/pdwFork -StartPosition "job2"

Adds an order to the workflow position labelled "job2" of the indicated workflow.

-------------------------- EXAMPLE 7 --------------------------

PS > $orderId = Add-JS7Order -WorkflowPath /ProductDemo/ParallelExecution/pdwFork -EndPositions "job3","job4"

Adds an order for two possible end positions with the labels "job3" and "job4" of the indicated workflow.