Rapport de MailDetailTransportRule

Article
11/14/2016

L'URI REST MailDetailTransportRule fournit plus d'informations sur les règles de transport de messagerie Exchange utilisés dans le traitement des messages électroniques. Start et end date/heure du rapport peut être spécifiée dans la demande.

Dernière modification : jeudi 17 septembre 2015

S’applique à : Office 365

URI REST

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailDetailTransportRule[?ODATA options]

Champs

Les champs suivants peuvent être spécifiés dans les options de requête de ODATA2 $select, $filter et $orderby . Tous les champs sont renvoyés si aucune option $select n'est fournie.

Nom	WCF Type *	Type EDM *	[In/Out] ** Description	Exemples de valeurs	Ajouté dans la version de service
Action	string	Aucun n'est spécifié	[In/Out] Description de l'action effectuée sur le message, le cas échéant. Ce champ peut être vide ou null si aucune action n'a été effectuée. Pour plus d'informations sur les valeurs d'Action valides, reportez-vous à la section Rapport de MailFilterList.	SetSpamConfidenceLevel, RejectMessage	2013-V1
Date	System.DateTime	Edm.DateTime	[In/Out] La date et l'heure que du message a été traité.	Date, abrégé (par exemple, 03/10/2013) ou l' Heure avec les guillemets (par exemple, "03/10/2013 4:55 PM")	2013-V1
Direction	string	Aucun n'est spécifié	[In/Out] Spécifie si le message électronique a été envoyé dans (Inbound) ou à partir de (Outbound) l'organisation lorsqu'il a été traité.	Les valeurs sont limitées à Inbound et Outbound.	2013-V1
Domain	string	Non spécifié	[In/Out] Le nom de domaine complet qui a été de traitement du message électronique.	example.onmicrosoft.com	2013-V1
EndDate	System.DateTime	Edm.DateTime	[In] Ce champ est utilisé pour limiter la période du rapport. Utilisez ce champ dans une option de requête $filter pour définir la date de fin et l'heure de la période de rapport. Si vous fournissez EndDate dans l'option $filter , vous devez également fournir StartDate.	Date, abrégé (par exemple, 03/10/2013) ou l' Heure avec les guillemets (par exemple, "03/10/2013 4:55 PM")	2013-V1
EventType	string	Aucun n'est spécifié	[In/Out] Le type d'événement ouvert une session d'analyse. Pour plus d'informations sur les valeurs valides EventType , consultez la rubrique Rapport de MailFilterList.	SpamContentFiltered, SpamIPBlock	2013-V1
MessageId	string	Aucun n'est spécifié	[In/Out] L'en-tête de MessageID Internet du message, si celui-ci a été fourni. Cette valeur peut également être explicitement null.	Si aucun ID a été fourni pour le message, les données du rapport indiquera <d:MessageId m:null="true" /> pour Atom et "MessageId":null pour JSON.	2013-V1
MessageSize	int	Edm.Int64	[In/Out] La taille du message en octets.	130840	2013-V1
MessageTraceId	System.Guid	Edm.Guid	[In/Out] Un identificateur utilisé pour obtenir le message détaillé transférer les informations de suivi. Le format interne du champ MessageTraceId doit être considéré opaque, comme le format peut changer. Pour plus d'informations sur le suivi des messages, consultez la rubrique Rapport de MessageTrace.	ae4ad8f6-7613-411c-e67e-08cfc740629	2013-V1
Organization	string	Aucun n'est spécifié	[In/Out] Le nom de domaine complet qui a été de traitement du message électronique.	example.onmicrosoft.com	2013-V1
RecipientAddress	string	Aucun n'est spécifié	[In/Out] L'adresse de messagerie SMTP de l'utilisateur que le message a été adressé.	userone@example.onmicrosoft.com	2013-V1
SenderAddress	string	Aucun n'est spécifié	[In/Out] L'adresse de messagerie SMTP de l'utilisateur, le message a été à partir de.	usertwo@example.onmicrosoft.com	2013-V1
StartDate	System.DateTime	Edm.DateTime	[In] Ce champ est utilisé pour limiter la période du rapport. Utilisez ce champ dans une option de requête $filter pour définir la date de début et l'heure de la période de rapport. Si vous fournissez un StartDate dans l'option $filter , vous devez également spécifier et EndDate.	Date, abrégé (par exemple, 03/10/2013) ou l' Heure avec les guillemets (par exemple, "03/10/2013 4:55 PM")	2013-V1
Subject	string	Aucun n'est spécifié	[In/Out] La ligne objet du message, s'il a été présente sur le message.	Free M0ney WoN!	2013-V1
TransportRule	string	Aucun n'est spécifié	Nom de la règle de transport Exchange exécutée à l'étape de traitement. Pour plus d'informations sur les valeurs TransportRule valides, reportez-vous à la section Rapport de MailFilterList.	PII Detction	2013-V1

