Merge pull request #2156 from Esri/jy-rvw-ogc

Update text description for adding an item with Folder.add

Author: jyaistMap

samples/05_content_publishers/publish_ogc_services.ipynb

@@ -218,6 +218,13 @@
     "print(webmap_item.title)"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The ``get_data`` method retrieves the data associated with the Web Map item, and we can see it contains `operationalLayers` and `baseMap`."
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": 39,
@@ -436,15 +443,15 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "The ``get_data`` method retrieves the data associated with the WebMap item, and we can see it contains `operationalLayers` and `baseMap`."
+    "We'll delete this web map since it's for illustration:"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 42,
+   "execution_count": null,
    "metadata": {},
    "outputs": [
-    {
+       {
      "data": {
       "text/plain": [
        "True"
@@ -647,22 +654,27 @@
     "Compared to the response of `get_data` retrieved from a WMTS Layer, we can see that that of a WMTS service serves as a subset to the former."
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We'll delete this:"
+   ]
+  },
   {
    "cell_type": "code",
-   "execution_count": 8,
+   "execution_count": null,
    "metadata": {},
-   "outputs": [
-    {
+   "outputs": [{
      "data": {
       "text/plain": [
        "True"
       ]
      },
-     "execution_count": 8,
+     "execution_count": 43,
      "metadata": {},
      "output_type": "execute_result"
-    }
-   ],
+    }],
    "source": [
     "item.delete(permanent=True)"
    ]
@@ -955,7 +967,7 @@
    "source": [
     "### WFS Service\n",
     "\n",
-    "For example, the `West Virginia Geological and Economic Survey (WVGES)`, which investigates and reports on West Virginia's geology and disseminates information, provides `WFS` endpoints at [WFS GetCapabilities](https://atlas2.wvgs.wvnet.edu/server/services/Hosted/Reference_Quadrangles/MapServer/WFSServer?request=GetCapabilities&service=WFS). With the WFS data support, we can see a simple example below that query the `Reference Boundaries for the State of West Virginia: 3.75' Quarter Quadrangles, 7.5' Quadrangles, 15' Quadrangles, 100k Quadrangles, 250k Quadrangles` layer to create WFS service, and add to a WebMap item:"
+    "For example, the `West Virginia Geological and Economic Survey (WVGES)`, which investigates and reports on West Virginia's geology and disseminates information, provides `WFS` endpoints at [WFS GetCapabilities](https://atlas2.wvgs.wvnet.edu/server/services/Hosted/Reference_Quadrangles/MapServer/WFSServer?request=GetCapabilities&service=WFS). With the WFS data support, we can see a simple example below that queries the `Reference Boundaries for the State of West Virginia: 3.75' Quarter Quadrangles, 7.5' Quadrangles, 15' Quadrangles, 100k Quadrangles, 250k Quadrangles` layer to create a WFS service, and then add it to a Web Map item:"
    ]
   },
   {
@@ -1094,8 +1106,8 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Then, use the `add(item_properties, data=None, thumbnail=None, metadata=None, owner=None, folder=None, item_id=None, **kwargs)` method defined in `arcgis.gis` module to add content to the GIS by creating an `WFS` service, with parameters set as:\n",
-    " - item_properties: Required dictionary. See [table](https://developers.arcgis.com/python/api-reference/arcgis.gis.toc.html#arcgis.gis.ContentManager.add) for the keys and values."
+    "Then, use the [`add()`](/python/latest/api-reference/arcgis.gis.toc.html#arcgis.gis._impl._content_manager.Folder.add) method on a [_Folder_](/python/latest/api-reference/arcgis.gis.toc.html#folder) object to add content to the GIS by creating an `WFS` service. The _item_properties_ argument can be an [ItemProperties](/python/api-reference/arcgis.gis.toc.html#arcgis.gis._impl._dataclasses.ItemProperties) object or a dictionary you create. \n",
+    "See the [Items and item types](/rest/users-groups-and-items/items-and-item-types/) rest documentation for detailed description on various items, and the [addItem](/rest/users-groups-and-items/add-item/#request-parameters) documentation for detailed descriptions of the properties."
    ]
   },
   {
@@ -1154,26 +1166,6 @@
     "wfs_item.get_data()['layerType']"
    ]
   },
-  {
-   "cell_type": "code",
-   "execution_count": 16,
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "True"
-      ]
-     },
-     "execution_count": 16,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "wfs_item.delete(permanent=True)"
-   ]
-  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -1266,26 +1258,6 @@
     "Image(printed_file_url)"
    ]
   },
-  {
-   "cell_type": "code",
-   "execution_count": 42,
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "True"
-      ]
-     },
-     "execution_count": 42,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "wfs_item.delete(permanent=True)"
-   ]
-  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -1314,9 +1286,9 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.7.11"
+   "version": "3.11.10"
   }
  },
  "nbformat": 4,
- "nbformat_minor": 2
+ "nbformat_minor": 4
 }