Extraire des chaînes d’entité d’un élément Outlook
Cet article décrit comment créer un complément Outlook pour l’affichage des entités qui extrait des instances de chaînes d’entités connues prises en charge dans l’objet et le corps de l’élément Outlook sélectionné. Cet élément peut être un rendez-vous, un message électronique ou encore une demande, une réponse ou une annulation de réunion.
Importante
Les compléments Outlook contextuels basés sur des entités seront mis hors service au deuxième trimestre 2024. Le travail de mise hors service de cette fonctionnalité commencera en mai et se poursuivra jusqu’à la fin du mois de juin. Après juin, les compléments contextuels ne seront plus en mesure de détecter les entités dans les éléments de courrier pour effectuer des tâches sur ces derniers. Les API suivantes seront également mises hors service.
- Office.context.mailbox.item.getEntities()
- Office.context.mailbox.item.getEntitiesByType(entityType)
- Office.context.mailbox.item.getFilteredEntitiesByName(name)
- Office.context.mailbox.item.getSelectedEntities()
Pour réduire les interruptions potentielles, les éléments suivants seront toujours pris en charge une fois les compléments contextuels basés sur des entités mis hors service.
- Une autre implémentation du bouton Participer à une réunion , qui est activé par les compléments de réunion en ligne, est en cours de développement. Une fois la prise en charge des compléments contextuels basés sur des entités terminée, les compléments de réunion en ligne passent automatiquement à l’implémentation alternative pour activer le bouton Participer à une réunion .
- Les règles d’expression régulière continueront d’être prises en charge une fois les compléments contextuels basés sur des entités mis hors service. Nous vous recommandons de mettre à jour votre complément contextuel pour utiliser des règles d’expression régulière comme solution alternative. Pour obtenir des conseils sur la façon d’implémenter ces règles, voir Utiliser des règles d’activation d’expression régulière pour afficher un complément Outlook.
Pour plus d’informations, consultez Retrait des compléments Outlook contextuels basés sur des entités.
Les entités prises en charge incluent notamment :
Adresse : une adresse postale aux États-Unis, qui a au moins un sous-ensemble des éléments de numéro de rue, nom de rue, ville, état et code postal.
Contact : informations de contact d’une personne, dans le contexte d’autres entités, telles qu’une adresse ou un nom commercial.
Adresse électronique : une adresse électronique SMTP.
Suggestion de réunion : suggestion de réunion, telle qu’une référence à un événement. Notez que seuls les messages (pas les rendez-vous) prennent en charge l’extraction de suggestion de réunion.
Numéro de téléphone : numéro de téléphone nord-américain.
Suggestion de tâche : une suggestion de tâche, généralement exprimée dans une phrase associée à une action.
URL
La plupart de ces entités s’appuient sur la reconnaissance du langage naturel, qui repose sur l’apprentissage automatique de grandes quantités de données. Ainsi, la reconnaissance est non déterministe et dépend parfois du contexte de l’élément Outlook.
Outlook active le complément des entités quand l’utilisateur sélectionne un rendez-vous, un message électronique ou une demande, une réponse ou une annulation de réunion à des fins d’affichage. Pendant l’initialisation, l’exemple de complément des entités lit toutes les instances des entités prises en charge à partir de l’élément actif.
Le complément comporte des boutons permettant à l’utilisateur de choisir un type d’entité. Quand l’utilisateur sélectionne une entité, le complément affiche les instances de l’entité sélectionnée dans le volet de complément. Les sections suivantes répertorient les manifestes XML, les fichiers HTML et JavaScript du complément des entités, et met en évidence le code qui prend en charge l’extraction de l’entité associée.
Manifeste XML
Remarque
La fonctionnalité de complément Outlook décrite dans cet article utilise des règles d’activation, qui ne sont pas prises en charge dans les compléments qui utilisent un manifeste unifié pour Microsoft 365 (préversion) .
Le complément pour entités a deux règles d’activation jointes par une opération OR logique.
<!-- Activate the add-in if the current item in Outlook is an email or appointment item. -->
<Rule xsi:type="RuleCollection" Mode="Or">
<Rule xsi:type="ItemIs" ItemType="Message"/>
<Rule xsi:type="ItemIs" ItemType="Appointment"/>
</Rule>
Ces règles spécifient qu’Outlook doit activer ce complément lorsque l’élément sélectionné dans l’inspecteur ou le volet de lecture est un rendez-vous ou un message (notamment un message électronique, ou une demande, une réponse ou une annulation de réunion).
Voici le manifeste du complément pour entités. Il utilise la version 1.1 du schéma pour les manifestes des Compléments Office.
<?xml version="1.0" encoding="utf-8"?>
<OfficeApp xmlns="http://schemas.microsoft.com/office/appforoffice/1.1"
xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
xsi:type="MailApp">
<Id>6880A140-1C4F-11E1-BDDB-0800200C9A68</Id>
<Version>1.0</Version>
<ProviderName>Microsoft</ProviderName>
<DefaultLocale>EN-US</DefaultLocale>
<DisplayName DefaultValue="Display entities"/>
<Description DefaultValue=
"Display known entities on the selected item."/>
<Hosts>
<Host Name="Mailbox" />
</Hosts>
<Requirements>
<Sets DefaultMinVersion="1.1">
<Set Name="Mailbox" />
</Sets>
</Requirements>
<FormSettings>
<Form xsi:type="ItemRead">
<DesktopSettings>
<!-- Change the following line to specify the web -->
<!-- server where the HTML file is hosted. -->
<SourceLocation DefaultValue=
"http://webserver/default_entities/default_entities.html"/>
<RequestedHeight>350</RequestedHeight>
</DesktopSettings>
</Form>
</FormSettings>
<Permissions>ReadItem</Permissions>
<!-- Activate the add-in if the current item in Outlook is -->
<!-- an email or appointment item. -->
<Rule xsi:type="RuleCollection" Mode="Or">
<Rule xsi:type="ItemIs" ItemType="Message"/>
<Rule xsi:type="ItemIs" ItemType="Appointment"/>
</Rule>
<DisableEntityHighlighting>false</DisableEntityHighlighting>
</OfficeApp>
Implémentation HTML
Le fichier HTML du complément pour entités spécifie les boutons permettant à l’utilisateur de sélectionner chaque type d’entité, et un autre bouton pour effacer les instances affichées d’une entité. Il inclut un fichier JavaScript, default_entities.js, qui est décrit dans la section suivante sous Implémentation JavaScript. Le fichier JavaScript inclut le gestionnaire d’événements pour chacun des boutons.
Notez que tous les compléments Outlook doivent comprendre le fichier office.js. Le fichier HTML qui suit inclut la version 1.1 de office.js sur le réseau de distribution de contenu (CDN).
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="X-UA-Compatible" content="IE=Edge" >
<title>standard_item_properties</title>
<link rel="stylesheet" type="text/css" media="all" href="default_entities.css" />
<script type="text/javascript" src="MicrosoftAjax.js"></script>
<!-- Use the CDN reference to Office.js. -->
<script src="https://appsforoffice.microsoft.com/lib/1/hosted/Office.js" type="text/javascript"></script>
<script type="text/javascript" src="default_entities.js"></script>
</head>
<body>
<div id="container">
<div id="button">
<input type="button" value="clear"
onclick="myClearEntitiesBox();">
<input type="button" value="Get Addresses"
onclick="myGetAddresses();">
<input type="button" value="Get Contact Information"
onclick="myGetContacts();">
<input type="button" value="Get Email Addresses"
onclick="myGetEmailAddresses();">
<input type="button" value="Get Meeting Suggestions"
onclick="myGetMeetingSuggestions();">
<input type="button" value="Get Phone Numbers"
onclick="myGetPhoneNumbers();">
<input type="button" value="Get Task Suggestions"
onclick="myGetTaskSuggestions();">
<input type="button" value="Get URLs"
onclick="myGetUrls();">
</div>
<div id="entities_box"></div>
</div>
</body>
</html>
Feuille de style
Le complément pour entités utilise un fichier CSS facultatif, default_entities.css, pour spécifier la mise en forme de la sortie. Le fichier CSS est présenté ci-dessous.
{
color: #FFFFFF;
margin: 0px;
padding: 0px;
font-family: Arial, Sans-serif;
}
html
{
scrollbar-base-color: #FFFFFF;
scrollbar-arrow-color: #ABABAB;
scrollbar-lightshadow-color: #ABABAB;
scrollbar-highlight-color: #ABABAB;
scrollbar-darkshadow-color: #FFFFFF;
scrollbar-track-color: #FFFFFF;
}
body
{
background: #4E9258;
}
input
{
color: #000000;
padding: 5px;
}
span
{
color: #FFFF00;
}
div#container
{
height: 100%;
padding: 2px;
overflow: auto;
}
div#container td
{
border-bottom: 1px solid #CCCCCC;
}
td.property-name
{
padding: 0px 5px 0px 0px;
border-right: 1px solid #CCCCCC;
}
div#meeting_suggestions
{
border-top: 1px solid #CCCCCC;
}
Implémentation JavaScript
Les sections suivantes expliquent comment l’exemple suivant (le fichier default_entities.js) extrait des entités connues de l’objet et du corps du message ou du rendez-vous consulté par l’utilisateur.
Extraction d’entités lors de l’initialisation
Lors de l’événement Office.initialize, le complément pour entités appelle la méthode getEntities de l’élément actuel. La getEntities méthode retourne à la variable _MyEntities globale un tableau d’instances d’entités prises en charge. Le code JavaScript associé est présenté ci-dessous.
// Global variables
let _Item;
let _MyEntities;
// The initialize function is required for all add-ins.
Office.initialize = function () {
const _mailbox = Office.context.mailbox;
// Obtains the current item.
_Item = _mailbox.item;
// Reads all instances of supported entities from the subject
// and body of the current item.
_MyEntities = _Item.getEntities();
// Checks for the DOM to load using the jQuery ready method.
$(document).ready(function () {
// After the DOM is loaded, app-specific code can run.
});
}
Extraction d’adresses
Lorsque l’utilisateur clique sur le bouton Obtenir les adresses, le gestionnaire d’événements myGetAddresses obtient un tableau d’adresses à partir de la propriété adresses de l’objet _MyEntities, si une adresse a été extraite. Toute adresse extraite est stockée comme chaîne dans le tableau. myGetAddresses forme une chaîne HTML locale dans htmlText pour afficher la liste des adresses extraites. Le code JavaScript associé est présenté ci-dessous.
// Gets instances of the Address entity on the item.
function myGetAddresses()
{
let htmlText = "";
// Gets an array of postal addresses. Each address is a string.
const addressesArray = _MyEntities.addresses;
for (let i = 0; i < addressesArray.length; i++)
{
htmlText += "Address : <span>" + addressesArray[i] + "</span><br/>";
}
document.getElementById("entities_box").innerHTML = htmlText;
}
Extraction d’informations de contact
Lorsque l’utilisateur clique sur le bouton Obtenir les informations de contact , le myGetContacts gestionnaire d’événements obtient un tableau de contacts avec leurs informations à partir de la propriété contacts de l’objet _MyEntities , le cas échéant. Chaque contact extrait est stocké en tant qu’objet Contact dans le tableau. myGetContacts obtient des données supplémentaires sur chaque contact. Notez que le contexte détermine si Outlook peut extraire un contact d’un élément : une signature à la fin d’un e-mail, ou au moins certaines des informations suivantes doivent exister à proximité du contact.
La chaîne représentant le nom du contact à partir de la propriété Contact.personName.
La chaîne représentant le nom de l’entreprise associée au contact à partir de la propriété Contact.businessName.
Le tableau des numéros de téléphone associés au contact à partir de la propriété Contact.phoneNumbers. Chaque numéro de téléphone est représenté par un objet PhoneNumber.
Pour chaque membre PhoneNumber dans le tableau des numéros de téléphone, la chaîne représentant le numéro de téléphone à partir de la propriété PhoneNumber.phoneString.
Le tableau des URL associées au contact à partir de la propriété Contact.urls. Chaque URL est représentée sous la forme d’une chaîne dans un membre de tableau.
Le tableau des adresses électroniques associées au contact à partir de la propriété Contact.emailAddresses. Chaque adresse électronique est représentée sous la forme d’une chaîne dans un membre de tableau.
Le tableau des adresses postales associées au contact à partir de la propriété Contact.addresses. Chaque adresse postale est représentée sous la forme d’une chaîne dans un membre de tableau.
myGetContacts forme une chaîne HTML locale dans htmlText pour afficher les données pour chaque contact. Le code JavaScript associé est présenté ci-dessous.
// Gets instances of the Contact entity on the item.
function myGetContacts()
{
let htmlText = "";
// Gets an array of contacts and their information.
const contactsArray = _MyEntities.contacts;
for (let i = 0; i < contactsArray.length; i++)
{
// Gets the name of the person. The name is a string.
htmlText += "Name : <span>" + contactsArray[i].personName +
"</span><br/>";
// Gets the company name associated with the contact.
htmlText += "Business : <span>" +
contactsArray[i].businessName + "</span><br/>";
// Gets an array of phone numbers associated with the
// contact. Each phone number is represented by a
// PhoneNumber object.
let phoneNumbersArray = contactsArray[i].phoneNumbers;
for (let j = 0; j < phoneNumbersArray.length; j++)
{
htmlText += "PhoneString : <span>" +
phoneNumbersArray[j].phoneString + "</span><br/>";
htmlText += "OriginalPhoneString : <span>" +
phoneNumbersArray[j].originalPhoneString +
"</span><br/>";
}
// Gets the URLs associated with the contact.
let urlsArray = contactsArray[i].urls;
for (let j = 0; j < urlsArray.length; j++)
{
htmlText += "Url : <span>" + urlsArray[j] +
"</span><br/>";
}
// Gets the email addresses of the contact.
let emailAddressesArray = contactsArray[i].emailAddresses;
for (let j = 0; j < emailAddressesArray.length; j++)
{
htmlText += "E-mail Address : <span>" +
emailAddressesArray[j] + "</span><br/>";
}
// Gets postal addresses of the contact.
let addressesArray = contactsArray[i].addresses;
for (let j = 0; j < addressesArray.length; j++)
{
htmlText += "Address : <span>" + addressesArray[j] +
"</span><br/>";
}
htmlText += "<hr/>";
}
document.getElementById("entities_box").innerHTML = htmlText;
}
Extraction des adresses électroniques
Lorsque l’utilisateur clique sur le bouton Obtenir les adresses Email, le myGetEmailAddresses gestionnaire d’événements obtient un tableau d’adresses e-mail SMTP à partir de la propriété emailAddresses de l’objet_MyEntities, le cas échéant. Chaque adresse électronique extraite est stockée sous la forme d’une chaîne dans le tableau. myGetEmailAddresses forme une chaîne HTML locale dans htmlText pour afficher la liste des adresses électroniques extraites. Le code JavaScript associé est présenté ci-dessous.
// Gets instances of the EmailAddress entity on the item.
function myGetEmailAddresses() {
let htmlText = "";
// Gets an array of email addresses. Each email address is a
// string.
const emailAddressesArray = _MyEntities.emailAddresses;
for (let i = 0; i < emailAddressesArray.length; i++) {
htmlText += "E-mail Address : <span>" + emailAddressesArray[i] + "</span><br/>";
}
document.getElementById("entities_box").innerHTML = htmlText;
}
Extraction de suggestions de réunion
Lorsque l’utilisateur clique sur le bouton Obtenir des suggestions de réunion, le gestionnaire d’événements myGetMeetingSuggestions obtient un tableau de suggestions de réunion à partir de la propriété meetingSuggestions de l’objet _MyEntities, si des suggestions ont été extraites.
Remarque
Seuls les messages, mais pas les rendez-vous, prennent en charge le type d’entité MeetingSuggestion .
Chaque suggestion de réunion extraite est stockée sous la forme d’un objet MeetingSuggestion dans le tableau. myGetMeetingSuggestions obtient d’autres données sur chaque suggestion de réunion :
La chaîne identifiée comme suggestion de réunion à partir de la propriété MeetingSuggestion.meetingString.
Le tableau des participants de la réunion à partir de la propriété MeetingSuggestion.attendees. Chaque participant est représenté par un objet EmailUser.
Le nom de chaque participant à partir de la propriété EmailUser.displayName.
L’adresse SMTP de chaque participant à partir de la propriété EmailUser.emailAddress.
La chaîne représentant l’emplacement de la suggestion de réunion à partir de la propriété MeetingSuggestion.location.
La chaîne représentant l’objet de la suggestion de réunion à partir de la propriété MeetingSuggestion.subject.
La chaîne représentant l’heure de début de la suggestion de réunion à partir de la propriété MeetingSuggestion.start.
La chaîne représentant l’heure de fin de la suggestion de réunion à partir de la propriété MeetingSuggestion.end.
myGetMeetingSuggestions forme une chaîne HTML locale dans htmlText pour afficher les données pour chacune des suggestions de réunion. Le code JavaScript associé est présenté ci-dessous.
// Gets instances of the MeetingSuggestion entity on the
// message item.
function myGetMeetingSuggestions() {
let htmlText = "";
// Gets an array of MeetingSuggestion objects, each array
// element containing an instance of a meeting suggestion
// entity from the current item.
const meetingsArray = _MyEntities.meetingSuggestions;
// Iterates through each instance of a meeting suggestion.
for (let i = 0; i < meetingsArray.length; i++) {
// Gets the string that was identified as a meeting suggestion.
htmlText += "MeetingString : <span>" + meetingsArray[i].meetingString + "</span><br/>";
// Gets an array of attendees for that instance of a
// meeting suggestion. Each attendee is represented
// by an EmailUser object.
let attendeesArray = meetingsArray[i].attendees;
for (let j = 0; j < attendeesArray.length; j++) {
htmlText += "Attendee : ( ";
// Gets the displayName property of the attendee.
htmlText += "displayName = <span>" + attendeesArray[j].displayName + "</span> , ";
// Gets the emailAddress property of each attendee.
// This is the SMTP address of the attendee.
htmlText += "emailAddress = <span>" + attendeesArray[j].emailAddress + "</span>";
htmlText += " )<br/>";
}
// Gets the location of the meeting suggestion.
htmlText += "Location : <span>" + meetingsArray[i].location + "</span><br/>";
// Gets the subject of the meeting suggestion.
htmlText += "Subject : <span>" + meetingsArray[i].subject + "</span><br/>";
// Gets the start time of the meeting suggestion.
htmlText += "Start time : <span>" + meetingsArray[i].start + "</span><br/>";
// Gets the end time of the meeting suggestion.
htmlText += "End time : <span>" + meetingsArray[i].end + "</span><br/>";
htmlText += "<hr/>";
}
document.getElementById("entities_box").innerHTML = htmlText;
}
Extraction de numéros de téléphone
Lorsque l’utilisateur clique sur le bouton Obtenir les numéros de téléphone , le myGetPhoneNumbers gestionnaire d’événements obtient un tableau de numéros de téléphone à partir de la propriété phoneNumbers de l’objet _MyEntities , le cas échéant. Chaque numéro de téléphone extrait est stocké sous la forme d’un objet PhoneNumber dans le tableau. myGetPhoneNumbers obtient d’autres données sur chaque numéro de téléphone :
La chaîne représentant le type de numéro de téléphone (par exemple, numéro de téléphone local), à partir de la propriété PhoneNumber.type.
La chaîne représentant le numéro de téléphone réel à partir de la propriété PhoneNumber.phoneString.
La chaîne qui a été initialement identifiée comme le numéro de téléphone à partir de la propriété PhoneNumber.originalPhoneString.
myGetPhoneNumbers forme une chaîne HTML locale dans htmlText pour afficher les données pour chacun des numéros de téléphone. Le code JavaScript associé est présenté ci-dessous.
// Gets instances of the phone number entity on the item.
function myGetPhoneNumbers()
{
let htmlText = "";
// Gets an array of phone numbers.
// Each phone number is a PhoneNumber object.
const phoneNumbersArray = _MyEntities.phoneNumbers;
for (let i = 0; i < phoneNumbersArray.length; i++)
{
htmlText += "Phone Number : ( ";
// Gets the type of phone number, for example, home, office.
htmlText += "type = <span>" + phoneNumbersArray[i].type +
"</span> , ";
// Gets the actual phone number represented by a string.
htmlText += "phone string = <span>" +
phoneNumbersArray[i].phoneString + "</span> , ";
// Gets the original text that was identified in the item
// as a phone number.
htmlText += "original phone string = <span>" +
phoneNumbersArray[i].originalPhoneString + "</span>";
htmlText += " )<br/>";
}
document.getElementById("entities_box").innerHTML = htmlText;
}
Extraction de suggestions de tâches
Lorsque l’utilisateur clique sur le bouton Obtenir des suggestions de tâche, le myGetTaskSuggestions gestionnaire d’événements obtient un tableau de suggestions de tâches à partir de la propriété taskSuggestions de l’objet _MyEntities , le cas échéant. Chaque suggestion de tâche extraite est stockée sous la forme d’un objet TaskSuggestion dans le tableau. myGetTaskSuggestions obtient d’autres données sur chaque suggestion de tâche :
La chaîne qui a été initialement identifiée comme une suggestion de tâche à partir de la propriété TaskSuggestion.taskString.
Le tableau des cessionnaires de tâches à partir de la propriété TaskSuggestion.assignees. Chaque cessionnaire est représenté par un objet EmailUser.
Le nom de chaque cessionnaire à partir de la propriété EmailUser.displayName.
L’adresse SMTP de chaque cessionnaire à partir de la propriété EmailUser.emailAddress.
myGetTaskSuggestions forme une chaîne HTML locale dans htmlText pour afficher les données pour chaque suggestion de tâche. Le code JavaScript associé est présenté ci-dessous.
// Gets instances of the task suggestion entity on the item.
function myGetTaskSuggestions()
{
let htmlText = "";
// Gets an array of TaskSuggestion objects, each array element
// containing an instance of a task suggestion entity from
// the current item.
const tasksArray = _MyEntities.taskSuggestions;
// Iterates through each instance of a task suggestion.
for (let i = 0; i < tasksArray.length; i++)
{
// Gets the string that was identified as a task suggestion.
htmlText += "TaskString : <span>" +
tasksArray[i].taskString + "</span><br/>";
// Gets an array of assignees for that instance of a task
// suggestion. Each assignee is represented by an
// EmailUser object.
let assigneesArray = tasksArray[i].assignees;
for (let j = 0; j < assigneesArray.length; j++)
{
htmlText += "Assignee : ( ";
// Gets the displayName property of the assignee.
htmlText += "displayName = <span>" + assigneesArray[j].displayName +
"</span> , ";
// Gets the emailAddress property of each assignee.
// This is the SMTP address of the assignee.
htmlText += "emailAddress = <span>" + assigneesArray[j].emailAddress +
"</span>";
htmlText += " )<br/>";
}
htmlText += "<hr/>";
}
document.getElementById("entities_box").innerHTML = htmlText;
}
Extraction d’URL
Lorsque l’utilisateur clique sur le bouton Obtenir les URL , le myGetUrls gestionnaire d’événements obtient un tableau d’URL à partir de la propriété urls de l’objet _MyEntities , le cas échéant. Chaque URL extraite est stockée sous la forme d’une chaîne dans le tableau. myGetUrls forme une chaîne HTML locale dans htmlText pour afficher la liste des URL extraites.
// Gets instances of the URL entity on the item.
function myGetUrls()
{
let htmlText = "";
// Gets an array of URLs. Each URL is a string.
const urlArray = _MyEntities.urls;
for (let i = 0; i < urlArray.length; i++)
{
htmlText += "Url : <span>" + urlArray[i] + "</span><br/>";
}
document.getElementById("entities_box").innerHTML = htmlText;
}
Effacement des chaînes d’entités affichées
Enfin, le complément d’entités spécifie un gestionnaire d’événements myClearEntitiesBox qui efface toutes les chaînes affichées. Le code associé est présenté ci-dessous.
// Clears the div with id="entities_box".
function myClearEntitiesBox()
{
document.getElementById("entities_box").innerHTML = "";
}
Listing JavaScript
Le listing complet de l’implémentation JavaScript est présenté ci-dessous.
// Global variables
let _Item;
let _MyEntities;
// Initializes the add-in.
Office.initialize = function () {
const _mailbox = Office.context.mailbox;
// Obtains the current item.
_Item = _mailbox.item;
// Reads all instances of supported entities from the subject
// and body of the current item.
_MyEntities = _Item.getEntities();
// Checks for the DOM to load using the jQuery ready method.
$(document).ready(function () {
// After the DOM is loaded, app-specific code can run.
});
}
// Clears the div with id="entities_box".
function myClearEntitiesBox()
{
document.getElementById("entities_box").innerHTML = "";
}
// Gets instances of the Address entity on the item.
function myGetAddresses()
{
let htmlText = "";
// Gets an array of postal addresses. Each address is a string.
const addressesArray = _MyEntities.addresses;
for (let i = 0; i < addressesArray.length; i++)
{
htmlText += "Address : <span>" + addressesArray[i] +
"</span><br/>";
}
document.getElementById("entities_box").innerHTML = htmlText;
}
// Gets instances of the EmailAddress entity on the item.
function myGetEmailAddresses()
{
let htmlText = "";
// Gets an array of email addresses. Each email address is a
// string.
const emailAddressesArray = _MyEntities.emailAddresses;
for (let i = 0; i < emailAddressesArray.length; i++)
{
htmlText += "E-mail Address : <span>" +
emailAddressesArray[i] + "</span><br/>";
}
document.getElementById("entities_box").innerHTML = htmlText;
}
// Gets instances of the MeetingSuggestion entity on the
// message item.
function myGetMeetingSuggestions()
{
let htmlText = "";
// Gets an array of MeetingSuggestion objects, each array
// element containing an instance of a meeting suggestion
// entity from the current item.
const meetingsArray = _MyEntities.meetingSuggestions;
// Iterates through each instance of a meeting suggestion.
for (let i = 0; i < meetingsArray.length; i++)
{
// Gets the string that was identified as a meeting
// suggestion.
htmlText += "MeetingString : <span>" +
meetingsArray[i].meetingString + "</span><br/>";
// Gets an array of attendees for that instance of a
// meeting suggestion.
// Each attendee is represented by an EmailUser object.
let attendeesArray = meetingsArray[i].attendees;
for (let j = 0; j < attendeesArray.length; j++)
{
htmlText += "Attendee : ( ";
// Gets the displayName property of the attendee.
htmlText += "displayName = <span>" + attendeesArray[j].displayName +
"</span> , ";
// Gets the emailAddress property of each attendee.
// This is the SMTP address of the attendee.
htmlText += "emailAddress = <span>" + attendeesArray[j].emailAddress +
"</span>";
htmlText += " )<br/>";
}
// Gets the location of the meeting suggestion.
htmlText += "Location : <span>" +
meetingsArray[i].location + "</span><br/>";
// Gets the subject of the meeting suggestion.
htmlText += "Subject : <span>" +
meetingsArray[i].subject + "</span><br/>";
// Gets the start time of the meeting suggestion.
htmlText += "Start time : <span>" +
meetingsArray[i].start + "</span><br/>";
// Gets the end time of the meeting suggestion.
htmlText += "End time : <span>" +
meetingsArray[i].end + "</span><br/>";
htmlText += "<hr/>";
}
document.getElementById("entities_box").innerHTML = htmlText;
}
// Gets instances of the phone number entity on the item.
function myGetPhoneNumbers()
{
let htmlText = "";
// Gets an array of phone numbers.
// Each phone number is a PhoneNumber object.
const phoneNumbersArray = _MyEntities.phoneNumbers;
for (let i = 0; i < phoneNumbersArray.length; i++)
{
htmlText += "Phone Number : ( ";
// Gets the type of phone number, for example, home, office.
htmlText += "type = <span>" + phoneNumbersArray[i].type +
"</span> , ";
// Gets the actual phone number represented by a string.
htmlText += "phone string = <span>" +
phoneNumbersArray[i].phoneString + "</span> , ";
// Gets the original text that was identified in the item
// as a phone number.
htmlText += "original phone string = <span>" +
phoneNumbersArray[i].originalPhoneString + "</span>";
htmlText += " )<br/>";
}
document.getElementById("entities_box").innerHTML = htmlText;
}
// Gets instances of the task suggestion entity on the item.
function myGetTaskSuggestions()
{
let htmlText = "";
// Gets an array of TaskSuggestion objects, each array element
// containing an instance of a task suggestion entity from the
// current item.
const tasksArray = _MyEntities.taskSuggestions;
// Iterates through each instance of a task suggestion.
for (let i = 0; i < tasksArray.length; i++)
{
// Gets the string that was identified as a task suggestion.
htmlText += "TaskString : <span>" +
tasksArray[i].taskString + "</span><br/>";
// Gets an array of assignees for that instance of a task
// suggestion. Each assignee is represented by an
// EmailUser object.
let assigneesArray = tasksArray[i].assignees;
for (let j = 0; j < assigneesArray.length; j++)
{
htmlText += "Assignee : ( ";
// Gets the displayName property of the assignee.
htmlText += "displayName = <span>" + assigneesArray[j].displayName +
"</span> , ";
// Gets the emailAddress property of each assignee.
// This is the SMTP address of the assignee.
htmlText += "emailAddress = <span>" + assigneesArray[j].emailAddress +
"</span>";
htmlText += " )<br/>";
}
htmlText += "<hr/>";
}
document.getElementById("entities_box").innerHTML = htmlText;
}
// Gets instances of the URL entity on the item.
function myGetUrls()
{
let htmlText = "";
// Gets an array of URLs. Each URL is a string.
const urlArray = _MyEntities.urls;
for (let i = 0; i < urlArray.length; i++)
{
htmlText += "Url : <span>" + urlArray[i] + "</span><br/>";
}
document.getElementById("entities_box").innerHTML = htmlText;
}
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour