Richtlinienstandardwerte und benutzerdefinierte Richtlinien

Dieser Artikel beschreibt, wie Sie mit Richtlinien in Ihren gewrapten ISV-Apps arbeiten können.

  • Ändern von Richtlinienstandardwerten für nicht verwaltete Premium-Apps

Das MDX App SDK enthält die folgenden Richtliniendateien, die Richtlinienstandardwerte nur für nicht verwaltete Premium-Apps festlegen.

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

Alle Richtlinien in diesen Dateien sind deaktiviert. Alle Richtlinien, die nicht in der Datei enthalten sind, werden für nicht verwaltete Premium-Apps ignoriert.

Sie können die Standardeinstellungen wie folgt ändern.

  1. Erstellen Sie eine Sicherungskopie aller Standardrichtliniendateien, die Sie ändern möchten, falls Sie diese später benötigen.
  2. Um einen Richtlinienstandardwert für ISV-Apps zu ändern, verwenden Sie die in der MDX Toolkit-Dokumentation angegebenen Richtlinienwerte unter MDX-Richtlinien für Android-Apps und MDX-Richtlinien für iOS-Apps.
  3. Fügen Sie die Standardrichtliniendatei zu Ihren App-Ressourcen hinzu, wenn Sie die Premium-App erstellen.

Erstellen benutzerdefinierter Richtlinien

  • Die Richtliniendateien im MDX Toolkit bieten vollständige Definitionen der Richtlinien, einschließlich der Richtlinienbezeichnung und des Hilfetexts, die in der Citrix Endpoint Management-Konsole angezeigt werden. Wenn Sie eine App wrappen, werden diese Richtlinien in die generierte .mdx-Datei aufgenommen. Sie können diesen Dateien benutzerdefinierte Richtlinien hinzufügen, die sich im Installationsordner des MDX Toolkit unter Applications/Citrix/MDXToolkit/data befinden.

    1. Erstellen Sie eine Sicherungskopie aller Richtliniendateien, die Sie ändern möchten, falls Sie diese später benötigen.
    1. Um Richtlinien zu den Richtlinien-XML-Dateien hinzuzufügen, verwenden Sie die im nächsten Abschnitt “Richtlinienformate” bereitgestellten Formate.
    1. Wenn Sie Ihre App wrappen, geben Sie den Speicherort Ihrer geänderten Richtlinien-XML-Datei an, indem Sie die Option -policyxml in der Wrapping-Befehlszeile angeben:

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

    Details zur Verwendung der Befehlszeile zum Wrappen von ISV-Apps finden Sie unter Enterprise iOS-App-Wrapping über die Befehlszeile und ISV Android-App-Wrapping mit der Befehlszeile

  1. Um die Richtliniennamen, Beschreibungen und Werte in der Citrix Endpoint Management™-Konsole zu überprüfen, laden Sie Ihre App in Endpoint Management hoch.

Richtlinien für das Hinzufügen von Richtlinien

  • Ändern Sie nur die fett dargestellten Elemente.
  • Der Wert des PolicyName-Elements ist der Name, der von Ihrer App aufgerufen wird.
  • Der Wert des PolicyCategory-Elements ist der Kategoriename, unter dem die Richtlinie in der Citrix Endpoint Management-Konsole aufgeführt wird. Um Kategorienamen nachzuschlagen, sehen Sie sich die CategoryId-Werte im Abschnitt <Category> der MDX-Richtliniendateien an.
  • Der Wert des PolicyDefault-Elements ist die Standardeinstellung Ihrer Richtlinie.
  • Die POLICY_ID in <Title res_id=”POLICY_ID”> ist eine eindeutige ID, die für die Richtlinie verwendet wird. Die ID muss mit einem Buchstaben beginnen, darf keine Leerzeichen enthalten und darf nur Buchstaben, Zahlen oder den Unterstrich enthalten.
  • Der Wert des Title-Elements ist die Richtlinienbezeichnung, die in der Citrix Endpoint Management-Konsole angezeigt wird.
  • Die POLICY_DESC_ID in <Description res_id=”POLICY_DESC_ID”> ist eine eindeutige ID für die Richtlinienbeschreibung. Die ID muss mit einem Buchstaben beginnen, darf keine Leerzeichen enthalten und darf nur Buchstaben, Zahlen oder den Unterstrich enthalten.
  • Der Wert des Description-Elements ist die Richtlinienbeschreibung, die in der Citrix Endpoint Management-Konsole angezeigt wird.

Zeichenfolge

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

Boolesch

<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-->
Richtlinienstandardwerte und benutzerdefinierte Richtlinien