Intégration des services - Module complémentaire Ad Hoc

Configuration requise pour le serveur de messagerie Microsoft

Le module complémentaire MOVEit Transfer est construit sur l'architecture des modules complémentaires basés sur le Web. Pour l'utiliser dans votre entreprise, votre solution de messagerie Microsoft doit répondre aux exigences minimales des modules complémentaires basés sur le Web et doit prendre en charge l'ensemble des fonctions de l'API de Microsoft nécessaires à la fonctionnalité de notre module complémentaire

Abonnement à Microsoft 365

Clients Outlook connectés à Microsoft 365 (version minimale 2008, build 13127.20296).

Échange en ligne

Si votre organisation n'utilise pas Microsoft 365, le complément fonctionnera également avec Exchange Online et les clients Outlook suivants :

• Outlook 2016 perpétuel autonome ou une version ultérieure.
• Outlook 2021 perpétuel avec licence en volume.

Exigences d'intégration du serveur de transfert MOVEit

Avant de déployer ou de configurer les choses du point de vue d'Outlook ou d'Exchange, le serveur de transfert MOVEit attend les paramètres de configuration décrits dans cette section.

Une fois que vous avez rempli les conditions requises pour le transfert MOVEit, comme indiqué dans le tableau, vous pouvez utiliser les outils cloud ou d'entreprise de Microsoft pour déployer le module complémentaire Ad Hoc de MOVEit Transfer pour les utilisateurs.

Déployer et gérer Ad Hoc de manière centralisée à l'aide de Microsoft 365 Admin Center

Les sites utilisant des boîtes aux lettres Exchange Online peuvent utiliser le déploiement centralisé des modules complémentaires de Microsoft.

Vous pouvez affecter le module d'extension Ad Hoc Outlook à la plupart des groupes pris en charge par Azure Active Directory, notamment :

• Groupes Microsoft 365
• Listes de distribution
• Groupes de sécurité

Avant le déploiement

Avant d'intégrer le MOVEit Transfer Ad Hoc Add-in for Outlook dans l'environnement de vos utilisateurs, suivez les instructions du tableau suivant :

Déployer en utilisant le centre d'administration

Vous pouvez accéder au centre d'administration de Microsoft 365 à partir de https://admin.microsoft.com. Vous avez besoin des droits d'administrateur de 365. Vérifiez auprès de votre administrateur Microsoft pour plus de détails.

Centre d'administration Microsoft (page des applications intégrées affichée)

1. Dans le centre d'administration de Microsoft 365, cliquez sur Paramètres > Applications intégrées.

   La page Accueil - Applications intégrées s'affiche.

2. Cliquez sur l'hyperlien Modules complémentaires.

   La page des modules complémentaires s'affiche.

3. Cliquez sur Déployer le module complémentaire

   

   Le panneau coulissant Déployer un nouveau module complémentaire s'affiche.

4. Au bas du panneau Déployer le module complémentaire, cliquez sur Suivant.

   

5. Chargez des applications personnalisées. Chargement à l'aide du fichier manifeste MOVEit.(https://moveit.addins.progress.com/transfer/outlook/manifest.xml)

   Le panneau Configurer le module complémentaire s'affiche.

6. Dans la section Affecter des utilisateurs, sélectionnez :
   • Tout le monde
   • Utilisateurs/groupes spécifiques
   • Juste moi
7. Dans la section Méthode de déploiement, choisissez un mode :
   • Fixe (par défaut) : le module complémentaire est automatiquement déployé auprès des utilisateurs assignés.
   • Disponible. Le module complémentaire est disponible pour être déployé (mais n'est pas installé sur le ruban Outlook de l'utilisateur)
   • Facultatif. Le module complémentaire est déployé et présent dans le client Outlook de l'utilisateur, mais celui-ci peut le supprimer.
8. Cliquez sur Déployer.

Déployer à l'aide de Cmdlets (PowerShell)

Pour gérer la disponibilité et la configuration du déploiement du module complémentaire MOVEit Transfer de manière programmatique, vous pouvez utiliser Windows PowerShell avec le module complémentaire O365 Centralized (O365CentralizedAddInDeployment).

1. Référencez la bibliothèque qui fournit les méthodes d'administration O365.

   Par exemple :

   Import-Module -Name O365CentralizedAddInDeployment

2. Créez une session de gestion.

   Connect-OrganisationAddInService

3. Fournissez des informations d'identification. (Si vous ne les fournissez pas en tant que propriétés PowerShell, Windows vous le demande de manière interactive).

   Par exemple, créez une propriété d'informations d'identification :

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

   --où vous remplacez MaiKewlUneeqPasswd par votre mot de passe.

   --et où vous créez un objet d'identification en utilisant la propriété d'identification(secpasswd) comme argument d'entrée pour la méthode qui crée un objet d'identification(mycredentials). Par exemple :

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

4. Connectez-vous à O365.

   Par exemple :

   Connect-OrganizationAddInService -Credential $mycredentials

