Get an Event Tool by ID
get
/api/event/Tools/{id}
Gets the event tool that matches the specified ID.
Request
Path Parameters
-
id(required): integer(int32)
The event tool ID.Example:
1
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : schema
Match All
Show Source
-
object
SuccessfulGetOperation
The response body for a successful get operation.
-
object
type
Nested Schema : SuccessfulGetOperation
Type:
object
The response body for a successful get operation.
Show Source
-
message: string
The response message.Example:
Loaded 1 entries
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
true
Nested Schema : type
Type:
Show Source
object
-
data: array
data
-
total: integer
The total number of results regardless of paging.Example:
1
Nested Schema : eventToolsRead
Type:
Show Source
object
-
AugmentData: boolean
Whether to obtain event data for the selected event (1) or not (0) to be used in the tool's request parameters. Only used for view tools.Example:
1
-
Height: integer
The height of the tool window, in pixels. Only used for view tools.Example:
80
-
Icon: string
The icon to represent the tool.Example:
fugue/thumb-up.png
-
JournalAction: string
The action that will be used when adding an event journal when the event tool is run. If not specified, defaults to the name of the event tool.Example:
Added by Event Tool
-
JournalActor: string
The actor that will be used when adding an event journal when the event tool is run. If not specified, defaults to the user who ran the tool.Example:
operator
-
JournalStatus: integer
The integer indication of whether an event journal entry will be added when tool is run (1) or not (0).Example:
1
-
JournalStatusIcon: string
The icon to indicate the journal status.Example:
OrbGreen.png
-
JournalStatusName: string
The text indication of whether a journal entry is added when the tool is run (Enabled) or not (Disabled).Example:
Enabled
-
JournalText: string
The event journal entry that will be added when the tool is run.Example:
Event Acknowledged
-
Refresh: integer
Whether the event list should be unpaused and refreshed when the tool finishes (1) or not (0). Only used for view tools. When ToolTarget is set to newtab, the list refreshes when the tab opens.
When ToolTarget is set to window, the list refreshes when the pop-up window is closed.
When ToolTarget is set to currenttab, this setting does not apply.Example:1
-
ToolID: integer
The event tool ID.Example:
1
-
ToolName: string
The event tool name.Example:
Acknowledge
-
ToolPath: string
The relative path to the URL that the tool opens. Only used for view tools.Example:
/go/vision/index?filterText=<Details>
-
ToolPathType: string
The tool path type. Only used for view tools.
Allowed values are:- Local
- Internal
- Hybrid
- Remote
Example:Remote
-
ToolPathTypeID: string
The tool path type ID. Only used for view tools.
Allowed values:- 1: Local
- 2: Internal
- 3: Hybrid
- 4: Remote
Example:oracle.doceng.json.BetterJsonNull@402adc9c
-
ToolSQL: string
The SQL command to run against the Event.Events schema table. Only used for SQL tools.Example:
UPDATE Events SET Action = 'SQL Tool: Acknowledge', Actor = $USERNAME, LastChanged = UNIX_TIMESTAMP(NOW(3)), Ack = 1, OwnerName = $USERNAME WHERE Ack = 0 AND EventID IN ($EVENTLIST);
-
ToolTarget: string
Where the tool opens new pages. Only used for view tools.
Allowed values:- window: Opens in a pop-up window.
- currenttab: Opens in the current tab.
- newtab: Opens in a new tab.
Example:window
-
ToolTargetDisplay: string
The display name to use for the ToolTarget setting. Only used for view tools.
Allowed Values:- PopUp
- CurrentTab
- NewTab
Example:PopUp
-
ToolTypeID: integer
The ID of the event tool type. Allowed values:
- 1: View
- 2: SQL
Example:1
-
ToolTypeName: string
The name of the event tool type. Allowed values:
- View
- SQL
Example:View
-
Width: integer
The width of the tool window, in pixels. Only used for view tools.Example:
80
Default Response
Failed operation
Root Schema : schema
Type:
Show Source
object
-
errors: array
errors
The list of errors reported. Validation errors will be keyed by record field.
-
message: string
The response message.Example:
Exception thrown
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
false
Nested Schema : errors
Type:
array
The list of errors reported. Validation errors will be keyed by record field.
Show Source
-
Array of:
object items
An error.
Nested Schema : items
Type:
object
An error.