EMMLProfile Meta Tag

PocketBrowser 3.x API

The EMMLProfile Meta Tag is an action tag used to manage EMML profile pages.

EMMLProfile (META Tag) Syntax
<META HTTP-Equiv="EMMLProfile" content="parameter:value">


Items listed in this section indicate parameters, or attributes which can be set.

Name Possible Values Description
Default Value
name:[Value] [optional name] (see remarks below) Imports the EMML profile page stored at the local specified by "import". Nb. This parameter should come before the related import method. N/A
import:[Value] url('URI') http or file location of the .emmp file containing the EMML profiles to be imported. N/A
clear:[Value] [optional name] (see remarks below) Clears the currently loaded EMML profiles. N/A
apply:[Value] [profile class name] Applies the EMML profile with the class name specified. N/A
Copy parameters template to clipboard: Copy META Tag template to clipboard META Tags Copy Javascript template to clipboard Javascript

The following example imports an EMML profile page into the temporary, unnamed space.

<META HTTP-Equiv="EMMLProfile" Content="import:url('http://myserver/scannerparams.emmp');">
Copy example to clipboard Copy example to clipboard

The following example imports an EMML profile page into a page persistent, named space.

<META HTTP-Equiv="EMMLProfile" Content="name:scanner_params;import:url('http://myserver/scannerparams.emmp');">
Copy example to clipboard Copy example to clipboard

The following example applies two profile classes from the temporary, unnamed space.

<META HTTP-Equiv="EMMLProfile" Content="apply:default_decorders;">
<META HTTP-Equiv="EMMLProfile" Content="apply:inventory_decorders;">
Copy example to clipboard Copy example to clipboard

The following example applies two profile classes from page persistent, named space.

<META HTTP-Equiv="EMMLProfile" Content="apply:scanner_params.default_decorders;">
<META HTTP-Equiv="EMMLProfile" Content="apply:scanner_params.inventory_decorders;">
Copy example to clipboard Copy example to clipboard

The following is an example of an EMML Profile page.

.default_decoders
{
scanner-alldecoders: disabled;
scanner-code128other128: false;
scanner-code128maxlength: 10;
scanner-code128minlength: 1; 
scanner-code128: enabled;
}

.inventory_decoders
{
scanner-ean13converttocode128: true;
scanner-ean13: enabled;
scanner-ean8: enabled;
scanner-i2of5: enabled; 
scanner-code128: enabled;
}
Copy example to clipboard Copy example to clipboard
Named Profile Pages
Normally, when importing a profile page, the imported profiles will be cleared from memory when the page is navigated away from. If you provide a name when importing a profile page, the imported profiles will not be cleared on page navigation and you will be able to reference them until you manually clear the profiles. To reference a named imported profile, prefix the profile class name with the name you supplied when importing the profile page (see example above). Naming profile pages can improve performance. If you include many profiles for your application within the profile page, it will only have to be downloaded, parsed and imported the once. It is often also preferable to maintain a central location for all your EMML.

Importing Local Profiles
Importing profiles from a file:// location will cause the profile to be moved from its previous location, not copied.


Supported Platforms Windows CE, Windows Mobile, Windows Mobile SE
Persistence Tag is page specific except where a named EMML profile set is imported
Min. Requirements None