synology_apm_repo.sdk.units.saas.contact module

open_contact_provider: M365/GWS Contact via contact_table, built as a SaasWorkloadProvider + SyntheticGroupedTree config. An empty contact_table is a valid, empty listing.

  • M365: contacts are grouped by parent_folder_id, named via contact_folder_table. The META JSON’s client_metadata holds Graph API contact fields; each contact exports as CSV (build_contact_csv).

  • GWS: contacts sit in one “Contacts” group; their many-to-many group memberships (_gws_contact_groups) become a groups detail. The META JSON (People API fields, plus photo_* keys when there’s a photo) exports as-is.

class synology_apm_repo.sdk.units.saas.contact.ContactState(gws_groups=<factory>)

Bases: object

What the contact tree_factory prefetches for _contact_extras.

Variables:

gws_groups (collections.abc.Mapping[str, list[str]]) – GWS contact group names, by contact_id; empty for M365.

gws_groups: Mapping[str, list[str]]
synology_apm_repo.sdk.units.saas.contact.CONTACT_CONFIG = SaasWorkloadConfig(root_name='Contacts', leaf_kind=<UnitKind.CONTACT: 'contact'>, tables=('contact_table',), tree_factory=<function _build_tree>, content=<function _content>, object_names={'contact_table': ('contact_db',)}, leaf_extras=<function _contact_extras>, group_extras=<function SaasWorkloadConfig.<lambda>>, leaf_size=<function SaasWorkloadConfig.<lambda>>, leaf_export_name=<function _export_name>)

SaasWorkloadConfig behind open_contact_provider.

async synology_apm_repo.sdk.units.saas.contact.open_contact_provider(repo, version, saas_streams, *, shared=None)

Async factory over CONTACT_CONFIG (see make_saas_provider).