Modèle d’URI Sway

Ce document définit le format des URI (Uniform Resource Identifiers) pour l’application Sway pour Windows. Vous pouvez utiliser ce schéma d’URI pour appeler l’application Sway avec différentes commandes.

Sway syntaxe du schéma d’URI

Voici la syntaxe du schéma d’URI :

<ms-sway>:<command-argument>

• <ms-sway>: indique que Sway est l’application à appeler. Lorsque Sway pour Windows est installé, ms-sway est inscrit auprès de Windows pour être le gestionnaire de Sway.
• <command-argument> : un URI peut avoir un ou plusieurs arguments de commande, délimités par l’esperluette (&). Lorsque plusieurs arguments de commande sont inclus dans un URI, un caractère esperluette (&) doit séparer chaque argument de commande de l’argument de commande suivant. Les arguments de commande varient en fonction du scénario.

Arguments de commande

Plusieurs arguments de commande peuvent être inclus dans le cadre du schéma d’URL Sway. Ces arguments de commande ne sont pas obligatoires. Si vous n’incluez pas les arguments de commande, l’application Sway est appelée.

Nom de l’argument de commande	Description	Type	Valeurs possibles	Obligatoire ?
id	Identificateur unique d’un Sway. Utilisé pour indiquer le Sway à ouvrir.	String	Identificateur unique valide pour un Sway. L’ID fait toujours partie de l’URL d’un Sway. Par exemple, pour le Sway https://sway.com/dBheQgVZ1RQBfiQUsuivant , l’ID est dBheQgVZ1RQBfiQU. Si le compte d’utilisateur associé à l’application Sway dispose d’autorisations de modification, l’application ouvre le Sway en mode édition. Sinon, l’application ouvre le Sway en mode affichage.	Non
mode	Mode dans lequel une Sway spécifique doit être ouverte, que ce soit pour modification ou pour affichage.	String	edit view REMARQUE : si aucun ID n’est spécifié, cet argument de commande est ignoré.	Non
auth_upn	Compte à utiliser lors de l’ouverture de Sway.	String	Une adresse e-mail valide. Si l’adresse e-mail spécifiée n’est pas associée à un compte Sway, Sway demande à l’utilisateur de se connecter en tant qu’utilisateur spécifié. Si plusieurs comptes sont associés à l’application Sway et que l’adresse e-mail spécifiée existe, l’application Sway passe à l’utilisation de ce compte lorsqu’elle est appelée.	Non
auth_pvr	Type de compte à utiliser pour ouvrir le Sway : un compte Microsoft ou un compte Microsoft Entra ID.	String	WindowsLiveId : spécifie que le compte auth_upn est un compte Microsoft. OrgId : spécifie que le compte auth_upn est un compte Microsoft Entra. Si aucune auth_upn n’est spécifiée, cet argument de commande est ignoré.	Non
invoking_app	Nom de l’application Windows utilisée pour appeler Sway.	String	Nom convivial de l’application Windows utilisée pour appeler Sway via le schéma d’URL Sway. L’objectif de cet argument de commande est de télémétrie et de suivi.	Non

Sémantique du schéma d’URI

Le <ms-sway> schéma définit une syntaxe d’URI pour ouvrir un Sway ou pour appeler l’application Sway. Le schéma définit plusieurs arguments de commande, qui peuvent être utilisés pour effectuer les opérations suivantes :

• Ouvrez l’application Sway : aucun argument de commande n’a besoin d’être spécifié.

• Ouvrir un Sway pour l’afficher dans l’application Sway : l’ID et le mode définis pour afficher doivent être spécifiés.

• Ouvrir un Sway pour modification dans l’application Sway : l’ID et le mode définis pour modifier doivent être spécifiés. Nous vous recommandons également d’inclure auth_upn et auth_pvr pour vous assurer que le compte approprié avec des autorisations de modification est utilisé lors de l’ouverture de Sway.

Exemple

ms-sway:id=CyrvEYLmFKi1B2_I&auth_upn=account@email.com&auth_pvr=WindowsLiveId&invoking_app=MyApp