Merge remote-tracking branch 'upstream/next' into next

Author: mohi9282

guide/01-getting-started/install-and-set-up.ipynb

@@ -15,6 +15,31 @@
     "See below for options to install arcgis and its dependencies:"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Table of Contents\n",
+    "* [Installation for ArcGIS Pro 2.5.x and later](#Installation-for-ArcGIS-Pro-2.5.x-and-later)\n",
+    "    * [Installation using Python Package Manager](#Installation-using-Python-Package-Manager)\n",
+    "    * [Installation using Python Command Prompt](#Installation-using-Python-Command-Prompt)\n",
+    "    * [Upgrade package](#Upgrade-package)\n",
+    "* [Installation using Anaconda for Python Distribution](#Installation-using-Anaconda-for-Python-Distribution)\n",
+    "    * [conda](#Conda)\n",
+    "    * [Pipenv](#Pipenv)\n",
+    "* [Install with minimum dependencies](#Install-with-minimum-dependencies)\n",
+    "* [Installation as a Docker image](#Installation-as-a-Docker-image)\n",
+    "* [Install Offline](#Install-Offline)\n",
+    "    * [1. While in a connected environment, download the appropriate software you'll need:](#1.-While-in-a-connected-environment,-download-the-appropriate-software-you'll-need:)\n",
+    "    * [2. Configure Anaconda for use in the disconnected enviroment:](2.-Configure-Anaconda-for-use-in-the-disconnected-enviroment:)\n",
+    "    * [3. Verify the install:](#3.-Verify-the-install:)\n",
+    "* [Installation for older versions](#Installation-for-older-versions)\n",
+    "* [Install deep learning dependencies](#Install-deep-learning-dependencies)\n",
+    "    * [Using the Deep Learning Frameworks Installer](#Using-the-Deep-Learning-Frameworks-Installer)\n",
+    "    * [Install using Python Command Prompt or Anaconda](#Install-using-Python-Command-Prompt-or-Anaconda)\n",
+    "* [Test your install with jupyter notebook](#Test-your-install-with-jupyter-notebook)"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -534,7 +559,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.8.2"
+   "version": "3.7.11"
   },
   "toc": {
    "base_numbering": 1,

guide/01-getting-started/install-older-versions.ipynb

@@ -10,6 +10,16 @@
     "See below for options to install both conda and the `arcgis` package:"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "toc": true
+   },
+   "source": [
+    "<h1>Table of Contents<span class=\"tocSkip\"></span></h1>\n",
+    "<div class=\"toc\"><ul class=\"toc-item\"><li><span><a href=\"#Step-1:-Get-Conda\" data-toc-modified-id=\"Step-1:-Get-Conda-1\">Step 1: Get Conda</a></span><ul class=\"toc-item\"><li><span><a href=\"#Get-Conda-with-ArcGIS-Pro\" data-toc-modified-id=\"Get-Conda-with-ArcGIS-Pro-1.1\">Get Conda with ArcGIS Pro</a></span></li><li><span><a href=\"#Get-Conda-with-Anaconda-for-Python-Distribution\" data-toc-modified-id=\"Get-Conda-with-Anaconda-for-Python-Distribution-1.2\">Get Conda with Anaconda for Python Distribution</a></span></li></ul></li><li><span><a href=\"#Step:-2-Install-the-arcgis-package\" data-toc-modified-id=\"Step:-2-Install-the-arcgis-package-2\">Step: 2 Install the <code>arcgis</code> package</a></span><ul class=\"toc-item\"><li><span><a href=\"#Install-using-ArcGIS-Pro-Python-Package-Manager\" data-toc-modified-id=\"Install-using-ArcGIS-Pro-Python-Package-Manager-2.1\">Install using ArcGIS Pro <a href=\"http://pro.arcgis.com/en/pro-app/arcpy/get-started/what-is-conda.htm\" target=\"_blank\">Python Package Manager</a></a></span></li><li><span><a href=\"#Install-using-Python-Command-Prompt\" data-toc-modified-id=\"Install-using-Python-Command-Prompt-2.2\">Install using Python Command Prompt</a></span></li><li><span><a href=\"#Install-using-Anaconda-for-Python-Distribution\" data-toc-modified-id=\"Install-using-Anaconda-for-Python-Distribution-2.3\">Install using Anaconda for Python Distribution</a></span></li><li><span><a href=\"#Install-using-pipenv-or-pip\" data-toc-modified-id=\"Install-using-pipenv-or-pip-2.4\">Install using pipenv or pip</a></span><ul class=\"toc-item\"><li><span><a href=\"#Pipenv\" data-toc-modified-id=\"Pipenv-2.4.1\">Pipenv</a></span></li><li><span><a href=\"#Pip\" data-toc-modified-id=\"Pip-2.4.2\">Pip</a></span></li><li><span><a href=\"#Disclaimer\" data-toc-modified-id=\"Disclaimer-2.4.3\">Disclaimer</a></span></li></ul></li><li><span><a href=\"#Install-with-minimum-dependencies\" data-toc-modified-id=\"Install-with-minimum-dependencies-2.5\">Install with minimum dependencies</a></span></li></ul></li><li><span><a href=\"#Install-deep-learning-dependencies-for-arcgis.learn-module\" data-toc-modified-id=\"Install-deep-learning-dependencies-for-arcgis.learn-module-3\">Install deep learning dependencies for arcgis.learn module</a></span><ul class=\"toc-item\"><li><span><a href=\"#Install-using-the-Python-Command-Prompt-(ArcGIS-Pro-2.5)-or-Anaconda\" data-toc-modified-id=\"Install-using-the-Python-Command-Prompt-(ArcGIS-Pro-2.5)-or-Anaconda-3.1\">Install using the Python Command Prompt (ArcGIS Pro 2.5) or Anaconda</a></span></li><li><span><a href=\"#For-TensorFlow-support-(optional),-use-the-following-command:\" data-toc-modified-id=\"For-TensorFlow-support-(optional),-use-the-following-command:-3.2\">For TensorFlow support (optional), use the following command:</a></span><ul class=\"toc-item\"><li><span><a href=\"#For-Multispectral-data-support-(optional-and-needed-only-for-Anaconda-users)\" data-toc-modified-id=\"For-Multispectral-data-support-(optional-and-needed-only-for-Anaconda-users)-3.2.1\">For Multispectral data support (optional and needed only for Anaconda users)</a></span></li></ul></li></ul></li><li><span><a href=\"#Upgrade-the-arcgis-package\" data-toc-modified-id=\"Upgrade-the-arcgis-package-4\">Upgrade the <code>arcgis</code> package</a></span><ul class=\"toc-item\"><li><ul class=\"toc-item\"><li><span><a href=\"#ArcGIS-Pro-2.2\" data-toc-modified-id=\"ArcGIS-Pro-2.2-4.0.1\">ArcGIS Pro 2.2</a></span></li><li><span><a href=\"#ArcGIS-Pro-2.1\" data-toc-modified-id=\"ArcGIS-Pro-2.1-4.0.2\">ArcGIS Pro 2.1</a></span></li><li><span><a href=\"#ArcGIS-Pro-1.4-and-2.0.x\" data-toc-modified-id=\"ArcGIS-Pro-1.4-and-2.0.x-4.0.3\">ArcGIS Pro 1.4 and 2.0.x</a></span><ul class=\"toc-item\"><li><span><a href=\"#Python-Package-Manager\" data-toc-modified-id=\"Python-Package-Manager-4.0.3.1\">Python Package Manager</a></span></li><li><span><a href=\"#Terminal-Window-or-Python-Command-Prompt\" data-toc-modified-id=\"Terminal-Window-or-Python-Command-Prompt-4.0.3.2\">Terminal Window or <strong>Python Command Prompt</strong></a></span></li></ul></li><li><span><a href=\"#ArcGIS-Pro-1.3\" data-toc-modified-id=\"ArcGIS-Pro-1.3-4.0.4\">ArcGIS Pro 1.3</a></span></li></ul></li></ul></li><li><span><a href=\"#Using-the-API\" data-toc-modified-id=\"Using-the-API-5\">Using the API</a></span><ul class=\"toc-item\"><li><ul class=\"toc-item\"><li><span><a href=\"#Start-the-Jupyter-notebook-installed-with-the-API:\" data-toc-modified-id=\"Start-the-Jupyter-notebook-installed-with-the-API:-5.0.1\">Start the <a href=\"http://jupyter.org/\" target=\"_blank\">Jupyter notebook</a> installed with the API:</a></span></li></ul></li></ul></li><li><span><a href=\"#Test-your-install-with-jupyter-notebook\" data-toc-modified-id=\"Test-your-install-with-jupyter-notebook-6\">Test your install with jupyter notebook</a></span></li><li><span><a href=\"#Install-as-a-Docker-image\" data-toc-modified-id=\"Install-as-a-Docker-image-7\">Install as a Docker image</a></span></li><li><span><a href=\"#Install-Offline\" data-toc-modified-id=\"Install-Offline-8\">Install-Offline</a></span><ul class=\"toc-item\"><li><ul class=\"toc-item\"><li><ul class=\"toc-item\"><li><span><a href=\"#1.-While-in-a-connected-environment,-download-the-appropriate-software-you'll-need:\" data-toc-modified-id=\"1.-While-in-a-connected-environment,-download-the-appropriate-software-you'll-need:-8.0.0.1\">1. While in a connected environment, download the appropriate software you'll need:</a></span></li><li><span><a href=\"#2.-Configure-Anaconda-for-use-in-the-disconnected-enviroment:\" data-toc-modified-id=\"2.-Configure-Anaconda-for-use-in-the-disconnected-enviroment:-8.0.0.2\">2. Configure Anaconda for use in the disconnected enviroment:</a></span></li><li><span><a href=\"#3.-Verify-the-install:\" data-toc-modified-id=\"3.-Verify-the-install:-8.0.0.3\">3. Verify the install:</a></span></li></ul></li></ul></li></ul></li></ul></div>"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},

guide/01-getting-started/system-requirements.ipynb

@@ -37,6 +37,15 @@
     "* [beautifulsoup](https://www.crummy.com/software/BeautifulSoup/) - used when authenticating with OAuth2.\n",
     "* [dill](https://pypi.org/project/dill/#description) - used when creating a Python toolbox from a method."
    ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "collapsed": true
+   },
+   "outputs": [],
+   "source": []
   }
  ],
  "metadata": {
@@ -55,20 +64,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.8.2"
-  },
-  "toc": {
-   "base_numbering": 1,
-   "nav_menu": {},
-   "number_sections": true,
-   "sideBar": true,
-   "skip_h1_title": false,
-   "title_cell": "Table of Contents",
-   "title_sidebar": "Contents",
-   "toc_cell": false,
-   "toc_position": {},
-   "toc_section_display": true,
-   "toc_window_display": false
+   "version": "3.6.5"
   }
  },
  "nbformat": 4,

guide/01-getting-started/using-the-jupyter-lab-environment.ipynb

@@ -18,6 +18,16 @@
     "JupyterLab builds upon all of the major components of the classic Jupyter Notebook experience (notebooks, terminal, text editor, file browser, ipywidgets, etc.) to create a flexible and powerful user experience. Click [here](https://blog.jupyter.org/jupyterlab-is-ready-for-users-5a6f039b8906) or [here](https://github.com/jupyterlab/jupyterlab) to read more about JupyterLab."
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "toc": true
+   },
+   "source": [
+    "<h1>Table of Contents<span class=\"tocSkip\"></span></h1>\n",
+    "<div class=\"toc\"><ul class=\"toc-item\"><li><span><a href=\"#Getting-Started\" data-toc-modified-id=\"Getting-Started-1\">Getting Started</a></span><ul class=\"toc-item\"><li><span><a href=\"#Installation\" data-toc-modified-id=\"Installation-1.1\">Installation</a></span><ul class=\"toc-item\"></ul></li></ul></li><li><span><a href=\"#File-Explorer\" data-toc-modified-id=\"File-Explorer-2\">File Explorer</a></span></li><li><span><a href=\"#Using-Windows-and-Tabs\" data-toc-modified-id=\"Using-Windows-and-Tabs-3\">Using Windows and Tabs</a></span></li><li><span><a href=\"#Using-Cell-Utilities\" data-toc-modified-id=\"Using-Cell-Utilities-4\">Using Cell Utilities</a></span></li><li><span><a href=\"#Integration-with-the-Map-Widget\" data-toc-modified-id=\"Integration-with-the-Map-Widget-5\">Integration with the Map Widget</a></span><ul class=\"toc-item\"><li><span><a href=\"#WebMaps-and-WebScenes\" data-toc-modified-id=\"WebMaps-and-WebScenes-5.1\">WebMaps and WebScenes</a></span></li><li><span><a href=\"#Controlling-New-Windows-Programatically\" data-toc-modified-id=\"Controlling-New-Windows-Programatically-5.2\">Controlling New Windows Programatically</a></span></li></ul></li></ul></div>"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -467,7 +477,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.8.2"
+   "version": "3.6.10"
   },
   "toc": {
    "base_numbering": 1,

guide/03-the-gis/accessing-and-creating-content.ipynb

@@ -6,7 +6,22 @@
    "source": [
     "# Accessing and creating content\n",
     "\n",
-    "Your GIS can host a [variety of maps, web layers, analytical tools, apps](http://doc.arcgis.com/en/arcgis-online/reference/geo-info.htm) and [individual files](http://doc.arcgis.com/en/arcgis-online/share-maps/supported-items.htm). Using the `gis` module, you can search for, access and manage all your folders, contents and automate such maintenance workflows as scripts."
+    "Your GIS can host a [variety of maps, web layers, analytical tools, apps](http://doc.arcgis.com/en/arcgis-online/reference/geo-info.htm) and [individual files](http://doc.arcgis.com/en/arcgis-online/share-maps/supported-items.htm). Using the `gis` module, you can search for, access and manage all your folders, contents and automate such maintenance workflows as scripts.\n",
+    "\n",
+    "In this page, we are going to observe how the following can be accomplished:\n",
+    " * [Import libraries](#Import-libraries)\n",
+    " * [About search](#About-search)\n",
+    "  * [Search tip](#Search-Tip)\n",
+    " * [Searching for content](#searching-for-content)\n",
+    "  * [Wild card search](#wild-card-search)\n",
+    "  * [Searching for content outside your portal](#Searching-for-content-outside-your-portal)\n",
+    "  * [Searching for content in ArcGIS Online](#Searching-for-content-in-ArcGIS-Online)\n",
+    " * [Creating new content](#Creating-new-content)\n",
+    "  * [Publishing an item as a web layer](#Publishing-an-item-as-a-web-layer)\n",
+    "  * [Importing data from a pandas dataframe](#Importing-data-from-a-pandas-data-frame)\n",
+    "  * [Publishing an empty service](#Publishing-an-empty-service)\n",
+    " * [Organizing content](#Organizing-content)\n",
+    "  * [Using folders to organize your content](#Using-folders-to-organize-your-content)"
    ]
   },
   {
@@ -2374,20 +2389,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.8.2"
-  },
-  "toc": {
-   "base_numbering": 1,
-   "nav_menu": {},
-   "number_sections": true,
-   "sideBar": true,
-   "skip_h1_title": false,
-   "title_cell": "Table of Contents",
-   "title_sidebar": "Contents",
-   "toc_cell": false,
-   "toc_position": {},
-   "toc_section_display": true,
-   "toc_window_display": false
+   "version": "3.6.8"
   }
  },
  "nbformat": 4,

