A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://developers.arcgis.com/rest/enterprise-administration/notebook/execute-notebook/ below:

Website Navigation


Execute Notebook | ArcGIS REST APIs

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.

Note

To run this operation, you must be signed in with an ArcGIS Enterprise portal account. You cannot execute notebooks from the ArcGIS Notebook Server primary site administrator account.

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.

Tip

To add a tag to a notebook cell, click View > Cell Toolbar > Tags on the notebook editor menu ribbon, select a cell, type the tag's value, and click Add tag.

Request parameters Parameter Details

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 blocks Copy

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 blocks Copy

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 Property Details

status

Indicates whether the operation succeeded in executing the notebook.

Example usage

Use dark colors for code blocks Copy

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
https://notebookserver.example.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 blocks Copy

1
2
3
4
5
{
  "jobId": "j3a581ce0-cf2f-4190-96a5-c5bc0617dd5d",
  "jobUrl": "https://notebookserver.example.com/<context>/admin/system/jobs/j3a581ce0-cf2f-4190-96a5-c5bc0617dd5d",
  "status": "success"
}

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4