Quick Start※”Operation Autonomy Support Engine” is referred to as “OASE” in this manual.

Exastro Operation Autonomy Support Engine Version 1.3.1
Exastro developerTable of contents
1. Introduction
1.1
1.2
1.3
1.4
1.5
1.6
1.7
1.8
1.9

About this guide
Login screen
Screen description （Dashboard screen）
Screen description （Action setting screen）
Screen Description（Token pay out screen）
Screen description （Decision table screen）
Screen description （rule screen）
Screen description （Request history screen）
Screen description （Action history screen）

2. Scenario description
2.1

Scenario

3. Preparation before execution
3.1
3.2
3.2
3.3
3.4
3.5
3.6

Setup mail driver and create mail template
Pay out token
Create decision table
Create decision table ※Excel operation
Upload decision table file
Test request
Apply to production environment

4. Operation execution
4.1
4.2

Send request via curl command
Check the result of action execution

A Appendix
Sample11. Introduction

1.1About this guide（1/2）▌Prerequisites
In order to follow this guide, the user must have installed OASE and thefollowing functions.
① OASE Installer (See the following guides)

Introduction• <OASE_docs Environment Construction manual-Basics->• <OASE Learn –OASE Offline install->② Mail Driver (See the following guides)

Prerequisites①

OASE
installed②

Mail Driver
Installed③

Mail server
Running• <Environment Construction manual- Driver install->③ Make sure that the mail server is running.
• e.g.）Checking that postfix.service is running.
# ps –ax | grep postfix※If it isn’t running, run the following command.
# systemctl start postfix

ExastroYou can now use thequick start guide.

4

1.1About this guide（2/2）▌Functions.
 The following OASE functions will be used. (The item no. correlates the upcoming
slides.) Dashboard screen

Item
No.

Screen namePath Location

1.2

Login

1.3

Dashboard

DashBoard

1.4

Action settings

DashBoard > System > Action settings > mail Driver ver1

1.5

Token Pay-out

DashBoard > Rules > Token Pay-out

1.6

Decision Table

DashBoard > Rules > Decision Table

1.7

Rules

1.8

Request History

DashBoard > Rules > Request History

1.9

Action History

DashBoard > Rules > Action History

Exastro

DashBoard > Rules > Rules > Staging Application rule
DashBoard > Rules > Rules > Production Application rule

5

1.2

Screen description（Login screen）▌OASE Login The login screen will be displayed by accessing the following URL.
https://exastro-oase/oase_web/top/login

The password will be requested to
be changed immediately after login
for the first time.

Exastro6

1.3

Screen Description（Dashboard Screen）▌The overview of the main menu is as follows.
 ”Rule “Menu：Action result management and Rule creation.

 ”System”Menu：OASE Settings/Permission management.

 “Administrator” Menu

：Security Management.

Menu

Please refer to the manuals for details of thefunctions in each menu.

Exastro7

1.4

Screen description（Action setting screen）▌Function Description① The name of the driver installed in OASE
② The information of the registered action target③ The button to add action target information to installed driver④ The button to create mail template

③
①
④
②

Please refer to themanuals for details of thefunctions in each menu.

Exastro8

1.5

Screen description（Token Pay-out）▌Function Description① List of Tokens registered in OASE.
② Button that creates new Tokens.

①②

For more information regarding the different functions,please see the respective manuals.

Exastro9

1.6

Screen description（Decision table screen）▌Function Description① Decision tables registered to OASE
② Button that allows users to download the decision table file
③ Button that allows users to add/create new decision tables

③

②

①

Please refer to themanuals for details of thefunctions in each menu.

Exastro10

1.6

Screen description（Rule screen）▌Function Description① Decision table file operation buttons.
② List of uploaded Decision table files and their status.
③ Production environment application button.
①②③

Please refer to themanuals for details of thefunctions in each menu.

Button ③ becomes available only when a decision table file uploaded toa staging environment is tested.

