VP SET DATA CONTEXT

VP SET DATA CONTEXT ( vpAreaName : Text ; dataObj : Object {; options : Object } {; sheet : Integer} )
VP SET DATA CONTEXT ( vpAreaName : Text ; dataColl : Collection ; {options : Object } {; sheet : Integer} )

Description​

La commande VP SET DATA CONTEXT définit le contexte de données d'une feuille. Un contexte de données est un objet ou une collection lié à une feuille de calcul et dont le contenu peut être utilisé pour remplir automatiquement les cellules de la feuille, soit en utilisant une option de génération automatique, soit la méthode VP SET BINDING PATH. En revanche, la commande VP Get data context peut renvoyer un contexte contenant des modifications apportées par l'utilisateur.

Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.

Dans dataObj ou dataColl, passez un objet ou une collection contenant les données à charger dans le contexte de données. Les images sont converties en schémas URI de données.

Pour passer une valeur Time dans dataObj ou dataColl, encapsulez-la dans un objet avec les propriétés suivantes (voir exemple 4):

Dans options, vous pouvez passer un objet qui spécifie des options supplémentaires. Il peut contenir les propriétés suivantes :

Dans sheet,, transmettez l'index de la feuille qui recevra le contexte de données. Si aucun numéro d'indice n'est passé, le contexte est appliqué à la feuille courante.

Si vous exportez votre document vers un objet en utilisant VP Export to object, ou vers un document 4DVP en utilisant [VP EXPORT DOCUMENT] (vp-export-document.md), l'option includeBindingSource vous permet de copier le contenu des contextes actuels en tant que valeurs de cellules dans l'objet ou le document exporté. Pour plus de détails, reportez-vous à la description de ces méthodes.

Exemple​

Passer un objet et lier les données de contexte aux cellules de la première ligne :

var $data : Object

$data:=New object

$data.firstName:="Freehafer"
$data.lastName:="Nancy"

VP SET DATA CONTEXT("ViewProArea"; $data)

VP SET BINDING PATH(VP Cell("ViewProArea"; 0; 0); "firstName")
VP SET BINDING PATH(VP Cell("ViewProArea"; 1; 0); "lastName")

Exemple 2​

Passer une collection d'objets et générer automatiquement des colonnes :

var $options : Object
var $data : Collection

$data:=New collection()
$data.push(New object("firstname"; "John"; "lastname"; "Smith"))
$data.push(New object("firstname"; "Mary"; "lastname"; "Poppins"))

$options:=New object("autoGenerateColumns"; True)

VP SET DATA CONTEXT("ViewProArea"; $data; $options)

Exemple 3​

Les données passées en paramètre sont une collection qui contient des sous-collections. Chaque sous-collection définit les valeurs des cellules de la ligne :

var $data : Collection
var $options : Object

$data:=New collection
$data.push(New collection(1; 2; 3; False; "")) // 5 colonnes sont créées
$data.push(New collection) // la 2e ligne est vide
$data.push(New collection(4; 5; Null; "hello"; "world")) // la 3e ligne a 5 valeurs
$data.push(New collection(6; 7; 8; 9)) // la 4e ligne a 4 valeurs

$options:=New object("autoGenerateColumns"; True)

VP SET DATA CONTEXT("ViewProArea"; $data; $options)

Exemple 4 - Syntaxe date et heure​

var $data : Collection
var $options : Object

$data:= New collection()

// Les valeurs Date peuvent être passées sous forme de valeurs scalaires.
$data.push(New collection("Date"; Current date)) 

// Les valeurs Time doivent être passées en tant qu'attributs d'objet.
$data.push(New collection("Time"; New object("time"; 5140)))

// Exemple de Date + Time
$data.push(New collection("Date + Time"; New object("value"; Current date; "time"; 5140))) 

$options:=New object("autoGenerateColumns"; True)

VP SET DATA CONTEXT("ViewProArea"; $data; $options)

Voici le résultat une fois les colonnes générées :

Voir également​

VP SET BINDING PATH
VP Get binding path
VP Get data context