Merge pull request #2208 from Esri/jy-update-append-guide

Add links to supporting info for supported formats

guide/04-feature-data-and-analysis/appending-features.ipynb

@@ -13,7 +13,13 @@
    "source": [
     "Any Web GIS Administrator can attest to the fundamental importance of managing hosted feature layers in ArcGIS online. Traditionally, adding data en masse to existing hosted feature layers typically involved a three-step process of downloading the feature layer data, merging additional edits, and finally overwriting the original feature layer.  While that workflow still suffices in many circumstances, the [`append()`](https://developers.arcgis.com/python/api-reference/arcgis.features.toc.html#arcgis.features.FeatureLayer.append) function greatly simplifies the process.  It can save you a ton of time if your features layers are large, eliminating the time involved in overwriting the feature layer. \n",
     "\n",
-    "Let's take a look at some example `append()` workflows below.  This guide document refers to the feature layer you will append data into as the `target`, while the item you append data from is referred to as the `source`."
+    "Let's take a look at some example `append()` workflows below.  This guide document refers to the feature layer you will append data into as the `target`, while the item you append data from is referred to as the `source`.\n",
+    "\n",
+    "> **Note:** Please see the [Append (Feature Service/Layer)](https://developers.arcgis.com/rest/services-reference/enterprise/append-feature-service-layer/) for technical reference details on the append operation.\n",
+    "\n",
+    "> **Note:** When appending features from files, important criteria must be met in order for the append to succeed, and only certain file formats may be supported for a given layer. Please see the documentation for your deployment before attempting to append data:\n",
+    "> * ArcGIS Online: _Manage hosted feature layers_ - [Add and update features from a file](https://doc.arcgis.com/en/arcgis-online/manage-data/manage-hosted-feature-layers.htm#APPEND)\n",
+    "> * ArcGIS Enteprise: _Manage hosted feature layers_ - [Add and update features from a file](https://enterprise.arcgis.com/en/portal/latest/use/manage-hosted-feature-layers.htm#APPEND)"
    ]
   },
   {
@@ -118,7 +124,7 @@
    "source": [
     "## Append New Features from a File Geodatabase\n",
     "\n",
-    "This first example appends new features from a File Geodatabase into a hosted feature layer. For optimal performance and minimal chance of errors when using [`append()`](https://developers.arcgis.com/python/api-reference/arcgis.features.toc.html#arcgis.features.FeatureLayer.append), Esri strongly recommends the schema for the source file to upload (source) matches the schema of the hosted feature service layer (target).  \n",
+    "This first example appends new features from a File Geodatabase into a hosted feature layer. For optimal performance and minimal chance of errors when using [`append()`](https://developers.arcgis.com/python/api-reference/arcgis.features.toc.html#arcgis.features.FeatureLayer.append), Esri strongly recommends the schema for the source file to upload (source) matches the schema of the hosted feature service layer (target).  Please note that appending from a file geodatabase is only supported in ArcGIS Online.\n",
     "\n",
     "In this first section, you'll have matching schema between your File Geodatabase item (named `SubDiv_PB11_PG48_parcels`) and a hosted feature service layer you will publish."
    ]
@@ -414,7 +420,11 @@
    "metadata": {},
    "source": [
     "### Get the source item for appending\n",
-    "In order for the append workflow to succeed, you need to add the source file containing the new features as an Item in your GIS. In this case, the data file is already uploaded as an Item for you. From there, get the item id value for this file geodatabase item containing features you want to append to the feature layer. In this case, the Schema from the file geodatabase you'll append matches that of the hosted feature layer."
+    "In order for the append workflow to succeed, you need to add the source file containing the new features as an Item in your GIS. In this case, the data file is already uploaded as an Item for you. From there, get the item id value for this file geodatabase item containing features you want to append to the feature layer. In this case, the Schema from the file geodatabase you'll append matches that of the hosted feature layer.\n",
+    "\n",
+    "> **Note:** It is important to verify the Feature Layer you use supports the operation you intend to run.  Please query the feature layer for the following properties to confirm:\n",
+    "> * `FeatureLayer.properties.supportsAppend` - see [Supports append](https://developers.arcgis.com/rest/services-reference/enterprise/append-feature-service-layer/#supports-append) for details.\n",
+    "> * `FeatureLayer.properties.supportedAppendFormats` - see [Supported append formats](https://developers.arcgis.com/rest/services-reference/enterprise/append-feature-service-layer/#supported-append-formats) for details."
    ]
   },
   {
@@ -546,7 +556,6 @@
    "source": [
     "m2 = gis.map(\"Downingtown, PA\")\n",
     "m2.center = [40.0065, -75.7033]\n",
-    "m2.zoom = 14\n",
     "m2"
    ]
   },