Jump to

• Request
• Response
• Examples

Execute a Watchlist v2

post

/v2/watchlist

Execute the specified Watchlist. The response includes record count as well as Watchlist definition metadata.

Request

Supported Media Types

• application/json

Header Parameters

• jde-AIS-Auth: string
  Token
• jde-AIS-Auth-Device: string
  Device Name
• jde-AIS-MonitorOnStart: boolean
  Monitor on Start
• jde-AIS-MonitorRequest: string
  Monitor Request

  Allowed Values: [ "monitorRequest", "monitorRequestIO" ]

Body ()

The input to the Watchlist service.

Root Schema : WatchListRequest

Type: object

The input to the Watchlist service.

Show Source

• deviceName: string
  An identifier for the device making the service call. If not provided, the requesting IP address is used.
• environment: string
  Specify the environment to use for login. If not specified, the default environment configured for the AIS Server will be used.
• forceUpdate: boolean
  Force the Watchlist to re-run fetching the data from the database instead of cache.
• jasserver: string
  The HTML (JAS) Server to use for login. If not specified, the default HTML Server configured for the AIS Server will be used.
• password: string
  The JD Edwards EnterpriseOne password, which is required if other authentication methods are not being used.
• psToken: string
  Used for logging in with psToken. Primarily used by the HTML Server to establish a session with the AIS Server.
• role: string
  The role to use for login. If not specified, the default role configured for the AIS Server will be used.
• setDirtyOnly: boolean
  Indicate that the Watchlist is dirty (but do not re-run it), so data will be fetched from the database not the cache next time.
• token: string
  The AIS token, which is required if other authentication methods are not being used.
• username: string
  JD Edwards EnterpriseOne username, which is required if other authentication methods are not being used.
• watchlistId: string
  The id of the Watchlist to execute. Either the Watchlist id or object name is required.
• watchlistObjectName: string
  The Object Management Workbench (OMW) object name of the watchlist. Either this name or the id is required.

