Almanac (nezávislý vydavatel) (Preview)

Almanac vytváří infrastrukturu pro spolupráci, která bude sloužit lidské kreativitě. Pomocí nejrychlejšího nástroje wikiwebu a pracovního postupu sloučit dokumenty do krásného uspořádaného jediného zdroje pravdy.

Tento konektor je dostupný v následujících produktech a oblastech:

Service	Class	Regions
Copilot Studio	Premium	Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD)
Logic Apps	Standard	Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure Government – Oblasti Azure China - Ministerstvo obrany USA (DoD)
Power Apps	Premium	Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD)
Power Automate	Premium	Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD)

Kontakt
Název	Troy Taylor
URL	https://www.hitachisolutions.com
Email	ttaylor@hitachisolutions.com

Metadata konektoru
Vydavatel	Troy Taylor
Internetová stránka	https://almanac.io/
Zásady ochrany osobních údajů	https://almanac.io/privacy-policy
Kategorie	Spolupráce; Obsah a soubory

Vytvoření připojení

Konektor podporuje následující typy ověřování:


výchozí	Parametry pro vytvoření připojení	Všechny oblasti	Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název	Typ	Description	Povinné
Identifikátor pracovního prostoru	řetězec	ID pracovního prostoru pro toto rozhraní API.	Pravdivé
Přístupový token (ve formátu Bearer yourAccessToken)	securestring	Přístupový token (ve formátu Bearer yourAccessToken) pro toto rozhraní API.	Pravdivé

Limity omezování

Name	Volání	Období obnovení
Volání rozhraní API na připojení	100	60 sekund

Akce

Aktualizace informací o dokumentu	Aktualizujte metainformace dokumentu.
Aktualizace informací o složce	Aktualizujte metainforma o složce.
Aktualizace přístupu k dokumentům	Aktualizujte přístup k dokumentu.
Import dokumentu	Importujte dokument z externího zdroje.
Nahradit informace o dokumentu	Aktualizujte metainformace dokumentu.
Nahradit informace o složce	Nahraďte metainforma o složce.
Nahrazení přístupu k dokumentu	Nahraďte přístup k dokumentu.
Odebrání přístupu k dokumentu	Odeberte přístup z dokumentu.
Odstranit položku sešitu	Odstraňte položku z příručky.
Odstranit vlastnost dokumentu	Odeberte z dokumentu vlastní vlastnost.
Odstranění vlastní vlastnosti dokumentu	Odstraňte vlastní vlastnost dokumentu na úrovni pracovního prostoru.
Přesunutí souborů	Přesuňte soubory (dokumenty nebo složky) do konkrétní složky (ve stejném nebo jiném pracovním prostoru).
Přidat vlastnost dokumentu	Přidejte do dokumentu vlastní vlastnost.
Přidání přístupu k dokumentu	Přidejte přístup k dokumentu.
Vytvoření položky příručky	Přidejte položku do příručky.
Vytvoření vlastnosti dokumentu	Vytvořte vlastnost dokumentu na úrovni pracovního prostoru.
Vytvořit složku	Vytvořte složku.
Získat příručky	Načte seznam handbooků pracovních prostorů.
Získání dokumentů	Načtěte meta informace o všech dokumentech v pracovním prostoru.
Získání importu	Načtěte informace o existujícím importu.
Získání informací o dokumentu	Načtěte metainformace dokumentu.
Získání informací o složce	Načte seznam meta informací o složce.
Získání položek příručky	Načte seznam položek příručky.
Získání přístupu k dokumentům	Zobrazení seznamu přístupů k dokumentům
Získání skupin	Načtěte skupiny uživatelů.
Získání složek	Načte seznam všech složek.
Získání uživatelů	Načtěte seznam uživatelů.
Získání uživatelů ve skupině	Načtěte všechny uživatele skupiny uživatelů.
Získání vlastností dokumentu	Výpis vlastních vlastností dokumentu na úrovni pracovního prostoru
Získání vlastností dokumentu	Zobrazení vlastních vlastností dokumentu na úrovni dokumentu

