Excel.LinkedEntityIdCulture interface

Stellt die Objekt-ID und die Kultur für ein LinkedEntityCellValue Objekt dar.

Hinweise

API-Satz: ExcelApi 1.19

Diese Schnittstelle wird in Excel im Web nicht unterstützt.

Verwendet von

Beispiele

/**
 * Custom function that acts as the data provider for a LinkedEntityDataDomain.
 * Called on demand by Excel to resolve and refresh LinkedEntityCellValue objects.
 * @customfunction
 * @linkedEntityLoadService
 * @param {any} request Request to resolve and refresh LinkedEntityCellValue objects.
 * @return {any} Resolved or refreshed LinkedEntityCellValue objects that were requested in the passed-in request.
 */
function contosoLoadService(request: any): any {
    const notAvailableError = new CustomFunctions.Error(CustomFunctions.ErrorCode.notAvailable);

    try {
        // Parse the request that was passed-in by Excel.
        const parsedRequest: Excel.LinkedEntityLoadServiceRequest = JSON.parse(request);
        // Initialize result to populate and return to Excel.
        const result: Excel.LinkedEntityLoadServiceResult = { entities: [] };

        // Identify the domainId of the request and call the corresponding function to create
        // linked entity cell values for that linked entity data domain.
        const entities: Excel.LinkedEntityIdCulture[] = parsedRequest.entities;
        for (const { entityId } of entities) {
            let linkedEntityResult = null;
            switch (parsedRequest.domainId) {
                case "products": {
                    linkedEntityResult = makeProductLinkedEntity(entityId);
                    break;
                }
                case "categories": {
                    linkedEntityResult = makeCategoryLinkedEntity(entityId);
                    break;
                }
                default:
                    throw notAvailableError;
            }

            if (!linkedEntityResult) {
                // Throw an error to signify to Excel that the resolution or refresh of the requested linkedEntityId failed.
                throw notAvailableError;
            }

            result.entities.push(linkedEntityResult);
        }

        return result;
    } catch (error) {
        console.error(error);
        throw notAvailableError;
    }
}

Eigenschaften

culture

Stellt die Sprachkultur dar, die zur Erstellung des LinkedEntityCellValue Objekts verwendet wurde.

entityId

Stellt den Bezeichner dar, der für einen Dienst spezifisch ist, der zum Erstellen des LinkedEntityCellValue Objekts verwendet wird.

Details zur Eigenschaft

culture

Stellt die Sprachkultur dar, die zur Erstellung des LinkedEntityCellValue Objekts verwendet wurde.

culture: string;

Eigenschaftswert

string

Hinweise

API-Satz: ExcelApi 1.19

Diese Eigenschaft wird in Excel im Web nicht unterstützt.

entityId

Stellt den Bezeichner dar, der für einen Dienst spezifisch ist, der zum Erstellen des LinkedEntityCellValue Objekts verwendet wird.

entityId: string;

Eigenschaftswert

string

Hinweise

API-Satz: ExcelApi 1.19

Diese Eigenschaft wird in Excel im Web nicht unterstützt.