You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The options are: `dvrv-us-1`, `dvrv-eu-1`, `dvrv-in-1`, and `dvrv-de-1`.
90
90
91
-
The first function of the local UI is to assemble a *blueprint* for a concrete import running in the test-org, allowing the mapping to be tested out and evaluated.
92
-
After it is used for the import, the mappings become immutable, but the chef-cli UI offers a button to make a draft clone, which can be edited again for refinements.
91
+
The first function of the Chef UI is to assemble a *blueprint* for a concrete import running in the test-org, allowing the mapping to be tested out and evaluated.
92
+
After it is used for the import, the mappings become immutable, but the Chef UI offers a button to make a draft clone, which can be edited again for refinements.
93
93
94
94
### Continue to initial domain mapping
95
95
96
-
When you are done, you should have the chef-cli context set up and have the chef-cli local UI running in your browser.
97
-
You can now use the chef-cli web UI to create initial domain mappings.
96
+
When you are done, you should have the chef-cli context set up and have the Chef UI running in your browser.
97
+
You can now use the Chef UI to create initial domain mappings.
98
98
99
99
</Steps>
100
100
101
-
## Use the local UI to create initial domain mappings
101
+
## Use the Chef UI to create initial domain mappings
102
102
103
-
The chef-cli UI generates an `initial_domain_mapping.json` file that must be embedded in your extractor. This defines the options that the end-user sees when they are mapping the data.
103
+
The Chef UI generates an `initial_domain_mapping.json` file that must be embedded in your extractor. This defines the options that the end-user sees when they are mapping the data.
104
104
105
-
Initial domain mappings differ from user mappings in two key ways:
105
+
Initial domain mappings provide two key configuration capabilities:
106
106
107
107
1.**Multiple mapping options**: The developer can choose how external record types map to DevRev records (for example, external *task* can map to either *issue* or *ticket*).
108
108
2.**Category-based defaults**: Mappings can apply to entire record type categories, automatically handling new record types.
@@ -111,26 +111,26 @@ Initial domain mappings differ from user mappings in two key ways:
111
111
112
112
### Map record types and fields
113
113
114
-
Use the chef-cli UI to map record types and fields.
115
-
The UI shows you the record types that are available in the org and allows you to map them to the external record types.
116
-
You should map one record type at a time.
114
+
Use the Chef UI to map record types and fields.
115
+
The UI displays the external record types you defined in external domain metadata and allows you to map them to DevRev objects.
116
+
Map one record type at a time, ensuring you map all required fields and as many optional fields as possible.
117
117
118
118
### Specify fallback mappings
119
119
120
-
For most required DevRev fields a fallback is required. This is used on object creation if the extractor doesn't provide a value.
120
+
For some required DevRev fields a fallback is required.
121
121
122
-
The fallback should be a DevRev value that is valid for the field.
123
-
For enum fields, the fallback should be the enum **value** as specified in [Supported object types](./supported-object-types.mdx).
122
+
The fallback you choose will be used on item creation if the extractor doesn't provide a value for the required DevRev field.
123
+
This is useful for fields that are required by DevRev but optional in the external system.
124
124
125
125
### Install the blueprint
126
126
127
-
Click **Install in this org** to access the initial domain mapping creation screen.
127
+
Apply the mappings and **install them in your org** to access the initial domain mapping creation screen.
128
128
Follow the instructions to create your initial domain mapping.
129
129
130
130
### Merge configurations
131
131
132
132
You can repeat the process for different record types and fields to create multiple mappings.
133
-
In the install screen, you can merge your mappings with existing initial mappings.
133
+
In the install screen, you can merge new mappings with existing initial domain mappings.
0 commit comments