{"id":1555742,"date":"2022-04-18T12:30:52","date_gmt":"2022-04-18T19:30:52","guid":{"rendered":"https:\/\/www.esri.com\/arcgis-blog\/?post_type=blog&p=1555742"},"modified":"2024-04-12T03:44:00","modified_gmt":"2024-04-12T10:44:00","slug":"contingent-attribute-values-in-the-arcgis-api-for-javascript","status":"publish","type":"blog","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/developers\/contingent-attribute-values-in-the-arcgis-api-for-javascript","title":{"rendered":"Contingent Attribute Values in the ArcGIS API for JavaScript"},"author":246262,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":""},"categories":[738191],"tags":[764532,764082],"industry":[],"product":[761642,36831,36601],"class_list":["post-1555742","blog","type-blog","status-publish","format-standard","hentry","category-developers","tag-4-23","tag-whats-new-march-2022","product-platform","product-js-api-arcgis","product-developers"],"acf":{"authors":[{"ID":246262,"user_firstname":"Jose","user_lastname":"Banuelos","nickname":"JBanuelos","user_nicename":"jbanuelos","display_name":"Jose Banuelos","user_email":"JBanuelos@esri.com","user_url":"","user_registered":"2021-07-02 18:51:02","user_description":"Jose is a Product Engineer on the ArcGIS API for JavaScript team in Redlands, CA.","user_avatar":""}],"short_description":"Learn how to create contingent values in ArcGIS Pro, publish a service with them, and consume them in the ArcGIS API for JavaScript.","flexible_content":[{"acf_fc_layout":"content","content":"

The FeatureForm<\/u><\/a> and Editor<\/u><\/a> widgets added support for contingent attribute values (contingent values) in the March release of the ArcGIS API for JavaScript (JS API), version 4.23.<\/p>\n

What are Contingent Attribute Values?<\/h2>\n

Contingent values are a data design feature introduced in ArcGIS Pro 2.3. Contingent values restrict the list of valid inputs in a field based off the field values chosen in one or more other fields. In other words, values in one field will become dependent on values chosen in other fields. This helps enforce data integrity in editing workflows by restricting the list of available attribute values to choose from. Take a look at Create and manage contingent values<\/u><\/a> to learn more about contingent attribute values.<\/p>\n

How to create and publish contingent attribute values in ArcGIS Pro<\/h2>\n

To demonstrate how to create and publish data with contingent values in ArcGIS Pro, I created a feature class with some animal taxonomy data included here<\/u><\/a>. You can skip this section if you are already familiar with creating contingent values, or if you already have a service published with contingent values. You can use the following item<\/u><\/a> and move on to the next section<\/u><\/a> to bring in the data to the FeatureForm and Editor widgets in the JS API.<\/p>\n

Step 1<\/strong>:
\nFirst, download the AnimalTax<\/u><\/a> file geodatabase containing the data we will be working with. Unzip the downloaded file and connect to the folder from ArcGIS Pro. Finally, add the GenusData<\/strong> feature class to your Map<\/strong>.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1555852,"id":1555852,"title":"Pro folder structure","filename":"folder-pro.png","filesize":3072,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/folder-pro.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/developers\/contingent-attribute-values-in-the-arcgis-api-for-javascript\/folder-pro","alt":"folder structure","author":"246262","description":"","caption":"ArcGIS Pro folder structure","name":"folder-pro","status":"inherit","uploaded_to":1555742,"date":"2022-04-15 19:41:45","modified":"2022-04-15 19:43:40","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":330,"height":180,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/folder-pro-213x180.png","thumbnail-width":213,"thumbnail-height":180,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/folder-pro.png","medium-width":330,"medium-height":180,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/folder-pro.png","medium_large-width":330,"medium_large-height":180,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/folder-pro.png","large-width":330,"large-height":180,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/folder-pro.png","1536x1536-width":330,"1536x1536-height":180,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/folder-pro.png","2048x2048-width":330,"2048x2048-height":180,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/folder-pro.png","card_image-width":330,"card_image-height":180,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/folder-pro.png","wide_image-width":330,"wide_image-height":180}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

As part of the data preparation, the contingent values fields should be setup with domains. Therefore, the feature class provided sets domains on the ORDER_<\/strong>, FAMILY<\/strong>, and GENUS<\/strong> fields. These fields will be used to create our contingent values. The following image illustrates how your Map in ArcGIS Pro should look like after adding the GenusData <\/strong>feature class.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1558742,"id":1558742,"title":"pro-map-new","filename":"pro-map-new.png","filesize":191903,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-map-new.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/developers\/contingent-attribute-values-in-the-arcgis-api-for-javascript\/pro-map-new","alt":"pro map","author":"246262","description":"","caption":"Genus feature class in ArcGIS Pro Map","name":"pro-map-new","status":"inherit","uploaded_to":1555742,"date":"2022-04-20 22:02:21","modified":"2022-04-20 22:03:17","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":1416,"height":706,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-map-new-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-map-new.png","medium-width":464,"medium-height":231,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-map-new.png","medium_large-width":768,"medium_large-height":383,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-map-new.png","large-width":1416,"large-height":706,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-map-new.png","1536x1536-width":1416,"1536x1536-height":706,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-map-new.png","2048x2048-width":1416,"2048x2048-height":706,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-map-new-826x412.png","card_image-width":826,"card_image-height":412,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-map-new.png","wide_image-width":1416,"wide_image-height":706}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Step 2<\/strong>:<\/p>\n

