vignette on updating definitions

[JosiahParry]

With the recent additions to arcgislayers of using update definition for feature layer metadata management

          @elipousson as a heads up, we have utility functions in `arcgisutils` to create layer definitions and layers—we may want to explore how to combine these two and make better documentation / vignette

library(arcgisutils)
#> 
#> Attaching package: 'arcgisutils'
#> The following object is masked from 'package:base':
#> 
#>     %||%
ld <- as_layer_definition(iris, "iris", "objectID")
l <- as_layer(iris, "iris name", "Iris Title")
str(l, 2)
#> List of 4
#>  $ featureSet     :List of 2
#>   ..$ spatialReference: Named list()
#>   ..$ features        :List of 150
#>  $ layerDefinition:List of 7
#>   ..$ name          : chr "iris name"
#>   ..$ objectIdField : chr "object_id"
#>   ..$ fields        :'data.frame':   6 obs. of  6 variables:
#>   ..$ hasAttachments: logi FALSE
#>   ..$ maxScale      : num 0
#>   ..$ minScale      : num 0
#>   ..$ type          : chr "Table"
#>  $ name           : chr "iris name"
#>  $ title          : chr "Iris Title"
str(ld, 2)
#> List of 7
#>  $ name          : chr "iris"
#>  $ objectIdField : chr "objectID"
#>  $ fields        :'data.frame':  6 obs. of  6 variables:
#>   ..$ name    : chr [1:6] "objectID" "Sepal.Length" "Sepal.Width" "Petal.Length" ...
#>   ..$ type    : chr [1:6] "esriFieldTypeOID" "esriFieldTypeDouble" "esriFieldTypeDouble" "esriFieldTypeDouble" ...
#>   ..$ alias   : chr [1:6] "objectID" "Sepal.Length" "Sepal.Width" "Petal.Length" ...
#>   ..$ length  : int [1:6] NA NA NA NA NA 255
#>   ..$ editable: logi [1:6] FALSE TRUE TRUE TRUE TRUE TRUE
#>   ..$ nullable: logi [1:6] FALSE TRUE TRUE TRUE TRUE TRUE
#>  $ hasAttachments: logi FALSE
#>  $ maxScale      : num 0
#>  $ minScale      : num 0
#>  $ type          : chr "Table"

^{Created on 2025-05-27 with reprex v2.1.1}

Originally posted by @JosiahParry in #193 (comment)