VP IMPORT FROM OBJECT
Historique
| Release | Modifications |
|---|---|
| 20 R9 | Prise en charge du paramètre paramObj |
VP IMPORT FROM OBJECT ( vpAreaName : Text { ; viewPro : Object { ; paramObj : Object} } )
| Paramètres | Type | Description | |
|---|---|---|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro |
| viewPro | Object | -> | Objet 4D View Pro |
| paramObj | Object | -> | (Facultatif) options d'importation |
Description
La commande VP IMPORT FROM OBJECT importe et affiche l'objet 4D View Pro viewPro dans la zone 4D View Pro vpAreaName. Le contenu de l'objet importé remplace toutes les données insérées auparavant dans la zone.
Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.
Dans viewPro, passez un objet 4D View Pro valide. Cet objet peut avoir été créé en utilisant VP Export to object ou manuellement. Pour plus d'informations sur les objets 4D View Pro, veuillez consulter la section Objet 4D View Pro.
Une erreur est retournée si l'objet viewPro est invalide.
Dans paramObj, vous pouvez passer la propriété suivante :
| Propriété | Type | Description |
|---|---|---|
| formula | 4D.Function | (Facultatif) Fonction callback à exécuter lorsque l'objet est chargé et que toutes les fonctions personnalisées 4D ont répondu. See Passing a callback method (formula). |
Les paramètres suivants peuvent être utilisés dans la méthode de rappel :
| Paramètres | Type | Description | |
|---|---|---|---|
| param1 | Text | Nom de l'objet 4D View Pro | |
| param2 | Text | Réservé pour des raisons de compatibilité, ce paramètre est toujours vide | |
| param3 | Object | Une référence au paramètre paramObj de la commande | |
| param4 | Object | Objet retourné par la méthode avec un message de statut | |
| .success | Boolean | True si l'importation a réussi, False sinon | |
| .errorCode | Integer | Code d'erreur | |
| .errorMessage | Text | Message d'erreur |
The callback function specified in the formula attribute is triggered after all 4D custom functions within the imported content have completed their calculations. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved.
Exemple
You want to import a spreadsheet that was previously saved in an object field, and trigger a callback function after all 4D custom functions have responded:
QUERY([VPWorkBooks];[VPWorkBooks]ID=10)
VP IMPORT FROM OBJECT("ViewProArea1"; [VPWorkBooks]SPBook; {formula: Formula(onImportComplete)})
// Method 'onImportComplete'
#DECLARE($name : Text; $path : Text; $paramObj : Object; $status : Object)
ALERT("The document has been imported, and all custom functions have finished processing.")