Compartir a través de

OneNote (Empresa)

OneNote es una aplicación que toma nota de Microsoft que facilita la sincronización de sus ideas, bocetos y notas en todos los dispositivos. Conéctese a su cuenta de Office 365 con OneDrive para la Empresa habilitado para realizar un seguimiento de las nuevas secciones, crear notas y mucho más.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Estándar Todas las regiones Power Automate
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps
Power Apps Estándar Todas las regiones de Power Apps
Power Automate Estándar Todas las regiones Power Automate
Metadatos del conector
Publicador Microsoft
Website https://products.office.com/onenote/digital-note-taking-app

Para usar esta integración, necesitará acceder a un bloc de notas de OneNote almacenado en OneDrive para la Empresa. Para establecer una conexión, seleccione Iniciar sesión. Se le pedirá que proporcione su cuenta de O365 con OneDrive para la Empresa habilitada, siga el resto de las pantallas para crear una conexión.

Problemas conocidos y limitaciones

  1. Al usar la conexión, si no ve la lista de cuadernos que espera, compruebe la cuenta con la que creó la conexión e inténtelo de nuevo. Si ve un error al usar el conector, puede buscar el código de error para obtener más información.
  2. Esta integración requiere la conexión con una cuenta que tenga el permiso "UserRemoteAPIs". Si ve este error: "Error: el usuario no tiene permisos para acceder al recurso solicitado", es posible que la cuenta no tenga los permisos correctos. Un administrador de SharePoint puede controlar los niveles de permisos; para ello, vaya a la colección de sitios y abra la configuración del sitio. Seleccione los permisos del sitio y, a continuación, el nivel de permisos para ver los permisos (como usar interfaces remotas) que contiene el nivel. Si un usuario que pertenece a un determinado nivel no tiene el permiso necesario, modifique el nivel activando la casilla del permiso o cree un nuevo nivel de permiso y asígnelo al usuario.
  3. Actualmente, el conector no admite un título de página de parámetro de entrada explícito para las acciones Crear página . Se trata de una limitación derivada de la implementación de la API de OneNote. Sin embargo, el título se puede especificar como parte del contenido de página en HTML mediante las <etiquetas title></title>.
  4. Sección cuaderno. Si desea proporcionar un valor personalizado para el parámetro Sección de cuadernos, especifíquelo en el formato de dirección URL de LA API. Patrón de dirección URL de api: https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{siteCollectionsId}/sites/{SiteId}/notes/sections/{SectionId}/pages. Para obtener más información, puede echar un vistazo a la documentación de la API de OneNote.
  5. No se admite la creación de una página en la acción Notas rápidas en las siguientes regiones:
    • Logic Apps:
      • Azure Government (servicio de nube de Microsoft para el gobierno)
      • Regiones de Azure China
    • Power Automate y Power Apps:
      • Administración Pública de Estados Unidos
      • Administración Pública de Estados Unidos (GCC High)
      • China Cloud operado por 21Vianet
  6. La acción Obtener contenido de página no se admite en Power Apps; sin embargo, esta acción se admite en Power Automate.

Nota:

No se permiten los siguientes caracteres en el nombre del cuaderno: *":<>?/|%

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos
Frecuencia de sondeos de desencadenador 1 1200 segundos

Acciones

Actualizar contenido de la página

Actualice el contenido de la página HTML.
Creación de una sección en un cuaderno

Crear sección en un cuaderno.
Crear página en una sección

Cree una nueva página en una sección especificada.
Crear una página en notas rápidas

Cree una nueva página en la sección Notas rápidas.
Eliminar una página

Eliminar una página.
Obtención de secciones en el cuaderno

Obtenga secciones en un cuaderno específico.
Obtener blocs de notas recientes

Obtenga cuadernos recientes.
Obtener contenido de la página

Obtener contenido de página HTML.
Obtener páginas para una sección específica

Obtener páginas para una sección específica.

Actualizar contenido de la página

Id. de la operación:
UpdatePageContent

Actualice el contenido de la página HTML.

Parámetros

Nombre Clave Requerido Tipo Description
Clave del cuaderno
 notebookKey True string

