class SynchronizationProgress
A class representing the progress of a synchronization job toward completion in Microsoft Office 365 services.
/tf/active/vicechatdev/SPFCsync/venv/lib64/python3.11/site-packages/office365/directory/synchronization/progress.py
4 - 5
simple
Purpose
This class serves as a data model to track and represent the progress state of synchronization operations in Office 365. It inherits from ClientValue, which is a base class for client-side value objects in the Office 365 SDK. The class is designed to encapsulate progress-related information for synchronization jobs, allowing applications to monitor and report on the status of data synchronization operations between Office 365 services.
Source Code
class SynchronizationProgress(ClientValue):
"""Represents the progress of a synchronizationJob toward completion."""
Parameters
| Name | Type | Default | Kind |
|---|---|---|---|
bases |
ClientValue | - |
Parameter Details
bases: Inherits from ClientValue, which provides base functionality for client-side value objects in the Office 365 SDK, including serialization and deserialization capabilities
Return Value
Instantiation returns a SynchronizationProgress object that represents the current state of a synchronization job. The object can be used to access progress-related properties and methods inherited from ClientValue.
Class Interface
Dependencies
office365
Required Imports
from office365.runtime.client_value import ClientValue
from office365.directory.synchronization.progress import SynchronizationProgress
Usage Example
from office365.directory.synchronization.progress import SynchronizationProgress
from office365.runtime.client_value import ClientValue
# Typically instantiated by the Office 365 SDK when retrieving synchronization job status
progress = SynchronizationProgress()
# The object is usually populated by the SDK with data from API responses
# Example of how it might be used in context:
# sync_job = client.directory.synchronization_jobs.get_by_id('job_id')
# progress = sync_job.progress
# This would contain progress information about the synchronization job
Best Practices
- This class is typically instantiated and populated by the Office 365 SDK rather than manually created by developers
- Use this class as a read-only data container to access synchronization progress information
- The class inherits serialization capabilities from ClientValue, making it suitable for JSON serialization/deserialization
- When working with synchronization jobs, retrieve this object through the appropriate Office 365 API endpoints rather than creating instances directly
- Ensure proper authentication and authorization are configured before accessing synchronization job data
Tags
Similar Components
AI-powered semantic similarity - components with related functionality:
-
class SynchronizationStatus 84.1% similar
-
class SynchronizationJob 65.6% similar
-
class SynchronizationQuarantine 64.6% similar
-
class DomainState 63.5% similar
-
class SynchronizationError 62.2% similar