Migrating Mashups to Use a New Feature or Namespace

To use a new feature from the EMML schema in an existing mashup script, you must update the EMML namespace in your mashup script. You may also need to change the schema location.

For the Mashup Editor, the new schema is installed with the new version of MashZone NextGen.

1. Open the EMML file in the Mashup Editor.

2. In the <mashup> element, change the namespace in the following attributes to match the new EMML version:

xmlns = the default namespace

xsi:schemaLocation = the location of the EMML schema

See EMML Namespaces for a list of supported namespaces. With an original namespace like this:

<?xml version="1.0"?>
<mashup xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.jackbe.com/2008-03-01/EMMLSchema"
xsi:schemaLocation="http://www.jackbe.com/2008-03-01/EMMLSchema
../xsd/EMMLSpec.xsd"
name="myMashup">

You would change the namespace to something like this:

3. If the schema file name or location has changed, change the path information in the xsi:schemaLocation attribute.

With an original xsi:schemaLocation like this:

<?xml version="1.0"?>
<mashup
xmlns="http://www.jackbe.com/2007-09-15/JMMLSchema"
xsi:schemaLocation="http://www.jackbe.com/2007-09-15/JMMLSchema
../xsd/JMMLSpec.xsd"

You would change it to something like this:

4. If the mashup uses macros or you want to add macros, you must add or update the xmlns:macro attribute.

You would add this attribute or change it to something like this:

<?xml version="1.0"?>
<mashup xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.openmashup.org/schemas/v1.0/EMML"
xsi:schemaLocation="http://www.openmashup.org/schemas/v1.0/EMML
../xsd/EMMLSpec.xsd"
xmlns:macro="http://www.openmashup.org/schemas/v1.0/EMMLMacro"
name="myMashup">

5. If the mashup or macros use MashZone NextGen extension elements, such as <presto:presto-meta>, you must add or update the xmlns:presto attribute.

For example:

6. Edit the mashup script, if needed, and save your changes.

7. Test the new mashup script. See Test Mashup Scripts or Macros in Mashup Editor or Testing Mashup Scripts from the Command Line for instructions.