{
    "type":"object",
    "properties":{
        "environment":{
            "type":"string",
            "description":"Specify the environment to use for login. If not specified, the default environment configured for the AIS Server will be used."
        },
        "role":{
            "type":"string",
            "description":"The role to use for login. If not specified, the default role configured for the AIS Server will be used."
        },
        "jasserver":{
            "type":"string",
            "description":"The HTML (JAS) Server to use for login. If not specified, the default HTML Server configured for the AIS Server will be used."
        },
        "token":{
            "type":"string",
            "description":"The AIS token, which is required if other authentication methods are not being used."
        },
        "deviceName":{
            "type":"string",
            "description":"An identifier for the device making the service call. If not provided, the requesting IP address is used."
        },
        "psToken":{
            "type":"string",
            "description":"Used for logging in with psToken. Primarily used by the HTML Server to establish a session with the AIS Server."
        },
        "username":{
            "type":"string",
            "description":"JD Edwards EnterpriseOne username, which is required if other authentication methods are not being used."
        },
        "password":{
            "type":"string",
            "description":"The JD Edwards EnterpriseOne password, which is required if other authentication methods are not being used."
        },
        "watchlistId":{
            "type":"string",
            "description":"The id of the Watchlist to execute. Either the Watchlist id or object name is required."
        },
        "forceUpdate":{
            "type":"boolean",
            "description":"Force the Watchlist to re-run fetching the data from the database instead of cache."
        },
        "watchlistObjectName":{
            "type":"string",
            "description":"The Object Management Workbench (OMW) object name of the watchlist. Either this name or the id is required."
        },
        "setDirtyOnly":{
            "type":"boolean",
            "description":"Indicate that the Watchlist is dirty (but do not re-run it), so data will be fetched from the database not the cache next time."
        }
    },
    "description":"The input to the Watchlist service."
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful Execution

400 Response

Bad Request - Invalid JSON Input

403 Response

Authorization Failure

415 Response

Invalid Content-Type Header - Must use application/json

444 Response

Invalid Token

Body ()

Root Schema : ServiceErrorResponse

Type: object

Error Response

Show Source

• errorText: string
• exception: string
  The class of the exception if an exception was thrown.
• exceptionId: string
  ExceptionId, only if an exception record was written to the F980060
• message: string
  Details about the error.
• status: string
  Allowed Values: [ "ERROR", "WARNING" ]

  Status determined by exception handling
• timeStamp: string
  The timestamp indicating the time the error message was returned.
• type: string
  Optional type of error
• userDefinedErrorText: string
  Optional error text added to an orchestration step.

{
    "type":"object",
    "properties":{
        "message":{
            "type":"string",
            "description":"Details about the error."
        },
        "exception":{
            "type":"string",
            "description":"The class of the exception if an exception was thrown."
        },
        "timeStamp":{
            "type":"string",
            "description":"The timestamp indicating the time the error message was returned."
        },
        "userDefinedErrorText":{
            "type":"string",
            "description":"Optional error text added to an orchestration step."
        },
        "type":{
            "type":"string",
            "description":"Optional type of error"
        },
        "errorText":{
            "type":"string"
        },
        "exceptionId":{
            "type":"string",
            "description":"ExceptionId, only if an exception record was written to the F980060"
        },
        "status":{
            "type":"string",
            "description":"Status determined by exception handling",
            "enum":[
                "ERROR",
                "WARNING"
            ]
        }
    },
    "description":"Error Response"
}

500 Response

Server Failed to Process Request

Body ()

Root Schema : ServiceErrorResponse

Type: object

Error Response

Show Source

• errorText: string
• exception: string
  The class of the exception if an exception was thrown.
• exceptionId: string
  ExceptionId, only if an exception record was written to the F980060
• message: string
  Details about the error.
• status: string
  Allowed Values: [ "ERROR", "WARNING" ]

  Status determined by exception handling
• timeStamp: string
  The timestamp indicating the time the error message was returned.
• type: string
  Optional type of error
• userDefinedErrorText: string
  Optional error text added to an orchestration step.

{
    "type":"object",
    "properties":{
        "message":{
            "type":"string",
            "description":"Details about the error."
        },
        "exception":{
            "type":"string",
            "description":"The class of the exception if an exception was thrown."
        },
        "timeStamp":{
            "type":"string",
            "description":"The timestamp indicating the time the error message was returned."
        },
        "userDefinedErrorText":{
            "type":"string",
            "description":"Optional error text added to an orchestration step."
        },
        "type":{
            "type":"string",
            "description":"Optional type of error"
        },
        "errorText":{
            "type":"string"
        },
        "exceptionId":{
            "type":"string",
            "description":"ExceptionId, only if an exception record was written to the F980060"
        },
        "status":{
            "type":"string",
            "description":"Status determined by exception handling",
            "enum":[
                "ERROR",
                "WARNING"
            ]
        }
    },
    "description":"Error Response"
}

Back to Top

Examples

Example Request

The following shows an example of a Watchlist request. The token passed in this example was received from a separate token request.

curl -i -X POST -H "Content-Type:application/json" http://ais_server_url/jderest/watchlist/ -d
{   
    "token": "044QF2SLgaM6vZX081eq8KsVi6XcJiiFL5un5ACH+eBGUg=MDE5MDEyMTY4NzY4NjcwMjI2NzExNzcyNDEwLjE1OS45OS43MzE0NzkxNDU4NDM4ODU=",
    "watchlistObjectName":"OVW0801A_1606210001CUST"

}

        

Example Response

The following example shows the contents of the response body.

Threshold Type is only returned in releases where that field is supported.

{
   "watchListOBNM": "P01012",
   "name": "Ab All in Name",
   "formtitle": "Work With Addresses",
   "queryname": "All",
   "rowcount":    {
      "records": 10,
      "modifier": false,
      "gridrows": 11
   },
   "lastRunTime": 1479146149105,
   "description": "Has All in Name",
   "warningThreshold": 3,
   "criticalThreshold": 10,
   "queryObjectName": "QRY01012B_1602160001CUST",
   "maxRecords": 200,
   "formOID": "P01012_W01012B_ZJDE0001",
   "isCritical": true,
   "thresholdType": "ASC"
}
        

Back to Top