com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_links' is unknown.

Creating and Publishing a Gadget

Note that this feature is in the Beta stage.

Creating a gadget

Follow the instructions below to create a gadget:

The gadget needs to be created as part of a microsite.

  1. Access the UES portal.
  2. On the Create menu, click Microsite.
  3. Enter a title for the dashboard.
    Only alphanumerical and - hyphen is allowed to be entered as the dashboard title. 
  4. Click Create new app.
  5. Click and open the folder containing the name of the newly created microsite.
  6. Open the jaggery.conf file in the Jaggery Web IDE and remove the following authentication snippet from the file:

    "loginConfig": {
      "authMethod": "BASIC"
    },
    "securityConstraints": [
      {
        "securityConstraint": {
          "webResourceCollection": {
            "name": "nnn",
            "urlPatterns": [
              "/*"
            ],
            "methods": [
              "GET",
              "POST",
              "PUT",
              "DELETE",
              "HEAD",
              "OPTIONS",
              "TRACE",
              "CONNECT",
              "PATCH"
            ]
          },
          "authRoles": [
            "private_admin"
          ]
        }
      ]
    }
  7. Navigate to the UES portal.

  8. Click Add a new file.

  9. Rename the file as a XML file (e.g., gadget.xml)
  10. Click Edit.
  11. Enter the customized code in the file.
    Use the tools in the editor when necessary.
  12. Click Save.
  13. Publish the gadget.

Publishing a gadget to the store

If there are multiple XML files with multiple gadget definitions, each of the gadget definition files need to be published separately to the store.

Follow the instructions below to publish a gadget to the store:

  1. Access the UES portal.
  2. On the My Items menu, click on the microsite folder.
     
  3. Click on the XML file that contains the gadget definition.
  4. Click Publish.
    The Published Settings page will appear.
  5. Select "gadget" as the Publish as option.

  6. Select the permission type allowed for this gadget.
    Users who have the edit permission will be able to edit the gadget. However, the changes will only be visible to the user who made the changes and will not be visible publicly.  

  7. Enter a name for the gadget.
  8. Enter the gadget version.
  9. Enter the URL that will be used to publicly access the gadget.
    For example:
    If your gadget definition is defined in a file named publisher-gadget.xml and this file is within a parent folder named publisher-gadget, then you should enter your gadget URL in one of the following formats:
    • https://localhost:9443/publisher-gadget/publisher-gadget.xml
    • http://localhost:9763/publisher-gadget/publisher-gadget.xml
  10. Enter a description on the gadget.
  11. Enter the URL of the thumbnail.
  12. Enter the URL of the image.
  13. Click Publish.
com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_links2' is unknown.