4.16.15 Time determination
Function
This plug-in judges whether the specified judgment-target time meets the specified condition.
The following is an explanation of the judgment-target time (the common.criterionTime property):
- Specify the judgment-target time (the common.criterionTime property) by using the format, "hh:mm".
- If specification of the judgment-target time is omitted, the current time of the execution target server is set.
The current time is based on the time zone that is specified for the user that is connected to the execution target server by using agentless connection.
The following is an explanation of the judgment conditions (the common.condition property):
- Specify the judgment condition by using the format, "hh:mm-hh:mm".
Specify the start time of the condition for the first "hh:mm", and the end time of the condition for the second "hh:mm".
- If the judgment-target time matches the specified condition, the output character string (the common.conditionOutput property) corresponding to the matched condition (the common.matchConditionOutput property) is stored.
(start time of the condition) ≤ (judgment-target time) < (end time of the condition)
- You can specify a maximum of 10 conditions.
If the specified time matches multiple conditions, a condition that has a smaller condition number takes priority, and the output character string (the common.conditionOutput property) corresponding to the matched condition (the common.matchConditionOutput property) is stored.
The following is an explanation of the output character string (the common.conditionOutput property):
- Specify a string of 512 or fewer characters.
- If this specification is omitted, the condition number is specified.
The following is an explanation of the output character string when the condition is not met (the common.otherConditionOutput property):
- Specify a string of 512 or fewer characters.
Use situation
By using this plug-in together with a judge value plug-in, you can branch flows according to time.
Prerequisites
For the most recent information about the prerequisite products for the system, prerequisite products for the execution-target server, and the supported OSs for the execution-target server, see the release notes.
[Prerequisite products for the system]
JP1/Automatic Operation 11-00 or later
[Prerequisite products for the execution-target server]
None.
[Supported OSs for the execution-target server]
(1) Windows Server 2008 R2 Standard/Enterprise/Datacenter
(2) Windows Server 2012 Standard/Datacenter or Windows Server 2012 R2 Standard/Datacenter
(3) Windows Server 2016 Standard/Datacenter
[Conditions for using the execution-target server]
None.
Cautions
(1) Do not specify character strings containing double quotation marks (") or single quotation marks (') for the properties of this plug-in.
(2) Do not specify the same time for the start and end times of the judgment condition (the common.condition property). If the same time is specified, this plug-in will end abnormally.
Version
02.00.00
Plug-in tags
Gather OS information,Windows
Plug-in name displayed in the task log
osJudgmentTime
Return code
0: Normal
12: Error (mistake by the user): A property is invalid.
27: Error (Check the error details in the task log.)
41: Error (An error was detected in the component.): A property was not entered. (An error was detected in the component script.)
Property list
The following table lists the properties:
Property key |
Property name |
Description |
Default value |
I/O type |
Required |
---|---|---|---|---|---|
plugin.destinationHost |
Host name of the execution target server |
Specify the host name or IP address of the server on which this plugin will be executed. IPv6 addresses are not supported. |
-- |
Input |
R |
common.criterionTime |
Determination target time (hh:mm) |
Specify the time of the determination target. By default, this value is set to the current time of the execution target server. |
-- |
Input |
O |
common.condition1 |
Condition 1 (hh:mm-hh:mm) |
Specify condition 1. |
-- |
Input |
R |
common.condition1Output |
Output string 1 |
Specify the string that is output if condition 1 is matched. By default, the string is set to "1". |
-- |
Input |
O |
common.condition2 |
Condition 2 (hh:mm-hh:mm) |
Specify condition 2. |
-- |
Input |
O |
common.condition2Output |
Output string 2 |
Specify the string that is output if condition 2 is matched. By default, the string is set to "2". |
-- |
Input |
O |
common.condition3 |
Condition 3 (hh:mm-hh:mm) |
Specify condition 3. |
-- |
Input |
O |
common.condition3Output |
Output string 3 |
Specify the string that is output if condition 3 is matched. By default, the string is set to "3". |
-- |
Input |
O |
common.condition4 |
Condition 4 (hh:mm-hh:mm) |
Specify condition 4. |
-- |
Input |
O |
common.condition4Output |
Output string 4 |
Specify the string that is output if condition 4 is matched. By default, the string is set to "4". |
-- |
Input |
O |
common.condition5 |
Condition 5 (hh:mm-hh:mm) |
Specify condition 5. |
-- |
Input |
O |
common.condition5Output |
Output string 5 |
Specify the string that is output if condition 5 is matched. By default, the string is set to "5". |
-- |
Input |
O |
common.condition6 |
Condition 6 (hh:mm-hh:mm) |
Specify condition 6. |
-- |
Input |
O |
common.condition6Output |
Output string 6 |
-- |
-- |
Input |
O |
common.condition7 |
Condition 7 (hh:mm-hh:mm) |
-- |
-- |
Input |
O |
common.condition7Output |
Output string 7 |
Specify the string that is output if condition 7 is matched. By default, the string is set to "7". |
-- |
Input |
O |
common.condition8 |
Condition 8 (hh:mm-hh:mm) |
Specify condition 8. |
-- |
Input |
O |
common.condition8Output |
Output string 8 |
Specify the string that is output if condition 8 is matched. By default, the string is set to "8". |
-- |
Input |
O |
common.condition9 |
Condition 9 (hh:mm-hh:mm) |
Specify condition 9. |
-- |
Input |
O |
common.condition9Output |
Output string 9 |
Specify the string that is output if condition 9 is matched. By default, the string is set to "9". |
-- |
Input |
O |
common.condition10 |
Condition 10 (hh:mm-hh:mm) |
Specify condition 10. |
-- |
Input |
O |
common.condition10Output |
Output string 10 |
Specify the string that is output if condition 10 is matched. By default, the string is set to "10". |
-- |
Input |
O |
common.otherConditionOutput |
Output string if no conditions are matched |
Specify the string that is output if no conditions are matched. |
99 |
Input |
R |
common.matchConditionOutput |
Matched conditions |
The string that is output if any of the conditions are matched or no conditions are matched is stored here. |
-- |
Output |
O |
common.returnValue |
Return value for the plugin |
The return value of this plugin stored. |
-- |
Output |
O |