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
Copy file name to clipboardExpand all lines: README.md
+21-6Lines changed: 21 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -413,7 +413,7 @@ Item types defined when uploading extracted data must validate the declarations
413
413
Extracted data must be normalized.
414
414
415
415
- Null values: All fields without a value should either be omitted or set to null. For example, if an external system provides values such as "", -1 for missing values, those must be set to null.
416
-
- Timestamps: Full-precision timestamps should be formatted as RFC3999 (`1972-03-29T22:04:47+01:00`), and dates should be just `2020-12-31`.
416
+
- Timestamps: Full-precision timestamps should be formatted as RFC3399 (`1972-03-29T22:04:47+01:00`), and dates should be just `2020-12-31`.
417
417
- References: references must be strings, not numbers or objects.
418
418
- Number fields must be valid JSON numbers (not strings)
419
419
- Multiselect fields must be provided as an array (not CSV)
This will reach 'waiting for user input' stage. Wait there.
455
455
456
+
## Add your token as an environment variable:
457
+
458
+
Obtain a PAT-token from the Settings/Account tab of the devorg where you deploy your snapin, and export is at DEVREV_TOKEN
459
+
456
460
## Initialize the context of the sync:
457
461
458
-
To allow the cli to work in the context of that sync, you have to provide its identifying properties in an environment variable (replacing the values based on the logs of your running import)
462
+
To allow the cli to work in the context of that sync, you have to provide its identifying properties in an environment variable.
463
+
The recommended method is to run:
464
+
```bash
465
+
chef-cli ctx switch --env prod
466
+
```
467
+
468
+
This will print the list of airdrop imports in the org. Select the one you like by running
469
+
```bash
470
+
$ eval$(chef-cli ctx switch --env --prod --id <the id you choose>); chef-cli ctx show
471
+
```
472
+
473
+
If this method doesn't work, you can manually export the variable (replacing the values based on the logs of your running import):
@@ -467,10 +482,6 @@ Or you can use the interactive helper of the cli:
467
482
$ eval$(chef-cli ctx init); chef-cli ctx show > ctx.json
468
483
```
469
484
470
-
## Add your token as an environment variable:
471
-
472
-
Obtain a PAT-token from the Settings/Account tab of the devorg where you deploy your snapin, and export is at DEVREV_TOKEN
473
-
474
485
## Use the local UI to create a recipe blueprint for your initial import:
475
486
476
487
`$ chef-cli configure-mappings --env prod`
@@ -490,6 +501,10 @@ where the options are:
490
501
The first function of the local UI is to assemble a 'blueprint' for concrete import running in the test-org, allowing the mapping to be tested out and evaluated.
491
502
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.
492
503
504
+
If you are also creating devrev -> external sync, use
505
+
506
+
`$ chef-cli configure-mappings --env prod --reverse`, which enabled mapping in both directions.
507
+
493
508
## Use the local UI to create an initial domain mappings
494
509
495
510
The final artifact of the recipe creation process is the initial_domain_mappings.json, which has to embedded in the extractor.
0 commit comments