Execute Notebook

URL:
https://<notebookserveradmin>/notebooks/executeNotebook
Methods:
POST
Required Capability:
Administrator or Create and Edit
Version Introduced:
10.8

Description

The executeNotebook operation allows administrators and users with Create and Edit ArcGIS Notebooks privileges to automate notebook execution in an ArcGIS Notebook Server site. The notebook specified in the operation is run with all cells in order.

Using this operation and an external scheduling tool, you can schedule the automated execution of a notebook either once or as a regular occurrence. This allows you to automate repeating tasks such as data collection and cleaning, content updates, and portal administration. On Linux machines, use a cron job to schedule the executeNotebook operation; on Windows machines, you can use the Task Scheduler app.

You can specify parameters to be used in the notebook at execution time. If you specify one or more parameters, they are inserted into the notebook as a new cell. This cell is placed at the beginning of the notebook, unless you added the parameters tag to a cell.

Request parameters

ParameterDetails

itemId

The portal item ID of the notebook you want to execute. You can find this value on the Notebook resource in this directory or in the portal as part of the item details page URL. Ensure that the notebook is using a runtime that's compatible with your software version.

Example

Use dark colors for code blocksCopy
1
itemId=70770e46d4be426dbd3adbec5f9124c8

updatePortalItem

Specifies whether the notebook portal item is updated after execution. The default is true . You can specify true when the notebook you're executing contains information that needs to be updated, such as a workflow that collects the most recent version of a dataset. It may not be important to update the portal item if the notebook won't store new information after execution, such as an administrative notebook that sends email reminders to inactive users.

Values: true | false

notebookParameters

Optional parameters in JSON format that will be added to the notebook for this execution. The parameters are inserted as a new cell directly after the cell you tagged as parameters . The following data types are supported for task parameters: string, long, Boolean, date, feature set, and record set.

Example

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
notebookParameters=
{
	"myLongVariable": 100,
	"epochSecondsDate": 1632326711000,
	"myStringVariable": "secret.pwd",
	"myDoubleVariable": 3.14,
	"myBooleanVariable": false,
	"myLinearUnitDictionary": {
		"distance": 345.678,
		"units": "esriMiles"
	},
	"myFeatureSetJSON": {
		"geometryType": "esriGeometryPoint",
		"spatialReference": {
			"wkid": 4326
		},
		"fields": [{
				"name": "Id",
				"type": "esriFieldTypeOID",
				"alias": "Id"
			},
			{
				"name": "Name",
				"type": "esriFieldTypeString",
				"alias": "Name"
			}
		],
		"features": [{
				"geometry": {
					"x": -104.44,
					"y": 34.83
				},
				"attributes": {
					"Id": 43,
					"Name": "Feature 1"
				}
			},
			{
				"geometry": {
					"x": -100.65,
					"y": 33.69
				},
				"attributes": {
					"Id": 67,
					"Name": "Feature 2"
				}
			}
		]
	}
}

saveInjectedParameters

Specifies whether the notebookParameters cell is saved in the notebook for future use. The default is false .

Values: true | false

f

The response format. The default response format is html .

Values: html | json | pjson

Response properties

PropertyDetails

status

Indicates whether the operation succeeded in executing the notebook.

Example usage

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
https://gisserver.domain.com:11443/arcgis/admin/notebooks/executeNotebook
itemId=70770e46d4be426dbd3adbec5f9124c8
updatePortalItem=true
notebookParameters={
  "name": "somename",
  "population": 19927500,
  "pop_percent": 11.94,
  "lowest_elevation_ft": -220,
  "highest_elevation": 12486,
  "top5cities": ["City 1", "City 2", "City 3", "City 4", "City 5"],
  "top5Values": [ 100, 98.2, 93.3, 89, 74],
  "isTrue": false,
  "value": null,
 "access": { "allowed": true}
}
saveInjectedParameters=false

JSON Response example

Use dark colors for code blocksCopy
1
2
3
4
5
{
  "jobId": "j3a581ce0-cf2f-4190-96a5-c5bc0617dd5d",
  "jobUrl": "https://mydomain.example.com/notebookserver/admin/system/jobs/j3a581ce0-cf2f-4190-96a5-c5bc0617dd5d",
  "status": "success"
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.