(feat) Add interstitial system admin page that links to non-core apps

[hadijahkyampeire]

Requirements

• This PR has a title that briefly describes the work done, including the ticket number if there is a ticket.
• My work conforms to the OpenMRS 3.0 Styleguide.
• I checked for feature overlap with existing widgets.

Summary

• This PR adds a new admin config app which has a page where the user can navigate to different apps outside the core 3.x
• It also adds a new menu item to our App switcher named System Administration which links to the above-mentioned page.
• It also creates an ExtensionSlot for card links that all apps that want to add card links can use. I have currently added the OCL cardLink since they are in the same repo.

Usage e.g in the Form builder

• Create a component with such a link

import React from "react";
import { useTranslation } from "react-i18next";
import { Layer, ClickableTile } from "@carbon/react";
import { ArrowRight } from "@carbon/react/icons";

const FormBuilderCardLink: React.FC = () => {
  const { t } = useTranslation();
  const header = t("manageForms", "Manage Forms");
  return (
    <Layer>
      <ClickableTile
        id={`clickable-tile-${header}`}
        href={`${window.spaBase}/form-builder`}
        target="_blank"
        rel="no-refferer"
      >
        <div>
          <div className="heading">{header}</div>
          <div className="content">{t("formBuilder", "Form Builder")}</div>
        </div>
        <div className="iconWrapper">
          <ArrowRight size={16} />
        </div>
      </ClickableTile>
    </Layer>
  );
};

export default FormBuilderCardLink;

And add an extension in index.ts like

      {
        id: "system-administration-form-builder-card-link",
        slot: "system-admin-page-card-link-slot",
        load: getAsyncLifecycle(
          () => import("./form-builder-admin-card-link.component"),
          options
        ),
        online: true,
        offline: true,
      },

Screenshots

Issue

None.

• https://issues.openmrs.org/browse/O3-2126

[hadijahkyampeire]

@ibacher please review my PR.

[hadijahkyampeire]

@ibacher I am not sure why tests are failing, but they probably need a rerun but I am not able to trigger that.

[jayasanka-sack]

Hi @hadijahkyampeire, it seems the lock file is not up to date. Could you please run yarn install and push changes? I hope it should fix builds

[hadijahkyampeire]

Thanks @jayasanka-sack I have done that, hopefully the tests will pass.

[ibacher]

Thanks @hadijahkyampeire! Looking very good!

One thing: do we need the config-schema copy.ts file?

[ibacher]

Suggested change

	<ClickableTile id={`clickable-tile-${header}`} href={`${window.spaBase}/ocl`} target="_blank" rel="norefferer">
	<ClickableTile id={`clickable-tile-ocl`} href={`${window.spaBase}/ocl`} target="_blank" rel="norefferer">

[hadijahkyampeire]

Thanks @denniskigen and @ibacher

[ibacher]

@hadijahkyampeire Please remember to select Squash and Merge when you merge a PR.

[hadijahkyampeire]

oh, yah, sorry, I thought it was the default.

[denniskigen]

Is the next step adding this package to the frontendModules in spa-build-config.json, @ibacher?

[ibacher]

Yes, otherwise it won't show up by default. Try to add it near the openconceptlab line (I'm trying to keep modules from monorepos near each other).