Add a unique value renderer for the Genus<\/strong> feature class with the ORDER_<\/strong>\u00a0field set. Next, select Add all values<\/strong> in the symbology pane to assign all field domains with their own corresponding symbol.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1559022,"id":1559022,"title":"uvr-symbology","filename":"uvr-symbology.png","filesize":22303,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/uvr-symbology.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/developers\/contingent-attribute-values-in-the-arcgis-api-for-javascript\/uvr-symbology","alt":"uvr-symbology","author":"246262","description":"feature class unique value renderer","caption":"","name":"uvr-symbology","status":"inherit","uploaded_to":1555742,"date":"2022-04-20 23:28:39","modified":"2022-04-20 23:29:03","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":475,"height":639,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/uvr-symbology-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/uvr-symbology.png","medium-width":194,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/uvr-symbology.png","medium_large-width":475,"medium_large-height":639,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/uvr-symbology.png","large-width":475,"large-height":639,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/uvr-symbology.png","1536x1536-width":475,"1536x1536-height":639,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/uvr-symbology.png","2048x2048-width":475,"2048x2048-height":639,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/uvr-symbology-346x465.png","card_image-width":346,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/uvr-symbology.png","wide_image-width":475,"wide_image-height":639}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Step 3<\/strong>:<\/p>\n

Next, right-click on the feature class in the Contents pane, hover over Data Design<\/strong>, and click Contingent Values<\/strong> to open the Contingent Values view.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1555862,"id":1555862,"title":"data design contingent values","filename":"pro-data-design.png","filesize":10601,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-data-design.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/developers\/contingent-attribute-values-in-the-arcgis-api-for-javascript\/pro-data-design","alt":"data design","author":"246262","description":"","caption":"Open Contingent Values View from Data Design","name":"pro-data-design","status":"inherit","uploaded_to":1555742,"date":"2022-04-15 19:41:48","modified":"2022-04-15 19:46:56","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":592,"height":255,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-data-design-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-data-design.png","medium-width":464,"medium-height":200,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-data-design.png","medium_large-width":592,"medium_large-height":255,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-data-design.png","large-width":592,"large-height":255,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-data-design.png","1536x1536-width":592,"1536x1536-height":255,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-data-design.png","2048x2048-width":592,"2048x2048-height":255,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-data-design.png","card_image-width":592,"card_image-height":255,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-data-design.png","wide_image-width":592,"wide_image-height":255}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Step 4<\/strong>:<\/p>\n

Create a new field group by clicking on the Field Groups<\/strong> button in the Contingent Values view. A field group is a named collection of fields in a table or feature class, and defines what fields will have contingent values. You can define multiple field groups for the same data, but in this example we will only create one.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1555812,"id":1555812,"title":"contingent-values-ribbon","filename":"contingent-values-ribbon.png","filesize":13813,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values-ribbon.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/developers\/contingent-attribute-values-in-the-arcgis-api-for-javascript\/contingent-values-ribbon","alt":"contingent values view","author":"246262","description":"","caption":"Contingent Values View","name":"contingent-values-ribbon","status":"inherit","uploaded_to":1555742,"date":"2022-04-15 19:41:31","modified":"2022-04-15 19:47:52","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":479,"height":142,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values-ribbon-213x142.png","thumbnail-width":213,"thumbnail-height":142,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values-ribbon.png","medium-width":464,"medium-height":138,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values-ribbon.png","medium_large-width":479,"medium_large-height":142,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values-ribbon.png","large-width":479,"large-height":142,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values-ribbon.png","1536x1536-width":479,"1536x1536-height":142,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values-ribbon.png","2048x2048-width":479,"2048x2048-height":142,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values-ribbon.png","card_image-width":479,"card_image-height":142,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values-ribbon.png","wide_image-width":479,"wide_image-height":142}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Step 5:<\/strong><\/strong><\/p>\n

