Relais d’alerte (préversion)
Alert Relay permet de remplacer la mise hors service des alertes SharePoint par des notifications plus riches et modernes. Elle retourne des modifications détaillées au niveau du champ ainsi que du code HTML d’alerte prêt à l’emploi. Vous pouvez donc afficher exactement ce qui a changé au lieu des notifications modifiées génériques. Vous pouvez également utiliser les informations de modification et de version dans les décisions et conditions de flux.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | Classe | Regions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Standard | Toutes les régions Logic Apps , à l’exception des suivantes : - régions Azure Government - régions de chine Azure - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | prise en charge independNET |
| URL | https://independnet.com.au/alert-relay/support |
| Messagerie électronique | support@alertbridge.com.au |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | independNET Software |
| Website | https://independnet.com.au/alert-relay/ |
| Politique de confidentialité | https://independnet.com.au/alert-relay/privacy |
| Catégories | Collaboration; Productivité |
Relais d’alerte
Relais d’alerte pour Power Platform et Microsoft 365 Copilot
Alert Relay aide les organisations à remplacer les alertes de SharePoint classiques par des solutions de Power Automate modernes et de Copilot Studio. Il compare SharePoint éléments, fichiers et pages par rapport aux versions antérieures et retourne des informations de modification structurées, l’historique des versions et le contenu de notification prêt à l’emploi sans que les fabricants créent une logique de comparaison de versions complexe SharePoint.
Aperçu
SharePoint déclencheurs peuvent identifier qu’un élément, un fichier ou une page a changé, mais ils ne fournissent pas une comparaison complète des valeurs précédentes et actuelles.
La création de cette comparaison nécessite souvent que les créateurs récupèrent des versions, interprètent les jetons de modification, comparent les champs et mettez en forme les résultats pour les notifications ou le traitement en aval.
Alert Relay centralise ces actions réutilisables pour Power Automate et Copilot Studio.
Principales fonctionnalités
Alert Relay centralise ce travail via des actions réutilisables qui peuvent :
- identifier les modifications détaillées au niveau du champ
- retourner les valeurs de champ précédentes et actuelles
- générer du code HTML prêt à l’emploi pour SharePoint e-mails d’alerte
- récupérer l’historique des versions d’élément, de fichier et de page
- comparer à partir d’un jeton de déclencheur, d’un jeton de modification, d’une étiquette de version ou d’une date
- format des types de champs SharePoint complexes pris en charge
- retourner des informations structurées pour Power Automate et Microsoft 365 Copilot
Alert Relay prend en charge les listes SharePoint, les bibliothèques de documents et les bibliothèques de pages de site.
Getting Started
Un flux d’alerte SharePoint classique inclut les éléments suivants :
- Déclencheur SharePoint, par exemple lorsqu’un élément est créé ou modifié.
- Action de relais d’alerte, telle que Obtenir des modifications d’élément ou de fichier en tant que code HTML d’alerte.
- Un e-mail ou une autre action de notification qui utilise l’objet retourné et le corps HTML.
Pour les conditions, la mise en forme personnalisée ou les scénarios d’agent Microsoft Copilot Studio, utilisez Obtenir des modifications détaillées d’élément ou de fichier et utilisez les informations de modification structurées qu’il retourne.
Pour les versions d’historique SharePoint, utilisez l’historique des versions d’élément ou de fichier.
Documentation
La documentation, les informations de référence sur les actions, les exemples et les conseils de prise en main sont disponibles à l’adresse suivante :
Documentation sur le relais d’alerte
Tutoriels vidéo
Des procédures pas à pas, des exemples et des vidéos pratiques sont disponibles sur la chaîne YouTube de Relais d’alerte :
Licences et versions d’évaluation
La gestion des licences De relais d’alerte est à l’échelle du locataire. Un seul essai ou abonnement s’applique au locataire Microsoft Entra, et ses unités d’utilisation sont partagées par les flux de relais d’alerte et les utilisateurs de ce locataire.
La version d’évaluation de 90 jours démarre automatiquement quand une action Alert Relay s’exécute d’abord dans le locataire et inclut 300 unités d’utilisation partagées dans l’essai. Pour plus d’informations sur les plans actuels, consultez la tarification et la gestion des licences de Relais d’alerte.
Actions
Obtenir des modifications détaillées d’élément ou de fichier
Retourne des modifications détaillées au niveau du champ entre la version actuelle d’un élément SharePoint, un fichier ou une page et une version antérieure.
L’action retourne des informations structurées, notamment les valeurs précédentes et actuelles, les valeurs mises en forme et les métadonnées de comparaison. Utilisez-le lorsqu’un flux ou un agent Microsoft Copilot Studio doit inspecter, résumer ou agir sur des modifications individuelles.
Obtenir des modifications d’élément ou de fichier en tant que code HTML d’alerte
Génère du code HTML prêt à l’emploi montrant ce qui a changé dans un élément, un fichier ou une page SharePoint.
L’action retourne également un objet de courrier suggéré, un titre d’élément et un lien d’élément. Utilisez-le pour créer des e-mails d’alerte SharePoint plus riches sans générer d’expressions de comparaison html et de version complexes dans chaque flux.
Obtenir l’historique des versions d’élément ou de fichier
Renvoie l’historique des versions délimitées et paginables d’un élément, d’un fichier ou d’une page SharePoint.
L’action peut retourner les champs SharePoint sélectionnés et prendre en charge les limites de version, de date et de SharePoint de jetons de déclencheur. Utilisez-le pour les scénarios de flux de travail historiques, d’audit, de création de rapports, d’approbation et de prise en charge des versions.
Analyser les informations de version SharePoint
Décode SharePoint fenêtre déclencheur et informations de jeton de modification.
Utilisez cette action pour récupérer l’horodatage du jeton, appliquer des décisions basées sur la date ou la version, et filtrer les déclencheurs mineurs ou brouillons indésirables avant d’appeler une action de modification détaillée.
Utilisations classiques
Le relais d’alerte peut vous aider à :
- remplacer les alertes de SharePoint classiques par des flux de Power Automate
- envoyer des notifications mises en forme montrant exactement ce qui a changé
- comparer les valeurs précédentes et actuelles pour les champs d’entreprise importants
- suivre les modifications apportées aux métadonnées de document et SharePoint pages
- récupérer SharePoint l’historique des versions de fichier et d’élément
- générer des flux de travail d’approbation, de révision, de gouvernance et d’audit
- fournir des informations structurées sur les modifications de SharePoint pour Microsoft 365 Copilot
Authentification et accès
Alert Relay utilise Microsoft Entra ID authentification déléguée.
SharePoint’accès est effectué dans le contexte de l’utilisateur connecté. Alert Relay n’accorde pas aux utilisateurs des autorisations de SharePoint supplémentaires. Les utilisateurs doivent donc déjà avoir accès au site, à la liste, à la bibliothèque, à l’élément ou au fichier SharePoint appropriés.
Conditions requises et étendue prise en charge
- Alert Relay prend en charge SharePoint Online. SharePoint Server local n’est pas pris en charge.
- Les actions s’exécutent lorsqu’elles sont appelées par Power Automate ou un autre client pris en charge. Pour les notifications de modification, utilisez un déclencheur de SharePoint approprié pour démarrer le flux.
- Les comparaisons utilisant SharePoint jetons de déclencheur sont basées sur la fenêtre de déclencheur SharePoint. La base de référence résultante peut différer d’une limite de version spécifique à un élément.
- La mise en forme détaillée est disponible pour les types de champs SharePoint pris en charge. Consultez la documentation du relais d’alerte pour obtenir la référence de type de champ actuelle.
Support
Site internet: https://independnet.com.au/alert-relay/
Soutien: https://independnet.com.au/alert-relay/support
E-mail : support@alertrelay.com.au
Politique de confidentialité : https://independnet.com.au/alert-relay/privacy
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
|
Analyser les informations de version Share |
Décode un jeton SharePoint comparer à partir du jeton. Lorsque le numéro de version et la date de modification sont également fournis, il détermine si l’élément ou le fichier est une nouvelle version. Utilisez cette action non facturable dans les conditions de flux avant d’appeler des actions facturables de relais d’alerte. |
| Obtenir des modifications détaillées d’élément ou de fichier |
Récupère les modifications détaillées et mises en forme au niveau du champ pour un élément ou un fichier SharePoint list, en comparant la version actuelle à une version précédente. Utilisez cette option lorsque vous souhaitez obtenir des données modifiées enrichies, et pas seulement les SharePoint des indicateurs de modification vrais/faux. Les résultats peuvent inclure une notification d’évaluation, d’abonnement ou d’utilisation importante de Alert Relay pour l’utilisateur. |
| Obtenir des modifications d’élément ou de fichier en tant que code HTML d’alerte |
Retourne le code HTML de relais d’alerte prêt à l’emploi pour SharePoint modifications d’élément, conçues principalement pour les e-mails d’alerte, mais également utilisables partout où le code HTML est pris en charge. Les résultats peuvent inclure une notification d’évaluation, d’abonnement ou d’utilisation importante de Alert Relay pour l’utilisateur. |
| Obtenir l’historique des versions d’élément ou de fichier |
Retourne jusqu’au nombre demandé de versions pour un élément ou un fichier SharePoint list, le plus récent. Chaque version inclut les détails de version, les valeurs de colonne, les valeurs de texte mises en forme et les indicateurs montrant les colonnes modifiées par rapport à la version précédente disponible. Sélectionnez le site et la liste ou la bibliothèque lors de la configuration de cette action pour rendre ses colonnes disponibles en tant que contenu dynamique. Les résultats peuvent inclure une notification d’évaluation, d’abonnement ou d’utilisation importante de Alert Relay pour l’utilisateur. |
Analyser les informations de version SharePoint
Décode un jeton SharePoint comparer à partir du jeton. Lorsque le numéro de version et la date de modification sont également fournis, il détermine si l’élément ou le fichier est une nouvelle version. Utilisez cette action non facturable dans les conditions de flux avant d’appeler des actions facturables de relais d’alerte.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Comparer à partir de
|
compareFrom | True | string |
TriggerWindowStartToken ou un jeton de modification SharePoint brut pour décoder. Les étiquettes de version et les valeurs de date/heure ISO ne sont pas prises en charge par cette action. |
|
Numéro de version
|
versionNumber | string |
Numéro de version du déclencheur ou de l’action SharePoint, tel que 0.1, 1.0 ou 1.5. Utilisé pour identifier les versions mineures/brouillons. |
|
|
Modifié le
|
modifiedDate | date-time |
Date de modification du déclencheur ou de l’action SharePoint. Permet de détecter si la version visible SharePoint a été modifiée pendant la fenêtre du déclencheur. |
|
|
Inclure des versions mineures
|
includeMinorVersions | boolean |
Indique si les numéros de version mineure/brouillon doivent être comptabilisés en tant que nouvelles versions. La valeur par défaut est false. |
|
|
Timezone
|
timezone | string |
Fuseau horaire facultatif pour les valeurs de comparaison locales, telles que « America/New_York », « Europe/Londres » ou « Australie/Sydney » (ID de fuseau horaire IANA). En cas d’omission, seule la valeur UTC est retournée. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Success
|
success | boolean |
True lorsque les informations de version ont été analysées avec succès ; false lors de l’échec de la validation ou du traitement. |
|
Message
|
message | string |
Message accessible à l’utilisateur décrivant le résultat de l’opération. Les agents et les copilotes doivent afficher ce message à l’utilisateur lorsqu’il contient des informations d’essai, d’abonnement, d’utilisation, d’avertissement ou de traitement de version. |
|
Heure UTC de date du jeton
|
tokenDateTimeUTC | date-time |
Date et heure du jeton Comparer à partir du jeton, retournés au format UTC. |
|
Heure de date du jeton local
|
tokenDateTimeLocal | date-time |
Date et heure du jeton Comparer à partir du jeton, converties en fuseau horaire sélectionné. |
|
Jeton décodé
|
decodedToken | string |
Les SharePoint brutes changent le jeton après le décodage. Si Compare From était déjà un jeton brut, cela correspond à la valeur fournie. |
|
Jeton Base64
|
isBase64Token | boolean |
True lorsque le jeton entrant a été encodé en base64. |
|
Sequence
|
sequence | integer |
Valeur de séquence de modification SharePoint incorporée dans le jeton. |
|
GUID de liste
|
listGuid | uuid |
GUID de liste ou de bibliothèque incorporé dans le jeton. |
|
Version du jeton
|
tokenVersion | integer |
Numéro de version du jeton. |
|
Type de jeton
|
tokenType | integer |
Numéro de type de jeton SharePoint. |
|
Nouvelle version détectée
|
isNewVersionDetected | boolean |
True lorsque les métadonnées de déclencheur/action fournies affichent une nouvelle version visible SharePoint doit être traitée. False lorsque la version doit être ignorée. Null lorsqu’il n’y a pas suffisamment de métadonnées pour déterminer. |
|
Version mineure
|
isMinorVersion | boolean |
True lorsque le numéro de version fourni est une version mineure/brouillon. Null lorsque le numéro de version n’a pas été fourni. |
|
Est la première version mineure
|
isFirstMinorVersion | boolean |
True lorsque le numéro de version fourni est la première version mineure/brouillon, généralement 0.1. Null lorsque le numéro de version n’a pas été fourni. |
|
Est la première version majeure
|
isFirstMajorVersion | boolean |
True lorsque le numéro de version fourni est la première version majeure/publiée, généralement 1.0. Null lorsque le numéro de version n’a pas été fourni. |
|
Date de modification UTC
|
modifiedDateUtc | date-time |
Date de modification fournie normalisée au format UTC. Null lorsque la date de modification n’a pas été fournie. |
|
Date de modification locale
|
modifiedDateLocal | date-time |
Date de modification fournie convertie en fuseau horaire sélectionné. Null lorsque la date de modification ou le fuseau horaire n’a pas été fourni. |
|
Error
|
error | string |
Détails de l’erreur si la réussite est false. |
Obtenir des modifications détaillées d’élément ou de fichier
Récupère les modifications détaillées et mises en forme au niveau du champ pour un élément ou un fichier SharePoint list, en comparant la version actuelle à une version précédente. Utilisez cette option lorsque vous souhaitez obtenir des données modifiées enrichies, et pas seulement les SharePoint des indicateurs de modification vrais/faux. Les résultats peuvent inclure une notification d’évaluation, d’abonnement ou d’utilisation importante de Alert Relay pour l’utilisateur.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
URL du site
|
siteUrl | True | string |
Sélectionnez un site SharePoint ou entrez l’URL du site. |
|
Liste ou bibliothèque
|
listId | True | string |
Sélectionnez une liste ou une bibliothèque, ou entrez son titre ou son GUID. |
|
Identifiant de l'article
|
itemId | True | integer |
ID de l’élément ou du fichier SharePoint à analyser pour les modifications. |
|
Comparer à partir de
|
triggerWindowStartToken | string |
Point de départ de la comparaison. Utilisez le déclencheur de SharePoint TriggerWindowStartToken lorsqu'il est disponible. Vous pouvez également entrer une étiquette de version, un jeton de modification brut ou une date/heure de référence. Les valeurs date uniquement utilisent minuit dans le fuseau horaire sélectionné, ou UTC si aucun fuseau horaire n’est sélectionné. Laissez vide pour comparer la version précédente. |
|
|
Inclure des versions mineures
|
includeMinorVersions | boolean |
Indique s’il faut inclure des versions mineures ou brouillons lors de la comparaison des modifications. Par défaut, seules les versions principales sont comparées. |
|
|
Inclure des champs inchangés
|
includeUnchangedFields | boolean |
Indique si les champs inchangés doivent être inclus dans la réponse. La valeur par défaut est true. |
|
|
Format de date
|
dateFormat | string |
Format utilisé pour les champs DateTime (par exemple, « aaaa-MM-dd », « dd/MM/aaaa », « MM/jj/aaaa », « MM/dd/aaaa »). La valeur par défaut est « aaaa-MM-jj ». |
|
|
Format de temps
|
timeFormat | string |
Format utilisé pour la partie heure des champs DateTime (par exemple, HH :mm :ss, HH :mm, hh :mm tt). La valeur par défaut est HH :mm :ss. |
|
|
Timezone
|
timezone | string |
Fuseau horaire utilisé lors de la mise en forme des dates et des heures (par exemple, Amérique/New_York, Europe/Londres, Australie/Sydney). La valeur par défaut est UTC. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Success
|
success | boolean |
True lorsque l’action s’est terminée avec succès ; false lors de l’échec de la validation ou du traitement. |
|
Message
|
message | string |
Message accessible à l’utilisateur décrivant le résultat de l’opération. Les agents et les copilotes doivent afficher ce message à l’utilisateur lorsqu’il contient des informations d’essai, d’abonnement, d’utilisation, d’avertissement ou de traitement de version. |
|
Afficher l’avis de l’utilisateur
|
shouldDisplayUserNotice | boolean |
Indique si Alert Relay a retourné une notification d’évaluation, d’abonnement ou d’utilisation importante pour l’utilisateur. |
|
Code d’avis utilisateur
|
userNoticeCode | string |
Raison stable lisible par l’ordinateur pour l’utilisateur. |
|
Gravité de l’avis utilisateur
|
userNoticeSeverity | string |
Gravité de la présentation pour l’avis de l’utilisateur : informations, avertissement ou critique. |
|
Avis de l’utilisateur
|
userNotice | string |
Informations importantes sur la version d’évaluation, l’abonnement ou l’utilisation d’Alert Relay. |
|
Appel à l’action avis de l’utilisateur
|
userNoticeCallToAction | string |
Ce que l’utilisateur peut faire ensuite, y compris le site web Alert Relay et le courrier électronique de support. |
|
Champs modifiés
|
changedFields | array of object |
Liste des champs comparés SharePoint, y compris le nom de chaque champ, la valeur précédente, la valeur actuelle et sa modification. |
|
La valeur de colonne a changé
|
changedFields.hasChanged | boolean |
True si la valeur de ce champ a changé entre la version précédente et la version actuelle |
|
Valeur de colonne précédente (texte)
|
changedFields.previousAsString | string |
Valeur précédente mise en forme en tant que chaîne lisible par l’homme |
|
Nom interne du champ
|
changedFields.internalName | string |
Nom de champ SharePoint interne |
|
Nom du champ
|
changedFields.displayName | string |
Nom complet convivial du champ |
|
Valeur de colonne précédente (détaillée)
|
changedFields.previous |
Valeur précédente brute. Cette propriété est dynamique et peut être une chaîne, un nombre, un booléen, un objet, un tableau ou une valeur Null en fonction du type de champ SharePoint. |
|
|
Valeur de colonne actuelle (texte)
|
changedFields.currentAsString | string |
Valeur actuelle mise en forme en tant que chaîne lisible par l’homme |
|
Valeur de colonne actuelle (détaillée)
|
changedFields.current |
Valeur actuelle brute. Cette propriété est dynamique et peut être une chaîne, un nombre, un booléen, un objet, un tableau ou une valeur Null en fonction du type de champ SharePoint. |
|
|
Possède une base de référence de comparaison
|
hasComparisonBaseline | boolean |
True si une version de base distincte a été résolue pour la comparaison avec la version actuelle. |
|
Est la première version de la base de référence
|
isBaselineFirstVersion | boolean |
True si la version de référence résolue est la première version enregistrée pour l’élément ou le fichier. |
|
Nouvel élément
|
isNewItem | boolean |
True lorsque l’élément ou le fichier doit être traité comme nouveau pour la fenêtre de comparaison résolue plutôt que comme une mise à jour. |
|
Étiquette de version actuelle
|
currentVersionLabel | string |
Étiquette de version de la version actuelle (par exemple, « 2.0 », « 5.0 ») |
|
Étiquette de version précédente
|
previousVersionLabel | string |
Étiquette de version utilisée pour la comparaison (par exemple, « 1.0 », « 4.0 ») |
|
Nom d’élément ou de fichier
|
itemTitle | string |
Titre ou nom de fichier de l’élément ou du fichier modifié. |
|
URL d’élément ou de fichier
|
itemUrl | string |
Lien direct vers l’élément ou le fichier modifié SharePoint. |
|
Modifié le
|
modifiedDate | date-time |
Date et heure de la dernière modification. |
|
Modifié par
|
modifiedBy | string |
Nom complet de l’utilisateur qui a modifié l’élément pour la dernière fois |
|
Error
|
error | string |
Détails de l’erreur si la réussite est false |
Obtenir des modifications d’élément ou de fichier en tant que code HTML d’alerte
Retourne le code HTML de relais d’alerte prêt à l’emploi pour SharePoint modifications d’élément, conçues principalement pour les e-mails d’alerte, mais également utilisables partout où le code HTML est pris en charge. Les résultats peuvent inclure une notification d’évaluation, d’abonnement ou d’utilisation importante de Alert Relay pour l’utilisateur.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
URL du site
|
siteUrl | True | string |
Sélectionnez un site SharePoint ou entrez l’URL du site. |
|
Liste ou bibliothèque
|
listId | True | string |
Sélectionnez une liste ou une bibliothèque, ou entrez son titre ou son GUID. |
|
Identifiant de l'article
|
itemId | True | integer |
ID de l’élément ou du fichier SharePoint à analyser pour les modifications. |
|
Comparer à partir de
|
triggerWindowStartToken | string |
Point de départ de la comparaison. Utilisez le déclencheur de SharePoint TriggerWindowStartToken lorsqu'il est disponible. Vous pouvez également entrer une étiquette de version, un jeton de modification brut ou une date/heure de référence. Les valeurs date uniquement utilisent minuit dans le fuseau horaire sélectionné, ou UTC si aucun fuseau horaire n’est sélectionné. Laissez vide pour comparer la version précédente. |
|
|
Inclure des versions mineures
|
includeMinorVersions | boolean |
Indique s’il faut inclure des versions mineures ou brouillons lors de la comparaison des modifications. Par défaut, seules les versions principales sont comparées. |
|
|
Inclure des champs inchangés
|
includeUnchangedFields | boolean |
Indique si les champs inchangés doivent être inclus dans le code HTML généré. La valeur par défaut est true. |
|
|
Format de date
|
dateFormat | string |
Format utilisé pour les champs DateTime (par exemple, « aaaa-MM-dd », « dd/MM/aaaa »). La valeur par défaut est « aaaa-MM-jj ». |
|
|
Format de temps
|
timeFormat | string |
Format utilisé pour la partie heure des champs DateTime (par exemple, HH :mm :ss, HH :mm, hh :mm tt). La valeur par défaut est HH :mm :ss. |
|
|
Timezone
|
timezone | string |
Fuseau horaire utilisé lors de la mise en forme des dates et des heures (par exemple, Amérique/New_York, Europe/Londres, Australie/Sydney). La valeur par défaut est UTC. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Success
|
success | boolean |
True lorsque l’action s’est terminée avec succès ; false lors de l’échec de la validation ou du traitement. |
|
Message
|
message | string |
Message accessible à l’utilisateur décrivant le résultat de l’opération. Les agents et les copilotes doivent afficher ce message à l’utilisateur lorsqu’il contient des informations d’essai, d’abonnement, d’utilisation, d’avertissement ou de traitement de version. |
|
Afficher l’avis de l’utilisateur
|
shouldDisplayUserNotice | boolean |
Indique si Alert Relay a retourné une notification d’évaluation, d’abonnement ou d’utilisation importante pour l’utilisateur. |
|
Code d’avis utilisateur
|
userNoticeCode | string |
Raison stable lisible par l’ordinateur pour l’utilisateur. |
|
Gravité de l’avis utilisateur
|
userNoticeSeverity | string |
Gravité de la présentation pour l’avis de l’utilisateur : informations, avertissement ou critique. |
|
Avis de l’utilisateur
|
userNotice | string |
Informations importantes sur la version d’évaluation, l’abonnement ou l’utilisation d’Alert Relay. |
|
Appel à l’action avis de l’utilisateur
|
userNoticeCallToAction | string |
Ce que l’utilisateur peut faire ensuite, y compris le site web Alert Relay et le courrier électronique de support. |
|
Corps HTML
|
htmlBody | string |
Corps HTML du message d’alerte, prêt à être utilisé par e-mail ou n’importe où html est pris en charge. |
|
Objet d’alerte généré
|
subject | string |
Ligne d’objet suggérée pour l’alerte |
|
Nom d’élément ou de fichier
|
itemTitle | string |
Titre ou nom de fichier de l’élément ou du fichier modifié. |
|
URL d’élément ou de fichier
|
itemUrl | string |
Lien direct vers l’élément ou le fichier modifié SharePoint. |
|
Nouvel élément
|
isNewItem | boolean |
Détermine si l’alerte générée décrit l’élément ou le fichier comme ajouté ou modifié. |
|
Error
|
error | string |
Détails de l’erreur si la réussite est false |
Obtenir l’historique des versions d’élément ou de fichier
Retourne jusqu’au nombre demandé de versions pour un élément ou un fichier SharePoint list, le plus récent. Chaque version inclut les détails de version, les valeurs de colonne, les valeurs de texte mises en forme et les indicateurs montrant les colonnes modifiées par rapport à la version précédente disponible. Sélectionnez le site et la liste ou la bibliothèque lors de la configuration de cette action pour rendre ses colonnes disponibles en tant que contenu dynamique. Les résultats peuvent inclure une notification d’évaluation, d’abonnement ou d’utilisation importante de Alert Relay pour l’utilisateur.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
URL du site
|
siteUrl | True | string |
Sélectionnez un site SharePoint ou entrez l’URL du site. |
|
Liste ou bibliothèque
|
listId | True | string |
Sélectionnez la liste ou la bibliothèque dont les colonnes de version doivent être disponibles en tant que contenu dynamique dans le flux. |
|
Identifiant de l'article
|
itemId | True | integer |
SharePoint list ID d’élément. Cela peut être fourni dynamiquement au moment de l’exécution, par exemple à partir d’un déclencheur SharePoint ou d’une action de flux antérieure. |
|
Unités d’utilisation maximales
|
maximumUsageUnits | True | integer |
La limite requise sélectionnée par l’appelant sur les unités d’utilisation que cet appel peut consommer. La valeur par défaut est 1. Il s’agit d’un service de facturation, et non d’une limite de nombre de versions ; une unité d’utilisation peut retourner plusieurs versions complètes. Utilisez le nombre maximal de versions pour limiter le nombre de lignes de version. |
|
Versions maximales
|
maximumVersions | integer |
Nombre maximal de lignes de version complètes à retourner sur toutes les pages. Laissez vide pour continuer jusqu’à ce que la plage sélectionnée, l’historique disponible ou le budget de l’unité d’utilisation se termine. Chaque réponse ne contient pas plus de 100 versions. |
|
|
Champs à retourner
|
fieldsToReturn | array of string |
SharePoint colonnes à inclure dans chaque version. Ajoutez une colonne par élément. Laissez les champs retourner vides pour renvoyer chaque colonne prise en charge. La sélection de moins de colonnes peut réduire la taille de réponse et le travail de l’unité d’utilisation. |
|
|
Comparer à partir de
|
fromVersion | string |
Point de départ de la plage d’historique des versions. Utilisez le déclencheur de SharePoint TriggerWindowStartToken lorsqu'il est disponible. Vous pouvez également entrer une étiquette de version, un jeton de modification brut ou une date/heure de référence. Les valeurs date uniquement utilisent minuit dans le fuseau horaire sélectionné, ou UTC si aucun fuseau horaire n’est sélectionné. Laissez vide pour aucune limite antérieure. |
|
|
Comparer à
|
toVersion | string |
Point de fin de la plage d’historique des versions. Utilisez le déclencheur SharePoint TriggerWindowEndToken lorsqu'il est disponible. Vous pouvez également entrer une étiquette de version, un jeton de modification brut ou une date/heure. Les valeurs date uniquement utilisent minuit dans le fuseau horaire sélectionné, ou UTC si aucun fuseau horaire n’est sélectionné. Laissez vide pour aucune limite plus récente. |
|
|
Jeton de pagination
|
continuationToken | string |
Jeton utilisé pour récupérer la page suivante de l’historique des versions, si un appel précédent a été retourné. |
|
|
Inclure des versions mineures
|
includeMinorVersions | boolean |
Indique s’il faut inclure des versions mineures ou brouillons lors de la récupération de l’historique des versions. Par défaut, seules les versions principales sont retournées. |
|
|
Format de date
|
dateFormat | string |
Format utilisé pour les champs DateTime (par exemple, « aaaa-MM-dd », « dd/MM/aaaa », « MM/jj/aaaa », « MM/dd/aaaa »). La valeur par défaut est « aaaa-MM-jj ». |
|
|
Format de temps
|
timeFormat | string |
Format utilisé pour la partie heure des champs DateTime (par exemple, HH :mm :ss, HH :mm, hh :mm tt). La valeur par défaut est HH :mm :ss. |
|
|
Timezone
|
timezone | string |
Fuseau horaire utilisé lors de la mise en forme des dates et des heures (par exemple, Amérique/New_York, Europe/Londres, Australie/Sydney). La valeur par défaut est UTC. |