Aktualizace informací o dokumentu

ID operace:: PatchDocsId

Aktualizujte metainformace dokumentu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Title	doc[title]	True	string	Název dokumentu.
ID	id	True	integer	Identifikátor.

Návraty

Model dokumentace: Doc

Aktualizace informací o složce

ID operace:: PatchFoldersId

Aktualizujte metainforma o složce.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název složky	folder[title]	True	string	Název složky.
ID	id	True	integer	Identifikátor.

Návraty

Model složek: Folder

Aktualizace přístupu k dokumentům

ID operace:: PatchDocsDocIdAccessesId

Aktualizujte přístup k dokumentu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Povolení	access[permission]	True	string	Oprávnění.
ID dokumentu	doc_id	True	integer	Identifikátor dokumentu.
ID	id	True	integer	Identifikátor.

Návraty

Model přístupu k dokumentu: DocAccess

Import dokumentu

ID operace:: PostImports

Importujte dokument z externího zdroje.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
File	import[file]	True	file	Soubor, který chcete importovat.
Zdroj	import[source]	True	string	Zdroj souboru.

Návraty

Import modelu: Import

Nahradit informace o dokumentu

ID operace:: PutDocsId

Aktualizujte metainformace dokumentu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Title	doc[title]	True	string	Název dokumentu.
ID	id	True	integer	Identifikátor.

Návraty

Model dokumentace: Doc

Nahradit informace o složce

ID operace:: PutFoldersId

Nahraďte metainforma o složce.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název složky	folder[title]	True	string	Název složky.
ID	id	True	integer	Identifikátor.

Návraty

Model složek: Folder

Nahrazení přístupu k dokumentu

ID operace:: PutDocsDocIdAccessesId

Nahraďte přístup k dokumentu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Povolení	access[permission]	True	string	Oprávnění.
ID dokumentu	doc_id	True	integer	Identifikátor dokumentu.
ID	id	True	integer	Identifikátor.

Návraty

Model přístupu k dokumentu: DocAccess

Odebrání přístupu k dokumentu

ID operace:: DeleteDocsDocIdAccessesId

Odeberte přístup z dokumentu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID dokumentu	doc_id	True	integer	Identifikátor dokumentu.
ID	id	True	integer	Identifikátor.

Odstranit položku sešitu

ID operace:: DeleteHandbooksHandbookIdItemsId

Odstraňte položku z příručky.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID	id	True	string	Identifikátor.
ID příručky	handbook_id	True	integer	Identifikátor příručky.

Odstranit vlastnost dokumentu

ID operace:: DeleteDocsDocIdPropertiesId

Odeberte z dokumentu vlastní vlastnost.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID dokumentu	doc_id	True	integer	Identifikátor dokumentu.
ID	id	True	integer	Identifikátor.

Odstranění vlastní vlastnosti dokumentu

ID operace:: DeletePropertiesId

Odstraňte vlastní vlastnost dokumentu na úrovni pracovního prostoru.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID	id	True	integer	Identifikátor.

Přesunutí souborů

ID operace:: PostFilesMove

Přesuňte soubory (dokumenty nebo složky) do konkrétní složky (ve stejném nebo jiném pracovním prostoru).

Parametry

Name	Klíč	Typ	Description
ID složek	folder_ids[]	array	Identifikátory složek.
ID dokumentu	doc_ids[]	array	Identifikátory dokumentu.
ID cílové složky	destination_folder_id	integer	Identifikátor cílové složky.
ID cílového pracovního prostoru	destination_workspace_id	integer	Identifikátor cílového pracovního prostoru.

Přidat vlastnost dokumentu

ID operace:: PostDocsDocIdProperties

