Configuration des propriétés de MobileFirst®

Configurez les propriétés MobileFirst® pour ajouter vos préférences à la page de portail.

Avant de commencer

Le module wp_worklight exige un module wl_config défini dans le fichier PortalServer_root\theme\wp.theme.worklight.ext\installedApps\wp.theme.worklight.ext.ear\wp.theme.worklight.ext.war\WEB-INF\plugin.xml.

Procédure

Utilisez le module wl_config pour charger les propriétés de configuration de MobileFirst®.

    <extension point="com.ibm.portal.resourceaggregator.module" id="wl_portal_config" >
        <module id="wl_config">
        	<runtimeActivation>
				<condition deviceClass="worklight"/>
			</runtimeActivation>
			
            <contribution type="config">
                <sub-contribution type="config_dynamic">
                    <uri value="wl:id" />
                </sub-contribution>
            </contribution>
        </module>
    </extension>

Pour activer les propriétés de configuration de MobileFirst®, ajoutez le paramètre "?uri=wl:id:appid" à l'URL à partir de l'application hybride, le paramètre appid étant remplacé par l'ID d'application en cours dans MobileFirst®.

Une fois l'activation effectuée, les propriétés de configuration de MobileFirst® sont injectées de manière dynamique à partir du fichier HTML d'application dans la page de portail. Par exemple:

<script>
  // Define WL namespace.
  var WL = WL ? WL : {};
  /**  * WLClient configuration variables.  * Values are injected by the deployer that packs the gadget.  */  
  WL.StaticAppProps = {    "APP_DISPLAY_NAME": "DemoApp",    
						   "APP_SERVICES_URL": "\/apps\/services\/",    
						   "ENVIRONMENT": "iphone",    
						   "LOGIN_DISPLAY_TYPE": "embedded",    
						   "POSTFIX_APP_SERVICES_URL": "\/apps\/services\/",    
						   "POSTFIX_WORKLIGHT_ROOT_URL": "\/apps\/services\/api\/DemoApp\/iphone\/",    
						   "WORKLIGHT_ROOT_URL": "\/apps\/services\/api\/DemoApp\/iphone\/" 
					  };
</script>

Configurez les propriétés de configuration de MobileFirst® via JavaScript.
Par exemple, utilisez le code suivant :
```
WL.StaticAppProps.ENVIRONMENT
```

Si votre application a besoin de propriétés de configuration supplémentaires par rapport aux propriétés de base fournies, vous pouvez facilement les combiner dans cet objet WL.StaticAppProps avec JavaScript.

Par exemple:

<script type="text/javascript">
i$.bindDomEvt(window, "onload", function(evt) {
	if (window.WL && window.WL.StaticAppProps) {
		window.WL.StaticAppProps.APP_VERSION = "1.0";
		window.WL.StaticAppProps.WORKLIGHT_PLATFORM_VERSION = "7.0.0";
	}
});
</script>

Injectez le code JavaScript que vous avez créé dans votre page à partir de votre thème. Vous pouvez ajouter le code que vous venez de créer à un des fichiers .jsp de votre zone de contenu dynamique existante. Sinon, vous pouvez ajouter le code JavaScript à un fichier HTML dans un module existant ou nouveau.