Skip to content

Create Local Registry Entries

The local registry acts as a memory registry where you can store static content as a key-value pair. This could be a static text specified as inline text, static XML specified as an inline XML fragment, or a URL (using the src attribute).

<localEntry key="version" xmlns="http://ws.apache.org/ns/synapse">0.1</localEntry>

<localEntry key="validate_schema" xmlns="http://ws.apache.org/ns/synapse">
    <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" ...
    </xs:schema>
</localEntry>

<localEntry key="xslt-key-req" src="file:repository/samples/resources/transform/transform.xslt" xmlns="http://ws.apache.org/ns/synapse"/>

This is useful for the type of static content often found in XSLT files, WSDL files, URLs, etc. Local entries can be referenced from mediators in the Micro Integrator mediation flows and resolved at runtime. These entries are top-level entries and are globally visible within the entire system. Values of these entries can be retrieved via the extension XPath function synapse:get-property(prop-name), and the keys of these entries could be specified wherever a registry key is expected within the configuration. A local entry shadows any entry with the same name from a remote Registry.

Instructions

Create the local entry

Follow these steps to create a new local entry.

  1. Click on the + mark next to Local Entries in the Project Explorer.

  2. Select one of the following types of local entries.

    • In-Line Text Entry: Type the text you want to store
    • In-Line XML Entry: Type the XML code you want to store
    • Source URL Entry: Type or browse to the URL you want to store

  3. Enter a unique name for the local entry and specify the values.

  4. Typically, a Local Entry is saved in the src/main/wso2mi/artifacts/local-entries directory. However, you can choose to save the Local Entry to the registry directory (src/main/wso2mi/resources/registry) if needed. To do this, select the appropriate option, which will display the form shown below.

  5. Click Create.

Update the properties

Open the new Local Entry artifact from the Project Explorer. You can use the Form view or the Source view to update Local Entry properties.

Use a local entry

After you create a local entry, you can reference it from a mediator in your mediation workflow. For example, if you created a local entry with XSLT code, you can add an XSLT mediator to the workflow and then reference the local entry as follows:

  1. Open to the Design View of your mediation sequence.

  2. Add an XSLT Mediator to the mediation flow as shown below.

  3. It will open up the Properties tab.

  4. Select the XSLT Static Schema Key and enter other properties.

  5. Click Submit.

Info

If you want to add local entries before deploying the server, you can add them to the top-level bootstrap file synapse.xml, or separate XML files in the local-entries directory, which are located under MI_HOME\repository\deployment\server\synapse-configs\default. When the server is started, these configurations will be added to the registry.

Examples