📋 Outlook Add-In (klassisch): Download- und SubmitBox-Buttons anpassen

Diese Anleitung zeigt Ihnen, wie Sie die Texte und Beschreibungen der Download-, SubmitBox- und Senden-Schaltflächen sowie die Blacklist-Nachricht in FTAPI-E-Mails über eine zentrale XML-Datei für das Add-In individuell gestalten.

Einführung zum Customizing

Sie können den Text und die Beschreibungen sowohl der Schaltfläche „Download" als auch der Schaltfläche „SubmitBox" anpassen. Diese Anpassung erfolgt auf Sprachbasis in einer einzigen Konfigurationsdatei für jede Sprache, die Sie in der Anwendung abändern möchten.

Hinweis: Die gewählte Sprache muss vom Outlook-Add-In offiziell unterstützt werden. Derzeit werden primär en-US und de-DE unterstützt.

Anforderungen an die Konfigurationsdatei

  1. Die Konfigurationsdatei MUSS im Roaming-Verzeichnis des Benutzers abgelegt werden: C:\Users\<Username>\AppData\Roaming\FTAPI\Outlook Add-In\
  2. Die Konfigurationsdatei MUSS exakt den Namen defaultbuttontext.xml tragen.
  3. Das Attribut Name im <Language>-Tag muss einem gültigen ISO-Sprachcode entsprechen, z. B. <Language Name="de-DE">.

Verfügbare UI-Elemente für die Anpassung

Name des TagsBeschreibung
Level1Text und Beschreibungstext der Download-Schaltfläche für Sicherheitsstufe 1
Level2Text und Beschreibungstext der Download-Schaltfläche für Sicherheitsstufe 2
Level3Text und Beschreibungstext der Download-Schaltfläche für Sicherheitsstufe 3
Level4Text und Beschreibungstext der Download-Schaltfläche für Sicherheitsstufe 4
Level4NoAttachmentsText und Beschreibungstext der Schaltfläche für Sicherheitsstufe 4, wenn keine Anhänge mit der Nachricht gesendet wurden
SubmitBoxText und Beschreibung der SubmitBox-/Upload-Schaltfläche
SendButtonText und Beschreibung der Senden-Schaltfläche
BlacklistNachrichtentext bei Empfängern auf der Blacklist. Der Platzhalter {0} wird durch den Empfänger ersetzt.

Tipp: Um den ausgewählten Empfänger in die Beschreibung einzubeziehen, sollte ein Platzhalter {0} an einer Stelle innerhalb der XML-Definition eingefügt werden.

Beispiel-Dateien für den Rollout

Beispiel 1: Nur eine Sicherheitsstufe auf Englisch anpassen

Hier entscheidet sich der Administrator, nur den Text und die Beschreibung für Level 1 für englischsprachige FTAPI-Mails anzupassen:

<?xml version="1.0" encoding="utf-8"?>
<DefaultButtonText xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Languages>
    <Language Name="en-US">
      <ButtonTexts>
        <TextDescription Name="Level1">
          <Text>L1 Custom Button Text</Text>
          <Description>L1 Custom EN Description for {0}</Description>
        </TextDescription>
      </ButtonTexts>
    </Language>
  </Languages>
</DefaultButtonText>

Beispiel 2: Vollständige Anpassung für Deutsch und Englisch

Hier entscheidet sich der Administrator, alle Texte und Beschreibungen für beide Sprachen vollständig nach Corporate Identity Vorgaben anzupassen:

<?xml version="1.0" encoding="utf-8"?>
<DefaultButtonText xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Languages>
    <Language Name="en-US">
      <ButtonTexts>
        <TextDescription Name="Level1">
          <Text>Download Secure Files</Text>
          <Description>Click to download files sent securely via FTAPI.</Description>
        </TextDescription>
        <TextDescription Name="SubmitBox">
          <Text>Upload to SubmitBox</Text>
          <Description>Click here to securely reply with your files.</Description>
        </TextDescription>
        <TextDescription Name="SendButton">
          <Text>Send Button Text</Text>
          <Description>Description of the send button</Description>
        </TextDescription>
        <TextDescription Name="Blacklist">
          <Text>This recipient is blocked: {0}</Text>
        </TextDescription>
      </ButtonTexts>
    </Language>
    <Language Name="de-DE">
      <ButtonTexts>
        <TextDescription Name="Level1">
          <Text>Sichere Dateien herunterladen</Text>
          <Description>Klicken Sie hier, um die Dateien sicher via FTAPI abzurufen.</Description>
        </TextDescription>
        <TextDescription Name="SubmitBox">
          <Text>In SubmitBox hochladen</Text>
          <Description>Klicken Sie hier, um uns Ihre Dokumente sicher zurückzusenden.</Description>
        </TextDescription>
        <TextDescription Name="SendButton">
          <Text>Senden-Button Text</Text>
          <Description>Beschreibung des Senden-Buttons</Description>
        </TextDescription>
        <TextDescription Name="Blacklist">
          <Text>Dieser Empfänger ist gesperrt: {0}</Text>
        </TextDescription>
      </ButtonTexts>
    </Language>
  </Languages>
</DefaultButtonText>

Ähnliche Artikel

📋 Outlook Add-In (klassisch): Konfiguration für Terminalserver und Mehrbenutzer