🔍 Code Extractor

class SuiteNavData

Maturity: 24

A SharePoint entity class representing Suite Navigation Data, which manages navigation information for the SharePoint suite bar.

File:
/tf/active/vicechatdev/SPFCsync/venv/lib64/python3.11/site-packages/office365/sharepoint/portal/suite_nav_data.py
Lines:
4 - 7
Complexity:
simple

Purpose

SuiteNavData is a specialized entity class that represents Microsoft SharePoint Portal Suite Navigation Data. It inherits from the Entity base class and provides a specific entity type identifier for SharePoint's suite navigation system. This class is used to interact with and manage the suite navigation bar data in SharePoint, which typically includes top-level navigation elements across the SharePoint portal.

Source Code

class SuiteNavData(Entity):
    @property
    def entity_type_name(self):
        return "Microsoft.SharePoint.Portal.SuiteNavData"

Parameters

Name Type Default Kind
bases Entity -

Parameter Details

__init__: Inherits constructor from Entity base class. The exact parameters depend on the Entity parent class implementation, but typically includes context and resource path parameters for SharePoint entity initialization.

Return Value

Instantiation returns a SuiteNavData object that represents a SharePoint suite navigation data entity. The entity_type_name property returns the string 'Microsoft.SharePoint.Portal.SuiteNavData', which is used internally by SharePoint's OData protocol for entity type identification.

Class Interface

Methods

@property entity_type_name(self) -> str property

Purpose: Returns the OData entity type name for SharePoint suite navigation data

Returns: String value 'Microsoft.SharePoint.Portal.SuiteNavData' representing the entity type identifier used in SharePoint OData operations

Attributes

Name Type Description Scope
entity_type_name str Read-only property that returns the SharePoint OData entity type identifier for suite navigation data instance

Dependencies

  • office365.sharepoint.entity

Required Imports

from office365.sharepoint.portal.suite_nav_data import SuiteNavData
from office365.sharepoint.entity import Entity

Usage Example

from office365.sharepoint.client_context import ClientContext
from office365.sharepoint.portal.suite_nav_data import SuiteNavData

# Assuming you have a ClientContext set up
ctx = ClientContext(site_url).with_credentials(credentials)

# Create or retrieve SuiteNavData instance
suite_nav = SuiteNavData(ctx)

# Access entity type name
entity_type = suite_nav.entity_type_name
print(entity_type)  # Output: Microsoft.SharePoint.Portal.SuiteNavData

# The instance can be used with SharePoint operations
# inherited from Entity base class

Best Practices

  • This class should be instantiated within a valid SharePoint ClientContext to ensure proper entity operations
  • The entity_type_name property is primarily used internally by the Office365 REST client for OData protocol communication
  • Do not override the entity_type_name property as it identifies the specific SharePoint entity type
  • Use this class when working with SharePoint suite navigation data through the Office365 REST Python Client library
  • Ensure proper authentication and permissions are set up before attempting to access or modify suite navigation data
  • This class inherits all methods and functionality from the Entity base class, so refer to Entity documentation for available operations

Similar Components

AI-powered semantic similarity - components with related functionality:

  • class Navigation 69.0% similar

    Represents navigation operations at the SharePoint site collection level, providing access to Quick Launch and Top Navigation Bar node collections.

    From: /tf/active/vicechatdev/SPFCsync/venv/lib64/python3.11/site-packages/office365/sharepoint/navigation/navigation.py
  • class NavigationService 65.9% similar

    NavigationService is a REST-based service class for managing SharePoint navigation operations, including global navigation, menu states, and publishing navigation providers.

    From: /tf/active/vicechatdev/SPFCsync/venv/lib64/python3.11/site-packages/office365/sharepoint/navigation/navigation_service.py
  • class StructuralNavigationCacheWrapper 63.0% similar

    A wrapper class for SharePoint's structural navigation cache that extends the Entity base class and provides access to navigation cache functionality.

    From: /tf/active/vicechatdev/SPFCsync/venv/lib64/python3.11/site-packages/office365/sharepoint/publishing/navigation/structural_navigation_cache_wrapper.py
  • class HomeSiteNavigationSettings 62.6% similar

    A class representing SharePoint home site navigation settings, providing functionality to manage global navigation configuration for a SharePoint home site.

    From: /tf/active/vicechatdev/SPFCsync/venv/lib64/python3.11/site-packages/office365/sharepoint/navigation/home_site_navigation_settings.py
  • class ConfiguredMetadataNavigationItem 62.1% similar

    A data class representing a configured metadata navigation item in SharePoint, storing field information and hierarchy properties.

    From: /tf/active/vicechatdev/SPFCsync/venv/lib64/python3.11/site-packages/office365/sharepoint/navigation/configured_metadata_items.py
← Back to Browse