MyQ X Server
MyQ X Server
Breadcrumbs

Numérisation vers SharePoint Online

La fonctionnalité doit être activée en trois étapes :

  1. Vous devez d'abord enregistrer l'application MyQ dans SharePoint.

  2. Ensuite, vous devez créer et configurer la destination SharePoint Online.

  3. Enfin, les utilisateurs doivent connecter leurs comptes MyQ à SharePoint.

Activer l'accès à SharePoint

Pour configurer l'accès, vous devez enregistrer l'application MyQ dans SharePoint et saisir l'ID d'application SharePoint et la clé secrète dans l'onglet Paramètres des systèmes externes de l'interface d'administration Web de MyQ.

Enregistrer l'application MyQ dans SharePoint

  1. Dans un navigateur, saisissez l'une des URL suivantes (vous devez disposer de droits d'administrateur au niveau spécifique – pour le site racine SharePoint ou pour le site spécifique – afin de pouvoir accéder aux paramètres) :

    1. Pour le site racine SharePoint :
      <https://<site_name>.sharepoint.com/_layouts/15/appregnew.aspx>
      (par exemple https://mycompany.sharepoint.com/_layouts/15/appregnew.aspx)

    2. Pour un site SharePoint spécifique (collection de sites) :
      <https://<nom_du_site>.sharepoint.com/sites/<nom_du_site_spécifique>/_layouts/15/appregnew.aspx>
      (par exemple https://mycompany.sharepoint.com/sites/SCANNING/_layouts/15/appregnew.aspx)

  2. Remplissez ou générez les champs, puis cliquez sur Créer. Un message vous informe que l'identifiant de l'application a été créé avec succès.

    Creating a new SharePoint app registration

    1. ID client : vous pouvez le générer ou utiliser le vôtre. Copiez sa valeur ; elle sera utilisée plus tard dans le processus d'enregistrement.

    2. Secret client : vous pouvez le générer ou utiliser le vôtre. Copiez sa valeur ; elle sera utilisée plus tard au cours du processus d'enregistrement.

    3. Titre : « MyQ »

    4. Domaine de l'application : « helper.myq.cz »

    5. URI de redirection : « https://helper.myq.cz/ »

      New SharePoint app information overview

  3. Dans le navigateur, saisissez l'une des URL suivantes :

    1. Pour le site SharePoint racine :
      <https://<site_name>.sharepoint.com/_layouts/15/appinv.aspx>
      (par exemple https://mycompany.sharepoint.com/_layouts/15/appinv.aspx)

    2. Pour un site SharePoint spécifique (collection de sites) :
      <https://<site_name>.sharepoint.com/sites/<specific_site_name>/_layouts/15/appinv.aspx
      (par exemple, https://mycompany.sharepoint.com/sites/SCANNING/_layouts/15/appinv.aspx)

  4. Remplissez le champ App ID (l'ID client de l'étape 2), puis cliquez sur Lookup. Cela devrait remplir tous les champs à l'exception de Permission Request XML.

    App ID Lookup
    Automatically filled fields after App ID Lookup

  5. Copiez la chaîne ci-dessous, collez-la dans le champ Permission Request XML, puis cliquez sur Create. Il vous est demandé si vous faites confiance à l'application MyQ.
    <AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web"
    Right="Write" />
    </AppPermissionRequests>

    Permission Request XML creation

  6. Assurez-vous que l'option Documents est sélectionnée sous « Autoriser la modification ou la suppression de documents et d'éléments de la liste » (elle devrait être sélectionnée par défaut), puis cliquez sur « Faire confiance ». Vous pouvez maintenant quitter les paramètres SharePoint et ouvrir l'interface Web MyQ pour terminer la configuration.

    Let SharePoint Online trust MyQ

  7. Ouvrez l'onglet « External Systems » (Systèmes externes) de l'interface d'administration Web de MyQ (MyQ, Settings, External Systems).

  8. Dans cet onglet, sous SharePoint Online, saisissez l'ID client et la clé de sécurité, puis cliquez sur Enregistrer.

Si MyQ est mis à niveau vers la version 10.1 ou supérieure, le connecteur SharePoint devra être reconfiguré.


Activation de l'accès à SharePoint pour MyQ Server 10.1+

Pour configurer l'accès, vous devez créer un nouvel enregistrement d'application Azure AD destiné à être utilisé par MyQ, puis saisir l'ID d'application Azure AD et la clé secrète dans l'onglet Paramètres de connexion de l'interface d'administration Web MyQ.

Dans Azure AD, vous devez créer et configurer un nouvel enregistrement d'application Azure Active Directory destiné à être utilisé par MyQ. Une fois l'enregistrement créé, vous définissez les autorisations et créez une clé secrète. Vous avez besoin de l'ID du locataire, de l'ID de l'application et de la valeur de la clé secrète pour créer une connexion pour SharePoint dans l'interface Web MyQ. La valeur de la clé secrète remplit le champ Clé de sécurité.

  1. Accédez à https://portal.azure.com/ et connectez-vous avec votre compte d'administrateur global.

  2. Dans le tableau de bord Azure, dans le volet de navigation de gauche, cliquez sur Azure Active Directory, puis dans le menu de gauche, cliquez sur Enregistrements d'applications.

  3. Pour créer une nouvelle application, cliquez sur « New registration ». La page « Register an application » s'affiche.

  4. Dans la zone Nom, saisissez un nom pour l'application.

  5. Sélectionnez Types de comptes pris en charge.

  6. Dans la zone URI de redirection, sélectionnez Web et https://helper.myq.cz/.

    Registering a sharepoint app in azure

  7. Cliquez sur Enregistrer.

  8. Sur l'écran d'aperçu, cliquez sur Afficher les autorisations API. Cliquez sur Ajouter une autorisation. Le volet Demander des autorisations API s'affiche. Les autorisations User.Read sont ajoutées par défaut. Ajoutez les autorisations déléguées à Files.ReadWrite pour Microsoft Graph.

    Adding permissions

  9. De retour sur l'écran d'aperçu, cliquez sur Aperçu, puis copiez et enregistrez l'ID d'application, car vous en aurez besoin dans les étapes suivantes.

  10. Sur l'écran d'aperçu, cliquez sur Certificats et secrets, puis sur Nouveau secret client. Ajoutez une description, définissez la date d'expiration de la clé sur Jamais, puis cliquez sur Ajouter.

  11. Enregistrez la valeur de la clé secrète du client, car vous en aurez besoin dans les étapes suivantes et vous ne pourrez pas la récupérer ultérieurement.

    Client secret overview

  12. Ouvrez l'onglet Paramètres de connexion dans l'interface Web MyQ (MyQ, Paramètres, Connexions).

  13. Cliquez sur +Ajouter et sélectionnez SharePoint Online dans le menu.

    Sharepoint connection settings

  14. Ajoutez un titre. Celui-ci servira à identifier la destination de stockage dans le cloud.

  15. Ajoutez l'ID d'application et la valeur de la clé secrète du client en tant que Clé de sécurité que vous avez précédemment copiée et enregistrée.

  16. Ajoutez l'URL du site : https://<tenant_name>.sharepoint.com (pour accéder au site SharePoint racine) ou https://<tenant_name>.sharepoint.com/sites/<site_name> (pour accéder à un site spécifique de la collection du locataire), puis cliquez sur OK.


Créer et configurer la destination SharePoint Online

  • Créez une nouvelle destination (modifiez ou créez une action de terminal Easy Scan ; dans son panneau de propriétés, sous l'onglet Destinations, cliquez sur +Ajouter).

  • Dans le panneau de propriétés de la nouvelle destination, sous Général, sélectionnez l'option Stockage cloud dans le menu déroulant Type.

  • Dans la section Paramètres, dans le menu déroulant Type, sélectionnez SharePoint Online, puis cliquez sur Enregistrer.


Connecter le compte MyQ d'un utilisateur à SharePoint Online

Si les deux conditions suivantes sont remplies, le widget de stockage cloud s'affiche sur l'écran d'accueil de l'utilisateur connecté à l'interface Web MyQ :

  • Il existe au moins une action de terminal Easy Scan avec cette destination.

  • L'utilisateur dispose des droits nécessaires pour voir le bouton Easy Scan ou est connecté au lecteur cloud.

MyQ web UI, SharePoint Online widget status

Pour pouvoir stocker le fichier de numérisation sortant sur SharePoint Online, l'utilisateur doit être connecté.

Pour se connecter à SharePoint Online, l'utilisateur doit effectuer les actions suivantes :

  1. Connectez-vous à l'interface Web MyQ avec votre compte utilisateur.

  2. Dans le widget Stockage cloud, cliquez sur Se connecter. La boîte de dialogue Stockage cloud s'affiche.

  3. Cliquez sur Se connecter au stockage cloud.

    MyQ Web UI, Login to the cloud storage window

  4. Connectez-vous à SharePoint Online et confirmez les autorisations (lorsque vous êtes invité à le faire, cliquez sur Oui).

  5. Copiez le code fourni.

  6. Collez le code dans la boîte de dialogue de connexion au stockage cloud MyQ.

  7. Cliquez sur OK pour connecter le stockage cloud à MyQ. L'état de la connexion SharePoint Online passe à Connecté.