Les métadonnées renvoyées par le service web de création de rapports Office 365

Cette rubrique décrit les métadonnées qui les Service web de création de rapports Office 365 renvoie avec chaque rapport et fournit dans le cadre de chaque entrée de rapport.

Dernière modification : jeudi 17 septembre 2015

S’applique à : Office 365

Métadonnées de niveau de service

Pour obtenir un document XML (au format Atom) répertoriant les rapports et les champs de l'utilisateur authentifié, accédez à cette URL.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/$metadata

Dans le document de métadonnées renvoyé, il existe trois sections principales :

• Définissant les éléments EntityType chaque type de rapport, les clés d'index et les noms et les types de toutes les propriétés

• Élément EntityContainer qui répertorie tous les noms de rapport et les définitions d'EntityType correspondantes.

• Éléments d'annotations fournissent des chaînes localisées, que votre application peut utiliser pour les étiquettes de l'axe dans un graphique. Les chaînes sont fournies pour le titre du rapport, x et y.

Notes

N'oubliez pas que le document de métadonnées contient des informations uniquement pour les rapports disponibles pour le compte d'utilisateur passé dans les requêtes HTTPS.

Métadonnées au niveau du rapport

Le fragment suivant d'une puissance de rapport au format Atom XML fournit un exemple de métadonnées retourné d'un rapport de StaleMailboxDetail. Le rapport ne renvoie pas ces métadonnées lors de l'application demande des données JSON.

<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/StaleMailboxDetail</id>
  <title type="text">StaleMailboxDetail</title>
  <updated>2013-02-10T03:40:33Z</updated>
  <link rel="self" title="StaleMailboxDetail" href="StaleMailboxDetail" />
  

Le tableau suivant répertorie les composants de métadonnées.

Composants de métadonnées au niveau du rapport

Balise de métadonnées au niveau du rapport Atom XML	Description
xml:base	Indique le point de terminaison de base du service de création de rapports. L'URL n'est pas sensible à la casse.
Espaces de noms XML	Plusieurs espaces de noms XML sont désignés, y compris l'espace de noms Atom standard et les espaces de noms dataservices liées à ADO ODATA et Microsoft deux.
<id>...</id>	Fournit l'URL de base, sans ornement du rapport.
<title>…</title>	Fournit une chaîne de texte qui peut être utilisée comme le titre du rapport.
<updated>...</updated>	Fournit la date et heure UTC lorsque le rapport a été renvoyé à l'application appelante.
<link/>	Fournit les informations nécessaires pour construire un lien HTML vers l'URL de rapport de base, comme indiqué dans la balise <id> .

Métadonnées de l'élément de l'entrée

Le fragment de document XML suivant montre une entrée renvoyée à partir d'un rapport StaleMailboxDetail au format Atom.

  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailboxDetail(datetime'2013-01-11T00%3A00%3A00')</id>
    <category term="TenantReporting.StaleMailboxDetailReport"
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="StaleMailboxDetailReport" 
      href="StaleMailboxDetail(datetime'2013-01-11T00%3A00%3A00')" />
    <title />
    <updated>2013-02-10T03:40:33Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-11T00:00:00</d:Date>
        <d:WindowsLiveID>userone@example.onmicrosoft.com</d:WindowsLiveID>
        <d:UserName>UserOne</d:UserName>
        <d:LastLogin m:type="Edm.DateTime" m:null="true" />
        <d:DaysInactive m:type="Edm.Int32">115</d:DaysInactive>
      </m:properties>
    </content>
  </entry>

Ce fragment JavaScript représente les mêmes informations au format JSON.

  {
    "d":
      [
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailboxDetail(datetime'2013-01-11T00%3A00%3A00')",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailboxDetail(datetime'2013-01-11T00%3A00%3A00')",
                "type":"TenantReporting.StaleMailboxDetailReport"
              },
            "Date":"\/Date(1357862400000)\/",
            "WindowsLiveID":"userone@example.onmicrosoft.com",
            "UserName":"UserOne",
            "LastLogin":null,
            "DaysInactive":115
          }
      ]
  }

Explications sur l'état des champs de données (Date, WindowsLiveID, UserName, LastLogin et DaysInactive) sont disponibles dans Rapport de StaleMailboxDetail. Le tableau suivant répertorie les métadonnées au niveau de l'élément de rapport indiquée précédemment dans cette rubrique. Il s'agit standard toutes les métadonnées de services ODATA et de données ADO.

Saisie des métadonnées d'élément

Balise de métadonnées au niveau de l'élément Atom XML	Propriété de métadonnées de niveau élément JSON JavaScript	Description
<id>...</id>	"id":	Fournit un identificateur pour l'élément. Bien que cet identificateur semble être un URI, vous ne devez pas supposer que vous pouvez passer cette valeur à la Service web de création de rapports et récupérer des résultats utiles. Il est uniquement un identificateur unique. L'étendue de l'unicité s'applique uniquement à ce résultat de rapport unique.
<category>...</category>	"type":	La valeur est une représentation sous forme de texte hiérarchique la combinaison du service (TenantReporting) et le nom du rapport (StaleMailboxDetailReport).
<link>...</link>	"uri":	Fournit les composants (Atom) ou un complets (JSON) URI pour cet élément de rapport. Tous les États en charge l'extraction directement l'élément en fonction de cet URI. Si votre application utilise ces URI, assurez-vous que les informations renvoyées est ce que vous attendez. En outre, certains rapports retournent un lien « Modifier ». N'utilisez pas ces liens, comme ils ne fonctionneront pas.
<title />	Pas fourni.	Cette balise est toujours vide.
<updated>...</updated>	Pas fourni.	Fournit la date et heure UTC lorsque l'entrée du rapport a été renvoyée à l'application appelante.
<author><name /></author>	Pas fourni.	Ces balises sont toujours vides.