Building the SayHi demo CyberApp

This section is a step-by-step guide to building the SayHi demonstration Cyberapp.

Note

If you prefer, you can import the SayHi Cyberapp.

Creating the CyberApp

Create a CyberApp and name it SayHi.

Note

Do not turn on the Connection to Acronis API toggle switch, because SayHi does not need access to the Acronis API.

Adding the CyberApp marketing

Note

For Acronis Partners to be able to find and enable a CyberApp, it must be listed in an Acronis catalog. SayHi must appear in the catalog to enable it (even for a test deployment), so a valid Description is required.

Create a Description and complete the minimum required fields for the Description to be valid. For the purposes of the demo, the content is unimportant, but here is what we used:

  • About CyberApp > Name: Say Hi!

  • About CyberApp > Logo:

    ../../../_images/democyberappicon.png
  • About CyberApp > Catalog card description: Say “Hi!’ to the world!

  • About CyberApp > Detail page title: Say “Hi!’ to the world!

  • About CyberApp > Action button (website): www.demoisv.com

  • Support contant > Company name: DemoISV

Building the CyberApp functionality

  1. Create a Version with explicit partner and customer enablement options.

    Note

    Ensure that the Connection with your platform toggle switch is not turned on, because SayHi does not need access to your platform, and if this toggle swtich is enabled a CyberApp cllback handler is expected.

  2. We named the menu item Say Hi!, and added it to the Acronis Cyber Platform Management menu by selecting Management from the Parent menu item in Protection Console dropdown.
    You can give the menu item any name, and you can add it to whichever Acronis menu you want.
../../../_images/ss-sayhi-build1.gif

Designing the root form

  1. Click uibuilder to design the SayHi UI.

  2. From the CONTENT ELEMENTS menu, drag and drop a Header element onto the form and change the Text field to Instructions.

  3. From the CONTENT ELEMENTS menu, drag and drop a Text element below the header element and change the Text field to Choose a greeting, then click Say Hi!..

  4. From the INPUT CONTROLS menu, drag and drop a Select element below the existing form elements and change both the ID and Label fields to Greeting.

  5. Add Options to the select element. The label and value should be the same for all of them. We added four:

    • Hello, World!

    • Hi, World!

    • Hey, World!

    • Howdy, World!

  6. From the LAYOUT MANAGEMENT menu, drag and drop a Divider element below the existing form elements.

../../../_images/ss-sayhi-build2.gif

Creating the dependent form

To display the greeting that the user choses from the dropdown, we need a dependent form.

  1. Create a dependent form by clicking plus in the Form group area, and name the form Saying Hi!.

  2. Create an input parameter named displaygreeting for the form. You an leave the Default value field empty.

  3. From the CONTENT ELEMENTS menu, drag and drop a Text element below the header element and change the ID field to displaygreeting.

  4. Create a form footer button, change the label to Close and assign the On click property as Close form.

../../../_images/ss-sayhi-build3.gif

Mapping the chosen greeting to the dependent form

We need to open the dependent form we just created, and map the chosen greeting from the Root form dropdown to the displaygreeting text element on the dependent form.

  1. Select Root form in the Form group area.

  2. From the ACTION CONTROLS menu, drag and drop a Button element below the existing form elements and change the Label field to Say Hi!.

  3. In the On click section of the button PROPERTIES, select Open form.

  4. In the Form name dropdown list, select Saying Hi!.

  5. In the Input parameters mapping section of the button PROPERTIES tab, select Greeting from the Model dropdown, and select displaygreeting from the Parameter dropdown.

  6. Click Save changes.

../../../_images/ss-sayhi-build4.gif

Deploying SayHi

Deploy the Description and Version you just created to your test environment.

../../../_images/ss-sayhi-build5.gif

Testing SayHi

  1. Login to Acronis as an administrator.

  2. Select INTEGRATIONS from the menu.

  3. Find the SayHi CyberApp in the catalog.

  4. Click Configure.

../../../_images/ss-sayhi-enable.gif

SayHi is now enabled. The menu item has been added to the Management menu. Click it to use the Cyberapp.