Udostępnij przez

OneNote (business)

Program OneNote to aplikacja do tworzenia notatek od firmy Microsoft, która ułatwia synchronizowanie pomysłów, szkiców i notatek na wszystkich urządzeniach. Połącz się z kontem usługi Office 365 za pomocą usługi OneDrive dla Firm, aby śledzić nowe sekcje, tworzyć notatki i nie tylko.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Standard Wszystkie regiony usługi Power Automate
Logic Apps Standard Wszystkie regiony usługi Logic Apps
Power Apps Standard Wszystkie regiony usługi Power Apps
Power Automate Standard Wszystkie regiony usługi Power Automate
Metadane łącznika
Publisher Microsoft
Witryna internetowa https://products.office.com/onenote/digital-note-taking-app

Aby korzystać z tej integracji, musisz mieć dostęp do notesu programu OneNote przechowywanego w usłudze OneDrive dla Firm. Aby nawiązać połączenie, wybierz pozycję Zaloguj. Zostanie wyświetlony monit o podanie konta usługi O365 z włączoną usługą OneDrive dla Firm. Postępuj zgodnie z pozostałymi ekranami, aby utworzyć połączenie.

Znane problemy i ograniczenia

  1. Jeśli podczas korzystania z połączenia nie widzisz listy notesu, którego oczekujesz, sprawdź konto, za pomocą którego utworzono połączenie, i spróbuj ponownie. Jeśli podczas korzystania z łącznika zostanie wyświetlony błąd, możesz wyszukać kod błędu , aby uzyskać więcej informacji.
  2. Ta integracja wymaga nawiązania połączenia z kontem z uprawnieniem "UserRemoteAPIs". Jeśli zostanie wyświetlony następujący błąd: "Błąd: użytkownik nie ma uprawnień dostępu do żądanego zasobu", konto może nie mieć odpowiednich uprawnień. Administrator programu SharePoint może kontrolować poziomy uprawnień, przechodząc do zbioru witryn i otwierając ustawienia witryny. Wybierz uprawnienia lokacji, a następnie poziom uprawnień, aby wyświetlić uprawnienia (takie jak Używanie interfejsów zdalnych), które zawiera poziom. Jeśli użytkownik należący do określonego poziomu nie ma wymaganych uprawnień, zmodyfikuj poziom, zaznaczając pole wyboru uprawnienia lub utwórz nowy poziom uprawnień i przypisz go do użytkownika.
  3. Łącznik obecnie nie obsługuje jawnego parametru wejściowego Tytuł strony dla akcji Tworzenie strony . Jest to ograniczenie wynikające z implementacji interfejsu API programu OneNote. Tytuł można jednak określić jako część zawartości strony w kodzie HTML przy użyciu <tagów tytułu></tytułu>.
  4. Sekcja notesu. Jeśli chcesz podać wartość niestandardową dla parametru Sekcja notesu, określ ją w formacie adresu URL interfejsu API. Wzorzec adresu URL interfejsu API: https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{siteCollectionsId}/sites/{SiteId}/notes/sections/{SectionId}/pages. Aby uzyskać więcej informacji, zapoznaj się z dokumentacją interfejsu API programu OneNote.
  5. Tworzenie strony w akcji Szybkie notatki nie jest obsługiwane w następujących regionach:
    • Logic Apps:
      • Azure Government
      • Regiony Azure w Chinach
    • Power Automate i Power Apps:
      • Rząd USA (GCC)
      • Rząd USA (GCC High)
      • China Cloud obsługiwane przez firmę 21Vianet
  6. Akcja Pobierz zawartość strony nie jest obsługiwana w usłudze Power Apps, jednak ta akcja jest obsługiwana w usłudze Power Automate.

Uwaga / Notatka

Następujące znaki nie są dozwolone w nazwie notesu: *":<>?/|%

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund
Częstotliwość sond wyzwalacza 1 1200 sekund

Akcje

Aktualizowanie zawartości strony

Zaktualizuj zawartość strony HTML.
Pobieranie ostatnich notesów

Pobierz najnowsze notesy.
Pobieranie sekcji w notesie

Pobieranie sekcji w określonym notesie.
Pobieranie stron dla określonej sekcji

Pobieranie stron dla określonej sekcji.
Pobieranie zawartości strony

Pobierz zawartość strony HTML.
Tworzenie sekcji w notesie

Utwórz sekcję w notesie.
Tworzenie strony w sekcji

Utwórz nową stronę w określonej sekcji.
Tworzenie strony w szybkich notatkach