Přidejte do dokumentu vlastní vlastnost.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID vlastnosti	property_id	True	integer	Identifikátor vlastnosti.
Hodnota	value		string	Typ parametru `value` závisí na typu vlastnosti: 'text', 'date', 'number', 'link' => String 'single_select' => { 'selected_item_id': Integer }, the PropertyValue#ID 'multi_select' => { 'selected_item_ids': Array[Integer] }, selected PropertyValue#ID 'checkbox' => { 'checked': Boolean } 'document' => { 'doc_id': Integer }, the Document#ID 'person' => { 'user_ids': Array[Integer] }, ID uživatele#ID.
ID dokumentu	doc_id	True	integer	Identifikátor dokumentu.

Návraty

Model vlastností doc: DocProperty

Přidání přístupu k dokumentu

ID operace:: PostDocsDocIdAccesses

Přidejte přístup k dokumentu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Povolení	access[permission]	True	string	Oprávnění.
Typ přístupového objektu	access[accessor_type]	True	string	Typ příslušenství.
ID přístupového objektu	access[accessor_id]	True	integer	Identifikátor přístupového objektu.
ID dokumentu	doc_id	True	integer	Identifikátor dokumentu.

Návraty

Model přístupu k dokumentu: DocAccess

Vytvoření položky příručky

ID operace:: PostHandbooksHandbookIdItems

Přidejte položku do příručky.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Typ položky	handbook_item[type]	True	string	Typ položky příručky.
Pozice položky	handbook_item[position]		integer	Připojí položku jako poslední pozici, pokud není k dispozici.
ID nadřazené položky	handbook_item[parent_item_id]		integer	ID nadřazené položky pro účely vnoření
ID dokumentu	handbook_item[doc_id]	True	integer	Vyžaduje se jenom pro položky dokumentu.
Název položky	handbook_item[title]	True	string	Vyžaduje se pouze pro položky oddílů a odkazů.
Adresa URL položky	handbook_item[url]	True	string	Vyžaduje se pouze pro položky propojení.
ID příručky	handbook_id	True	integer	Identifikátor příručky.

Návraty

HandbookItem Model: HandbookItem

Vytvoření vlastnosti dokumentu

ID operace:: PostProperties

Vytvořte vlastnost dokumentu na úrovni pracovního prostoru.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název vlastnosti	property[name]	True	string	Název vlastnosti, který musí být jedinečný pro každý pracovní prostor.
Typ vlastnosti	property[type]	True	string	Typ vlastnosti.
Výchozí nastavení pro články	property[default_for_articles]		boolean	Automaticky přidat tuto vlastnost do nových článků? Výchozí hodnota je False.
Formát dat	property[meta][date_format]		string	Volitelné pro vlastnosti typu datum.
Formát čísla	property[meta][number_format]		string	Volitelné pro vlastnosti typu číslo.
Povolit zmínce více lidí	property[meta][allow_mentioning_multiple_people]		boolean	Volitelné pro vlastnosti typu osoby.
Oznámit osobě	property[meta][notify_person]		boolean	Volitelné pro vlastnosti typu osoby.
Hodnoty vlastností	property[property_values][][value]	True	array	Hodnoty vlastností.
Barva	property[property_values][][meta][color]		array	Barva.

Návraty

Model vlastností: Property

Vytvořit složku

ID operace:: PostFolders

Vytvořte složku.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název složky	folder[title]	True	string	Název složky.
ID nadřazené složky	folder[parent_folder_id]		integer	ID nadřazené složky. Pokud není k dispozici, vytvoří se v kořenovém adresáři pracovního prostoru.

Návraty

Model složek: Folder

Získat příručky

ID operace:: GetHandbooks

Načte seznam handbooků pracovních prostorů.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Stránka	page		integer	Posun stránky pro načtení
Položky	items		integer	Počet položek, které se mají vrátit na stránku

Návraty

response: array of Handbook

Získání dokumentů

ID operace:: GetDocs

Načtěte meta informace o všech dokumentech v pracovním prostoru.

Parametry

