ObjectId - diagramfunctie

De diagramfunctie ObjectId() retourneert de ID van het object waarin de uitdrukking wordt geëvalueerd. De functie gebruikt een optioneel argument om te specificeren op welk type object de functie betrekking heeft. Het object kan een werkblad zijn of een visualisatie. Deze functie is alleen beschikbaar in diagramuitdrukkingen.

Syntaxis:

ObjectId([object_type_str])

Retourgegevenstypen: tekenreeks

Het enige argument van de functie, object_type_str, is optioneel en refereert aan een tekenreekswaarde die het objecttype vertegenwoordigt.

Argumenten
Argument	Beschrijving
object_type_str	Een tekenreekswaarde die het type vertegenwoordigt van het object dat wordt geëvalueerd.

Als er in de functie-uitdrukking geen argument wordt gespecificeerd, retourneert ObjectId() de ID van het object waarin de uitdrukking wordt gebruikt. Gebruik ObjectId('sheet') om de ID van het werkbladobject waarbinnen de visualisatie verschijnt te retourneren.

Specificeer in het geval van visualisatie-objecten die in andere visualisatie-objecten zijn genest het gewenste objecttype in het functie-argument voor verschillende resultaten. Gebruik bijvoorbeeld voor een diagram met tekst en afbeelding binnen een container 'text-image' om het tekst & afbeelding-object te retourneren en 'container' om de ID van de container te retourneren.

Doe het volgende:

Voeg in analysemodus de volgende tekst toe aan uw URL:

/opties/ontwikkelaar
Klik met de rechtermuisknop op de visualisatie en klik op Ontwikkelaar.
Verkrijg onder Eigenschappen de object-ID uit de dialoogkop en het objecttype uit de eigenschap "qType".

Beperkingen:

Deze functie kan tot onverwachte resultaten leiden wanneer ze wordt opgeroepen in een object (een knop bijvoorbeeld) binnen een container die een masteritem is. De beperking geldt ook voor het filtervak masteritems. Dit zijn containers voor een aantal keuzelijsten. Dit komt door de manier waarop masteritems gebruikmaken van de objecthiërarchie.

De diagramuitdrukking ObjectId('werkblad') zal in dergelijke gevallen een lege tekenreeks retourneren, terwijl ObjectId('masterobject') de identifier van het bezittende masteritem zal retourneren.

ObjectId() wordt vaak gebruikt in combinatie met de volgende functies:

Gerelateerde functies
Functie	Interactie
if - script- en diagramfunctie	De functies if en ObjectId kunnen in combinatie worden gebruikt om voorwaardelijke uitdrukkingen te creëren. Zo kunnen visualisaties bijvoorbeeld voorwaardelijke kleuren krijgen dankzij uitdrukkingen die gebruikmaken van deze functies.
InObject - diagramfunctie	Net als if wordt InObject ook gebruikt met ObjectId om voorwaardelijke uitdrukkingen te creëren.

Voorbeeld 1 – Diagram object-ID retourneren

Het volgende basisvoorbeeld laat zien hoe u de ID van een visualisatie retourneert.

Doe het volgende:

Open een nieuw werkblad en sleep een Tekst & afbeelding-diagram op het werkblad.
Klik in het eigenschappenvenster op Meting toevoegen.
Klik op om de uitdrukkingseditor te openen.
Plak de volgende uitdrukking in de dialoog:
```
=ObjectId()
```
Klik op Toepassen.

De ID van het Tekst & afbeelding-object wordt weergegeven in de visualisatie.

Hetzelfde resultaat kan worden bereikt met de volgende uitdrukking:

=ObjectId('text-image')

Voorbeeld 2 – Werkblad-ID retourneren

Het volgende basisvoorbeeld laat zien hoe u de ID van het werkblad waarin een visualisatie optreedt retourneert.

Doe het volgende:

Open een nieuw werkblad en sleep een Tekst & afbeelding-diagram op het werkblad.
Klik in het eigenschappenvenster op Meting toevoegen.
Klik op om de uitdrukkingseditor te openen.
Plak de volgende uitdrukking in de dialoog:
```
=ObjectId('sheet')
```
Klik op Toepassen.

De ID van het werkblad wordt weergegeven in de visualisatie.

Voorbeeld 3 – Geneste uitdrukking

Het volgende voorbeeld laat zien hoe de ObjectId()-functie kan in andere uitdrukkingen worden genest.

Doe het volgende:

Open een nieuw werkblad en sleep een Tekst & afbeelding-diagram op het werkblad.
Klik in het eigenschappenvenster op Meting toevoegen.
Klik op om de uitdrukkingseditor te openen.
Plak de volgende uitdrukking in de dialoog:

=if(InObject(ObjectId('text-image')), 'In Tekst & afbeelding', 'Niet in Tekst & afbeelding')
Klik op Toepassen.

De tekst In Tekst & afbeelding verschijnt in het diagram, waarmee wordt aangegeven dat het object waaraan wordt gerefereerd in de uitdrukking een Tekst & afbeelding-diagram is.

Raadpleeg voor een meer gedetailleerd voorbeeld dat gebruikmaakt van voorwaardelijke kleuren, het voorbeeld op InObject - diagramfunctie

Was deze pagina nuttig?

Als u problemen ervaart op deze pagina of de inhoud onjuist is – een typfout, een ontbrekende stap of een technische fout – laat het ons weten zodat we dit kunnen verbeteren!

Geef hier uw feedback