guide/03-the-gis/accessing-and-managing-groups.ipynb

@@ -12,6 +12,16 @@
     "In this guide, we will observe:"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "toc": true
+   },
+   "source": [
+    "<h1>Table of Contents<span class=\"tocSkip\"></span></h1>\n",
+    "<div class=\"toc\"><ul class=\"toc-item\"><li><span><a href=\"#Searching-for-groups\" data-toc-modified-id=\"Searching-for-groups-1\">Searching for groups</a></span></li><li><span><a href=\"#Properties-of-a-group\" data-toc-modified-id=\"Properties-of-a-group-2\">Properties of a group</a></span></li><li><span><a href=\"#Creating-new-groups\" data-toc-modified-id=\"Creating-new-groups-3\">Creating new groups</a></span><ul class=\"toc-item\"><li><span><a href=\"#Sharing-content-to-groups\" data-toc-modified-id=\"Sharing-content-to-groups-3.1\">Sharing content to groups</a></span></li></ul></li><li><span><a href=\"#Managing-your-groups\" data-toc-modified-id=\"Managing-your-groups-4\">Managing your groups</a></span><ul class=\"toc-item\"><li><span><a href=\"#Listing-contents-of-the-group\" data-toc-modified-id=\"Listing-contents-of-the-group-4.1\">Listing contents of the group</a></span></li><li><span><a href=\"#Adding-users-to-the-group\" data-toc-modified-id=\"Adding-users-to-the-group-4.2\">Adding users to the group</a></span></li><li><span><a href=\"#Removing-users-from-a-group\" data-toc-modified-id=\"Removing-users-from-a-group-4.3\">Removing users from a group</a></span></li><li><span><a href=\"#Listing-users-belonging-to-a-group\" data-toc-modified-id=\"Listing-users-belonging-to-a-group-4.4\">Listing users belonging to a group</a></span></li><li><span><a href=\"#Updating-a-group\" data-toc-modified-id=\"Updating-a-group-4.5\">Updating a group</a></span></li><li><span><a href=\"#Terminating-a-group\" data-toc-modified-id=\"Terminating-a-group-4.6\">Terminating a group</a></span></li></ul></li></ul></div>"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -655,7 +665,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.8.2"
+   "version": "3.6.6"
   },
   "toc": {
    "base_numbering": 1,

guide/03-the-gis/accessing-and-managing-users.ipynb

@@ -5,7 +5,20 @@
    "metadata": {},
    "source": [
     "# Accessing and managing users\n",
-    "Users are an indispensible part of your web GIS. As the number of users grow, you can see value in automating your management tasks such as provisioning licenses, privileges, creating and removing user accounts etc. The `gis` module provides you with `User` and `UserManager` classes to respresent users as objects and help you accomplish the most common tasks.\n",
+    "Users are an indispensible part of your web GIS. As the number of users grow, you can see value in automating your management tasks such as provisioning licenses, privileges, creating and removing user accounts etc. The `gis` module provides you with `User` and `UserManager` classes to respresent users as objects and help you accomplish the most common tasks. In this guide, we will learn about:\n",
+    "\n",
+    " * [About your account](#about-your-account)\n",
+    " * [Properties of a `User` object](#properties-of-a-user-object)\n",
+    " * [Searching for user accounts](#searching-for-user-accounts)\n",
+    " * [Creating new user accounts](#creating-new-user-accounts)\n",
+    "  * [About user roles](#about-user-roles)\n",
+    "  * [Managing user roles](#managing-user-roles)\n",
+    "    * [Creating new roles](#creating-new-roles)\n",
+    "    * [Creating a user with a custom role](#creating-a-user-with-a-custom-role)\n",
+    "    * [Listing all the custom roles in an org](#listing-all-the-custom-roles-in-an-org)\n",
+    " * [Deleting user accounts](#deleting-user-accounts)\n",
+    "  * [Accessing user content](#accessing-user-content)\n",
+    "  * [Reassigning user content](#reassigning-user-content)\n",
     "\n",
     "As you might have seen the pattern with `ContentManager` and `Item` objects, the `UserManager` object is a resource manager that gives you access to `User` objects. You access a `UserManager` object not by instantiating that class through its constructor, but by accessing the `users` property of your `GIS` object. This is the typical pattern of usage throughout the `gis` module."
    ]
@@ -1235,20 +1248,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.8.2"
-  },
-  "toc": {
-   "base_numbering": 1,
-   "nav_menu": {},
-   "number_sections": true,
-   "sideBar": true,
-   "skip_h1_title": false,
-   "title_cell": "Table of Contents",
-   "title_sidebar": "Contents",
-   "toc_cell": false,
-   "toc_position": {},
-   "toc_section_display": true,
-   "toc_window_display": false
+   "version": "3.7.6"
   }
  },
  "nbformat": 4,