Name	Klíč	Typ	Description
Stránka	page	integer	Posun stránky pro načtení
Položky	items	integer	Počet položek, které se mají vrátit na stránku
ID složky	folder_id	string	Volitelný filtr: Zobrazí jenom dokumenty, které jsou v kořenovém adresáři této složky.

Návraty

response: array of Doc

Získání importu

ID operace:: GetImportsId

Načtěte informace o existujícím importu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID	id	True	integer	Identifikátor.

Návraty

Import modelu: Import

Získání informací o dokumentu

ID operace:: GetDocsId

Načtěte metainformace dokumentu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID	id	True	integer	Identifikátor.

Návraty

Model dokumentace: Doc

Získání informací o složce

ID operace:: GetFoldersId

Načte seznam meta informací o složce.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID	id	True	string	Identifikátor.

Návraty

Model složek: Folder

Získání položek příručky

ID operace:: GetHandbooksHandbookIdItems

Načte seznam položek příručky.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Stránka	page		integer	Posun stránky pro načtení
Položky	items		integer	Počet položek, které se mají vrátit na stránku
ID příručky	handbook_id	True	integer	Identifikátor příručky.

Návraty

response: array of HandbookItem

Získání přístupu k dokumentům

ID operace:: GetDocsDocIdAccesses

Zobrazení seznamu přístupů k dokumentům

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Stránka	page		integer	Posun stránky pro načtení
Položky	items		integer	Počet položek, které se mají vrátit na stránku
ID dokumentu	doc_id	True	integer	Identifikátor dokumentu.

Návraty

response: array of DocAccess

Získání skupin

ID operace:: GetGroups

Načtěte skupiny uživatelů.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Stránka	page		integer	Posun stránky pro načtení
Položky	items		integer	Počet položek, které se mají vrátit na stránku

Návraty

response: array of Group

Získání složek

ID operace:: GetFolders

Načte seznam všech složek.

Parametry

Name	Klíč	Typ	Description
Stránka	page	integer	Posun stránky pro načtení
Položky	items	integer	Počet položek, které se mají vrátit na stránku
ID nadřazené složky	parent_folder_id	string	Volitelný filtr: Zobrazí jenom složky s tímto ID nadřazené složky.

Návraty

response: array of Folder

Získání uživatelů

ID operace:: GetUsers

Načtěte seznam uživatelů.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Stránka	page		integer	Posun stránky pro načtení
Položky	items		integer	Počet položek, které se mají vrátit na stránku

Návraty

response: array of User

Získání uživatelů ve skupině

ID operace:: GetGroupsGroupIdUsers

Načtěte všechny uživatele skupiny uživatelů.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Stránka	page		integer	Posun stránky pro načtení
Položky	items		integer	Počet položek, které se mají vrátit na stránku
ID skupiny	group_id	True	integer	Identifikátor skupiny.

Návraty

response: array of User

Získání vlastností dokumentu

ID operace:: GetProperties

Výpis vlastních vlastností dokumentu na úrovni pracovního prostoru

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Stránka	page		integer	Posun stránky pro načtení
Položky	items		integer	Počet položek, které se mají vrátit na stránku

Návraty

response: array of Property

Získání vlastností dokumentu

ID operace:: GetDocsDocIdProperties

Zobrazení vlastních vlastností dokumentu na úrovni dokumentu

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Stránka	page		integer	Posun stránky pro načtení
Položky	items		integer	Počet položek, které se mají vrátit na stránku
ID dokumentu	doc_id	True	integer	Identifikátor dokumentu.

Návraty

response: array of DocProperty

Definice

Uživatel

Name	Cesta	Typ	Description
ID	id	integer	Identifikátor
Křestní jméno	first_name	string	Jméno.
Příjmení	last_name	string	Příjmení.

Skupina

Name	Cesta	Typ	Description
ID	id	integer	Identifikátor
Název	name	string	Název.
Description	description	string	Popis.
Accessibility	accessibility	string	Přístupnost.

Vlastnictví

