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

Managing the Registry

Owned by Former user (Deleted)
Last updated: Jun 11, 2013Version comment
6 min read

This page describes how to manage a registry using Developer Studio. It includes the following sections:

Displaying the Registry Browser

To work with the registry, you first display the Registry Browser by choosing Window -> Open Perspective -> Other -> WSO2 Registry.

Adding a remote registry instance

Right-click the Registry Browser and enter the information for connecting to the registry (the default information is already filled in). In the path text box, you can either specify the root (/) to get the full registry or specify any other valid registry path for a collection (e.g., /_system/local, /_system, etc). Elements down the given path will be loaded in the Registry Browser.

When you expand the added registry instance, you will see two main nodes called UserStore and Repository. When you right-click the UserStore node, you get access to user management functionality. When you right-click the Repository node, get access to repository functionality.

You can refresh the registry at any time to get the latest updates by right-clicking the registry and clicking Refresh.

Linking the repository tree with the editor

You can double-click a resource to display it in an editor window. To help you identify which resource's editor window you're working with when you have multiple editor windows open, you can enable Link with Editor mode to highlight the resource in the Repository tree when you switch to its window. To enable this mode, right-click the Repository node and click Link with Editor.  

Managing collections and resources

A collection allows you to group resources. When you right-click a location in the repository, you can add a collection and then add resources to it. You can also edit and delete resources and collections and their metadata and community features. For more information on these items, see the Governance Registry documentation.

To add a new collection:
  1. Right-click the registry path location where you want to add the collection and click Add a new collection
  2. Specify the name, media type (choose Other to specify a type not in the list), and description for this collection.
  3. Click Save.
To add a resource to a collection:
  1. Right-click the collection where you want to add a resource and click Add a new resource.
  2. In the Method list, choose one of the following:
    • Upload Content From File: Browse to the file that contains the resource you want to add, verify that the information that's filled in is correct, and then enter a description for this resource.
    • Create Custom Content: Enter the name, media type, and description for this resource, and then enter the custom content in the Content field.
    • Import Content from URL: Enter the URL that contains the content you want to add (be sure the URL does not contain characters like ~), verify that the media type is correct, and then enter a name and description for this resource.
  3. Click Save.
    The resource appears in the collection you selected.
To add multiple files or a folder to a collection:
  1. Right-click the collection to which you want to add the files or folder, click Add Local Resources, and then click either multiple files or folder.
  2. Select the files or folder you want to add and click Open.
  3. Click OK to confirm that you want to add the files or folder.
To edit a resource:
  • Right-click the resource and click Information to see details about the resource and to edit it as needed.
To delete a resource from a collection:
  • Right-click the resource, click Delete, and then click Yes to confirm that you want to delete this resource.
To add metadata for a collection or resource:
  1. Right-click the collection or resource to which you want to add metadata (properties, dependencies, and associations), and then click Metadata.
  2. Do one of the following, depending on the type of metadata you want to add:
    • Click Add a Property, click in the table, and then enter the property name and value.
    • Click Add a Dependency, click in the table and then click the ... button on the far right, navigate to the dependency in the registry, and click OK.
    • Click Add an Association, click in the table and then click the ... button on the right edge of the Path column, navigate to the association in the registry, enter the association type, and click OK.
  3. To add another metadata item, click below it in the table and repeat these steps.
  4. To delete a metadata item after adding it, click it in the table and click Delete. You must save the collection or resource before the item disappears from the list. Before you save, you can click Undelete to restore the item.
  5. Click File -> Save to save the collection or resource.
To add community features for a collection or resource:
  1. Right-click the collection or resource to which you want to add community features (comments, tags, or ratings), and then click Community.
  2. Do one of the following, depending on the type of community feature you want to add:
    • Click Add Comment, click in the table, and then enter type the comment. Press Enter to add another comment.
    • Click Add a Tag, click in the table, and then type the tag, which can be any unique string value. Press Enter to add another tag.
    • Click Add a Rating and then select a rating from the My Rating list.
  3. To delete a comment or tag after adding it, click it in the table and click Delete. You must save the collection or resource before the item disappears from the list. Before you save, you can click Undelete to restore the item.
  4. Click File -> Save to save the collection or resource.
To export a resource or collection:

  1. Right-click the resource or collection you want to export and click Export To.

  2. Specify the location in the registry where you want to export the resource or collection and click OK.

  3. Click OK to confirm that you want to export.

To import a resource or collection:

  1. Right-click the collection where you want to import the resource or collection and click Import From. 

  2. Specify the location of the resource or collection in the registry that you want to import, and then click OK.

  3. Click OK to confirm that you want to import. 

To move a resource or collection:
  1. Click and drag the resource or collection to its new location in the same or different registry.
  2. Click OK to confirm that you want to move the item.
To modify permissions for a resource or collection:
  1. Right-click the resource or collection and click Modify Permissions.
  2. For each role, specify whether users with that role can read, write, delete, or authorize the item, and then click OK.  

When browsing the registry in the management console, you can verify that the permissions for this item have changed.

Using source control

If you have a project defined in the workspace, you can check out a resource or collection to a local project, update it, and then check it back in.

To check out to a local project:
  1. Right-click the resource or collection and click Checkout.
  2. Specify the location within the local project where you want to check out the item and click OK.

You can now open the resource or collection in the Project Explorer, make your changes, and check it back in. You can only check in an entire folder, not a single resource.

To check in the updated folder:
  1. In the Project Explorer, right-click the folder where you made the changes (it will be displayed with a yellow icon to indicate that it's been updated) and click WSO2 Registry -> Commit changes as user.
  2. Specify the credentials for the user you are checking in as and click Commit.

At any time, you can right-click a resource or collection in the Project Explorer and click WSO2 Registry -> Show in Registry to display the item in the Registry Browser.

To view and restore a previous version of a resource:
  1. Return to the WSO2 Registry perspective by clicking WSO2 Registry in the perspective bar in the upper right corner.
  2. Right-click the resource and click Versions. Up to the last five versions are available.
  3. Click the version you want, and then click either View to display the content of that version or click Restore to use the selected version as the current version.

Managing users and roles

The UserStore node provides functionality for adding and modifying users and roles.

To add a user:
  1. Right-click Users and click Add User. 
  2. Enter a unique user name, and then type and re-type the user's password.
  3. Click Finish.
To add a role:
  1. Right-click Roles and click Add Role.
  2. Enter a unique name for this role and click Next.
  3. Select the permissions that will apply to users with this role and click Finish.
To modify a user or role:
  1. Right-click the user or role you want to change, and click Modify.
  2. Make the necessary changes and click Finish.
To change a role's permissions for resources:
  1. Right-click a non-admin role (such as everyone or wso2.anonymous.role) and click Change Permission.
  2. Select one or more resources or collections and click Next.
  3. Select the permissions you want to grant for these resources or collections and click Finish.

 

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