OneNote (Negócios)
O OneNote é uma aplicação de anotações da Microsoft que facilita a sincronização das suas ideias, esboços e notas em todos os seus dispositivos! Ligue-se à sua conta do Office 365 com o OneDrive para Empresas ativado para acompanhar novas secções, criar notas e muito mais.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Standard | Todas as Power Automate regiões |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps |
| Aplicações Power | Standard | Todas as regiões do Power Apps |
| Automatize o poder | Standard | Todas as Power Automate regiões |
| Metadados do conector | |
|---|---|
| Editora | Microsoft |
| Sítio Web | https://products.office.com/onenote/digital-note-taking-app |
Para usar essa integração, você precisará acessar um bloco de anotações do OneNote armazenado no OneDrive for Business. Para estabelecer uma ligação, selecione Iniciar sessão. Você será solicitado a fornecer sua conta do O365 com o OneDrive for Business habilitado, siga o restante das telas para criar uma conexão.
Problemas conhecidos e limitações
- Ao usar a conexão, se você não estiver vendo a lista de blocos de anotações esperados, verifique a conta com a qual criou a conexão e tente novamente. Se vir um erro ao utilizar o conector, poderá procurar o código de erro para obter mais informações.
- Essa integração requer a conexão com uma conta que tenha a permissão "UserRemoteAPIs". Se você vir este erro: "Erro: o usuário não tem permissões para acessar o recurso solicitado", a conta pode não ter as permissões corretas. Um administrador do SharePoint pode controlar os níveis de permissão navegando até o conjunto de sites e abrindo as configurações do site. Selecione as Permissões do Site e, em seguida, o Nível de Permissão para ver as permissões (como Usar Interfaces Remotas) que o nível contém. Se um usuário pertencente a um determinado nível não tiver a permissão necessária, modifique o nível marcando a caixa para a permissão ou crie um novo nível de permissão e atribua-o ao usuário.
- O conector atualmente não suporta um parâmetro de entrada explícito Page Title para as ações Criar página . Esta é uma limitação decorrente da implementação da API do OneNote. No entanto, o título pode ser especificado como parte do Conteúdo da Página em HTML usando as <tags title></title>.
-
Secção do bloco de notas. Se você quiser fornecer um valor personalizado para o parâmetro Notebook Section, especifique-o no formato URL da API. O padrão url da api:
https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{siteCollectionsId}/sites/{SiteId}/notes/sections/{SectionId}/pages. Para obter mais informações, você pode dar uma olhada na documentação da API do OneNote. -
A ação Criar uma página em Notas Rápidas não é suportada nas seguintes regiões:
- Aplicativos lógicos:
- Azure Government
- Regiões do Azure China
- Power Automate e Power Apps:
- Governo dos Estados Unidos (GCC)
- Governo dos EUA (Alto CCG)
- China Cloud operado pela 21Vianet
- Aplicativos lógicos:
- A ação Obter conteúdo da página não é suportada no Power Apps, no entanto, esta ação é suportada no Power Automate.
Observação
Os seguintes caracteres não são permitidos no nome do bloco de anotações: *":<>?/|%
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
| Frequência das sondagens de desencadeamento | 1 | 1200 segundos |
Ações
| Atualizar o conteúdo da página |
Atualize o conteúdo da página HTML. |
| Criar página numa secção |
Crie uma nova página em uma seção especificada. |
| Criar secção num bloco de notas |
Criar secção num bloco de notas. |
| Criar uma página nas Notas Rápidas |
Crie uma nova página na secção Notas Rápidas. |
| Eliminar uma página |
Excluir uma página. |
| Obter blocos de notas recentes |
Obtenha blocos de notas recentes. |
| Obter conteúdo da página |
Obtenha conteúdo de página HTML. |
| Obter páginas para uma secção específica |
Obter páginas para uma seção específica. |
| Obter secções no bloco de notas |
Obter seções em um bloco de anotações específico. |
Atualizar o conteúdo da página
Atualize o conteúdo da página HTML.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tecla do Notebook
|
notebookKey | True | string |
Uma chave que identifica o bloco de notas. Observe que isso é específico da API e não pode ser digitado manualmente. |
|
Secção do bloco de notas
|
sectionId | True | string |
URL da API das páginas da seção. |
|
ID da página
|
pageId | True | string |
ID exclusivo da página. |
|
Target
|
target | string |
O elemento a ser atualizado. |
|
|
Ação
|
action | string |
A ação a ser executada no elemento de destino. |
|
|
Localização
|
position | string |
O local para adicionar o conteúdo fornecido. |
|
|
Content
|
content | html |
O novo conteúdo. |
Devoluções
O conteúdo HTML da página
- response
- string
Criar página numa secção
Crie uma nova página em uma seção especificada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tecla do Notebook
|
notebookKey | True | string |
Uma chave que identifica o bloco de notas. Observe que isso é específico da API e não pode ser digitado manualmente. |
|
Secção do bloco de notas
|
sectionId | True | string |
URL da API das páginas da seção. |
|
Conteúdo da Página
|
pageContent | True | html |
Conteúdo da página. |
Devoluções
- Body
- Page
Criar secção num bloco de notas
Criar secção num bloco de notas.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tecla do Notebook
|
notebookKey | True | string |
Uma chave que identifica o bloco de notas. Observe que isso é específico da API e não pode ser digitado manualmente. |
|
Nome da nova secção
|
name | string |
O nome da nova seção. |
Devoluções
Criar uma página nas Notas Rápidas
Crie uma nova página na secção Notas Rápidas.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Conteúdo da Página
|
pageContent | True | html |
Conteúdo da página. |
Devoluções
- Body
- Page
Eliminar uma página
Excluir uma página.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tecla do Notebook
|
notebookKey | True | string |
Uma chave que identifica o bloco de notas. Observe que isso é específico da API e não pode ser digitado manualmente. |
|
Secção do bloco de notas
|
sectionId | True | string |
URL da API das páginas da seção. |
|
ID da página
|
pageId | True | string |
ID exclusivo da página. |
Obter blocos de notas recentes
Obter conteúdo da página
Obtenha conteúdo de página HTML.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tecla do Notebook
|
notebookKey | True | string |
Uma chave que identifica o bloco de notas. Observe que isso é específico da API e não pode ser digitado manualmente. |
|
Secção do bloco de notas
|
sectionId | True | string |
URL da API das páginas da seção. |
|
ID da página
|
pageId | True | string |
ID exclusivo da página. |
Devoluções
O conteúdo HTML da página
- response
- string
Obter páginas para uma secção específica
Obter páginas para uma seção específica.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tecla do Notebook
|
notebookKey | True | string |
Uma chave que identifica o bloco de notas. Observe que isso é específico da API e não pode ser digitado manualmente. |
|
Secção do bloco de notas
|
sectionId | True | string |
URL da API das páginas da seção. |
Devoluções
Obter secções no bloco de notas
Obter seções em um bloco de anotações específico.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tecla do Notebook
|
notebookKey | True | string |
Uma chave que identifica o bloco de notas. Observe que isso é específico da API e não pode ser digitado manualmente. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
valor
|
value | array of SectionListItem |
Acionadores
| Quando um novo grupo de seção é criado |
Aciona um fluxo quando um novo grupo de seções é adicionado a um bloco de anotações. |
| Quando uma nova página é criada em uma seção |
Aciona um fluxo quando uma nova página é adicionada a uma seção. |
| Quando uma nova seção é criada |
Aciona um fluxo quando uma nova seção é adicionada a um bloco de anotações. |
Quando um novo grupo de seção é criado
Aciona um fluxo quando um novo grupo de seções é adicionado a um bloco de anotações.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tecla do Notebook
|
notebookKey | True | string |
Uma chave que identifica o bloco de notas. Observe que isso é específico da API e não pode ser digitado manualmente. |
Devoluções
Resposta para um novo grupo de seções.
Quando uma nova página é criada em uma seção
Aciona um fluxo quando uma nova página é adicionada a uma seção.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tecla do Notebook
|
notebookKey | True | string |
Uma chave que identifica o bloco de notas. Observe que isso é específico da API e não pode ser digitado manualmente. |
|
Secção do bloco de notas
|
sectionId | True | string |
URL da API das páginas da seção. |
Devoluções
Resposta para uma nova página.
- Body
- NewPageResponse
Quando uma nova seção é criada
Aciona um fluxo quando uma nova seção é adicionada a um bloco de anotações.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tecla do Notebook
|
notebookKey | True | string |
Uma chave que identifica o bloco de notas. Observe que isso é específico da API e não pode ser digitado manualmente. |
Devoluções
Resposta para uma nova seção.
- Body
- NewSectionResponse
Definições
CreateSectionInNotebookResponse
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Contexto OData
|
@odata.context | string |
O contexto OData. |
|
Criado pelo nome
|
createdBy | string |
Esta seção criada pelo nome. |
|
Tempo criado
|
createdTime | date-time |
Esta seção criou tempo. |
|
Criar seção na ID do objeto do bloco de anotações
|
id | string | |
|
Sinalizador de seção padrão
|
isDefault | boolean |
Um sinalizador para indicar se esta é a seção padrão. |
|
modificado pela última vez por
|
lastModifiedBy | string |
Última modificação pelo nome. |
|
Hora da última modificação
|
lastModifiedTime | date-time |
A hora em que esta seção foi modificada pela última vez. |
|
href cliente de desktop
|
links.oneNoteClientUrl.href | string |
Href do cliente de área de trabalho do OneNote. |
|
Cliente Web href
|
links.oneNoteWebUrl.href | string |
Href do cliente Web do OneNote. |
|
Nome da secção
|
name | string |
O nome da seção. |
|
As páginas Url
|
pagesUrl | string |
O url das páginas. |
|
Url para criar secção no bloco de notas
|
self | string |
A url para criar seção no grupo de blocos de anotações. |
Página
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Título da página
|
title | string |
O título da página. |
|
links
|
links | Link |
Os links associados à página do OneNote. |
|
URL do conteúdo
|
contentUrl | string |
Um url para o conteúdo da página. |
|
Data da última modificação
|
lastModifiedTime | date-time |
A data da última modificação da página. |
|
Data de criação
|
createdTime | date-time |
A data em que a página foi criada. |
|
Id
|
id | string |
O identificador exclusivo da página. |
Computador portátil
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome do arquivo
|
FileName | string | |
|
Key
|
Key | string |
ParentNotebook
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Chave do bloco de anotações pai
|
id | string |
O identificador exclusivo do bloco de anotações pai. |
|
Nome do bloco de anotações pai
|
name | string |
O nome do bloco de anotações pai. |
|
URL do Bloco de Anotações Pai
|
self | string |
Um link url para o bloco de anotações pai. |
Link
Os links associados à página do OneNote.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
oneNoteClientUrl
|
oneNoteClientUrl | OneNoteClientUrl | |
|
oneNoteWebUrl
|
oneNoteWebUrl | OneNoteWebUrl |
OneNoteClientUrl
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
URL do cliente OneNote
|
href | string |
Um link para o bloco de anotações usando o cliente Windows do OneNote. |
OneNoteWebUrl
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
URL da Web do OneNote
|
href | string |
Um link para o bloco de anotações usando o cliente Web do OneNote. |
SectionListItem
Os campos incluídos em um item de lista de seção.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome da secção
|
name | string |
O nome da seção. |
|
Chave de secção
|
pagesUrl | string |
A chave usada para fazer referência a esta seção; também um url para as páginas. |
|
Identificador de secção
|
id | string |
Identificador único da secção. |
SectionResponse
Os campos incluídos numa secção.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Criador
|
createdBy | string |
O criador da seção. |
|
Data de criação
|
createdTime | date-time |
A data e hora de criação da seção. |
|
Identificador de secção
|
id | string |
Identificador único da secção. |
|
modificado pela última vez por
|
lastModifiedBy | string |
O usuário que modificou a seção pela última vez. |
|
Data da última modificação
|
lastModifiedTime | date-time |
A data e hora da última modificação da seção. |
|
Nome da secção
|
name | string |
O nome da seção. |
|
URL das páginas
|
pagesUrl | string |
Url para as páginas nesta seção. |
|
parentNotebook
|
parentNotebook | ParentNotebook | |
|
Endereço URL
|
self | string |
O url para esta seção. |
SectionGroupResponse
Os campos incluídos em um grupo de seções.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Data de criação
|
createdTime | date-time |
A data e hora de criação do grupo de seção. |
|
Criador
|
createdBy | string |
O criador do grupo de secções. |
|
Identificador
|
id | string |
Identificador exclusivo do grupo de seções. |
|
Último modificador
|
lastModifiedBy | string |
O usuário que modificou o grupo de seções pela última vez. |
|
Data da última modificação
|
lastModifiedTime | date-time |
A data e hora da última modificação do grupo de secções. |
|
Nome
|
name | string |
O nome do grupo de seções. |
|
Seções Url
|
sectionsUrl | string |
Url das seções dentro deste grupo de seções. |
|
URL do Grupo de Seções
|
self | string |
O url para este grupo de seção. |
NewSectionResponse
Resposta para uma nova seção.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Secções
|
value | array of SectionResponse |
Uma matriz de objetos, cada um representando uma seção específica. |
NewSectionGroupResponse
Resposta para um novo grupo de seções.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Grupos de Secções
|
value | array of SectionGroupResponse |
Uma matriz de objetos, cada um representando um grupo de seção específico. |
NewPageResponse
Resposta para uma nova página.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Páginas
|
value | array of Page |
Uma matriz de objetos, cada um representando uma página específica. |
GetPagesInSectionResponse
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Contexto OData
|
@odata.context | string |
O contexto OData. |
|
Páginas no objeto de valor da seção
|
value | array of object |
valor |
|
URL do conteúdo
|
value.contentUrl | string |
O URL do conteúdo. |
|
Criado por id do aplicativo
|
value.createdByAppId | string |
O criado pelo id do aplicativo. |
|
Tempo criado
|
value.createdTime | date-time |
O tempo criado para esta resposta. |
|
Identificador exclusivo da resposta
|
value.id | string |
O identificador exclusivo para esta resposta. |
|
Hora da última modificação
|
value.lastModifiedTime | date-time |
A última hora modificada para este objeto. |
|
Cliente de área de trabalho do OneNote href
|
value.links.oneNoteClientUrl.href | string |
Href do cliente de área de trabalho do OneNote. |
|
Cliente Web do OneNote href
|
value.links.oneNoteWebUrl.href | string |
Href do cliente Web do OneNote. |
|
Identificador exclusivo da secção principal
|
value.parentSection.id | string |
O identificador exclusivo para esta seção pai de objeto. |
|
Nome da seção pai
|
value.parentSection.name | string | |
|
Páginas na seção pai da seção
|
value.parentSection.self | string |
O url para as páginas na seção pai da seção. |
|
Contexto OData da Seção Pai
|
value.parentSection@odata.context | string |
Contexto OData da Seção Pai. |
|
Grupo Páginas na Secção
|
value.self | string |
O url para o grupo Páginas na seção. |
|
Título da página
|
value.title | string |
Título da página. |
cadeia (de caracteres)
Este é o tipo de dados básico 'string'.