Edit

Share via


Excel.Interfaces.LinkedEntityDataDomainData interface

An interface describing the data returned by calling linkedEntityDataDomain.toJSON().

Properties

dataProvider

Gets the name of the data provider for the linked entity data ___domain. This name can change based on the information provided by the data provider.

id

Gets the ID of the linked entity data ___domain defined by Office Add-ins. This ID is not applicable to linked entity data domains defined by service data providers, such as Bing or Power BI.

lastRefreshed

Gets the date and time (in the local time zone) since the workbook was opened and the LinkedEntityCellValue objects of this linked entity data ___domain were last refreshed. Returns undefined if LinkedEntityCellValue objects have not been refreshed since the workbook was opened.

loadFunctionId

Gets the ID of the custom function that is called on demand to resolve or refresh the LinkedEntityCellValue objects of the linked entity data ___domain defined by Office Add-ins. For further information, see Autogenerate JSON metadata for custom functions: ID. This ID is not applicable to linked entity data domains defined by service data providers, such as Bing or Power BI.

name

Gets the name of the linked entity data ___domain. This name can change based on the information provided by the data provider.

periodicRefreshInterval

Gets the frequency, in seconds, at which LinkedEntityCellValue objects of this linked entity data ___domain are refreshed automatically. The refresh interval only applies if the refreshMode is set to "Periodic".

refreshMode

Specifies the refresh mode that defines how and when the LinkedEntityCellValue objects of this linked entity data ___domain are refreshed. If the refresh mode being set is not supported by this linked entity data ___domain, then the current refresh mode is not changed. If the refresh mode is set to "Periodic", the refresh interval is set to the periodicRefreshInterval of this linked entity data ___domain.

serviceId

Gets the service ID of the linked entity data ___domain. This ID is a permanently reserved value for all linked entity data domains which are defined by service data providers, such as Bing or Power BI, or defined by Office Add-ins. This ID never changes across user sessions.

supportedRefreshModes

Gets all the refresh modes supported by the linked entity data ___domain. This array can change based on the information provided by the data provider.

Property Details

dataProvider

Gets the name of the data provider for the linked entity data ___domain. This name can change based on the information provided by the data provider.

dataProvider?: string;

Property Value

string

Remarks

[ API set: ExcelApi 1.19 ]

id

Gets the ID of the linked entity data ___domain defined by Office Add-ins. This ID is not applicable to linked entity data domains defined by service data providers, such as Bing or Power BI.

id?: string;

Property Value

string

Remarks

[ API set: ExcelApi 1.19 ]

lastRefreshed

Gets the date and time (in the local time zone) since the workbook was opened and the LinkedEntityCellValue objects of this linked entity data ___domain were last refreshed. Returns undefined if LinkedEntityCellValue objects have not been refreshed since the workbook was opened.

lastRefreshed?: Date;

Property Value

Date

Remarks

[ API set: ExcelApi 1.19 ]

loadFunctionId

Gets the ID of the custom function that is called on demand to resolve or refresh the LinkedEntityCellValue objects of the linked entity data ___domain defined by Office Add-ins. For further information, see Autogenerate JSON metadata for custom functions: ID. This ID is not applicable to linked entity data domains defined by service data providers, such as Bing or Power BI.

loadFunctionId?: string;

Property Value

string

Remarks

[ API set: ExcelApi 1.19 ]

name

Gets the name of the linked entity data ___domain. This name can change based on the information provided by the data provider.

name?: string;

Property Value

string

Remarks

[ API set: ExcelApi 1.19 ]

periodicRefreshInterval

Gets the frequency, in seconds, at which LinkedEntityCellValue objects of this linked entity data ___domain are refreshed automatically. The refresh interval only applies if the refreshMode is set to "Periodic".

periodicRefreshInterval?: number;

Property Value

number

Remarks

[ API set: ExcelApi 1.19 ]

refreshMode

Specifies the refresh mode that defines how and when the LinkedEntityCellValue objects of this linked entity data ___domain are refreshed. If the refresh mode being set is not supported by this linked entity data ___domain, then the current refresh mode is not changed. If the refresh mode is set to "Periodic", the refresh interval is set to the periodicRefreshInterval of this linked entity data ___domain.

refreshMode?: Excel.LinkedEntityDataDomainRefreshMode | "Unknown" | "Manual" | "OnLoad" | "Periodic";

Property Value

Excel.LinkedEntityDataDomainRefreshMode | "Unknown" | "Manual" | "OnLoad" | "Periodic"

Remarks

[ API set: ExcelApi 1.19 ]

serviceId

Gets the service ID of the linked entity data ___domain. This ID is a permanently reserved value for all linked entity data domains which are defined by service data providers, such as Bing or Power BI, or defined by Office Add-ins. This ID never changes across user sessions.

serviceId?: number;

Property Value

number

Remarks

[ API set: ExcelApi 1.19 ]

supportedRefreshModes

Gets all the refresh modes supported by the linked entity data ___domain. This array can change based on the information provided by the data provider.

supportedRefreshModes?: Excel.LinkedEntityDataDomainRefreshMode[];

Property Value

Remarks

[ API set: ExcelApi 1.19 ]