Utwórz nową stronę w sekcji Szybkie notatki.
Usuń stronę

Usuń stronę.

Aktualizowanie zawartości strony

Identyfikator operacji:
UpdatePageContent

Zaktualizuj zawartość strony HTML.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klucz notesu
 notebookKey True string

Klucz identyfikujący notes. Należy pamiętać, że jest to specyficzne dla interfejsu API i nie można go wpisać ręcznie.
Sekcja notesu
 sectionId True string

Adres URL interfejsu API stron sekcji.
Identyfikator strony
 pageId True string

Unikatowy identyfikator strony.
Target
 target string

Element do aktualizacji.
Akcja
 action string

Akcja do wykonania w elemecie docelowym.
Lokalizacja
 position string

Lokalizacja dodawania dostarczonej zawartości.
Content
 content html

Nowa zawartość.

Zwraca

Zawartość HTML strony

response
string

Pobieranie ostatnich notesów

Identyfikator operacji:
GetNotebooks

Pobierz najnowsze notesy.

Zwraca

response
array of Notebook

Pobieranie sekcji w notesie

Identyfikator operacji:
GetSectionsInNotebook

Pobieranie sekcji w określonym notesie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klucz notesu
 notebookKey True string

Klucz identyfikujący notes. Należy pamiętać, że jest to specyficzne dla interfejsu API i nie można go wpisać ręcznie.

Zwraca

Nazwa Ścieżka Typ Opis
value
 value array of SectionListItem

Pobieranie stron dla określonej sekcji

Identyfikator operacji:
GetPagesInSection

Pobieranie stron dla określonej sekcji.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klucz notesu
 notebookKey True string

Klucz identyfikujący notes. Należy pamiętać, że jest to specyficzne dla interfejsu API i nie można go wpisać ręcznie.
Sekcja notesu
 sectionId True string

Adres URL interfejsu API stron sekcji.

Zwraca

Body
GetPagesInSectionResponse

Pobieranie zawartości strony

Identyfikator operacji:
GetPageContent

Pobierz zawartość strony HTML.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klucz notesu
 notebookKey True string

Klucz identyfikujący notes. Należy pamiętać, że jest to specyficzne dla interfejsu API i nie można go wpisać ręcznie.
Sekcja notesu
 sectionId True string

Adres URL interfejsu API stron sekcji.
Identyfikator strony
 pageId True string

Unikatowy identyfikator strony.

Zwraca

Zawartość HTML strony

response
string

Tworzenie sekcji w notesie

Identyfikator operacji:
CreateSectionInNotebook

Utwórz sekcję w notesie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klucz notesu
 notebookKey True string

Klucz identyfikujący notes. Należy pamiętać, że jest to specyficzne dla interfejsu API i nie można go wpisać ręcznie.
Nazwa nowej sekcji
 name string

Nazwa nowej sekcji.

Zwraca

Body
CreateSectionInNotebookResponse

Tworzenie strony w sekcji

Identyfikator operacji:
CreatePageInSection

Utwórz nową stronę w określonej sekcji.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klucz notesu
 notebookKey True string

Klucz identyfikujący notes. Należy pamiętać, że jest to specyficzne dla interfejsu API i nie można go wpisać ręcznie.
Sekcja notesu
 sectionId True string

Adres URL interfejsu API stron sekcji.
Zawartość strony
 pageContent True html

Zawartość strony.

Zwraca

Body
Page

Tworzenie strony w szybkich notatkach

Identyfikator operacji:
CreatePageInQuickNotes

Utwórz nową stronę w sekcji Szybkie notatki.

Parametry

Nazwa Klucz Wymagane Typ Opis
Zawartość strony
 pageContent True html

Zawartość strony.

Zwraca

Body
Page

Usuń stronę

Identyfikator operacji:
DeletePage

Usuń stronę.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klucz notesu
 notebookKey True string

Klucz identyfikujący notes. Należy pamiętać, że jest to specyficzne dla interfejsu API i nie można go wpisać ręcznie.
Sekcja notesu
 sectionId True string

Adres URL interfejsu API stron sekcji.
Identyfikator strony
 pageId True string

Unikatowy identyfikator strony.

Wyzwalacze

Po utworzeniu nowej grupy sekcji

Wyzwala przepływ po dodaniu nowej grupy sekcji do notesu.
Po utworzeniu nowej sekcji

Wyzwala przepływ po dodaniu nowej sekcji do notesu.
Po utworzeniu nowej strony w sekcji