Exastro11

1.7

Screen description（Rule screen）▌Function Description① The list of the rules that are practically operated when messages are sent to OASE①

Please refer to themanuals for details of thefunctions in each menu.

Exastro12

1.8

Screen description（Request history screen）▌Function description① The list of the matched rules and their status①

Please refer to themanuals for details of thefunctions in each menu.
Exastro13

1.8

Screen description（Action history screen）▌Function description① The list of the matched rules and their status①

Please refer to themanuals for details of thefunctions in each menu.

Exastro14

2. Scenario description

2.1

Scenario▌Scenarios after OASE installation until action history being obtained.
１

Set mail driver and create mail template２

Pay out Token【Preparation】 ３

Create decision table

４

Create decision table file ※In Excel

５

Upload decision table file６

Test request

7

Apply to production environment【Operation】

8

Send request via curl command

Inserting messages
Matching rules andExecuting Actions.

9

Check the results of action execution

Configuring settings
andRegistering rules

Exastro16

3. Preparation before execution

3.1

Set mail driver and create mail template (1/3)▌Add action target① Press the “Add action target” button in the “Action settings” screen.
② Select “mail Driver ver1”.
１

Set mail driver andcreate mail template
Pay out Token

Create decision table

2

Create decision table file
※In Excel
Upload decision table file
Test request
Apply to production
environment
Send request via curl command

The “mail Driver ver1” will not be displayed
if you don`t have the driver installed.

Check the result ofaction execution

Please refer to <Environment construction manaul -Driver installation->
if the mail driver hasn’t been registered.
Exastro18

3.1

Set mail driver and create mail template (2/3)▌Set action target
 Enter required information then click the “Save” button.
Set mail driver andcreate mail template
Pay out Token

Create decision table
Create decision table file
※In Excel

Item

Setting value

Name

Enter your desired action target name.

ProtocolSelect either “smtp” or “smtp_auth”

Smtp
ServerEnter private IP or global IP※The SMTP server has to be prepared in advancePort

Enter the port number used for communication

User nameEnter the user name as the mail sender.

Password

Enter the password required for authentication

Exastro“Item:name” is used to
specify “Execute action
to which action target”
when creating the latter
mentioned decisiontable file.

Upload decision table file
Test request
Apply to production
environment
Send request via curl command
Check the result ofaction execution“Item:user name” isdisplayed as thesender of the mail.

Items with * arerequired items
19

3.1

Set mail driver and create mail template (3/3)▌Create mail template① Press the “Email Templates” button② Press the “Register” button③ Fill in the required items with the information below④ Press the “Save” button.

Set mail driver andcreate mail template
Pay out Token

Create decision table

１

Create decision table file
※In Excel

2

Upload decision table file3
Item

Setting value

TemplatenameEnter any desired template
nameDestination

Enter destination mail address

CC

Optional

BCC

Optional

Subject

Enter any desired subject

Body

Enter any desired body context

Exastro4

The "Template name" is required later
when we are creating a decision table
file. We will use it to specify what kindof mail template we will use.
By tagging the "Body" with[ACTION_INFO] or[EVENT_INFO] ,we can receive mail with request
information or event information
included.

Test request
Apply to production
environment
Send request via curl command
Check the result ofaction execution

Items with * arerequired items
20

3.2

Token Pay-out▌Pay out new token.
① Press the “ Pay out new token” button② Input the information found below③ Press the “Pay out Token” button④ Copy and save the Token displayed in the “Token” screen.

Set mail driver andcreate mail template
Pay out Token⑤ Press the “Close” button.
１

Create decision table
Create decision table file
※In Excel

2

Input the following information
Item

3

4
5
ExastroUpload decision table file

Setting value

Token name

Free nameGroup
Permissions

SystemAdministrator :With
Permission

Test request
Apply to production
environment
Send request via curl command
Check the result ofaction execution

Token needs to be configured forthe curl command requests
introduced later in this document.

21

3.3

Create Decision table(1/2)▌Create Decision table① Press the “Register” button on the decision table screen.
② Fill out the required fields in the “Basic Information/ permissions” tab③ Press the “Move to Conditional expression settings” button

Pay out Token１
Input
the following
valuesBasic information/ permissionstab

2

Set mail driver andcreate mail template

Item

Setting value

Decisiontable name

Free value

Setpermissions

SystemAdministrator : “canperform update” onall

Create decision table
Create decision table file
※In Excel
Upload decision table file
Test request
Apply to production
environment
Send request via curl command3
ExastroThe "Permission settings" needs
to have at least one group who
can "Perform update".
If not, you will not be able toupdate it.

Check the result ofaction execution

Items with * arerequired items
22

3.3

Create Decision table(2/2)▌Create Decision table④ In the “Conditional Branch” tab in the “New addition” screen, input the necessary information⑤ Press the “Unknown Event Notification settings” button.
⑥ In the “Unknown Event Notification” tab in the “New addition screen”,
input the necessary information⑦ Press the “Save” button.
“Conditional expression” tabItem
Condition name

Conditional
expression

Pay out Token“Unknown event Notification” tabSetting value
Free Character string
Equal(Number)

Input the values above

Set mail driver andcreate mail template

Item

Setting value

Unknown event
notifications

Don’t notify me

Create decision table
Create decision table file
※In Excel
Upload decision table file

Input the value above

6
Test request

4

Apply to production
environment

We will set theDecision table
file's Conditional
part`s specificvalue to theconfigured
Conditional
Branch.