Clave que identifica el cuaderno. Tenga en cuenta que esto es específico de la API y no se puede escribir a mano.
Sección de cuadernos
 sectionId True string

Dirección URL de API de las páginas de sección.
Id. de página
 pageId True string

Identificador único de la página.
Objetivo
 target string

Elemento que se va a actualizar.
Acción
 action string

Acción que se va a realizar en el elemento de destino.
Ubicación
 position string

Ubicación para agregar el contenido proporcionado.
Content
 content html

Nuevo contenido.

Devoluciones

Contenido HTML de la página

response
string

Creación de una sección en un cuaderno

Id. de la operación:
CreateSectionInNotebook

Crear sección en un cuaderno.

Parámetros

Nombre Clave Requerido Tipo Description
Clave del cuaderno
 notebookKey True string

Clave que identifica el cuaderno. Tenga en cuenta que esto es específico de la API y no se puede escribir a mano.
Nombre de la nueva sección
 name string

Nombre de la nueva sección.

Devoluciones

Body
CreateSectionInNotebookResponse

Crear página en una sección

Id. de la operación:
CreatePageInSection

Cree una nueva página en una sección especificada.

Parámetros

Nombre Clave Requerido Tipo Description
Clave del cuaderno
 notebookKey True string

Clave que identifica el cuaderno. Tenga en cuenta que esto es específico de la API y no se puede escribir a mano.
Sección de cuadernos
 sectionId True string

Dirección URL de API de las páginas de sección.
Contenido de página
 pageContent True html

Contenido de la página.

Devoluciones

Body
Page

Crear una página en notas rápidas

Id. de la operación:
CreatePageInQuickNotes

Cree una nueva página en la sección Notas rápidas.

Parámetros

Nombre Clave Requerido Tipo Description
Contenido de página
 pageContent True html

Contenido de la página.

Devoluciones

Body
Page

Eliminar una página

Id. de la operación:
DeletePage

Eliminar una página.

Parámetros

Nombre Clave Requerido Tipo Description
Clave del cuaderno
 notebookKey True string

Clave que identifica el cuaderno. Tenga en cuenta que esto es específico de la API y no se puede escribir a mano.
Sección de cuadernos
 sectionId True string

Dirección URL de API de las páginas de sección.
Id. de página
 pageId True string

Identificador único de la página.

Obtención de secciones en el cuaderno

Id. de la operación:
GetSectionsInNotebook

Obtenga secciones en un cuaderno específico.

Parámetros

Nombre Clave Requerido Tipo Description
Clave del cuaderno
 notebookKey True string

Clave que identifica el cuaderno. Tenga en cuenta que esto es específico de la API y no se puede escribir a mano.

Devoluciones

Nombre Ruta de acceso Tipo Description
value
 value array of SectionListItem

Obtener blocs de notas recientes

Id. de la operación:
GetNotebooks

Obtenga cuadernos recientes.

Devoluciones

response
array of Notebook

Obtener contenido de la página

Id. de la operación:
GetPageContent

Obtener contenido de página HTML.

Parámetros

Nombre Clave Requerido Tipo Description
Clave del cuaderno
 notebookKey True string

Clave que identifica el cuaderno. Tenga en cuenta que esto es específico de la API y no se puede escribir a mano.
Sección de cuadernos
 sectionId True string

Dirección URL de API de las páginas de sección.
Id. de página
 pageId True string

Identificador único de la página.

Devoluciones

Contenido HTML de la página

response
string

Obtener páginas para una sección específica

Id. de la operación:
GetPagesInSection

Obtener páginas para una sección específica.

Parámetros

Nombre Clave Requerido Tipo Description
Clave del cuaderno
 notebookKey True string

Clave que identifica el cuaderno. Tenga en cuenta que esto es específico de la API y no se puede escribir a mano.
Sección de cuadernos
 sectionId True string

Dirección URL de API de las páginas de sección.

Devoluciones

Body
GetPagesInSectionResponse

Desencadenadores

Cuando se crea un nuevo grupo de secciones

Desencadena un flujo cuando se agrega un nuevo grupo de secciones a un cuaderno.
Cuando se crea una nueva sección

Desencadena un flujo cuando se agrega una nueva sección a un cuaderno.
Cuando se crea una página nueva en una sección

