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

Diese Anleitung zeigt Ihnen, wie Sie die Texte und Beschreibungen der Download- und SubmitBox-Schaltflächen 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

Die Konfigurationsdatei MUSS im Roaming-Verzeichnis des Benutzers abgelegt werden: C:\Users\<Username>\AppData\Roaming\FTAPI\Outlook Add-In\
Die Konfigurationsdatei MUSS exakt den Namen defaultbuttontext.xml tragen.
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 Tags	Beschreibung
`Level1`	Text und Beschreibungstext der Download-Schaltfläche für Sicherheitsstufe 1
`Level2`	Text und Beschreibungstext der Download-Schaltfläche für Sicherheitsstufe 2
`Level3`	Text und Beschreibungstext der Download-Schaltfläche für Sicherheitsstufe 3
`Level4`	Text und Beschreibungstext der Download-Schaltfläche für Sicherheitsstufe 4
`Level4NoAttachments`	Text und Beschreibungstext der Schaltfläche für Sicherheitsstufe 4, wenn keine Anhänge mit der Nachricht gesendet wurden
`SubmitBox`	Text und Beschreibung der SubmitBox-/Upload-Schaltfläche

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>
      </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>
      </ButtonTexts>
    </Language>
  </Languages>
</DefaultButtonText>