5
ExastroSend request via curl command
Check the result ofaction execution

7

Items with * arerequired items
23

3.3

Create decision table file ※In Excel (1/2)▌Download and create decision table file Download the decision table created in “3.2 create decision table” by clicking thedownload button.
Set mail driver andcreate mail template
Pay out Token

Create decision table
Create decision table file
※In Excel
Upload decision table file
Test request
Apply to production
environment
Send request via curl command
Check the result ofaction execution

The name of the Decision table file is created automatically.
(E.g) idid00000000000.xlsx). This is different from the earlier mentioned"Decision table name". More information regarding each item is written on thenext page.

Exastro24

3.3

Create decision table file ※In Excel (2/2)▌Enter the following content in the decision table file.
※For practical usage example, please refer to “A Appendix Sample1”.
Set mail driver andcreate mail template
Pay out Token

①

②

③

④

Create decision table
Create decision table file
※In Excel①Comment partCan be empty. Enter description or other desired content.

②Condition partEnter the condition which matches the rule.

③Action part

• Set the action to be executed for each rule name.
• Users can set to execute action or send approval mail.
• Only the drivers set in “Action settings” screen can be entered in“action type”.
（In this document, “mail Driver ver1” is set.)• Please note that the format of “Action parameter information” isdifferent for each action type.

④Actioncondition partCan be empty. Users can set the time to enable and disable the rule.

Upload decision table file
Test request
Apply to production
environment
Send request via curl command
Check the result ofaction execution

For information regarding describing values, please refer to the "Description example" sheet.
You can change the file name to whatever you want after updating the decision table file.
Exastro25

3.4

Upload decision table file

▌Select the decision table file to perform test request.
① Click the “select file” button in the “Rule” screen then select the created decisiontable file.
② Click the “Upload” button.
③ Press the “OK” button on the Pop-up message.

Set mail driver andcreate mail template
Pay out Token①②

Create decision table
Create decision table file
※In Excel
Upload decision table file
Test request
Apply to production
environment
Send request via curl command
Check the result ofaction execution

Exastro26

3.5

Test request (1/3)▌Select Test Request Target① Click the “Test request” button when the “Working status” column changes to“Applied to Staging Environment”.
② In the “Select Decision table name” column,
select the Decision table you want to test.

Set mail driver andcreate mail template③ Press the “Test Request settings” button.

