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 et du code HTML d’alerte prêt à l’emploi afin de pouvoir afficher exactement ce qui a changé au lieu des notifications modifiées génériques.
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 | produits independNET |
| Website | https://independnet.com.au/alert-relay/ |
| Politique de confidentialité | https://independnet.com.au/alert-relay/privacy |
| Catégories | Collaboration; Productivité |
Relais d’alerte
Alert Relay permet de remplacer la mise hors service des alertes SharePoint par des notifications plus riches et modernes pour les environnements Microsoft 365. Il fournit des informations détaillées sur les modifications d’élément Et de document SharePoint, notamment les comparaisons au niveau du champ mises en forme et la sortie d’alerte HTML prête à l’emploi.
Aperçu
Alert Relay est conçu pour les créateurs qui souhaitent des notifications SharePoint plus utiles que l’expérience « élément a été modifié » par défaut.
Il prend en charge :
- inspection détaillée des modifications au niveau du champ
- Sortie HTML prête à l’emploi pour les e-mails d’alerte
- analyse des jetons de déclencheur pour les décisions de base et de première exécution
- Listes SharePoint
- bibliothèques de documents
- Pages de site / bibliothèques de pages
Principales fonctionnalités
1. Suivi détaillé des modifications
Le connecteur peut comparer la version actuelle d’un élément ou d’un document SharePoint à une version antérieure et retourner les détails des modifications structurées.
2. Sortie d’alerte HTML prête à l’emploi
Le connecteur peut générer du code HTML mis en forme afin que les flux puissent envoyer des e-mails d’alerte utiles sans générer manuellement des expressions HTML complexes.
3. Déclencher l’analyse des jetons
L’action Parse Compare From décode les jetons de modification SharePoint, tels que TriggerWindowStartToken et retourne les détails de l’horodatage incorporé et du jeton pour la prise de décision dans les flux.
4. Listes déroulantes dynamiques
Le connecteur inclut la prise en charge dynamique des listes déroulantes pour :
- sites
- listes et bibliothèques
- formats de date
- formats d’heure
- fuseaux horaires
5. Base de référence de comparaison flexible
Le connecteur prend en charge la comparaison à partir de :
- Jetons de déclencheur SharePoint
- jetons de modification SharePoint bruts
- étiquettes de version
- Bases de référence de date/heure ISO 8601
Actions prises en charge
Obtenir des modifications détaillées
Retourne un JSON structuré décrivant les champs modifiés, y compris les valeurs mises en forme précédentes et actuelles.
Obtenir des modifications détaillées en tant que code HTML d’alerte
Retourne une sortie HTML prête à l’emploi et des métadonnées d’alerte associées pour l’e-mail ou d’autres destinations compatibles HTML.
Analyser la comparaison à partir de
Décode un jeton de déclencheur/de modification SharePoint et retourne les détails de l’horodatage incorporé et du jeton.
Cas d’usage classiques
- Envoyer de meilleurs e-mails d’alerte SharePoint lorsqu’un élément de liste change
- Afficher les valeurs précédentes et actuelles pour les champs d’entreprise importants
- Suivre les modifications apportées aux métadonnées de la bibliothèque de documents
- Générer des flux de notification d’approbation, de conformité ou d’audit
- Supprimer les alertes bruyantes de première exécution en évaluant les dates de jeton de déclencheur par rapport à une base de référence choisie
Authentication
Alert Relay utilise l’authentification Microsoft Entra ID avec une clé d’abonnement API.
Pour utiliser le connecteur, un utilisateur a besoin des éléments suivants :
- accès au site, à la liste ou à la bibliothèque SharePoint appropriés
- une connexion de relais d’alerte valide
- une clé d’abonnement d’API Relay d’alerte valide
Lorsqu’un locataire utilise d’abord Alert Relay, il est placé en mode d’évaluation automatiquement. Pour sortir du mode d’essai, contactez support@alertbridge.com.au.
Getting Started
Un flux de validation classique utilise :
- Un déclencheur SharePoint tel que
When an item is created or modified - Une action de relais d’alerte telle que
Get Detailed Changes as Alert HTML - Une étape de messagerie ou de composition pour utiliser l’objet retourné et la sortie HTML
Pour le traitement structuré en aval, utilisez Get Detailed Changes et itérer sur le tableau retourné changedFields .
Problèmes connus et limitations
- SharePoint Online est pris en charge ; SharePoint Server local n’est pas pris en charge.
- Le minutage du déclencheur SharePoint peut affecter les comparaisons de première exécution, car les jetons de déclencheur reflètent la fenêtre de déclencheur SharePoint plutôt qu’un historique d’alerte par élément.
Support
Site internet:
Politique de confidentialité :
Soutien:
E-mail de support :
- support@alertbridge.com.au
Remarques supplémentaires
Alert Relay est destiné à améliorer l’utilisation des scénarios de notification sharePoint en réduisant la quantité de travail d’expression personnalisée requise dans les flux, en particulier pour l’inspection des modifications au niveau du champ et de mise en forme des e-mails HTML.
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 la comparaison à partir de |
Décode un jeton de modification SharePoint brut ou TriggerWindowStartToken et retourne l’horodatage incorporé pour les conditions de flux et les décisions de référence. Cette action n’appelle pas SharePoint. |
| Obtenir le code HTML d’alerte d’élément détaillé |
Retourne le code HTML de relais d’alerte prêt à l’emploi pour les modifications d’éléments SharePoint, conçues principalement pour les e-mails d’alerte de style SharePoint, mais également utilisables dans des documents ou d’autres destinations compatibles HTML. |
| Obtenir les modifications détaillées des éléments |
Récupère les modifications détaillées au niveau des champs mises en forme pour un élément de liste ou un document SharePoint, en comparant la version actuelle à la version précédente. Utilisez cette option lorsque vous souhaitez obtenir des données modifiées enrichies plutôt que les indicateurs de champ true/false intégrés de type SharePoint. |
Analyser la comparaison à partir de
Décode un jeton de modification SharePoint brut ou TriggerWindowStartToken et retourne l’horodatage incorporé pour les conditions de flux et les décisions de référence. Cette action n’appelle pas SharePoint.
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. |
|
Timezone
|
timezone | string |
ID de fuseau horaire IANA facultatif pour une valeur de comparaison locale (par exemple, « Amérique/New_York », « Europe/Londres », « Australie/Sydney »). En cas d’omission, seule la valeur UTC est retournée. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Success
|
success | boolean | |
|
Message
|
message | string | |
|
Heure UTC de date du jeton
|
tokenDateTimeUTC | date-time |
Horodatage de jeton au format UTC. |
|
Heure de date du jeton local
|
tokenDateTimeLocal | date-time |
Horodatage de jeton converti en fuseau horaire demandé. |
|
Jeton décodé
|
decodedToken | string |
Texte du jeton brut décodé. Pour l’entrée de jeton brut, cela correspond à la valeur d’origine. |
|
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. |
|
Error
|
error | string |
Détails de l’erreur lors de l’analyse échoue. |
Obtenir le code HTML d’alerte d’élément détaillé
Retourne le code HTML de relais d’alerte prêt à l’emploi pour les modifications d’éléments SharePoint, conçues principalement pour les e-mails d’alerte de style SharePoint, mais également utilisables dans des documents ou d’autres destinations compatibles HTML.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
URL du site
|
siteUrl | True | string |
URL complète du site SharePoint contenant la liste ou la bibliothèque. |
|
Liste ou bibliothèque
|
listId | True | string |
GUID ou titre exact de la liste ou de la bibliothèque SharePoint. La liste déroulante retourne des valeurs GUID, mais l’entrée manuelle peut utiliser un GUID ou le titre de liste exacte. |
|
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 |
Définit le point de départ de la comparaison des modifications. Accepte le {TriggerWindowStartToken} du déclencheur SharePoint (recommandé), une étiquette de version telle que « 5.0 », un jeton de modification SharePoint brut ou une date/heure de référence ISO 8601 telle que « 2026-03-30 » ou « 2026-03-30T14:15:00Z ». Les valeurs date uniquement sont interprétées comme minuit dans le fuseau horaire sélectionné ou UTC si le fuseau horaire est vide. Omettez de comparer la version immédiatement précédente. |
|
|
Inclure des versions mineures
|
includeMinorVersions | boolean |
Indique si les versions mineures ou provisoires doivent participer à la comparaison. La valeur par défaut est false, ce qui signifie que seules les versions principales sont utilisé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 de date personnalisé pour les champs DateTime (par exemple, « aaaa-MM-dd », « dd/MM/aaaa »). La valeur par défaut est « aaaa-MM-jj » si elle n’est pas spécifiée. |
|
|
Format de temps
|
timeFormat | string |
Format d’heure ajouté à la date pour les champs DateTime avec heure (par exemple, « HH :mm :ss », « HH :mm », « hh :mm tt »). |
|
|
Timezone
|
timezone | string |
ID de fuseau horaire IANA pour la conversion de date/heure (par exemple, « America/New_York », « Europe/Londres », « Australie/Sydney »). |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Success
|
success | boolean |
Indique si l’opération s’est terminée avec succès |
|
Message
|
message | string |
Message lisible par l’homme décrivant le résultat |
|
Corps HTML
|
htmlBody | string |
Compléter le corps HTML prêt à être utilisé dans les e-mails d’alerte ou d’autres destinations compatibles HTML |
|
Objet suggéré
|
subject | string |
Ligne d’objet suggérée pour l’alerte |
|
Titre de l’élément
|
itemTitle | string |
Titre de l’élément modifié |
|
URL de l’élément
|
itemUrl | string |
Lien direct vers l’élément SharePoint modifié |
|
Nouvel élément
|
isNewItem | boolean |
True si l’alerte concerne un nouvel élément ou un fichier SharePoint plutôt qu’une mise à jour d’un élément ou d’un fichier existant. |
|
Error
|
error | string |
Détails de l’erreur si la réussite est false |
Obtenir les modifications détaillées des éléments
Récupère les modifications détaillées au niveau des champs mises en forme pour un élément de liste ou un document SharePoint, en comparant la version actuelle à la version précédente. Utilisez cette option lorsque vous souhaitez obtenir des données modifiées enrichies plutôt que les indicateurs de champ true/false intégrés de type SharePoint.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
URL du site
|
siteUrl | True | string |
URL complète du site SharePoint contenant la liste ou la bibliothèque (par exemple). |
|
Liste ou bibliothèque
|
listId | True | string |
GUID ou titre exact de la liste ou de la bibliothèque SharePoint. La liste déroulante retourne des valeurs GUID, mais l’entrée manuelle peut utiliser un GUID ou le titre de liste exacte. |
|
Identifiant de l'article
|
itemId | True | integer |
ID de l’élément ou du fichier SharePoint à analyser pour les modifications (disponible à partir des sorties du déclencheur en tant qu’ID). |
|
Comparer à partir de
|
triggerWindowStartToken | string |
Définit le point de départ de la comparaison des modifications. Accepte le {TriggerWindowStartToken} du déclencheur SharePoint (recommandé), une étiquette de version telle que « 5.0 », un jeton de modification SharePoint brut ou une date/heure de référence ISO 8601 telle que « 2026-03-30 » ou « 2026-03-30T14:15:00Z ». Les valeurs date uniquement sont interprétées comme minuit dans le fuseau horaire sélectionné ou UTC si le fuseau horaire est vide. Omettez de comparer la version immédiatement précédente. |
|
|
Inclure des versions mineures
|
includeMinorVersions | boolean |
Indique si les versions mineures ou provisoires doivent participer à la comparaison. La valeur par défaut est false, ce qui signifie que seules les versions principales sont utilisé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 de date personnalisé pour les champs DateTime (par exemple, « aaaa-MM-dd », « dd/MM/aaaa », « MM/jj/aaaa »). La valeur par défaut est « aaaa-MM-jj » si elle n’est pas spécifiée. |
|
|
Format de temps
|
timeFormat | string |
Format d’heure ajouté à la date pour les champs DateTime avec heure (par exemple, « HH :mm :ss », « HH :mm », « hh :mm tt »). La valeur par défaut est « HH :mm :ss » si elle n’est pas spécifiée. |
|
|
Timezone
|
timezone | string |
ID de fuseau horaire IANA pour la conversion de date/heure (par exemple, « America/New_York », « Europe/Londres », « Australie/Sydney »). La valeur par défaut est UTC si elle n’est pas spécifiée. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Success
|
success | boolean |
Indique si l’opération s’est terminée avec succès |
|
Message
|
message | string |
Message lisible par l’homme décrivant le résultat |
|
Champs modifiés
|
changedFields | array of object |
Champs suivis sous forme de tableau. |
|
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. |
|
É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 ») |
|
Titre de l’élément
|
itemTitle | string |
Titre de l’élément modifié |
|
URL de l’élément
|
itemUrl | string |
Lien direct vers l’élément SharePoint modifié |
|
Modifié le
|
modifiedDate | date-time |
Horodatage 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 |