Wyzwala przepływ po dodaniu nowej strony do sekcji.

Po utworzeniu nowej grupy sekcji

Identyfikator operacji:
OnNewSectionGroupInNotebook

Wyzwala przepływ po dodaniu nowej grupy sekcji do notesu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klucz notesu
 notebookKey True string

Klucz identyfikujący notes. Należy pamiętać, że jest to specyficzne dla interfejsu API i nie można go wpisać ręcznie.

Zwraca

Odpowiedź dla nowej grupy sekcji.

Body
NewSectionGroupResponse

Po utworzeniu nowej sekcji

Identyfikator operacji:
OnNewSectionInNotebook

Wyzwala przepływ po dodaniu nowej sekcji do notesu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klucz notesu
 notebookKey True string

Klucz identyfikujący notes. Należy pamiętać, że jest to specyficzne dla interfejsu API i nie można go wpisać ręcznie.

Zwraca

Odpowiedź na nową sekcję.

Body
NewSectionResponse

Po utworzeniu nowej strony w sekcji

Identyfikator operacji:
OnNewPageInSection

Wyzwala przepływ po dodaniu nowej strony do sekcji.

Parametry

Nazwa Klucz Wymagane Typ Opis
Klucz notesu
 notebookKey True string

Klucz identyfikujący notes. Należy pamiętać, że jest to specyficzne dla interfejsu API i nie można go wpisać ręcznie.
Sekcja notesu
 sectionId True string

Adres URL interfejsu API stron sekcji.

Zwraca

Odpowiedź na nową stronę.

Body
NewPageResponse

Definicje

CreateSectionInNotebookResponse

Nazwa Ścieżka Typ Opis
Kontekst OData
 @odata.context string

Kontekst OData.
Utworzone według nazwy
 createdBy string

Ta sekcja utworzona według nazwy.
Czas utworzenia
 createdTime date-time

W tej sekcji utworzono czas.
Tworzenie sekcji w identyfikatorze obiektu notesu
 id string
Flaga sekcji domyślnej
 isDefault boolean

Flaga wskazująca, czy jest to sekcja domyślna.
Ostatnia modyfikacja wykonana przez
 lastModifiedBy string

Ostatnia modyfikacja według nazwy.
Godzina ostatniej modyfikacji
 lastModifiedTime date-time

Czas ostatniej modyfikacji tej sekcji.
Href klienta pulpitu
 links.oneNoteClientUrl.href string

Href klienta klasycznego programu OneNote.
Href klienta internetowego
 links.oneNoteWebUrl.href string

Href klienta internetowego programu OneNote.
Nazwa sekcji
 name string

Nazwa sekcji.
Adres URL stron
 pagesUrl string

Adres URL stron.
Adres URL do utworzenia sekcji w notesie
 self string

Adres URL do utworzenia sekcji w grupie notesów.

Strona

Nazwa Ścieżka Typ Opis
Tytuł strony
 title string

Tytuł strony.
links
 links Link

Łącza skojarzone ze stroną programu OneNote.
Adres URL zawartości
 contentUrl string

Adres URL do zawartości strony.
Data ostatniej modyfikacji
 lastModifiedTime date-time

Data ostatniej modyfikacji strony.
Data utworzenia
 createdTime date-time

Data utworzenia strony.
Id
 id string

Unikatowy identyfikator strony.

Notatnik

Nazwa Ścieżka Typ Opis
NazwaPliku
 FileName string
Key
 Key string

Element ParentNotebook

Nazwa Ścieżka Typ Opis
Klucz notesu nadrzędnego
 id string

Unikatowy identyfikator notesu nadrzędnego.
Nazwa notesu nadrzędnego
 name string

Nazwa notesu nadrzędnego.
Adres URL notesu nadrzędnego
 self string

Link adresu URL do notesu nadrzędnego.

Łącza skojarzone ze stroną programu OneNote.

Nazwa Ścieżka Typ Opis
oneNoteClientUrl
 oneNoteClientUrl OneNoteClientUrl
oneNoteWebUrl
 oneNoteWebUrl OneNoteWebUrl

OneNoteClientUrl

Nazwa Ścieżka Typ Opis
Adres URL klienta programu OneNote
 href string

Link do notesu przy użyciu klienta systemu Windows programu OneNote.

OneNoteWebUrl

Nazwa Ścieżka Typ Opis
Adres URL sieci Web programu OneNote
 href string

Link do notesu przy użyciu klienta internetowego programu OneNote.

