Valeurs par défaut des stratégies et stratégies personnalisées

27 février 2018

Cet article explique comment vous pouvez utiliser les stratégies dans vos applications ISV encapsulées.

Modifier les valeurs par défaut de stratégie pour les applications Premium non gérées

La SDK du Worx App comprend les fichiers de stratégie suivants qui spécifient les valeurs par défaut de stratégie pour les applications Premium non gérées uniquement.

  • Android : Applications/Citrix/MDXToolkit/data/MDXSDK_Android/ default_sdk_policies.xml
  • iOS : Applications/Citrix/MDXToolkit/data/MDXSDK/default_policies.xml

Toutes les stratégies dans ces fichiers sont désactivées. Les stratégies qui ne se trouvent pas dans le fichier sont ignorées pour les applications Premium non gérées.

Vous pouvez modifier les paramètres par défaut comme suit.

  1. Effectuez une copie de sauvegarde des fichiers de stratégie par défaut que vous voulez modifier, dans le cas où vous en auriez besoin plus tard.
  2. Pour modifier une stratégie par défaut pour des applications ISV, utilisez les valeurs de stratégie spécifiées dans la documentation du MDX Toolkit, dans Stratégies MDX XenMobile pour applications Android et Stratégies MDX XenMobile pour applications iOS.
  3. Vous devez inclure le fichier de stratégie par défaut avec les ressources de votre application lorsque vous générez l’application Premium.

Créer des stratégies personnalisées

Les fichiers de stratégie dans le MDX Toolkit fournissent des définitions complètes des stratégies, y compris le nom de la stratégie et le texte d’aide affiché dans la console XenMobile. Lorsque vous encapsulez une application, ces stratégies sont inclues avec le fichier .mdx généré. Vous pouvez ajouter des stratégies personnalisées à ces fichiers, qui sont situés dans le dossier d’installation MDX Toolkit dans Applications/Citrix/MDXToolkit/data.

  1. Effectuez une copie de sauvegarde des fichiers de stratégie que vous voulez modifier, dans le cas où vous en auriez besoin plus tard.

  2. Pour ajouter des stratégies aux fichiers de stratégie XML, utilisez les formats fournis dans « Formats de stratégie » ci-après.

  3. Lorsque vous encapsulez l’application, spécifiez l’emplacement de votre fichier de stratégie XML modifié, y compris l’option -policyxml à l’aide de la ligne de commande d’encapsulation :

    -policyxml /Applications/Citrix/MDXToolkit/data/policy_metadata.xml

    Pour de plus amples informations sur l’utilisation de la ligne de commande pour encapsuler des applications ISV, consultez les sections Encapsulation d’applications ISV iOS à l’aide de la ligne de commande et Encapsulation d’applications ISV Android à l’aide de la ligne de commande.

  4. Pour vérifier les noms, les descriptions et les valeurs de stratégie dans la console XenMobile, chargez l’application sur XenMobile. Cette opération est intégrée aux étapes de publication dans les sections Publication d’une application Android et Publication d’une application iOS.

Recommandations pour ajouter des stratégies

  • Modifiez uniquement les éléments affichés en gras.
  • La valeur de l’élément PolicyName correspond au nom appelé depuis l’application.
  • La valeur de l’élément PolicyCategory correspond au nom de la catégorie dans laquelle la stratégie sera répertoriée dans la console XenMobile. Pour vérifier les noms des catégories, veuillez consulter les valeurs CategoryId dans la section <Category> des fichiers de stratégie MDX.
  • La valeur de l’élément PolicyDefault est le paramètre par défaut de votre stratégie.
  • L’élément POLICY_ID dans <Title res_id=”POLICY_ID”> correspond à un ID unique utilisé pour la stratégie. L’ID doit commencer par une lettre, ne peut pas contenir d’espaces et doit contenir uniquement des lettres, des chiffres ou un trait de soulignement.
  • La valeur de l’élément Title est le nom de la stratégie qui s’affiche dans la console XenMobile.
  • L’élément POLICY_DESC_ID dans <Description res_id=”POLICY_DESC_ID”> correspond à un ID unique utilisé pour la description de la stratégie. L’ID doit commencer par une lettre, ne peut pas contenir d’espaces et doit contenir uniquement des lettres, des chiffres ou un trait de soulignement.
  • La valeur de l’élément Descriptioncorrespond à la description de la stratégie qui s’affiche dans la console XenMobile.

Chaîne

<Policy>
   <PolicyName>PolicyName</PolicyName>
   <PolicyType>string</PolicyType>
   <PolicyCategory>Category_ID</PolicyCategory>
   <PolicyDefault>Value</PolicyDefault>
   <PolicyStrings>
      <Title res_id="POLICY_ID”>Sample String Policy</Title>
      <Description res_id="POLICY_DESC_ID">
          Please enter the policy value.
      </Description>
   </PolicyStrings>
</Policy>

Booléen

<Policy>
   <PolicyName>PolicyName</PolicyName>
   <PolicyType>string</PolicyType>
   <PolicyCategory>Category_ID</PolicyCategory>
   <PolicyDefault>false</PolicyDefault>
   <PolicyStrings>
        <Title res_id="POLICY_ID”>Sample Boolean Policy</Title>
      <BooleanTrueLabel res_id="POLICY_ON">On</BooleanTrueLabel>
      <BooleanFalseLabel res_id="POLICY_OFF">Off</BooleanFalseLabel>
      <Description res_id="POLICY_DESC_ID">
          If On, the app does something.
          If Off, the app does something else.

            Default value is Off.
      </Description>
   </PolicyStrings>
</Policy>

Enum

<Policy>
   <PolicyName>PolicyName</PolicyName>
   <PolicyType>enum</PolicyType>
        <PolicyEnumValues>
         <PolicyEnumValue>
               <PolicyEnumValueId>Value1</PolicyEnumValueId>
            <PolicyEnumValueString res_id="ID_1">Yes</PolicyEnumValueString>
            </PolicyEnumValue>
            <PolicyEnumValue>
               <PolicyEnumValueId>Value2</PolicyEnumValueId>
            <PolicyEnumValueString res_id="ID_2">No</PolicyEnumValueString>
         </PolicyEnumValue>
         <PolicyEnumValue>
            <PolicyEnumValueId>Value3</PolicyEnumValueId>
            <PolicyEnumValueString res_id="ID_3">Maybe</PolicyEnumValueString>
            </PolicyEnumValue>
        </PolicyEnumValues>
   <PolicyCategory>Category_ID</PolicyCategory>
   <PolicyDefault>Value1</PolicyDefault>
   <PolicyStrings>
        <Title res_id="POLICY_ID”>Sample Enum Policy</Title>
      <Description res_id="POLICY_DESC_ID">
          Sample policy description.

             Default value is Yes.
      </Description>
   </PolicyStrings>
</Policy>