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 [-WorkflowPath] <String> [[-OrderName] <String>] [[-Variables] <Hashtable>] [[-At] <String>] [[-AtDate] <DateTime>] [[-Timezone] <String>] [[-BlockPosition] <String>] [[-StartPosition] <String>] [[-EndPositions] <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.

...

-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

...

-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

...

-Timezone <String>
Specifies the time zone to be considered for the start time that is indicated with the -At parameter.
Without this parameter the time zone of the JS7 Controller is assumed.

This parameter should be used if the JS7 Controller runs in a time zone different from the environment
that makes use of this cmdlet.

Find the list of time zone names from https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
# .PARAMETER StartPosition
# Specifies that the order should enter the workflow at the workflow node that
# is assigend the specified position.
#
# .PARAMETER EndPosition
# Specifies that the order should leave the workflow at the workflow node that
# is assigend the specified position.
#

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

BlockPosition

-BlockPosition <String>

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

StartPosition

-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?611
Default value
Accept pipeline input?true (ByPropertyName)
Accept wildcard characters?false

BatchSize

-BatchSize <Int32>
[Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)]
[string] $StartPosition,
[Parameter(Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelinebyPropertyName=$True)]
[string] $EndPosition, 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?712
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?813
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 enforce Audit Log comments for any interventions.

Required?false
Position?914
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?1015
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?1116
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.

...

Adds an order to the indicated workflow. The order will start one hour later and will use the variables as specified by the -Variables 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.