Add branch versioning draft (#2309)

* Add branch versioning draft

* Fix wording in differences

* remove identifying info

* Add title and description

* Add title and description saved

* Remove private object call

* Use correct import

Author: kgalliher

guide/04-feature-data-and-analysis/part2_branch_versioning_with_parcel_fabrics.ipynb

@@ -51,87 +51,69 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 3,
+   "execution_count": 1,
    "id": "3b5328c1",
    "metadata": {},
    "outputs": [],
    "source": [
     "from arcgis import GIS\n",
-    "from arcgis.features import _version"
+    "from arcgis.features import FeatureLayerCollection"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
+   "execution_count": 7,
    "id": "abdf9cc2",
    "metadata": {},
-   "outputs": [
-    {
-     "name": "stderr",
-     "output_type": "stream",
-     "text": [
-      "Setting `verify_cert` to False is a security risk, use at your own risk.\n"
-     ]
-    }
-   ],
+   "outputs": [],
    "source": [
     "base_server_url = (\n",
-    "    \"https://rextapilnx02eb.mysite.com/server/rest/services/WashingtonCounty/\"\n",
+    "    \"https://example.server.com/server/rest/services/WashingtonCountyLSA/\"\n",
     ")\n",
     "gis = GIS(\n",
-    "    \"https://myenterprisesite.com/portal/\",\n",
-    "    \"my_user_name\",\n",
-    "    \"my_secure_password\",\n",
-    "    verify_cert=False,\n",
+    "    \"https://example.server.com/portal/\",\n",
+    "    \"admin\",\n",
+    "    \"esri.agp\",\n",
     ")"
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "522387ea",
+   "id": "903d406b-e96b-4f8f-92f9-064930d5cd70",
    "metadata": {},
    "source": [
-    "### Access branch versions via Version Management Server"
+    "### Access the Version Management Server through the Parcel Fabric `FeatureLayerCollection` object\n",
+    "\n",
+    "The `versions` property in a parcel fabric `FeatureLayerCollection` (FLC) creates a `VersionManager` object to create, update and use versions.  \n",
+    "\n",
+    "The `FeatureServer` endpoint is used to create a `FeatureLayerCollection`."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 11,
-   "id": "bf7b899c",
+   "execution_count": 10,
+   "id": "db6cc7e3-76de-4fdf-bbb2-006159e7df1c",
    "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "{\n",
-       "  \"name\": \"Version Management Server\",\n",
-       "  \"type\": \"Map Server Extension\",\n",
-       "  \"defaultVersionName\": \"sde.DEFAULT\",\n",
-       "  \"defaultVersionGuid\": \"{BD3F4817-9A00-41AC-B0CC-58F78DBAE0A1}\",\n",
-       "  \"capabilities\": {\n",
-       "    \"supportsConflictDetectionByAttribute\": true,\n",
-       "    \"supportsPartialPost\": true,\n",
-       "    \"supportsDifferencesFromMoment\": true,\n",
-       "    \"supportsDifferencesWithLayers\": true,\n",
-       "    \"supportsAsyncReconcile\": true,\n",
-       "    \"supportsAsyncPost\": true,\n",
-       "    \"supportsAsyncDifferences\": true,\n",
-       "    \"supportsOutSR\": true\n",
-       "  }\n",
-       "}"
+       "< VersionManager @ https://example.server.com/server/rest/services/WashingtonCountyLSA/VersionManagementServer >"
       ]
      },
-     "execution_count": 11,
+     "execution_count": 10,
      "metadata": {},
      "output_type": "execute_result"
     }
    ],
    "source": [
-    "from arcgis.features._version import VersionManager\n",
+    "from arcgis.features.layer import FeatureLayerCollection\n",
+    "\n",
+    "parcel_fabric_feature_server_url = f\"{base_server_url}/FeatureServer\"\n",
+    "parcel_fabric_flc = FeatureLayerCollection(parcel_fabric_feature_server_url, gis)\n",
     "\n",
-    "version_management_server_url = f\"{base_server_url}/VersionManagementServer\"\n",
-    "vms = VersionManager(version_management_server_url, gis)\n",
-    "vms.properties"
+    "vms = parcel_fabric_flc.versions\n",
+    "vms"
    ]
   },
   {
@@ -144,18 +126,19 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 12,
+   "execution_count": 11,
    "id": "31fcaff3",
    "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
        "[<Version sde.DEFAULT @ {BD3F4817-9A00-41AC-B0CC-58F78DBAE0A1}>,\n",
-       " <Version mycreator.merge_version_1 @ {D1FDA18B-7B15-4773-9D7D-814092D88171}>]"
+       " <Version user.Editor1 @ {7FC9DF13-6E04-46D2-A1A4-19410463B696}>,\n",
+       " <Version user.QA_Editor @ {3860EB29-81C8-4B50-BBE3-9C8DA823B307}>]"
       ]
      },
-     "execution_count": 12,
+     "execution_count": 11,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -219,46 +202,6 @@
     "version # view the version's properties"
    ]
   },
-  {
-   "cell_type": "markdown",
-   "id": "325394fc",
-   "metadata": {},
-   "source": [
-    "### Access the Version Management Server through the Parcel Fabric `FeatureLayerCollection` object\n",
-    "\n",
-    "The `versions` property in a parcel fabric `FeatureLayerCollection` (FLC) creates a `VersionManager` object to create, update and use versions.  \n",
-    "\n",
-    "The `FeatureServer` endpoint is used to create a `FeatureLayerCollection`."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 14,
-   "id": "e77b0221",
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "['sde.DEFAULT', 'my_user_name.fabric_editor_1', 'mycreator.merge_version_1']"
-      ]
-     },
-     "execution_count": 14,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "from arcgis.features.layer import FeatureLayerCollection\n",
-    "\n",
-    "parcel_fabric_feature_server_url = f\"{base_server_url}/FeatureServer\"\n",
-    "parcel_fabric_flc = FeatureLayerCollection(parcel_fabric_feature_server_url, gis)\n",
-    "\n",
-    "# print the version names from the FLC's versions property:\n",
-    "vms_from_flc = parcel_fabric_flc.versions\n",
-    "[v.properties.versionName for v in vms_from_flc.all]"
-   ]
-  },
   {
    "cell_type": "markdown",
    "id": "fb52f011",
@@ -377,7 +320,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.0"
+   "version": "3.13.5"
   },
   "toc": {
    "base_numbering": 1,