In this step, add a name for the field group you created. Click on the Add Fields<\/strong> drop-down to select the fields that will make up this field group. Check the ORDER_<\/strong>, FAMILY<\/strong>, and GENUS <\/strong>fields. Click Add<\/strong>. Leave the Restrictive <\/strong>check box checked and click OK<\/strong>.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1556012,"id":1556012,"title":"create-field-group-2","filename":"create-field-group-2-1.png","filesize":11140,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/create-field-group-2-1.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/developers\/contingent-attribute-values-in-the-arcgis-api-for-javascript\/create-field-group-2-2","alt":"create field group","author":"246262","description":"","caption":"Create field group","name":"create-field-group-2-2","status":"inherit","uploaded_to":1555742,"date":"2022-04-15 21:29:32","modified":"2022-04-15 21:30:07","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":623,"height":622,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/create-field-group-2-1-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/create-field-group-2-1.png","medium-width":261,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/create-field-group-2-1.png","medium_large-width":623,"medium_large-height":622,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/create-field-group-2-1.png","large-width":623,"large-height":622,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/create-field-group-2-1.png","1536x1536-width":623,"1536x1536-height":622,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/create-field-group-2-1.png","2048x2048-width":623,"2048x2048-height":622,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/create-field-group-2-1-466x465.png","card_image-width":466,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/create-field-group-2-1.png","wide_image-width":623,"wide_image-height":622}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Step 6<\/strong>:<\/p>\n

Next, we will create the contingent values for this data. Select the Field Group name you created in the previous step. Click the New<\/strong> button on the ribbon or click directly on the empty row where it says Click to add contingent values<\/strong>. Choose a field attribute value from the drop-down menus for each field in the field group. See the image below as an example for the contingent values you can create for the Rodentia <\/strong>and Primates <\/strong>domains.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1556022,"id":1556022,"title":"contingent-values","filename":"contingent-values.png","filesize":8505,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/developers\/contingent-attribute-values-in-the-arcgis-api-for-javascript\/contingent-values","alt":"contingent values","author":"246262","description":"","caption":"Creating contingent values","name":"contingent-values","status":"inherit","uploaded_to":1555742,"date":"2022-04-15 21:35:55","modified":"2022-04-15 21:36:18","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":342,"height":367,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values.png","medium-width":243,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values.png","medium_large-width":342,"medium_large-height":367,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values.png","large-width":342,"large-height":367,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values.png","1536x1536-width":342,"1536x1536-height":367,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values.png","2048x2048-width":342,"2048x2048-height":367,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values.png","card_image-width":342,"card_image-height":367,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/contingent-values.png","wide_image-width":342,"wide_image-height":367}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

The AnimalTax.gdb<\/strong> contains a GenusDataContingentValues<\/strong> feature class with all contingent values already set if you would like to use as a reference for the rest of the domain fields. Feel free to choose whatever contingent values you like, the data provided is just an example that you can follow. Make sure to click the Save <\/strong>button in the Contingent Values view to save your changes.<\/p>\n"},{"acf_fc_layout":"content","content":"

Step 7<\/strong>:<\/p>\n

Finally publish the layer as a web layer to ArcGIS Online or Portal for ArcGIS. Add a name, summary, tags, and make sure to set the Layer Type to Feature.<\/p>\n

Note: Contingent Values are currently not supported for ArcGIS Enterprise hosted feature services. Use feature services that reference registered data instead when working with Enterprise deployments.<\/em><\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1555882,"id":1555882,"title":"pro-publish","filename":"pro-publish.png","filesize":7263,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-publish.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/developers\/contingent-attribute-values-in-the-arcgis-api-for-javascript\/pro-publish","alt":"Publish as web layer","author":"246262","description":"","caption":"Publish data as web layer.","name":"pro-publish","status":"inherit","uploaded_to":1555742,"date":"2022-04-15 19:41:58","modified":"2022-04-15 19:56:49","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":457,"height":560,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-publish-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-publish.png","medium-width":213,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-publish.png","medium_large-width":457,"medium_large-height":560,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-publish.png","large-width":457,"large-height":560,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-publish.png","1536x1536-width":457,"1536x1536-height":560,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-publish.png","2048x2048-width":457,"2048x2048-height":560,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-publish-379x465.png","card_image-width":379,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/pro-publish.png","wide_image-width":457,"wide_image-height":560}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

<\/a><\/p>\n

Contingent Values with the JS API<\/h2>\n

The goal to support contingent values in the JS API was to avoid the complexity associated with them, and instead provide a comprehensible user experience. We achieved this by adding native support to the FeatureForm<\/u><\/a> and Editor<\/u><\/a> widgets. All you need to do is bring in your feature services published with contingent values and start editing! Everything is handled out-of-the-box.<\/p>\n