* WCF Type fait référence au type de données .NET Framework affecté au champ lorsque vous créez une référence de Service Windows Communication Framework (WCF) dans Visual Studio. Le Type EDM fait référence aux types ADO.NET Entity Data Model (EDM) renvoyées dans les rapports au format Atom.

** [In/Out]: consultez les paramètres d'entrée et sortie colonnes section d'état.

Remarques

Chaque entrée dans le rapport comprend plusieurs champs de métadonnées. Pour plus d'informations, voir Les métadonnées renvoyées par le service web de création de rapports Office 365.

Le champ Date indique lorsque les messages ont été traitées par le système Office 365 et sont déclarées dans le fuseau horaire de ces serveurs.

À l'aide de StartDate et EndDate

Les champs StartDate et EndDate ne fournissent pas d'informations utiles dans les résultats du rapport et sont toujours la valeur 0001-01-01T00:00:00Z dans la sortie du rapport. Ils sont destinés à activer la restriction facile de la fenêtre de temps de création de rapports et fournir une plus fine précision que seraient disponibles dans un état « quotidien ».

Cela peut être particulièrement utile, par exemple, lors de l'enregistrement d'activité de d'utilisation de règle de transport courrier toutes les heures. Lorsque vous utilisez ces champs, vous devez inclure les champs StartDate et EndDate dans l'option $filter . Ils sont considérées comme étant facultatifs, mais si vous fournissez une, vous devez fournir l'autre. Si la paire StartDate/EndDate n'est pas disponibles dans la requête, la période de création de rapports par défaut est deux semaines précédentes. La section exemples qui suit montre comment utiliser les champs StartDate et EndDate .

Exemples

La demande de MailDetailTransportRule suivante renvoie l'objet du message, la taille et l'adresse du destinataire pour les messages entrants traités par la règle de transport qui détecte les informations d'identification personnelle (PII), le 8 février 2013. Les résultats doivent être au format Atom XML. Pour plus de clarté, sauts de ligne ont été ajoutés à la demande et certains résultats Atom XML ont été supprimées à partir des résultats.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailDetailTransportRule?
    $select=Subject,MessageSize,RecipientAddress&
    $filter=Direction%20eq%20'Inbound'%20and%20StartDate%20eq%20datetime'2013-02-08T00:00:00'%20
      and%20EndDate%20eq%20datetime'2013-02-08T23:59:59'%20and%20TransportRule%20eq%20'PII%20Detection'&
    $format=Atom

<?xml version="1.0" encoding="utf-8"?>
<feed xml:base="https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/" 
    xmlns="http://www.w3.org/2005/Atom" 
    xmlns:d="https://schemas.microsoft.com/ado/2007/08/dataservices" 
    xmlns:m="https://schemas.microsoft.com/ado/2007/08/dataservices/metadata">
  <id>https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MailDetailTransportRule</id>
  <title type="text">MailDetailTransportRule</title>
  <updated>2013-02-08T08:06:32Z</updated>
  <link rel="self" title="MailDetailTransportRule" href="MailDetailTransportRule" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(0)</id>
    <category term="TenantReporting.MailDetailTransportRuleReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailTransportRuleReport" href="MailDetailTransportRule(0)" />
    <title />
    <updated>2013-02-08T08:06:32Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Subject>ClickZ Asia Weekly: Facebook Graph Search - A Fresh Take on SEO</d:Subject>
        <d:MessageSize m:type="Edm.Int32">40320</d:MessageSize>
        <d:RecipientAddress>userone@example.onmicrosoft.com</d:RecipientAddress>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(1)</id>
    <category term="TenantReporting.MailDetailTransportRuleReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailTransportRuleReport" href="MailDetailTransportRule(1)" />
    <title />
    <updated>2013-02-08T08:06:32Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Subject>ClickZ Asia Weekly: Facebook Graph Search - A Fresh Take on SEO</d:Subject>
        <d:MessageSize m:type="Edm.Int32">40320</d:MessageSize>
        <d:RecipientAddress>userone@example.onmicrosoft.com</d:RecipientAddress>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(2)</id>
    <category term="TenantReporting.MailDetailTransportRuleReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailTransportRuleReport" href="MailDetailTransportRule(2)" />
    <title />
    <updated>2013-02-08T08:06:32Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Subject>ClickZ Asia Weekly: Facebook Graph Search - A Fresh Take on SEO</d:Subject>
        <d:MessageSize m:type="Edm.Int32">40495</d:MessageSize>
        <d:RecipientAddress>userone@example.onmicrosoft.com</d:RecipientAddress>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(3)</id>
    <category term="TenantReporting.MailDetailTransportRuleReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailTransportRuleReport" href="MailDetailTransportRule(3)" />
    <title />
    <updated>2013-02-08T08:06:32Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Subject>ClickZ Asia Weekly: Facebook Graph Search - A Fresh Take on SEO</d:Subject>
        <d:MessageSize m:type="Edm.Int32">40495</d:MessageSize>
        <d:RecipientAddress>userone@example.onmicrosoft.com</d:RecipientAddress>
      </m:properties>
    </content>
  </entry>

  [[ XML entries removed for clarity]]

  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(4)</id>
    <category term="TenantReporting.MailDetailTransportRuleReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MailDetailTransportRuleReport" href="MailDetailTransportRule(4)" />
    <title />
    <updated>2013-02-08T08:06:32Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Subject>ClickZ Asia Today: What Are the Real Challenges for Digital Marketing in 2013?</d:Subject>
        <d:MessageSize m:type="Edm.Int32">30552</d:MessageSize>
        <d:RecipientAddress>userone@example.onmicrosoft.com</d:RecipientAddress>
      </m:properties>
    </content>
  </entry>
