Administración de sesiones y persistencia en Excel

  • Artículo

Si la aplicación necesita realizar más de una o dos llamadas a la API de Excel en Microsoft Graph, cree una sesión y pase el identificador de sesión con cada solicitud. La presencia de un identificador de sesión en las solicitudes garantiza que usa la API de Excel de la manera más eficaz posible.

Se puede llamar a las API de Excel de tres modos:

  • Sesión persistente: Todos los cambios realizados en el libro se conservan (guardan) en el libro. Esta es la forma más eficaz y que ofrece un mejor rendimiento para usar la API de Excel.

  • Sesión no persistente: Los cambios realizados por la API no se guardan en la ubicación de origen. En su lugar, el servidor backend de Excel conserva una copia temporal del archivo que refleja los cambios realizados durante esa sesión API en concreto. Cuando expira la sesión de Excel, se pierden los cambios. Este modo es útil para aplicaciones que necesitan realizar análisis u obtener los resultados de un cálculo de una imagen de gráfico, pero no necesitan afectar al estado de documento.

  • Sin sesión: Las llamadas API no pasan un identificador de sesión. Los servidores de Excel tienen que buscar la copia del servidor del libro para cada operación. No es una forma eficaz para llamar a la API de Excel, pero es adecuada para hacer ciertos tipos de solicitudes aisladas.

Para representar la sesión en la API, utilice el encabezado workbook-session-id: {session-id}.

Nota:

El encabezado de sesión no es necesario para que una API de Excel funcione. Sin embargo, recomendamos que utilice el encabezado de sesión para mejorar el rendimiento. Si no utiliza un encabezado de sesión, los cambios realizados durante la llamada API sí persisten en el archivo.

Tipos de solicitud

El control de errores sugerido para las API de Excel se basa en el tipo de solicitud, el código de error y el código de estado. A continuación se muestran los tipos de solicitud:

  • Solicitud CreateSession: Se usa para crear una sesión persistente o no persistente. En una respuesta correcta, el identificador de sesión se devolverá en la propiedad id en el cuerpo de la respuesta. Para obtener más información, vea Crear sesión.
  • Solicitud con sesión: Solicitudes posteriores que siguen una solicitud CreateSession. Normalmente incluyen un workbook-session-id: {session-id} encabezado. La excepción es una solicitud de estado de sondeo, que usa el patrón de operación de ejecución prolongada. Para obtener más información, consulte Trabajo con API que tardan mucho tiempo en completarse.
  • Solicitud sin sesión: Se usa en modo sin sesión. Estas solicitudes no tienen un workbook-session-id: {session-id} encabezado.

Pasos siguientes

Para obtener información sobre cómo crear y usar sesiones, consulte el tema de referencia sobre creación de sesiones.

Contenido relacionado