Dienstintegration – Ad Hoc Add-in

Anforderungen für den Microsoft Mail-Server

Das MOVEit Transfer Add-in basiert auf der webbasierten Add-in-Architektur von Microsoft. Um es für Ihr Unternehmen nutzen zu können, muss Ihre Microsoft Mail-Lösung die Mindestanforderungen für webbasierte Add-ins erfüllen und die Microsoft API-Funktionen unterstützen, die für unsere Add-in-Funktionalität erforderlich sind

Microsoft 365-Abonnement

Outlook-Clients, die mit Microsoft 365 verbunden sind (mindestens Version 2008, Build 13127.20296).

Exchange Online

Wenn Ihre Organisation nicht Microsoft 365 verwendet, funktioniert das Add-in auch mit Exchange Online und den folgenden Outlook-Clients:

• Unbegrenztes Outlook 2016 oder höher für Endkunden.
• Volumenlizenz Outlook 2021 für unbegrenzte Zeit.

Integrationsanforderungen für MOVEit Transfer Server

Vor der Bereitstellung bzw. Konfiguration von Outlook oder Exchange müssen die in diesem Abschnitt aufgeführten Konfigurationseinstellungen von MOVEit Transfer Server vorgenommen werden.

Wenn die in der Tabelle aufgeführten Anforderungen für MOVEit Transfer erfüllt wurden, können Sie das MOVEit Transfer Ad Hoc Add-in für Benutzer mit den Cloud- bzw. Enterprise-Werkzeugen von Microsoft bereitstellen.

Ad Hoc mit Microsoft 365 Admin Center zentral bereitstellen und verwalten

Standorte mit Exchange-Online-Postfächern können die zentrale Bereitstellung für Add-ins von Microsoft nutzen.

Das Ad Hoc Outlook-Add-in kann den meisten Gruppen zugewiesen werden, die von Azure Active Directory unterstützt werden, z. B.:

• Microsoft 365-Gruppen
• Verteilerlisten
• Sicherheitsgruppen

Vorbereitung der Bereitstellung

Prüfen Sie vor der Bereitstellung des MOVEit Transfer Ad Hoc Add-ins for Outlook in der Umgebung Ihrer Benutzer die Anforderungen in der Tabelle unten:

Bereitstellung mit Admin Center

Sie finden das Microsoft 365 Admin Center unter https://admin.microsoft.com. Sie benötigen Administratorberechtigungen für Microsoft 365. Details erhalten Sie beim Microsoft-Administrator.

Microsoft Admin Center (Seite „Integrierte Apps“)

1. Klicken Sie im Microsoft 365 Admin Center auf Einstellungen > Integrierte Apps.

   Die Seite „Start – Integrierte Apps“ wird angezeigt.

2. Klicken Sie auf den Hyperlink Add-ins.

   Die Seite „Add-ins“ wird angezeigt.

3. Klicken Sie auf Add-in bereitstellen.

   

   „Neues Add-in bereitstellen“ wird angezeigt.

4. Klicken Sie im unteren Bereich des Bereitstellungsfensters auf Weiter.

   

5. Benutzerdefinierte Apps hochladen. Laden Sie das Add-in mit der MOVEit-Manifest-Datei hoch. (https://moveit.addins.progress.com/transfer/outlook/manifest.xml)

   Das Fenster Add-in konfigurieren wird angezeigt.

6. Wählen Sie eine Option im Abschnitt „Benutzer zuweisen“ aus:
   • Alle
   • Bestimmte Benutzer/Gruppen
   • Nur ich
7. Wählen Sie unter „Bereitstellungsmethode“ einen Modus aus:
   • Fest (Standard) Das Add-in wird automatisch zugewiesenen Benutzern bereitgestellt.
   • Verfügbar. Das Add-in steht zur Bereitstellung zur Verfügung (wird jedoch nicht auf dem Outlook-Band der Benutzer installiert).
   • Optional. Das Add-in wird bereitgestellt und im Outlook-Client des Benutzers angezeigt, aber der Benutzer kann es entfernen.
8. Klicken Sie auf „Bereitstellen“.

Bereitstellung mit Cmdlets (PowerShell)

Wenn Sie die Bereitstellung und Konfiguration des MOVEit Transfer Add-ins programmatisch verwalten möchten, können Sie Windows PowerShell mit dem zentralisierten Add-in-Modul von O365 (O365CentralizedAddInDeployment) kombinieren.

1. Verweisen Sie auf die Bibliothek, die O365-Admin-Methoden zur Verfügung stellt.

   Beispiel:

   Import-Module -Name O365CentralizedAddInDeployment

2. Erstellen Sie eine Management-Sitzung.

   Connect-OrganizationAddInService

3. Geben Sie die Anmeldeinformationen an. (Wenn Sie diese nicht als PowerShell-Eigenschaften angeben, fragt Windows sie interaktiv ab.)

   Beispiel – erstellen Sie eine Anmeldeinformationen-Eigenschaft:

   $secpasswd = ConvertTo-SecureString "MaiKewlUneeqPasswd" -AsPlainText -Force

   – Ersetzen Sie hier MaiKewlUneeqPasswd mit Ihren Kennwort.

   – und erstellen Sie ein Anmeldeinformationen-Objekt, indem die Anmeldeinformationen-Eigenschaft (secpasswd) als Eingangsargument für die Methode verwendet wird, die ein Anmeldeinformationen-Objekt (mycredentials) erstellt. Beispiel:

   $mycredentials = New-Object System.Management.Automation.PSCredential ("myMsftAdmin@example.com", $secpasswd)

4. Stellen Sie eine Verbindung mit O365 her.

   Beispiel:

   Connect-OrganizationAddInService -Credential $mycredentials

5. Laden Sie das Add-in mit der Manifest-Datei hoch.

   Beispiel:

   New-OrganizationAddIn -ManifestPath 'https://moveit.addins.progress.com/transfer/outlook/manifest.xml' -Locale 'en-US' -Members 'myExampleUser@example.com'

   – Hier ist https://moveit.addins.progress.com/transfer/outlook/manifest.xml die URL der gehosteten Manifest-Datei.

   Status des Add-ins abrufen (Admin Center)

   Sie können den Status des MOVEit Transfer Ad Hoc Add-ins for Outlook hier abrufen:

   • Spalte Status auf der Seite Start > Integrierte Apps.
   • Spalte Status auf der Add-ins-Seite (Home > Add-ins)
   • Umschalter Status für ein konkretes Add-in (Start > Add-ins [MOVEit Add Hoc Add-in]

   Start > Integrierte Apps – Spalte „Status“ (O365 Admin Center)

   

   Vollständige Details und Status des Add-ins abrufen (einzeiliges PowerShell-Skript)

   Umfassende Details zum MOVEit Transfer Outlook-Add-in für Ihre Organisation und deren Status können Sie mit folgendem einzeiligen PowerShell-Skript abrufen:

   $Get-OrganizationAddIn -ProductId 05c2e1c9-3e1d-406e-9a91-e9ac64854143 | Format-List

   – Hier ist 05c2e1c9-3e1d-406e-9a91-e9ac64854143 die aktuelle Produkt-ID für das MOVEit Transfer Ad Hoc Add-in.

Add-in anpassen

Sie können Text und Symbole, die im Add-in verwendet werden, anpassen, indem Sie die XML-Manifest-Datei bearbeiten und das Add-in aus Ihrer angepassten Kopie verwenden (mit der Option Aus Datei hochladen). Sie müssen Ihre kuratierte/angepasste Kopie hochladen und nicht über die Progress-CDN-URL.

Diese Anpassungsfunktion gibt Ihnen die Kontrolle über:

• Textzeichenfolgen und Operationen (Schaltflächen), wie MOVEit Add in der Outlook-Benutzeroberfläche angezeigt wird.
• Auf diesen Schaltflächen angezeigte Icons.
• Standard-MOVEit-Serveradresse.
• Und so weiter.

Outlook Add-in Manifest-Datei

Genauere Angaben zur Anpassung finden Sie unten. Zunächst ein Überblick über die grundlegenden Schritte:

• Navigieren Sie in einem Webbrowser zu der Online-Manifest-Datei (manifest.xml).
• Speichern Sie die XML-Manifest-Datei auf einem Computer, damit sie bearbeitet werden kann.
  Wichtig: Bewahren Sie eine Kopie der ursprünglichen Datei auf. Dies ist hilfreich, wenn Sie das Gefühl haben, einen früheren Zustand vergleichen oder wiederherstellen zu müssen.
  Tipp: Wenn Sie die XML-Datei anpassen, ist es ratsam, die ursprüngliche Progress-CDN-gestufte XML-Datei im Auge zu behalten (um sie auf Aktualisierungen zu überwachen). Sie können auch die Versionshinweise überprüfen, falls Sie sich entscheiden, Aktualisierungen mit Ihrer eigenen lokalen Kopie zusammenzuführen. (Sie können z. B. die Dateiüberwachungsfunktion von WhatsUp Gold oder eine Anwendung verwenden, die Etags überprüft)
• Nehmen Sie im Abschnitt „Resources“ der XML-Manifest-Datei in den Bereichen „Images“, „ShortStrings“ und „LongStrings“ die gewünschten Änderungen vor.
• Speichern Sie die Datei.
  Tipp: Stellen Sie beim Speichern sicher, dass Sie einen Editor verwenden, der die ursprüngliche Zeichenkodierung beibehält, z. B. Visual Studio Editor oder Notepad++. Ignorieren Sie die Warnungen zur Zeichenkodierung nicht. (Die Manifest-Datei enthält lokalisierte Zeichenfolgen)
• Stellen Sie das Add-in mit der angepassten XML-Manifest-Datei über die Option Aus Datei hochladen (statt Von URL hochladen) bereit.

Manifest-Datei anpassen

Images-Attribut

Im Bereich „Images“ befinden sich die von Progress gehosteten Speicherorte (URLS) für die einzelnen Symbolgrößen. Wenn Sie eigene Symbole verwenden möchten, benötigen Sie Bilder für jede unten aufgeführte Größe an einem öffentlich zugänglichen Speicherort. Ersetzen Sie dann die von Progress gehostete Bild-URL mit der eigenen Bild-URL für die einzelnen Größen.

<bt:Images>
<bt:Image id="Icon.16x16"
		DefaultValue="https://moveit.addins.progress.com/transfer/outlook/assets/icon-16.png"/>
<bt:Image id="Icon.32x32"
		DefaultValue="https://moveit.addins.progress.com/transfer/outlook/assets/icon-32.png"/>
<bt:Image id="Icon.64x64"
		DefaultValue="https://moveit.addins.progress.com/transfer/outlook/assets/icon-64.png"/>
<bt:Image id="Icon.80x80"
		DefaultValue="https://moveit.addins.progress.com/transfer/outlook/assets/icon-80.png"/>
</bt:Images>
			

ShortStrings- und LongStrings-Attribute

<bt:ShortStrings>
<bt:String id="ComposeGroupLabel" DefaultValue="MOVEit Transfer"/>
<bt:String id="TaskpaneButton.Label" DefaultValue="Create Secure Package"/>
<bt:String id="ReadGroupLabel" DefaultValue="MOVEit Transfer"/>
<bt:String id="ReadDialogButton.Label" DefaultValue="View Secure Package"/>
</bt:ShortStrings>
<bt:LongStrings>
<bt:String id="TaskpaneButton.Tooltip" DefaultValue="Create and send files and
				messages securely using MOVEit Transfer"/>
<bt:String id="ReadDialogButton.Tooltip" DefaultValue="View the secure package
				associated with a 'New Package' notification"/>
</bt:LongStrings>

Hinzufügen einer benutzerdefinierten MOVEit Transfer-Serveradresse

<Resources>
   <bt:Images>
      <bt:Image id="Icon.16x16" DefaultValue="https://localhost:3000/assets/icon-16.png"/>
      <bt:Image id="Icon.32x32" DefaultValue="https://localhost:3000/assets/icon-32.png"/>
      <bt:Image id="Icon.64x64" DefaultValue="https://localhost:3000/assets/icon-64.png"/>
      <bt:Image id="Icon.80x80" DefaultValue="https://localhost:3000/assets/icon-80.png"/>
    </bt:Images>
      <bt:Urls>
        <bt:Url id="Commands.Url" DefaultValue="https://localhost:3000/commands.html" />
        <bt:Url id="Taskpane.Url" DefaultValue="https://localhost:3000/taskpane.html?DefaultMitServerAddress=" />
      </bt:Urls>

Beispiel

<bt:Url id="Taskpane.Url" DefaultValue="https://localhost:3000/taskpane.html?DefaultMitServerAddress=moveit.beispiel.de"/>

Add-in mit Änderungen bereitstellen

Stellen Sie als Best Practice das Add-in einem Test-Benutzer bereit, um zu prüfen, dass die Änderungen Ihren Wünschen entsprechen (über den Befehl „Add-ins abrufen“ in der Outlook-Symbolleiste). Sobald Sie die Änderungen zufriedenstellend geprüft haben, stellen Sie das Add-in an alle übrigen Benutzer bereit. Nutzen Sie dazu die oben aufgeführten Schritte, aber verwenden Sie die angepasste Manifest-Datei statt der Progress-CDN-URL für die Standard-Manifest-Datei.

Lokalisierte Versionen aktualisieren

Der Anwendungscode für das Add-in wird automatisch anhand des Gebietsschemas (Anzeigesprache) der in Outlook eingestellten Sprache angezeigt.

Es ist jedoch nicht der gesamte lokalisierte Text in das Add-in eingebettet.

Das sog. Manifest stellt lokalisierten Text in der Outlook-Benutzeroberfläche (z. B. Beschreibung des Add-ins und Infos zur Anwendung) bereit. Wenn Sie ein Upgrade auf eine Version vornehmen, die erst kürzlich lokalisiert wurde, und Text in der Benutzeroberfläche von Outlook auf Englisch angezeigt wird, muss das Manifest neu geladen werden.

Aktualisierung des Manifests für die Outlook-Benutzeroberfläche zur Lokalisierung