</feed>

Le texte suivant présente les mêmes informations de rapport au format JSON.

{
    "d":
      [
        
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(0)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(0)",
                "type":"TenantReporting.MailDetailTransportRuleReport"
              },
            "Subject":"ClickZ Asia Weekly: Facebook Graph Search - A Fresh Take on SEO",
            "MessageSize":40320,
            "RecipientAddress":"userone@example.onmicrosoft.com"
          },
        
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(1)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(1)",
                "type":"TenantReporting.MailDetailTransportRuleReport"
              },
            "Subject":"ClickZ Asia Weekly: Facebook Graph Search - A Fresh Take on SEO",
            "MessageSize":40320,
            "RecipientAddress":"userone@example.onmicrosoft.com"
          },
        
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(2)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(2)",
                "type":"TenantReporting.MailDetailTransportRuleReport"
              },
            "Subject":"ClickZ Asia Weekly: Facebook Graph Search - A Fresh Take on SEO",
            "MessageSize":40495,
            "RecipientAddress":"userone@example.onmicrosoft.com"
          },
        
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(3)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(3)",
                "type":"TenantReporting.MailDetailTransportRuleReport"
              },
            "Subject":"ClickZ Asia Weekly: Facebook Graph Search - A Fresh Take on SEO",
            "MessageSize":40495,
            "RecipientAddress":"userone@example.onmicrosoft.com"
          },

[[ items removed for clarity ]]

          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(4)",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MailDetailTransportRule(4)",
                "type":"TenantReporting.MailDetailTransportRuleReport"
              },
            "Subject":"ClickZ Asia Today: What Are the Real Challenges for Digital Marketing in 2013?",
            "MessageSize":30552,
            "RecipientAddress":"userone@example.onmicrosoft.com"
          }
        
      ]
    
  }

Paramètres d'entrée et de colonnes de sortie de l'état

Les indicateurs [In/Out] dans la table champs ont les significations suivantes :

Les champs marqués [In] dans les champs de table sont principalement destinés à être utilisés dans $filter=, $orderby= et autres options de requête qui restreignent les entrées renvoie le rapport. Les champs marqués [In] dans les champs de table peut être inclus à l'option $select= et ils s'affichent dans les entrées de rapport, mais ils ne contiendront aucune donnée utile.
Les champs marqués [In/Out] dans les champs de table peut être utilisée dans les options de ($filter= et $orderby=) de restriction de l'entrée et de sélection de la colonne ($select=). Lorsque vous incluez un de ces champs dans l'option $select= , ils apparaissent dans les entrées de rapport et contient des données utiles lorsqu'elle est disponible.

Compatibilité

Le rapport MailDetailTransportRule a été introduit dans Service Office 365 version 2013-V1. Pour plus d'informations sur le contrôle de version, consultez la rubrique Contrôle de version dans le service web de création de rapports Office 365.

Applets de commande PowerShell correspondant

Le rapport MailDetailTransportRule renvoie les mêmes informations que l'applet de commande Get-MailDetailTransportRuleReportWindows PowerShell.

Autorisations

Le compte que vous accédez aux rapports du doit disposer d'autorisations d'administration dans cette organisation Office 365. Si le compte peut afficher ce rapport dans le panneau de configuration de Office 365, le compte dispose des autorisations pour récupérer les données à partir du service web REST. Ce rapport oblige l'utilisateur à affecter au rôle de destinataires en affichage seul. Dans la structure des autorisations Office 365 par défaut, les utilisateurs disposant des autorisations d'administrateur suivantes peuvent accéder à ce rapport : administrateur, administrateur général, le mot de passe et administrateur de facturation, administrateur de service, administrateur de gestion des utilisateurs.

Disponibilité, persistance et la granularité des données

Informations disponibles dans ce rapport contient exactement date et heure de chaque événement. Vous pouvez utiliser n'importe quel réalisable-période plus longue et la durée en incluant les champs StartDate et EndDate dans l'option $filter . Temps sont déclarés dans le fuseau horaire du serveur d'analyse du message électronique.

Les informations de ce rapport sont disponibles pour une période de 7 jours, ou jusqu'à ce que l'abonnement est annulé.

Les événements peuvent être retardées par jusqu'à 24 heures avant qu'ils s'affichent dans un rapport.

Partager via