Metadatos comunes devueltos por el servicio web de informes de Office 365

Artículo
11/14/2016

Este tema describe los metadatos que el Servicio Web de informes de Office 365 devuelve con cada informe y se proporciona como parte de cada entrada del informe.

Última modificación: jueves, 17 de septiembre de 2015

Hace referencia a: Office 365

Metadatos de nivel de servicio

Para obtener un documento XML (formato Atom) relativa a los informes y los campos para el usuario autenticado, tener acceso a esta dirección URL.

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

En el documento de metadatos devuelto, hay tres secciones principales:

Elementos EntityType definición cada tipo de informe, las claves de índice y los nombres y tipos de todas las propiedades
Elemento EntityContainer que enumera todos los nombres de informe y las definiciones de EntityType correspondientes.
Elementos de anotaciones proporcionan cadenas localizadas, que la aplicación puede utilizar para los rótulos del eje de un gráfico. Las cadenas se proporcionan para el título del informe, ejes x e.

Nota

Recuerde que el documento de metadatos contiene información sólo para los informes disponibles para la cuenta de usuario que se pasan en la solicitud HTTPS.

Metadatos de nivel de informe

El siguiente fragmento de un informe con formato XML de Atom de salida proporciona un ejemplo de los metadatos que se devuelven para un informe de StaleMailboxDetail. El informe no devuelve estos metadatos cuando la aplicación solicita datos 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" />

En la siguiente tabla se enumera los componentes de metadatos.

Componentes de metadatos de nivel de informe

Etiqueta de metadatos de nivel de informe de Atom XML	Descripción
xml:base	Indica el base del extremo del servicio de generación de informes. La dirección URL no distingue mayúsculas de minúsculas.
Espacios de nombres XML	Varios espacios de nombres XML se conocen, incluidos el espacio de nombres de Atom estándar y espacios de nombres relacionados con ADO dataservices ODATA y Microsoft dos.
<id>...</id>	Proporciona la dirección URL de base, sin sufijo del informe.
<title>…</title>	Proporciona una cadena de texto que se pueden usar como el título del informe.
<updated>...</updated>	Proporciona la fecha y hora UTC cuando el informe se ha devuelto a la aplicación que llama.
<link/>	Proporciona la información necesaria para crear un vínculo HTML a la dirección URL base del informe, como se muestra en la etiqueta <id> .

Metadatos del elemento de entrada

El siguiente fragmento de documento XML muestra una entrada devuelta desde un informe de StaleMailboxDetail en formato 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>

Este fragmento de JavaScript representa la misma información en formato 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
          }
      ]
  }

Explicaciones detalladas de los campos de datos de informe (fecha, WindowsLiveID, nombre de usuario, LastLogin y DaysInactive) están disponibles en Informe de StaleMailboxDetail. En la siguiente tabla se enumera los metadatos de nivel de elemento de informe que se ha mostrado anteriormente en este tema. Estos son los metadatos de servicios ODATA y datos de ADO estándar.

Metadatos de elemento de entrada

Etiqueta de metadatos de nivel de elemento XML de Atom	Propiedad de metadatos de nivel de elemento de JavaScript de JSON	Descripción
<id>...</id>	"id":	Proporciona un identificador para el elemento. Aunque este identificador parece ser una dirección URI, no debe asumir que puede pasar ese valor a la Servicio Web de informes y recuperar los resultados útiles. Es solo un identificador único. El ámbito de unicidad sólo se aplica a ese resultado único informe.
<category>...</category>	"type":	El valor es una representación de texto jerárquica combinar el servicio (TenantReporting) y el nombre del informe (StaleMailboxDetailReport).
<link>...</link>	"uri":	Proporciona los componentes (Atom) o una forma totalmente (JSON) URI a este elemento de informe. No todos los informes permite recuperar directamente el elemento basándose en este identificador URI. Si la aplicación utiliza a estos URI, asegúrese de que la información devuelta es se prevén. Además, algunos informes devuelven un vínculo "Editar". No utilice estos vínculos, ya no funcionan.
<title />	No se proporciona.	Esta etiqueta siempre está vacía.
<updated>...</updated>	No se proporciona.	Proporciona la fecha y hora UTC cuando se ha devuelto la entrada del informe para la aplicación que llama.
<author><name /></author>	No se proporciona.	Estas etiquetas siempre están vacías.

Metadatos comunes devueltos por el servicio web de informes de Office 365

Metadatos de nivel de servicio

Metadatos de nivel de informe

Metadatos del elemento de entrada

Recursos adicionales