Desencadena un flujo cuando se agrega una nueva página a una sección.

Cuando se crea un nuevo grupo de secciones

Id. de la operación:
OnNewSectionGroupInNotebook

Desencadena un flujo cuando se agrega un nuevo grupo de secciones a un cuaderno.

Parámetros

Nombre Clave Requerido Tipo Description
Clave del cuaderno
 notebookKey True string

Clave que identifica el cuaderno. Tenga en cuenta que esto es específico de la API y no se puede escribir a mano.

Devoluciones

Respuesta para un nuevo grupo de secciones.

Body
NewSectionGroupResponse

Cuando se crea una nueva sección

Id. de la operación:
OnNewSectionInNotebook

Desencadena un flujo cuando se agrega una nueva sección a un cuaderno.

Parámetros

Nombre Clave Requerido Tipo Description
Clave del cuaderno
 notebookKey True string

Clave que identifica el cuaderno. Tenga en cuenta que esto es específico de la API y no se puede escribir a mano.

Devoluciones

Respuesta para una nueva sección.

Body
NewSectionResponse

Cuando se crea una página nueva en una sección

Id. de la operación:
OnNewPageInSection

Desencadena un flujo cuando se agrega una nueva página a una sección.

Parámetros

Nombre Clave Requerido Tipo Description
Clave del cuaderno
 notebookKey True string

Clave que identifica el cuaderno. Tenga en cuenta que esto es específico de la API y no se puede escribir a mano.
Sección de cuadernos
 sectionId True string

Dirección URL de API de las páginas de sección.

Devoluciones

Respuesta de una nueva página.

Body
NewPageResponse

Definiciones

CreateSectionInNotebookResponse

Nombre Ruta de acceso Tipo Description
Contexto de OData
 @odata.context string

Contexto de OData.
Creado por nombre
 createdBy string

Esta sección se creó por nombre.
Tiempo creado
 createdTime date-time

Esta sección creó la hora.
Crear sección en el identificador de objeto del cuaderno
 id string
Marca de sección predeterminada
 isDefault boolean

Marca que indica si se trata de la sección predeterminada.
Última modificación realizada por
 lastModifiedBy string

Última modificación por nombre.
Hora de la última modificación
 lastModifiedTime date-time

Hora en que se modificó por última vez esta sección.
HREF del cliente de escritorio
 links.oneNoteClientUrl.href string

Href del cliente de escritorio de OneNote.
Href del cliente web
 links.oneNoteWebUrl.href string

Href del cliente web de OneNote.
Nombre de sección
 name string

Nombre de la sección.
La dirección URL de las páginas
 pagesUrl string

Dirección URL de las páginas.
Dirección URL para crear la sección en el cuaderno
 self string

Dirección URL que se va a crear en el grupo de cuadernos.

Página

Nombre Ruta de acceso Tipo Description
Título de página
 title string

Título de la página.
Enlaces
 links Link

Vínculos asociados a la página de OneNote.
Dirección URL de contenido
 contentUrl string

Dirección URL al contenido de la página.
Fecha de última modificación
 lastModifiedTime date-time

Fecha de última modificación de la página.
Fecha de creación
 createdTime date-time

Fecha en que se creó la página.
Id
 id string

Identificador único de la página.

Notebook

Nombre Ruta de acceso Tipo Description
NombreDeArchivo
 FileName string
Key
 Key string

ParentNotebook

Nombre Ruta de acceso Tipo Description
Clave principal del bloc de notas
 id string

Identificador único del cuaderno primario.
Nombre del cuaderno primario
 name string

Nombre del bloc de notas primario.
Dirección URL del cuaderno primario
 self string

Vínculo url al bloc de notas primario.

Vínculos asociados a la página de OneNote.

Nombre Ruta de acceso Tipo Description
oneNoteClientUrl
 oneNoteClientUrl OneNoteClientUrl
oneNoteWebUrl
 oneNoteWebUrl OneNoteWebUrl

OneNoteClientUrl

Nombre Ruta de acceso Tipo Description
Dirección URL del cliente de OneNote
 href string

Vínculo al bloc de notas mediante el cliente de Windows de OneNote.