SectionListItem

Pola zawarte w elemencie listy sekcji.

Nazwa Ścieżka Typ Opis
Nazwa sekcji
 name string

Nazwa sekcji.
Klucz sekcji
 pagesUrl string

Klucz używany do odwołowania się do tej sekcji; również adres URL stron.
Identyfikator sekcji
 id string

Unikatowy identyfikator sekcji.

SekcjaResponse

Pola zawarte w sekcji.

Nazwa Ścieżka Typ Opis
Kreator
 createdBy string

Twórca sekcji.
Data utworzenia
 createdTime date-time

Data i godzina utworzenia sekcji.
Identyfikator sekcji
 id string

Unikatowy identyfikator sekcji.
Ostatnia modyfikacja wykonana przez
 lastModifiedBy string

Użytkownik, który ostatnio zmodyfikował sekcję.
Data ostatniej modyfikacji
 lastModifiedTime date-time

Data i godzina ostatniej modyfikacji sekcji.
Nazwa sekcji
 name string

Nazwa sekcji.
Adres URL stron
 pagesUrl string

Adres URL stron w tej sekcji.
element parentNotebook
 parentNotebook ParentNotebook
URL
 self string

Adres URL do tej sekcji.

SekcjaGroupResponse

Pola zawarte w grupie sekcji.

Nazwa Ścieżka Typ Opis
Data utworzenia
 createdTime date-time

Data i godzina utworzenia grupy sekcji.
Kreator
 createdBy string

Twórca grupy sekcji.
Identyfikator
 id string

Unikatowy identyfikator grupy sekcji.
Ostatni modyfikator
 lastModifiedBy string

Użytkownik, który ostatnio zmodyfikował grupę sekcji.
Data ostatniej modyfikacji
 lastModifiedTime date-time

Data i godzina ostatniej modyfikacji grupy sekcji.
Name
 name string

Nazwa grupy sekcji.
Adres URL sekcji
 sectionsUrl string

Adres URL sekcji w tej grupie sekcji.
Adres URL grupy sekcji
 self string

Adres URL tej grupy sekcji.

NewSectionResponse

Odpowiedź na nową sekcję.

Nazwa Ścieżka Typ Opis
Sekcje
 value array of SectionResponse

Tablica obiektów, z których każda reprezentuje określoną sekcję.

NewSectionGroupResponse

Odpowiedź dla nowej grupy sekcji.

Nazwa Ścieżka Typ Opis
Grupy sekcji
 value array of SectionGroupResponse

Tablica obiektów, z których każda reprezentuje określoną grupę sekcji.

NewPageResponse

Odpowiedź na nową stronę.

Nazwa Ścieżka Typ Opis
Strony
 value array of Page

Tablica obiektów, z których każda reprezentuje określoną stronę.

GetPagesInSectionResponse

Nazwa Ścieżka Typ Opis
Kontekst OData
 @odata.context string

Kontekst OData.
Strony w obiekcie wartości sekcji
 value array of object

value
Adres URL zawartości
 value.contentUrl string

Adres URL zawartości.
Utworzone według identyfikatora aplikacji
 value.createdByAppId string

Utworzony przez identyfikator aplikacji.
Czas utworzenia
 value.createdTime date-time

Czas utworzenia tej odpowiedzi.
Unikatowy identyfikator odpowiedzi
 value.id string

Unikatowy identyfikator tej odpowiedzi.
Czas ostatniej modyfikacji
 value.lastModifiedTime date-time

Czas ostatniej modyfikacji dla tego obiektu.
Href klienta klasycznego programu OneNote
 value.links.oneNoteClientUrl.href string

Href klienta klasycznego programu OneNote.
Href klienta internetowego programu OneNote
 value.links.oneNoteWebUrl.href string

Href klienta internetowego programu OneNote.
Unikatowy identyfikator sekcji nadrzędnej
 value.parentSection.id string

Unikatowy identyfikator tej sekcji nadrzędnej obiektu.
Nazwa sekcji nadrzędnej
 value.parentSection.name string
Strony w sekcji nadrzędnej sekcji
 value.parentSection.self string

Adres URL stron w sekcji nadrzędnej sekcji.
Kontekst OData sekcji nadrzędnej
 value.parentSection@odata.context string

Kontekst OData sekcji nadrzędnej.
Strony w grupie sekcji
 value.self string

Adres URL grupy Strony w sekcji.
Tytuł strony
 value.title string

Tytuł strony.

ciąg

Jest to podstawowy typ danych "string".