@salesforce/plugin-orchestrator 1.0.18 → 1.1.0

package/lib/commands/orchestrator/app/upgrade.d.ts

@@ -0,0 +1,32 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type OrchestratorAppUpgradeResult = {
+    appId: string;
+};
+export default class OrchestratorAppUpgrade extends SfCommand<OrchestratorAppUpgradeResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly state = "preview";
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'app-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'app-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'template-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'template-values': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'runtime-method': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'log-level': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'chain-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    private static validateRequiredFlags;
+    private static validateTemplateMatch;
+    private static parseTemplateValues;
+    private static buildUpdateOptions;
+    private static resolveAppById;
+    private static handleUpgradeError;
+    run(): Promise<OrchestratorAppUpgradeResult>;
+    private resolveApp;
+    private resolveAppByName;
+    private executeUpgrade;
+    private displayUpgradedApp;
+}

package/lib/commands/orchestrator/app/upgrade.js

@@ -0,0 +1,188 @@
+/*
+ * Copyright 2025, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages, SfError } from '@salesforce/core';
+import AppFrameworkApp from '../../../utils/app/appframeworkapp.js';
+import { AppListUtil } from '../../../utils/app/appListUtils.js';
+import { AppDisplayUtil } from '../../../utils/app/appDisplayUtil.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-orchestrator', 'orchestrator.app.upgrade');
+export default class OrchestratorAppUpgrade extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static state = 'preview';
+    static flags = {
+        'target-org': Flags.requiredOrg({
+            summary: messages.getMessage('flags.target-org.summary'),
+            description: messages.getMessage('flags.target-org.description'),
+            required: true,
+        }),
+        'api-version': Flags.orgApiVersion({
+            summary: messages.getMessage('flags.api-version.summary'),
+            description: messages.getMessage('flags.api-version.description'),
+        }),
+        'app-id': Flags.string({
+            char: 'i',
+            summary: messages.getMessage('flags.app-id.summary'),
+            description: messages.getMessage('flags.app-id.description'),
+            exclusive: ['app-name'],
+        }),
+        'app-name': Flags.string({
+            char: 'n',
+            summary: messages.getMessage('flags.app-name.summary'),
+            description: messages.getMessage('flags.app-name.description'),
+            exclusive: ['app-id'],
+        }),
+        'template-id': Flags.string({
+            char: 't',
+            summary: messages.getMessage('flags.template-id.summary'),
+            description: messages.getMessage('flags.template-id.description'),
+            required: true,
+        }),
+        'template-values': Flags.string({
+            char: 'v',
+            summary: messages.getMessage('flags.template-values.summary'),
+            description: messages.getMessage('flags.template-values.description'),
+        }),
+        'runtime-method': Flags.string({
+            char: 'r',
+            summary: messages.getMessage('flags.runtime-method.summary'),
+            description: messages.getMessage('flags.runtime-method.description'),
+            options: ['sync', 'async'],
+        }),
+        'log-level': Flags.string({
+            char: 'l',
+            summary: messages.getMessage('flags.log-level.summary'),
+            description: messages.getMessage('flags.log-level.description'),
+            options: ['debug', 'info', 'warn', 'error'],
+        }),
+        'chain-name': Flags.string({
+            char: 'c',
+            summary: messages.getMessage('flags.chain-name.summary'),
+            description: messages.getMessage('flags.chain-name.description'),
+        }),
+    };
+    static validateRequiredFlags(flags) {
+        if (!flags['app-id'] && !flags['app-name']) {
+            throw new SfError(messages.getMessage('noAppSpecified'), 'AppUpgradeError', messages.getMessages('error.UpgradeError.Actions'));
+        }
+    }
+    static validateTemplateMatch(app, templateId) {
+        if (app.templateSourceId !== templateId) {
+            throw new SfError(`Template ID mismatch. App is using template '${app.templateSourceId ?? 'unknown'}' but you specified '${templateId}'. You cannot change the underlying template during an upgrade.`, 'AppUpgradeError', messages.getMessages('error.UpgradeError.Actions'));
+        }
+    }
+    static parseTemplateValues(templateValuesString) {
+        if (!templateValuesString) {
+            return undefined;
+        }
+        try {
+            const parsed = JSON.parse(templateValuesString);
+            if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+                throw new SfError('Template values must be a valid JSON object, not an array or primitive value.', 'AppUpgradeError', messages.getMessages('error.UpgradeError.Actions'));
+            }
+            return parsed;
+        }
+        catch (error) {
+            if (error instanceof SfError) {
+                throw error;
+            }
+            throw new SfError(messages.getMessage('invalidTemplateValues'), 'AppUpgradeError', messages.getMessages('error.UpgradeError.Actions'));
+        }
+    }
+    static buildUpdateOptions(flags, templateValues) {
+        const updateOptions = {
+            templateSourceId: flags['template-id'],
+            templateValues,
+            runtimeMethod: flags['runtime-method'],
+            logLevel: flags['log-level'],
+        };
+        if (flags['chain-name']) {
+            updateOptions.chainName = flags['chain-name'];
+        }
+        return updateOptions;
+    }
+    static async resolveAppById(appId, appFrameworkApp) {
+        if (!appId) {
+            throw new SfError(messages.getMessage('noAppSpecified'), 'AppUpgradeError', messages.getMessages('error.UpgradeError.Actions'));
+        }
+        const app = await appFrameworkApp.getApp(appId);
+        if (!app) {
+            throw new SfError(messages.getMessage('noAppFound'), 'AppUpgradeError', messages.getMessages('error.UpgradeError.Actions'));
+        }
+        return { appId, app };
+    }
+    static handleUpgradeError(error) {
+        if (error instanceof SfError) {
+            throw error;
+        }
+        throw new SfError(messages.getMessage('error.UpgradeError', [error.message]), 'AppUpgradeError', messages.getMessages('error.UpgradeError.Actions'), undefined, error);
+    }
+    async run() {
+        const { flags } = await this.parse(OrchestratorAppUpgrade);
+        OrchestratorAppUpgrade.validateRequiredFlags(flags);
+        try {
+            const connection = flags['target-org'].getConnection(flags['api-version']);
+            const appFrameworkApp = new AppFrameworkApp(connection);
+            const { appId, app } = await this.resolveApp(flags, appFrameworkApp);
+            OrchestratorAppUpgrade.validateTemplateMatch(app, flags['template-id']);
+            const templateValues = OrchestratorAppUpgrade.parseTemplateValues(flags['template-values']);
+            const updateOptions = OrchestratorAppUpgrade.buildUpdateOptions(flags, templateValues);
+            const upgradedAppId = await this.executeUpgrade(appFrameworkApp, appId, updateOptions);
+            await this.displayUpgradedApp(appFrameworkApp, upgradedAppId);
+            return { appId: upgradedAppId };
+        }
+        catch (error) {
+            this.spinner.stop();
+            OrchestratorAppUpgrade.handleUpgradeError(error);
+        }
+    }
+    async resolveApp(flags, appFrameworkApp) {
+        if (flags['app-name']) {
+            return this.resolveAppByName(flags['app-name'], appFrameworkApp);
+        }
+        return OrchestratorAppUpgrade.resolveAppById(flags['app-id'], appFrameworkApp);
+    }
+    async resolveAppByName(appName, appFrameworkApp) {
+        this.spinner.start(messages.getMessage('fetchingApp'));
+        const apps = await appFrameworkApp.list();
+        const foundApp = apps.find((a) => a.name === appName);
+        if (!foundApp?.id) {
+            this.spinner.stop();
+            throw new SfError(messages.getMessage('noAppFound'), 'AppUpgradeError', messages.getMessages('error.UpgradeError.Actions'));
+        }
+        this.spinner.stop();
+        return { appId: foundApp.id, app: foundApp };
+    }
+    async executeUpgrade(appFrameworkApp, appId, updateOptions) {
+        this.spinner.start(messages.getMessage('upgradingApp'));
+        const upgradedAppId = await appFrameworkApp.updateApp(appId, updateOptions);
+        this.spinner.stop();
+        this.log(messages.getMessage('upgradeSuccess', [upgradedAppId]));
+        return upgradedAppId;
+    }
+    async displayUpgradedApp(appFrameworkApp, upgradedAppId) {
+        const upgradedApp = await appFrameworkApp.getApp(upgradedAppId);
+        if (upgradedApp) {
+            const processedApps = AppListUtil.processApps([upgradedApp]);
+            if (processedApps.length > 0) {
+                AppDisplayUtil.displayAppDetails(this, processedApps[0]);
+            }
+        }
+    }
+}
+//# sourceMappingURL=upgrade.js.map

package/lib/commands/orchestrator/app/upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../../../src/commands/orchestrator/app/upgrade.ts"],"names":[],"mappings":"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"}

package/lib/commands/orchestrator/template/eval.d.ts

@@ -0,0 +1,63 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+type TransformationPayload = {
+    document: {
+        user: {
+            firstName: string;
+            lastName: string;
+            userName: string;
+            id: string;
+            hello: string;
+        };
+        company: {
+            id: string;
+            name: string;
+            namespace: string;
+        };
+    };
+    values: {
+        Variables: {
+            hello: string;
+        };
+    };
+    definition: {
+        rules: Array<{
+            name: string;
+            actions: Array<{
+                action: string;
+                description: string;
+                key: string;
+                path: string;
+                value: string;
+            }>;
+        }>;
+    };
+};
+type TemplateInfo = {
+    name: string;
+    path: string;
+    source: 'static' | 'local';
+};
+export type TemplatePreviewResult = {
+    status: 'success' | 'error';
+    template?: TemplateInfo;
+    input?: TransformationPayload;
+    output?: unknown;
+    error?: string;
+    executionTime?: string;
+};
+export default class TemplateEval extends SfCommand<TemplatePreviewResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'document-file': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'values-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'definition-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<TemplatePreviewResult>;
+    private getTemplatePayload;
+    private getDirectFilePayload;
+}
+export {};

package/lib/commands/orchestrator/template/eval.js

@@ -0,0 +1,132 @@
+/*
+ * Copyright 2025, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import * as fs from 'node:fs/promises';
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-orchestrator', 'orchestrator.template.eval');
+export default class TemplateEval extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        'target-org': Flags.requiredOrg({
+            summary: messages.getMessage('flags.target-org.summary'),
+            description: messages.getMessage('flags.target-org.description'),
+            required: true,
+        }),
+        'api-version': Flags.orgApiVersion({
+            summary: messages.getMessage('flags.api-version.summary'),
+            description: messages.getMessage('flags.api-version.description'),
+        }),
+        'document-file': Flags.file({
+            char: 'd',
+            summary: messages.getMessage('flags.document-file.summary'),
+            description: messages.getMessage('flags.document-file.description'),
+            required: true,
+        }),
+        'values-file': Flags.file({
+            char: 'v',
+            summary: messages.getMessage('flags.values-file.summary'),
+            description: messages.getMessage('flags.values-file.description'),
+            dependsOn: ['document-file'],
+        }),
+        'definition-file': Flags.file({
+            char: 'r',
+            summary: messages.getMessage('flags.definition-file.summary'),
+            description: messages.getMessage('flags.definition-file.description'),
+            dependsOn: ['document-file'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(TemplateEval);
+        try {
+            const connection = flags['target-org'].getConnection(flags['api-version']);
+            // Determine template source and payload
+            const templateResult = await this.getTemplatePayload(flags);
+            this.log(`Testing transformation: ${templateResult.template.name}`);
+            this.log(`Source: ${templateResult.template.source}`);
+            if (templateResult.template.source === 'local') {
+                this.log(`Path: ${templateResult.template.path}`);
+            }
+            const startTime = Date.now();
+            // Make request to jsonxform/transformation endpoint
+            const apiPath = `/services/data/v${connection.getApiVersion()}/jsonxform/transformation`;
+            const result = await connection.request({
+                method: 'POST',
+                url: apiPath,
+                body: JSON.stringify(templateResult.payload),
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+            });
+            const executionTime = `${Date.now() - startTime}ms`;
+            this.log('Transformation completed successfully!');
+            this.log('Results:');
+            this.log(JSON.stringify(result, null, 2));
+            return {
+                status: 'success',
+                template: templateResult.template,
+                input: templateResult.payload,
+                output: result,
+                executionTime,
+            };
+        }
+        catch (error) {
+            this.log(`Transformation failed: ${error.message}`);
+            return {
+                status: 'error',
+                error: error.message,
+            };
+        }
+    }
+    async getTemplatePayload(flags) {
+        return this.getDirectFilePayload(flags['document-file'], flags['values-file'], flags['definition-file']);
+    }
+    async getDirectFilePayload(documentFile, valuesFile, definitionFile) {
+        this.log(`Loading document: ${documentFile}`);
+        // Read and parse the document file
+        const documentContent = await fs.readFile(documentFile, 'utf8');
+        const document = JSON.parse(documentContent);
+        // Read values file if provided, otherwise use empty object
+        let values = { Variables: { hello: 'world' } };
+        if (valuesFile) {
+            this.log(`Loading values: ${valuesFile}`);
+            const valuesContent = await fs.readFile(valuesFile, 'utf8');
+            values = JSON.parse(valuesContent);
+        }
+        // Read definition file if provided, otherwise use empty rules
+        let definition = { rules: [] };
+        if (definitionFile) {
+            this.log(`Loading definition: ${definitionFile}`);
+            const definitionContent = await fs.readFile(definitionFile, 'utf8');
+            definition = JSON.parse(definitionContent);
+        }
+        return {
+            template: {
+                name: 'Direct Files',
+                path: documentFile,
+                source: 'local',
+            },
+            payload: {
+                document: document,
+                values: values,
+                definition: definition,
+            },
+        };
+    }
+}
+//# sourceMappingURL=eval.js.map

package/lib/commands/orchestrator/template/eval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.js","sourceRoot":"","sources":["../../../../src/commands/orchestrator/template/eval.ts"],"names":[],"mappings":"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"}

package/messages/orchestrator.app.upgrade.md

@@ -0,0 +1,141 @@
+# summary
+
+Upgrade an orchestrated app.
+
+# description
+
+Upgrade an existing orchestrated app by running its template's upgrade chains. This command allows you to apply template upgrades, reconfigure the app with new template values, and modify runtime settings while staying within the same template.
+
+You can identify the app by either its unique ID or its name. App IDs are guaranteed to be unique, while names should be unique within an org.
+
+Use this command to run template-defined upgrade workflows that can update app configurations, apply new template versions, or reconfigure template values. This is different from the update command which only changes basic metadata like label and description.
+
+You must have Data Cloud and Tableau Next enabled in your org and the AppFrameworkManageApp user permission to modify apps. The template ID must match the app's current template - you cannot change the underlying template an app is based on.
+
+# flags.target-org.summary
+
+Login username or alias for the target org.
+
+# flags.target-org.description
+
+The target org to connect to for upgrading the app.
+
+# flags.api-version.summary
+
+Override the API version used for API requests.
+
+# flags.api-version.description
+
+Override the API version used for orchestrator API requests. Use this flag to specify a particular API version when the default version doesn't work with your org's configuration.
+
+# flags.app-id.summary
+
+ID of the app to upgrade.
+
+# flags.app-id.description
+
+The unique identifier of the app to upgrade.
+
+# flags.app-name.summary
+
+Name of the app to upgrade.
+
+# flags.app-name.description
+
+The name of the app to upgrade.
+
+# flags.template-id.summary
+
+ID of the template to use for the upgrade.
+
+# flags.template-id.description
+
+The unique identifier of the template to use for upgrading the app. This must match the app's current template ID. Template upgrades run the template's defined upgrade chains to reconfigure or update the app. Use "sf orchestrator template list" to find available template IDs.
+
+# flags.template-values.summary
+
+Template-specific configuration values as JSON.
+
+# flags.template-values.description
+
+A JSON object containing template-specific configuration values to pass to the upgrade chain. The available values depend on the template's variable definitions. For example: '{"dataSource":"mySource","refreshInterval":30}'. These values customize how the template upgrade chain configures the app.
+
+# flags.runtime-method.summary
+
+Runtime method for the upgrade execution.
+
+# flags.runtime-method.description
+
+Specifies how the upgrade chain should be executed. Use 'sync' for synchronous execution (wait for completion) or 'async' for asynchronous execution (run in background). This affects how long the command takes to complete and how errors are handled.
+
+# flags.log-level.summary
+
+Log level for the upgrade execution.
+
+# flags.log-level.description
+
+Sets the logging level for the upgrade chain execution. Higher levels provide more diagnostic information: 'debug' (most verbose), 'info' (normal), 'warn' (warnings only), or 'error' (errors only). Use 'debug' when troubleshooting upgrade issues.
+
+# flags.chain-name.summary
+
+Specific chain name to execute for the upgrade.
+
+# flags.chain-name.description
+
+The name of the specific upgrade chain to execute. If not specified, the template's default upgrade chain will be used. Different chains may perform different types of upgrades or configurations within the same template.
+
+# noAppSpecified
+
+No app specified for upgrade. You must specify either an app ID with --app-id or an app name with --app-name.
+
+# noAppFound
+
+No app found with the specified ID or name.
+
+# invalidTemplateValues
+
+Invalid template values JSON. Please provide a valid JSON object for --template-values.
+
+# fetchingApp
+
+Fetching app details...
+
+# upgradingApp
+
+Upgrading app...
+
+# upgradeSuccess
+
+Successfully upgraded app: %s
+
+# error.UpgradeError
+
+Failed to upgrade app: %s
+
+# error.UpgradeError.Actions
+
+- Verify that you have permission to modify apps in the target org
+- Check that the app exists and is accessible
+- Ensure the template ID matches the app's current template
+- Verify the template values are valid JSON and match expected variables
+- Check that Data Cloud and Tableau Next are enabled in your org
+- Try using a different API version with --api-version
+- Verify your authentication and org connection are valid
+
+# examples
+
+- Upgrade an app with its current template:
+
+  <%= config.bin %> <%= command.id %> --target-org myOrg --app-id 1zAxx000000000123 --template-id 1zDxx000000001EAA
+
+- Upgrade an app with new template values:
+
+  <%= config.bin %> <%= command.id %> --target-org myOrg --app-name "My App" --template-id 1zDxx000000001EAA --template-values '{"dataSource":"newSource","refreshInterval":60}'
+
+- Upgrade an app with async execution:
+
+  <%= config.bin %> <%= command.id %> --target-org myOrg --app-id 1zAxx000000000123 --template-id 1zDxx000000001EAA --runtime-method async --log-level debug
+
+- Upgrade an app using a specific chain:
+
+  <%= config.bin %> <%= command.id %> --target-org myOrg --app-id 1zAxx000000000123 --template-id 1zDxx000000001EAA --chain-name "UpdateConfiguration"

package/messages/orchestrator.template.eval.md

@@ -0,0 +1,58 @@
+# summary
+
+Test JSON transformation rules using the jsonxform/transformation endpoint.
+
+# description
+
+Preview how transformation rules will modify JSON documents before deploying templates. This command uses a sample transformation to test the jsonxform/transformation endpoint with built-in User and Org context variables.
+
+# flags.target-org.summary
+
+Username or alias for the target org; overrides default target org.
+
+# flags.target-org.description
+
+The username or alias of the target org where the jsonxform/transformation endpoint will be called. This org provides the User and Org context variables used in the transformation.
+
+# flags.api-version.summary
+
+Override the api version used for api requests made by this command.
+
+# flags.api-version.description
+
+API version to use for the transformation request. Defaults to the org's configured API version.
+
+# flags.document-file.summary
+
+Path to JSON document file to transform.
+
+# flags.document-file.description
+
+Path to the JSON document file that will be transformed by the rules.
+
+# flags.values-file.summary
+
+Path to JSON values file for variables.
+
+# flags.values-file.description
+
+Path to JSON file containing variables used in transformations.
+
+# flags.definition-file.summary
+
+Path to JSON rules definition file.
+
+# flags.definition-file.description
+
+Path to JSON file containing transformation rules and definitions.
+
+# examples
+
+- Test JSON transformation with document file only:
+  <%= config.bin %> <%= command.id %> --document-file ./document.json --target-org myorg
+
+- Test with document, values, and rules files:
+  <%= config.bin %> <%= command.id %> --document-file ./document.json --values-file ./values.json --definition-file ./rules.json --target-org myorg
+
+- Test with specific API version:
+  <%= config.bin %> <%= command.id %> --document-file ./document.json --target-org myorg --api-version 60.0