Pay out Token

Create decision table
Create decision table file
※In Excel

１

Upload decision table file
Test request
Apply to production
environment

2

Send request via curl command
Check the result ofaction execution

3
ExastroThe working status updates automatically every 5 seconds.
Please refer to <Instruction manual –Rule Screen(1)Rule screen(Staging)> for the details of working status.
27

3.5

Test request (2/3)▌Enter Test value and execute.
①

In the "Single test" tab in the "Settings" tab, input a value that matches the rule.

②

Press the "Execute" button.

③

Press the "OK" button in the Pop-up message.

Set mail driver andcreate mail template
Pay out Token

１

3

Create decision table
Create decision table file
※In Excel
Upload decision table file
Test request
Apply to production
environment

2

Send request via curl command
Check the result ofaction execution

When matched the rules created in <3.3 Create decision table (Excel)>,“Successfully processed” and “Matched” will be displayed in execution log.
When rule matched, “Operation status” will change to next state.
Exastro28

3.6

Test Request (3/3)▌Confirm that the Rules are active.
 Check the Execution log from the “log” tab.
① Press the “Close” button② Press the “OK” button on the pop-up message.

Set mail driver andcreate mail template
Pay out Token

Enlarged2

Create decision table file
※In Excel

The process ended successfully
Rule A got Matched１

 If the rule got hit, press the “OK” buttonin the dialog box.

Create decision table

Upload decision table file

The previously
mentioned "Create
Decision table file"If a rule created in theprevious
section ,"Create
Decision table file" gets
hit, the "Execution log"
field will display"Successfully
processed" or "Matchedwith XXX".

Test request
Apply to production
environment
Send request via curl command
Check the result ofaction execution

When a rule match, the"Application status" will
move to the next status.

Exastro29

3.6

Apply to production environment▌Make verified rules available in production environment.
 To enable rule in production environment, apply the rule from “Rules applying to
Staging environment” to “Rules applying to Production environment”.
① When the test request matched the rule correctly, the operation
status in staging environment will change to “Verification completed”.
② Press the “Apply” button③ Press the “OK” button in the dialogue window.

2

If the Test request ended
successfully, the status willchange to “Verification
１ completed”

After the Production
environment's Working
status has changed to"Production application
completed", the decisiontable can be used in a realenvironment.
3

Set mail driver andcreate mail template
Pay out Token

Create decision table
Create decision table file
※In Excel
Upload decision table file
Test request
Apply to production
environment
Send request via curl command
Check the result ofaction execution

The operation status updates automatically every 5 seconds. Please refer to<Instruction Manual -Rule Screen- (2)Rule Screen(Production)> for the detailsof operation status.
Exastro30

4. Operation execution

4.1

Send request via curl command (1/2)▌Send the message and match the rule applied to production
environment with the message
 Open the terminal and execute after rewriting the following commands according to the rules.
※See "A Appendix Sample 1" below for specific usage examplesof the curl command.
curl -X POST -k “

①
” -d

②

” -H “⑤Item

Pay out Token

Create decision table③④

Set mail driver andcreate mail template

Setting value①Host nameEnter valid host name, IP address②Rule Table nameEnter the rule file name applied to production
environment(without .xlsx)③Request typeEnter “1” since the target is “1:production environment”
Example）"requesttype":"1"④Event occurrence
datetime

Enter the time in”yyyy/mm/dd hh:mm:ss” format
Example）"eventdatetime":"2020/01/01 01:01:01"⑤Event information

Specify in list format

Example）["2","foo"]

Create decision table file
※In Excel
Upload decision table file
Test request
Apply to production
environment
Send request via curl command
Check the result ofaction execution

Please refer to <RestAPI Function Instruction Manual> for the details of HTTP request.
Exastro32

4.1

Send request via curl command (2/2)▌Check the “request history” screen A history of sending a request by specifying parameters with the curl command is added.

Set mail driver andcreate mail template
Pay out Token

Create decision table※Items displayed in the “Request history” screen can bechanged.

Create decision table file
※In Excel
Upload decision table file
Test request
Apply to production
environment
Send request via curl command
Check the result ofaction execution

Exastro33

4.2

Check the result of action execution (action history)▌Execute action
 When rule is matched, action(mail notification) will be executed as users set in preparation
before execution, and users can check the result in “Action history” screen.
 Action will be executed as the specification in the action part of<3.3 Create decision table file ※In Excel >（mail Driver will sent notification mail as user’s specification)▌Mail notification
 Mail with the receiver, title, body set in<3.1 Set mail driver and create mail template> is sent.

▌Action history
 Check if the rules are matched and executed are displayed in“Action history” screen.

Set mail driver andcreate mail template
Pay out Token

Create decision table
Create decision table file
※In Excel
Upload decision table file
Test request
Apply to production
environment
Send request via curl command
Check the result ofaction execution

Exastro34

A

AppendixSample1(1/4)▌Enter Sample value and Execute OASE Case: When OASE receive “MessageID: 10001”, execute a action to send a mailwith information “Title:【OASE】Notification test”, “Body:[Request Info][EventInfo]”【Preparation】①「Action Settings」Screen• Prepare「mail Driver ver1」
Nameoasetest

Smtp Server

0.0.0.0

User namesample@example.com

Password（blank）②「Token Pay-out」screen• Prepare Token needed whensending request via curlcommand.
Token nametest_token（Register other required info）（Register other required info）
・ Create「Mail Template」

ExastroTemplate nametest_template

Title【OASE】Notification test

Body

[ACTION_INFO][EVENT_INFO]This information is used in theseparts of this manual:<3.1 Set
mail driver and create mailtemplate>and <3.2 Pay-out token.>36

Sample１(2/4)②「Decision table」Screen
Create a rule that the “MessageID” will hit
Decision table nametest

Permission Settings（System Administrator）

All「Editable」

Conditional nameMessage ID

Conditional branch

Equal(Number)This information is used inthese parts of this manual<3.3 Create Decisiontable>and <3.4 Create
Decision table *with Excel>.

③「Decision table 」File• Rename and save the “Decision table” file.
File namemail_test.xlsx

Create a rule that “messageID:10001” will hit※Change the text marked with Red.
MessageID（Equal(Numeric
Value)）

10001

Action Typemail(ver1)

Action Parameter
Information

MAIL_NAME=oasetest,MAIL_TO=<Mail
Address>,MAIL_CC=,MAIL_BCC=,MAIL_TEMPLATE=test_template（For the other items, use the "example" sheet in the Decision table file as a reference point.）
Exastro37

Sample１(3/4)④「Rule（Staging Application Rule)」Screen• Upload the created Decision table file.
Select Filemail_test.xlsx⑤「Test Request」Screen
Test whether when request “MessageID:10001” matches the uploaded decision table ornot
Select Decision table nametest

Message ID

10001

This information is used in these parts of this manual<3.5 Uploading Decision table file>And <3.6Test Request>
Exastro38

Sample１(4/4)
【Execute Operation】⑥Terminal Operation（Linux server）
Send request to the prepared rule via curl command※Please change the text marked with red.
curl -X POST -k "https://<HostName>/oase_web/event/event/eventsrequest" -H "accept:
application/json" -d '{"decisiontable":"test","requesttype":"1","eventdatetime":"2020/01/01
01:01:01","eventinfo":["10001"]}' -H "Authorization: Bearer <Access_Token>"⑦Main
Notification

Title

Check if the
mail withinformationon the rightis sent.

Body【OASE Notification test】[Request Information]
Trace ID
Decision table name
Request user
Request server[Event information]
Event Time/Date
Condition nameMessage ID

This information is used in these parts of this manual<4.1 Send Request via curl command>and<4.2Check the result of Action execution>
Exastro39