added export and import functions to README

Author: asmith236

README.md

@@ -364,6 +364,40 @@ kfutil stores inventory remove \
   --cn <additional cert subject name>
 ```
 
+### Export Instance Data
+
+For full documentation, see [export](docs/kfutil_export.md).
+
+Export select instance data to JSON file:
+
+```bash
+# export only collections, metadata, and roles
+kfutil export --collections --metadata --roles --file <path to JSON file>
+```
+
+Export all exportable instance data to JSON file:
+
+```bash
+kfutil export --all --file <path to JSON file>
+```
+
+### Import Instance Data
+
+For full documentation, see [import](docs/kfutil_import.md).
+
+Import select instance data from exported JSON file:
+
+```bash
+# export only collections, metadata, and roles
+kfutil import --collections --metadata --roles --file <path to JSON file>
+```
+
+Import all importable instance data from exported JSON file:
+
+```bash
+kfutil import --all --file <path to JSON file>
+```
+
 ## Development
 
 This CLI developed using [cobra](https://umarcor.github.io/cobra/)
@@ -379,4 +413,3 @@ alternatively you can specify the parent command
 ```bash
 cobra-cli add <my-new-command> -p '<parent>Cmd'
 ```
-

cmd/import.go

@@ -167,7 +167,8 @@ func importNetworks(networks []keyfactor_command_client_api.KeyfactorApiModelsSs
 	}
 }
 
-func findMatchingTempIds(exportedWorkflowDef exportKeyfactorApiModelsWorkflowsDefinitionCreateRequest, kfClient *keyfactor_command_client_api.APIClient) *string {
+// identify matching templates between instances by name, then return the template Id of the matching template in the import instance
+func findMatchingTemplates(exportedWorkflowDef exportKeyfactorApiModelsWorkflowsDefinitionCreateRequest, kfClient *keyfactor_command_client_api.APIClient) *string {
 	importInstanceTemplates, _, _ := kfClient.TemplateApi.TemplateGetTemplates(context.Background()).XKeyfactorRequestedWith(xKeyfactorRequestedWith).XKeyfactorApiVersion(xKeyfactorApiVersion).Execute()
 	for _, template := range importInstanceTemplates {
 		importInstTempNameJson, _ := json.Marshal(template.TemplateName)
@@ -190,7 +191,7 @@ func importWorkflowDefinitions(workflowDefs []exportKeyfactorApiModelsWorkflowsD
 			fmt.Printf("Error: %s\n", jErr)
 			log.Fatalf("Error: %s", jErr)
 		}
-		newTemplateId := findMatchingTempIds(workflowDef, kfClient)
+		newTemplateId := findMatchingTemplates(workflowDef, kfClient)
 		if newTemplateId != nil {
 			workflowDefReq.Key = newTemplateId
 		}
@@ -204,6 +205,7 @@ func importWorkflowDefinitions(workflowDefs []exportKeyfactorApiModelsWorkflowsD
 	}
 }
 
+// check for built-in report discrepancies between instances, return the report id of reports that need to be updated in import instance
 func checkBuiltInReportDiffs(exportedReport exportModelsReport, kfClient *keyfactor_command_client_api.APIClient) *int32 {
 	importInstanceReports, _, _ := kfClient.ReportsApi.ReportsQueryReports(context.Background()).XKeyfactorRequestedWith(xKeyfactorRequestedWith).XKeyfactorApiVersion(xKeyfactorApiVersion).Execute()
 	//check if built in report was modified from default in exported instance; if modified, update built-in report in new instance

docs/kfutil_export.md

@@ -0,0 +1,30 @@
+## kfutil export
+
+Keyfactor export utilities.
+
+### Synopsis
+
+A collections of APIs and utilities for exporting Keyfactor instance data.
+
+### Options
+
+```
+ -a, --all                    export all exportable data to JSON file
+  -c, --collections            export collections to JSON file
+  -d, --denied-alerts          export denied cert alerts to JSON file
+  -e, --expiration-alerts      export expiration cert alerts to JSON file
+  -f, --file string            export JSON to a specified filepath
+  -h, --help                   help for export
+  -i, --issued-alerts          export issued cert alerts to JSON file
+  -m, --metadata               export metadata to JSON file
+  -n, --networks               export SSL networks to JSON file
+  -p, --pending-alerts         export pending cert alerts to JSON file
+  -r, --reports                export reports to JSON file
+  -s, --security-roles         export security roles to JSON file
+  -w, --workflow-definitions   export workflow definitions to JSON file
+```
+
+### SEE ALSO
+
+* [kfutil](kfutil.md)	 - Keyfactor CLI utilities
+

docs/kfutil_import.md

@@ -0,0 +1,30 @@
+## kfutil import
+
+Keyfactor import utilities.
+
+### Synopsis
+
+A collections of APIs and utilities for importing Keyfactor instance data.
+
+### Options
+
+```
+  -a, --all                    import all importable data to JSON file
+  -c, --collections            import collections to JSON file
+  -d, --denied-alerts          import denied cert alerts to JSON file
+  -e, --expiration-alerts      import expiration cert alerts to JSON file
+  -f, --file string            import JSON to a specified filepath
+  -h, --help                   help for import
+  -i, --issued-alerts          import issued cert alerts to JSON file
+  -m, --metadata               import metadata to JSON file
+  -n, --networks               import SSL networks to JSON file
+  -p, --pending-alerts         import pending cert alerts to JSON file
+  -r, --reports                import reports to JSON file
+  -s, --security-roles         import security roles to JSON file
+  -w, --workflow-definitions   import workflow definitions to JSON file
+```
+
+### SEE ALSO
+
+* [kfutil](kfutil.md)	 - Keyfactor CLI utilities
+