OneNoteWebUrl

Nombre Ruta de acceso Tipo Description
Dirección URL web de OneNote
 href string

Vínculo al bloc de notas mediante el cliente web de OneNote.

SectionListItem

Los campos incluidos en un elemento de lista de secciones.

Nombre Ruta de acceso Tipo Description
Nombre de sección
 name string

Nombre de la sección.
Clave de sección
 pagesUrl string

Clave utilizada para hacer referencia a esta sección; también una dirección URL a las páginas.
Identificador de sección
 id string

Identificador único de la sección.

SectionResponse

Los campos incluidos en una sección.

Nombre Ruta de acceso Tipo Description
Creador
 createdBy string

Creador de la sección.
Fecha de creación
 createdTime date-time

Fecha y hora de creación de la sección.
Identificador de sección
 id string

Identificador único de la sección.
Última modificación realizada por
 lastModifiedBy string

Usuario que modificó por última vez la sección.
Fecha de última modificación
 lastModifiedTime date-time

Fecha y hora de la última modificación de la sección.
Nombre de sección
 name string

Nombre de la sección.
Url de páginas
 pagesUrl string

Dirección URL a las páginas de esta sección.
parentNotebook
 parentNotebook ParentNotebook
URL
 self string

Dirección URL de esta sección.

SectionGroupResponse

Los campos incluidos en un grupo de secciones.

Nombre Ruta de acceso Tipo Description
Fecha de creación
 createdTime date-time

Fecha y hora de creación del grupo de secciones.
Creador
 createdBy string

Creador del grupo de secciones.
Identificador
 id string

Identificador único del grupo de secciones.
Último modificador
 lastModifiedBy string

Usuario que modificó por última vez el grupo de secciones.
Última modificación
 lastModifiedTime date-time

Fecha y hora de última modificación del grupo de secciones.
Nombre
 name string

Nombre del grupo de secciones.
Url de secciones
 sectionsUrl string

Dirección URL de las secciones de este grupo de secciones.
Dirección URL del grupo de secciones
 self string

Dirección URL de este grupo de secciones.

NewSectionResponse

Respuesta para una nueva sección.

Nombre Ruta de acceso Tipo Description
Secciones
 value array of SectionResponse

Matriz de objetos, cada una que representa una sección específica.

NewSectionGroupResponse

Respuesta para un nuevo grupo de secciones.

Nombre Ruta de acceso Tipo Description
Grupos de secciones
 value array of SectionGroupResponse

Matriz de objetos, cada una que representa un grupo de secciones específico.

NewPageResponse

Respuesta de una nueva página.

Nombre Ruta de acceso Tipo Description
Páginas
 value array of Page

Matriz de objetos, cada una que representa una página específica.

GetPagesInSectionResponse

Nombre Ruta de acceso Tipo Description
Contexto de OData
 @odata.context string

Contexto de OData.
Pages en el objeto de valor de sección
 value array of object

value
Dirección URL de contenido
 value.contentUrl string

Dirección URL del contenido.
Creado por identificador de aplicación
 value.createdByAppId string

creado por el identificador de la aplicación.
Tiempo creado
 value.createdTime date-time

Hora de creación de esta respuesta.
Identificador único para la respuesta
 value.id string

Identificador único de esta respuesta.
Hora de última modificación
 value.lastModifiedTime date-time

Hora de la última modificación para este objeto.
Href del cliente de escritorio de OneNote
 value.links.oneNoteClientUrl.href string

Href del cliente de escritorio de OneNote.
Href del cliente web de OneNote
 value.links.oneNoteWebUrl.href string

Href del cliente web de OneNote.
Identificador único de sección principal
 value.parentSection.id string

Identificador único de esta sección primaria del objeto.
Nombre de sección principal
 value.parentSection.name string
Páginas de la sección primaria
 value.parentSection.self string

Dirección URL a las páginas de la sección primaria.
Contexto de OData de sección primaria
 value.parentSection@odata.context string

Contexto de OData de sección primaria.
Páginas del grupo de secciones
 value.self string

Dirección URL del grupo Páginas en sección.
Título de página
 value.title string

Título de página.

cuerda / cadena

Este es el tipo de datos básico "string".