Name	Cesta	Typ	Description
ID	id	integer	Identifikátor
Název	name	string	Název.
Typ	type	string	Typ.
Výchozí nastavení pro články	default_for_articles	boolean	Určuje, jestli se má pro články použít výchozí nastavení.
meta	meta	PropertyMeta
property_values	property_values	array of PropertyValue

PropertyMeta

Name	Cesta	Typ	Description
Formát čísla	number_format	string	Pouze vráceny a relevantní pro vlastnosti typu číslo.
Formát data	date_format	string	Pouze vráceno a relevantní pro vlastnosti data typu
Povolit zmínce více lidí	allow_mentioning_multiple_people	boolean	Pouze vráceny a relevantní pro vlastnosti typu osoby.
Oznámit osobě	notify_person	boolean	Pouze vráceny a relevantní pro vlastnosti typu osoby.

PropertyValue

Name	Cesta	Typ	Description
ID	id	integer	Identifikátor
ID vlastnosti	property_id	integer	Identifikátor vlastnosti.
Hodnota	value	string	Hodnota.
meta	meta	PropertyValueMeta

PropertyValueMeta

Name	Cesta	Typ	Description
Barva	color	string	Vráceny a relevantní pouze pro vlastnosti typu single_select a multi_select.

HandbookItem

Name	Cesta	Typ	Description
ID	id	integer	Identifikátor
ID příručky	handbook_id	integer	Identifikátor příručky.
Typ	type	string	Typ.
Position	position	integer	Pozice.
Title	title	string	Relevantní pouze pro položky oddílů a odkazů.
URL	url	string	Relevantní pouze pro položky odkazu.
ID nadřazené položky	parent_item_id	integer	Pokud je položka vnořená, není null.
ID dokumentu	doc_id	integer	Platí jenom pro položky dokumentu.

Příručka

Name	Cesta	Typ	Description
ID	id	integer	Identifikátor
Název	name	string	Název.

Složka

Name	Cesta	Typ	Description
ID	id	integer	Identifikátor
Title	title	string	Název.
Identifikátor pracovního prostoru	workspace_id	integer	Identifikátor pracovního prostoru.
ID nadřazené složky	parent_folder_id	integer	Identifikátor nadřazené složky.

DocAccess

Name	Cesta	Typ	Description
ID	id	integer	Identifikátor
ID dokumentu	doc_id	integer	Identifikátor dokumentu.
Povolení	permission	string	Oprávnění.
Typ přístupového objektu	accessor_type	string	Typ příslušenství.
ID přístupového objektu	accessor_id	integer	Identifikátor přístupového objektu.
Zděděný	inherited	boolean	Zda je zděděno.

DocProperty

Name	Cesta	Typ	Description
ID	id	integer	Identifikátor
Model vlastností	property	Property
Hodnota	value	string	`value` Typ závisí na typu vlastnosti: 'text', 'date', 'number', 'link' => String 'single_select' => { 'selected_item_id': Integer }, the PropertyValue#ID 'multi_select' => { 'selected_item_ids': Array[Integer] }, selected PropertyValue#ID 'checkbox' => { 'checked': Boolean } 'document' => { 'doc_id': Integer }, the Document#ID 'person' => { 'user_ids': Array[Integer] }, ID user#ID.

Doktor

Name	Cesta	Typ	Description
ID	id	integer	Identifikátor
Title	title	string	Název.
Identifikátor pracovního prostoru	workspace_id	integer	Identifikátor pracovního prostoru.
ID složky	folder_id	integer	Identifikátor složky.
ID vlastníka	owner_id	integer	ID uživatele vlastníka dokumentu.
Vytvořeno na adrese	created_at	string	ISO8601 formátované datum a čas.
Aktualizováno na adrese	updated_at	string	ISO8601 formátované datum a čas.

Import

Name	Cesta	Typ	Description
ID	id	integer	Identifikátor
stav	status	string
Model dokumentace	doc	Doc