FeatureForm<\/h3>\n

The FeatureForm widget automatically detects if a feature service was published with contingent values. The field inputs in the form that make up the field group(s) created will display Recommended <\/strong>and Other <\/strong>sections in the dropdown. The Recommended <\/strong>section displays a list of domain values that would satisfy the contingencies defined when preparing the data.<\/p>\n

The Other <\/strong>section displays a list of the rest of the domain values for that field. Selecting a value from the Other <\/strong>list will lead to validation errors since they are considered invalid for the contingency. The purpose of the Other <\/strong>section is to allow users to still view and select the other values available in the field domain. As a result, data editing in the FeatureForm is not restricted to a top-down approach.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1556032,"id":1556032,"title":"feature-form-recommendation","filename":"feature-form-recommendation.png","filesize":6089,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/feature-form-recommendation.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/developers\/contingent-attribute-values-in-the-arcgis-api-for-javascript\/feature-form-recommendation","alt":"feature form","author":"246262","description":"","caption":"FeatureForm recommendations","name":"feature-form-recommendation","status":"inherit","uploaded_to":1555742,"date":"2022-04-15 21:37:49","modified":"2022-04-15 21:38:11","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":346,"height":458,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/feature-form-recommendation-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/feature-form-recommendation.png","medium-width":197,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/feature-form-recommendation.png","medium_large-width":346,"medium_large-height":458,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/feature-form-recommendation.png","large-width":346,"large-height":458,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/feature-form-recommendation.png","1536x1536-width":346,"1536x1536-height":458,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/feature-form-recommendation.png","2048x2048-width":346,"2048x2048-height":458,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/feature-form-recommendation.png","card_image-width":346,"card_image-height":458,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/feature-form-recommendation.png","wide_image-width":346,"wide_image-height":458}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

FeatureForm widget live app<\/u><\/a><\/p>\n

Validation<\/h3>\n

The FeatureForm provides validation for invalid contingencies. If there is an invalid field value set in the form, then all the fields that make up the field group will display a validation error message underneath each field input.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1556052,"id":1556052,"title":"validation","filename":"validation.png","filesize":9200,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/validation.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/developers\/contingent-attribute-values-in-the-arcgis-api-for-javascript\/validation","alt":"validation","author":"246262","description":"","caption":"FeatureForm contingent values validation","name":"validation","status":"inherit","uploaded_to":1555742,"date":"2022-04-15 21:42:23","modified":"2022-04-15 21:42:54","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":345,"height":394,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/validation-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/validation.png","medium-width":229,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/validation.png","medium_large-width":345,"medium_large-height":394,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/validation.png","large-width":345,"large-height":394,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/validation.png","1536x1536-width":345,"1536x1536-height":394,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/validation.png","2048x2048-width":345,"2048x2048-height":394,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/validation.png","card_image-width":345,"card_image-height":394,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/validation.png","wide_image-width":345,"wide_image-height":394}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Editor<\/h3>\n

The Editor widget also supports contingent values natively since it uses the FeatureForm widget. The benefit of using the Editor is that it will not allow you to submit any edits if there are contingency validation errors. This enforces data integrity because it helps prevent incorrect data entry. There is no server-side validation for contingent values. Therefore, the only way to ensure that we submit valid data is to enforce error handling on the client via the Editor widget.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1556882,"id":1556882,"title":"editor-cav","filename":"editor-cav.gif","filesize":376586,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/editor-cav.gif","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/developers\/contingent-attribute-values-in-the-arcgis-api-for-javascript\/editor-cav","alt":"editor contingent values","author":"246262","description":"","caption":"Editing features with contingent values","name":"editor-cav","status":"inherit","uploaded_to":1555742,"date":"2022-04-18 15:22:54","modified":"2022-04-18 15:23:30","menu_order":0,"mime_type":"image\/gif","type":"image","subtype":"gif","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":808,"height":624,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/editor-cav-213x200.gif","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/editor-cav.gif","medium-width":338,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/editor-cav.gif","medium_large-width":768,"medium_large-height":593,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/editor-cav.gif","large-width":808,"large-height":624,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/editor-cav.gif","1536x1536-width":808,"1536x1536-height":624,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/editor-cav.gif","2048x2048-width":808,"2048x2048-height":624,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/editor-cav-602x465.gif","card_image-width":602,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2022\/04\/editor-cav.gif","wide_image-width":808,"wide_image-height":624}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Editor widget live app<\/u><\/a><\/p>\n

Limitations<\/h3>\n