SA Extension Administration overview

Infor Consulting Services or your in-house development team can use SA Extension Administration to manage and plug in custom extensions. They can create, copy, import, modify, and delete extensions, and maintain a revision history. Extension types include new functions, new views, existing views, JavaScript, CSS, and JSON at the company or system level.

Developers can also use SA Extension Administration to customize grids, add controllers to modals and panels, and add color and define hot keys on views throughout the application.

This feature is part of the standard product, but it requires an advanced understanding of JavaScript to fully use it. We recommend that you engage Infor Consulting Services to learn how to use the toolkit, or to have their developers extend Distribution SX.e for your business requirements.

You can use the Compare With option to compare extensions by selecting one or two extensions. If you select one extension, you can compare the selected extension with an extension from the clipboard, previous version, next version, latest version, or imported version. If you select two extensions, you can compare the selected extensions directly with each other.

The Code Review option is available in the General section of the SA Extension Administration details screen for extension of the JavaScript type. This option allows you to review the JavaScript code defined in the Value section, using the Gen AI functionality. The review results, along with the suggested changes, are displayed in the Code Review section. You can manually apply the recommended changes to the code in the Value section.

Prerequisites for the Code Review process:

• Procure Gen AI license.
• Install all the Gen AI services in the specific tenant.

• Ensure that the INFOROS.GENAI business rule is activated on the SA Business Rule Setup screen.

• Ensure that the saaea-extension-codereview prompt is defined on the SA Table Code Value Setup - GenAI screen.

  Note: You can modify the prompt based on the requirement.

Limitations of Code Review:

• Gen AI content filters can block the output if the code contains sensitive information, and the The generated text has been blocked by our content filters message is displayed.
• Possibility of review suggestions not aligning with Infor Extensibility standards or CSD best practices.

The Export option allows you to export one or more extensions in these formats:

• Binary (Legacy): Use this option to export the extensions as a single binary ZIP file that cannot be extracted manually. This format can only be interpreted, versioned, or scanned from the SA Extension Administration screen.

• Text Files (New): Use this option to export the extensions as a single text-based ZIP file that can be extracted manually. The ZIP file includes:

  • JavaScript, JSON, or CSS files for each extension containing the extension values.
  • Text files for each extension containing the required metadata and the code review results, if available.

  The exported files are named based on the following elements:

  • Extension ID: The Extension ID from the application.

  • Prefix: Possible values:

    • Zero if the extension is at the system level.
    • Company number if the extension is at the company level.
  • Suffix: The revision number of the extension.

  For example, if the Extension ID is ap-apece-detail, the company number is 1000, and the revision number is 5, the files are named as 1000_ap-apece-detail_5.js and 1000_ap-apece-detail_5.txt.

  Text-based exports allow you to perform these actions:

  • Track extensions in source control systems such as Git.
  • Review or audit extension metadata outside the application.
  • Run code verification tools for an extension code.
  Note: If multiple extensions are exported, the ZIP file includes the JavaScript files and the corresponding text files for each extension.

The Import option allows you to import extensions using a ZIP file. The application automatically detects whether the ZIP file is in binary legacy format or text-based format. For text-based imports, the ZIP file must include an extension file (JavaScript, JSON, or CSS) and a corresponding text file containing metadata to process the import file. Filenames must follow the required naming convention.

If duplicate extensions are found during import, a red information icon is displayed in the Exists column, and the extensions are imported as new revisions.

On the SA Extension Administration - Import Extension screen, you can select extension records and use these options:

• Change Active Status: Enables you to modify the extension status.
• Change Level: Enables you to modify the extension level between Company and System.
• Submit: Enables you to save the selected records as new extensions.

You can drill into an import record to view the list of available revisions for the extension on the SA Extension Administration - Import Extension details screen. You can select one or two revisions to compare. If you select one revision, you can compare the selected revision with the revision from the clipboard, previous version, next version, latest version, or import version. If you select two revisions, you can compare the selected versions with each other.