5. Téléchargez le module complémentaire à l'aide du fichier manifeste.

   Par exemple :

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

   -Où https://moveit.addins.progress.com/transfer/outlook/manifest.xml est l'URL du fichier manifeste hébergé.

   Obtenir le statut du module complémentaire (Centre d'administration)

   Vous pouvez obtenir le statut de l'add-in MOVEit Transfer Ad Hoc pour Outlook à partir de l'un des sites suivants :

   • Colonne d'état de la page Accueil > Applications intégrées .
   • Colonne d'état de la page des compléments (Accueil > Modules complémentaires)
   • Afficher la bascule d'état dans le panneau coulissant pour un complément spécifique (Accueil > Compléments [Module complémentaire MOVEit Add Hoc]

   Accueil > Page des applications intégrées - Colonne d'état (O365 Admin Center)

   

   Obtenir tous les détails et l'état du module d'extension (PowerShell one-liner)

   Pour obtenir tous les détails de l'extension Outlook de MOVEit Transfer pour votre organisation, y compris son état, vous pouvez exécuter un script d'une ligne à partir de PowerShell :

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

   --Où 05c2e1c9-3e1d-406e-9a91-e9ac64854143 est l'ID du produit actuel pour le MOVEit Transfer Ad Hoc Add-in.

Personnaliser le module complémentaire

Vous pouvez personnaliser le texte et les icônes utilisés dans le module complémentaire en modifiant le fichier manifeste XML et en installant le module complémentaire depuis votre copie personnelle (grâce à l'option Upload from File [Télécharger depuis un fichier]). Vous devrez télécharger votre copie personnalisée plutôt que l'URL du CDN de Progress.

Cette fonction de personnalisation vous permet de contrôler :

• Les chaînes de texte et opérations (boutons) car MOVEit Add s'affiche dans l'interface utilisateur d'Outlook.
• Les icônes affichées sur ces boutons.
• L'adresse du serveur MOVEit par défaut.
• Et bien d'autres choses encore.

Fichier manifeste du module complémentaire Outlook

Les détails de la personnalisation sont fournis ci-dessous, mais les étapes de base sont les suivantes :

• Accédez au fichier manifeste en ligne (manifest.xml) depuis un navigateur Web.
• Enregistrez le fichier manifeste XML localement afin de pouvoir le modifier.
  Important : Conservez une copie du dossier original. Cela vous sera utile si vous avez besoin de comparer ou de revenir à un état antérieur.
  Conseil : Si vous personnalisez le fichier XML, la meilleure pratique consiste à garder une trace du fichier XML original Progress CDN-staged (pour surveiller les mises à jour). Vous pouvez également consulter les notes de version, au cas où vous décideriez de fusionner les mises à jour avec votre copie locale personnalisée. (Par exemple, vous pouvez utiliser la fonction de surveillance des fichiers de WhatsUp Gold ou une application qui vérifie les balises.)
• Dans la section Ressources du fichier XML Manifest, modifiez les Images, ShortStrings et LongStrings pour refléter vos personnalisations.
• Enregistrez le fichier.
  Conseil : Veillez à utiliser un éditeur qui conserve le codage des caractères d'origine, tel que Visual Studio Editor ou Notepad++ au moment de l'enregistrement. N'ignorez pas les avertissements relatifs au codage des caractères. (Le fichier manifeste contient des chaînes de caractères traduites.)
• Déployez le complément à l'aide du manifeste XML personnalisé en utilisant l'option Upload from File (Télécharger depuis un fichier) (plutôt que Upload from URL [Télécharger depuis une URL]).

Personnaliser en utilisant le manifeste

Attribut des images

La section Images contient les emplacements hébergés par Progress (URLS) pour chaque taille d'icône. Si vous souhaitez afficher votre propre icône, vous devrez disposer d'images pour chaque taille énumérée ci-dessous sur un site accessible au public, puis remplacer l'URL de l'image hébergée par Progress par votre propre URL d'image pour chaque taille d'icône.

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

Attributs de ShortStrings et LongStrings

<bt:ShortStrings>
<bt:String id="ComposeGroupLabel" DefaultValue="MOVEit Transfer"/>
<bt:String id="TaskpaneButton.Label" DefaultValue="Créer un paquet sécurisé"/>
<bt:String id="ReadGroupLabel" DefaultValue="MOVEit Transfer"/>
<bt:String id="ReadDialogButton.Label" DefaultValue="Voir le paquet sécurisé"/>
</bt:ShortStrings>
<bt:LongStrings>
<bt:String id="TaskpaneButton.Tooltip" DefaultValue="Créer et envoyer des fichiers et
				des messages de manière sécurisée avec MOVEit Transfer"/>
<bt:String id="ReadDialogButton.Tooltip" DefaultValue="Voir le paquet sécurisé
				associé à une notification 'Nouveau paquet'."/>
</bt:LongStrings>

Ajouter une adresse personnalisée de serveur MOVEit Transfer

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

Exemple

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

Déployer le module complémentaire avec vos personnalisations

Il est recommandé de déployer le module complémentaire sur un utilisateur test et vérifiez que les modifications qui y sont apportées sont conformes à vos attentes (Vous pouvez le faire à partir de la commande Obtenir des modules complémentaires de votre barre d'outils Outlook.). Une fois que vous êtes satisfait de vos personnalisations, déployez le complément aux autres utilisateurs en suivant les étapes décrites ci-dessus, mais en utilisant le fichier manifeste personnalisé plutôt que l'URL du CDN Progress pour le fichier manifeste standard.

Mise à jour des versions localisées

Le code de l'application du complément modifie automatiquement les paramètres linguistiques (langue d'affichage) en fonction de la langue définie dans Outlook.

Cependant, tous les textes localisés ne sont pas intégrés dans l'application complémentaire.

Le manifeste lui-même fournit tout texte localisé qui s'affiche dans l'interface utilisateur d'Outlook (comme les cadres de la Description du module complémentaire et À propos de). Si vous mettez à jour une version récemment localisée et que vous voyez du texte dans l'interface utilisateur d'Outlook toujours en anglais, vous devrez recharger le manifeste.

Mise à jour du manifeste de l'interface utilisateur d'Outlook pour la localisation