synology_apm_repo.sdk.units.saas.site module¶
open_site_provider: M365 SharePoint Site (FORMAT-SPEC.md: SharePoint Site) via
list_version_table + item_version_table. M365-only.
Tree: “Document Library”/”List” categories (
CategorizedGroupTree) → list → items, with document-library folders nested byparent_folder_id(NamedGroupRecursiveTree). Each list’s top-level anchor is itsroot_folder_id(""for a general list, a non-empty id for a document library).Content: an item with a
content_listentry (an attached file) reads that object; one without (a plain list row, a folder) exports itsvaluesas JSON.
- class synology_apm_repo.sdk.units.saas.site.SiteState(list_create_time)¶
Bases:
objectWhat
_build_treeprefetches for_group_extras.- Variables:
list_create_time (collections.abc.Mapping[str, int]) – Each list’s
create_time, bylist_id.
- synology_apm_repo.sdk.units.saas.site.SITE_CONFIG = SaasWorkloadConfig(root_name='Lists', leaf_kind=<UnitKind.SITE_ITEM: 'site_item'>, tables=('list_version_table', 'item_version_table'), tree_factory=<function _build_tree>, content=<function _content>, object_names={'list_version_table': ('site_list_db',), 'item_version_table': ('site_item_db',)}, leaf_extras=<function _item_extras>, group_extras=<function _group_extras>, leaf_size=<function _leaf_size>, leaf_export_name=None)¶
SaasWorkloadConfigbehindopen_site_provider— Lists/document libraries viatree_strategy.CategorizedGroupTree.
- async synology_apm_repo.sdk.units.saas.site.open_site_provider(repo, version, saas_streams, *, shared=None)¶
Async factory over
SITE_CONFIG(seemake_saas_provider).
- class synology_apm_repo.sdk.units.saas.site.SiteListItems(rows, truncated)¶
Bases:
objectA SharePoint List’s items, each as its field dict.
- Variables:
- async synology_apm_repo.sdk.units.saas.site.read_site_list_items(provider, node, *, item_cap, read_limit, max_concurrent)¶
Up to
item_capof the items ofnode(a List group node,NodeRole.LIST_OVERVIEW), each read through at mostread_limitbytes,max_concurrentat a time, for showing the List as one table. Best-effort past the listing: an item that can’t be opened, read or parsed as a JSON object is left out rather than failing the whole List.- Raises:
ApmRepoError – Listing the List’s items failed.