Valores predeterminados de directivas y directivas personalizadas

27 de febrero de 2018

En este artículo se describe cómo puede trabajar con las directivas en las aplicaciones ISV empaquetadas.

Cambio de valores predeterminados de directivas para las aplicaciones Premium no administradas

El MDX App SDK incluye los siguientes archivos de directiva que especifican los valores predeterminados de las directivas solo para aplicaciones Premium no administradas.

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

Todas las directivas de esos archivos están inhabilitadas. Se ignoran todas las directivas que no consten en el archivo cuando se trate de aplicaciones Premium no administradas.

Puede cambiar la configuración predeterminada de la siguiente manera.

  1. Haga una copia de seguridad de cualquier archivo predeterminado de directiva que vaya a cambiar, por si lo necesita más tarde.
  2. Para cambiar un valor predeterminado de directiva para aplicaciones ISV, use los valores de directiva especificados en la documentación del MDX Toolkit, concretamente en Directivas MDX de XenMobile para aplicaciones Android y Directivas MDX de XenMobile para aplicaciones iOS.
  3. Incluya el archivo predeterminado de directiva en los recursos de la aplicación cuando cree la aplicación Premium.

Creación de directivas personalizadas

Los archivos de directivas ubicados en el MDX Toolkit proporcionan definiciones completas de las directivas, incluida la etiqueta de la directiva y la ayuda de directiva que aparece en la consola de XenMobile. Al empaquetar una aplicación, estas directivas se incluyen en el archivo MDX generado. Puede agregar directivas personalizadas a estos archivos, que se encuentran en la carpeta de instalación del MDX Toolkit en Applications/Citrix/MDXToolkit/data.

  1. Haga una copia de seguridad de cualquier archivo de directiva que vaya a cambiar, por si lo necesita más tarde.

  2. Para agregar directivas a los archivos XML de directiva, use los formatos proporcionados en el siguiente apartado “Formatos de directiva”.

  3. Cuando empaquete su aplicación, especifique la ubicación de su archivo XML de directiva modificado. Para ello, incluya la opción -policyxml en la línea de comandos de empaquetado:

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

    Para obtener más información sobre el uso de la línea de comandos para empaquetar aplicaciones ISV, consulte Empaquetado de aplicaciones ISV para iOS mediante línea de comandos y Empaquetado de aplicaciones ISV para Android mediante línea de comandos.

  4. Para verificar los nombres, las descripciones y los valores de la directiva en la consola de XenMobile, cargue la aplicación en XenMobile. Es uno de los pasos de publicación indicado en Publicación de una aplicación Android y Publicación de una aplicación iOS.

Directrices para agregar directivas

  • Cambie solo los elementos que aparecen en negrita.
  • El valor del elemento PolicyName es el nombre llamado desde la aplicación.
  • El valor del elemento PolicyCategory es el nombre de categoría en que se incluirá la directiva en la consola de XenMobile. Para buscar los nombres de las categorías, consulte los valores CategoryId en la sección <Category> de los archivos de directivas MDX.
  • El valor del elemento PolicyDefault es la configuración predeterminada de la directiva.
  • El elemento POLICY_ID en <Title res_id=”POLICY_ID”> es un identificador único que se utiliza para la directiva. El ID debe comenzar por una letra, no puede incluir espacios; solo puede incluir letras, números o caracteres de subrayado.
  • El valor del elemento Title es la etiqueta de la directiva que aparece en la consola de XenMobile.
  • El elemento POLICY_DESC_ID en <Description res_id=”POLICY_DESC_ID”> es un identificador único para la descripción de la directiva. El ID debe comenzar por una letra, no puede incluir espacios; solo puede incluir letras, números o caracteres de subrayado.
  • El valor del elemento Description es la descripción de la directiva que aparece en la consola de XenMobile.

Cadena

<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>

Booleano

<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>