Expand import job examples in the API AF plan

Add more import job examples with usage.

Signed-off-by: thc202 <[email protected]>

Author: thc202

other/af-plans/ApiScanExample.yaml

@@ -231,22 +231,44 @@ jobs:
             return false
         }
 
+- type: "postman"
+  parameters:
+    collectionFile: postman.json # The target is defined in the collection.
+
+- type: "postman"
+  parameters:
+    collectionUrl: "https://api.example.com/postman.json" # The target is defined in the collection.
+
 - type: "graphql"
   parameters:
-    endpoint:           # String: the endpoint URL, default: null, no schema is imported
-    schemaUrl:          # String: URL pointing to a GraphQL Schema, default: null, import using introspection on endpoint
-    schemaFile:         # String: Local file path of a GraphQL Schema, default: null, import using schemaUrl
+    endpoint: "https://www.example.com/api/"
+    schemaFile: file.graphql
+
+- type: "graphql"
+  parameters:
+    endpoint: "https://www.example.com/api/"
+    schemaUrl: "https://www.example.com/api/file.graphql" # If no schemaFile nor schemaUrl is provided, introspection is done on the endpoint.
+
+- type: "openapi"
+  parameters:
+    apiFile: openapi.json # Assumes the definition has the target URL.
+
+- type: "openapi"
+  parameters:
+    apiUrl: "https://api.example.com/openapi.json" # Imports from URL, if the definition does not have the target it will be used the domain of the URL.
 
 - type: "openapi"
   parameters:
-    apiFile:            # String: Local file containing the OpenAPI definition, default: null, no definition will be imported
-    apiUrl:             # String: URL containing the OpenAPI definition, default: null, no definition will be imported
-    targetUrl:          # String: URL which overrides the target defined in the definition, default: null, the target will not be overridden
+    apiFile: openapi.json
+    targetUrl: "https://api.example.com/" # The definition does not have the target, we provide it in the job instead.
+
+- type: "soap"
+  parameters:
+    wsdlFile: file.wsdl # The WSDL needs to specify the target locations.
 
 - type: "soap"
   parameters:
-    wsdlFile:           # String: Local file path of the WSDL, default: null, no definition will be imported
-    wsdlUrl:            # String: URL pointing to the WSDL, default: null, no definition will be imported
+    wsdlUrl: "https://api.example.com/file.wsdl" # The WSDL needs to specify the target locations.
 
 - parameters:
   policyDefinition: