Valores predeterminados de directivas y directivas personalizadas

En este artículo se describe cómo se pueden utilizar las directivas en las aplicaciones ISV empaquetadas.

Cambiar valores predeterminados de directivas para las aplicaciones Premium no administradas

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 para aplicaciones Android y Directivas MDX para aplicaciones iOS.
3. Incluya el archivo predeterminado de directiva en los recursos de la aplicación cuando cree la aplicación Premium.

Crear directivas personalizadas

Los archivos de directivas ubicados en 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 Citrix Endpoint Management. 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 de 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 Empaquetar aplicaciones iOS de empresa mediante línea de comandos y Empaquetar 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 Citrix Endpoint Management, cargue la aplicación en Endpoint Management.

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 Citrix Endpoint Management. 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 Citrix Endpoint Management.
• 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 Citrix Endpoint Management.

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

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

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