Fonctions pour manipuler fields
Fonctions pour manipuler fields
getCurrentField() | Renvoie un lien vers l’objet Field qui utilise le script personnalisé actuel. |
getFieldByName(namesPath) (*) | Renvoie un lien vers le champ pour lequel le script personnalisé a été ouvert. Exemple :
|
getFieldValue(namesPath) (*) | Renvoie :
namesPath | fieldObject :
|
setCurrentFieldValue(value, forced, onSaved) | Modifie la valeur du champ pour lequel le script personnalisé a été ouvert. Paramètres :
|
setFieldValue(namesPath | field, value, forced, onSaved) (*) | Modifie la valeur du champ. Paramètres :
|
save() | Ferme la fenêtre dans laquelle le script personnalisé s’exécute et enregistre les modifications. |
cancel() | Ferme la fenêtre d’exécution du script personnalisé sans enregistrer les modifications. |
(*) Pour certaines fonctions répertoriées ci-dessus, le chemin d’accès au champ est spécifié en tant que paramètre d’entrée. Il comprend le nom du champ et les noms des éléments parents (groupe de champs, section). Pour les tableaux, les tableaux répétitifs et les groupes répétitifs, vous devez indiquer le numéro d’instance à partir de 0 (zéro). Exemple : où [10] correspond au numéro d’instance du groupe répétitif. | |
Fonctions pour manipuler les jeux de données
Fonctions pour manipuler les jeux de données
addEntity(entityInfo: {cacheName, columns, values}, onResult(newId)) | Ajoute une entrée au jeu de données. Paramètres :
|
editEntity(entityInfo: {cacheName, columns, values}, onResult()) | Modifie une entrée dans la base de données. Paramètres :
|
getDict({cacheName, filters: [{FieldName, FieldValue}], cursorPos, allowMultipleColumnResults}, onResult (param: { FieldName, FieldValue, BoldMask}[][]) ) | Effectue une recherche dans un jeu de données pour une valeur spécifiée ou pour une partie de celle-ci. Retourne les string correspondantes au format suivant : [{FieldName Paramètres :
Si, par exemple, le jeu de données contient ce qui suit : CompanyName: ABBYY Supposons qu’une recherche soit effectuée sur les symboles “ABB”. Alors, le résultat suivant sera retourné : [ [ { FieldName: ‘CompanyName’, FieldValue: ‘ABBYY’, BoldMask: ‘11100’ }, ] ] Remarque : Le tableau retourné peut contenir plusieurs valeurs, y compris certaines qui ne correspondaient pas initialement aux conditions de recherche. Les résultats de recherche dans le tableau seront triés par valeur du paramètre BoldMask par ordre décroissant (c’est-à-dire en commençant par les string correspondant le mieux aux conditions de recherche). |
getDictAll({cacheName, filters: {FieldName, FieldValue}}, }, onResult (param: { FieldName, FieldValue, BoldMask}[][])) | Effectue une recherche dans la base de données sur l’intégralité de la valeur spécifiée. Renvoie les valeurs de tous les champs trouvés. Paramètres :
[ [ { FieldName: ‘CompanyName’, FieldValue: ‘ABBYY’, BoldMask: ‘11100’ }, ] ] Remarque : Le tableau renvoyé peut contenir plusieurs valeurs, y compris certaines qui ne correspondaient pas initialement aux conditions de recherche. Les résultats de recherche dans le tableau seront triés par valeur du paramètre BoldMask par ordre décroissant (c’est-à-dire en commençant par les string qui correspondent le mieux aux conditions de recherche). |
Fonctions pour travailler avec le formulaire du document
Fonctions pour travailler avec le formulaire du document
selectRow(tablePath, rowNumber) (*) | Marque une ligne du tableau comme sélectionnée.
|
deselectRow(tablePath, rowNumber?) (*) | Supprime la sélection d’une ligne du tableau.
|
scrollFormToField(namesPath) (*) | Fait défiler l’éditeur de formulaire pour afficher le champ.
|
getDomElementPosition(domId, onResult: (result?: {width, height, top, left, right, bottom})) | Obtient la position d’un élément dans la fenêtre de l’éditeur de formulaire et renvoie le résultat d’une fonction de rappel.
|
setStyles(styles, callback) | Ajoute des styles CSS à la fenêtre du cadre d’action personnalisé.
|
(*) Pour certaines fonctions répertoriées ci-dessus, le chemin vers le champ est indiqué comme paramètre d’entrée. Il comprend le nom du champ et les noms des éléments parents (groupe de champs, section). Pour les tableaux, les tableaux répétitifs et les groupes répétitifs, vous devez spécifier le numéro d’instance à partir de zéro. Exemple: où [10] est le numéro de l’instance du groupe répétitif. | |
Propriétés de l'objet commandArgs
Propriétés de l'objet commandArgs
commandArgs.params.document | Document | Stocke une copie d’objet d’un document ouvert. Elle peut être utilisée pour accéder à toute erreur, tout champ ou toute région du document actif. |
commandArgs.params.currentField | (Picture | Checkmark | Checkmark Groups | FieldsGroup | Table | TextField) | Renvoie une référence à un objet champ qui reflète l’état du champ au moment de l’appel du script. Il fait partie du document spécifié ci-dessus. Remarque : Si la valeur du champ a été modifiée après l’initialisation du script, ces modifications ne seront pas prises en compte. |
commandArgs.params.appPath | String | Le nom de domaine du serveur. |
commandArgs.params.coordinates | Object | Les coordonnées de l’élément DOM qui a appelé le script personnalisé. |
commandArgs.params.currentElementDomId | String | L’ID de l’élément DOM qui a appelé le script personnalisé. |
| Fonction | Description |
|---|---|
| commandArgs.events.addEventHandler | Ajoute un gestionnaire d’événement dans le contexte global du script personnalisé. |
| commandArgs.events.triggerHandlers | Déclenche un événement dans le contexte global du script personnalisé. |
| commandArgs.events.removeEventHandler | Supprime un gestionnaire d’événement dans le contexte global du script personnalisé. |
Champ de type groupe de champs
Champ de type groupe de champs
Fields | (Picture | Checkmark | Checkmark Groups | FieldsGroup | Table | TextField)[] | Lecture seule | Tableau de champs |
HasTableLayout | Boolean | Lecture seule | Indique si la région du champ correspond à un tableau. |
Caption | String | Lecture seule | Nom ou libellé du champ personnalisé |
FieldType | Number | Lecture seule | Type de champ. Valeur possible : 4 – groupe de champs |
Id | Number | Lecture seule | ID du champ |
IsReadOnly | Boolean | Lecture seule | Indique si la modification des champs est interdite. |
IsVisible | Boolean | Lecture seule | Indique si le champ est visible dans le formulaire de données. |
MaxRegions | Number | Lecture seule | Nombre maximal de régions de champ. Si la valeur est -1, un nombre quelconque de régions est autorisé. |
Name | String | Lecture seule | Nom interne du champ. |
NamePath | String[] | Lecture seule | Tableau des noms de champs et de groupes qui forment le chemin vers le champ. |
NeedRecognize | Boolean | Lecture/écriture | Indique s’il faut récupérer la valeur du champ depuis la région lorsque les règles sont à nouveau vérifiées. |
Regions | {
| Lecture seule | Tableau de régions.
|
Champ de section
Champ de section
Fields | (Picture | Checkmark | Checkmark Groups | FieldsGroup | Table | TextField)[] | Lecture seule | Tableau de champs |
Pageids | Number[] | Lecture seule | Identifiants des pages sur lesquelles se trouve la section. |
IsFlexible | Boolean | Lecture seule | Indique si la section est flexible. |
Caption | String | Lecture seule | Nom du champ personnalisé (légende) |
FieldType | Number | Lecture seule | Type de champ. Valeur possible : 6 – section |
Id | Number | Lecture seule | ID du champ |
IsReadOnly | Boolean | Lecture seule | Indique si la modification du champ est interdite |
IsVisible | Boolean | Lecture seule | Indique si le champ est visible dans le formulaire de données. |
MaxRegions | Number | Lecture seule | Nombre maximal de régions du champ. Si la valeur est -1, un nombre quelconque de régions est autorisé. |
Name | String | Lecture seule | Nom interne du champ |
NamePath | String[] | Lecture seule | Tableau des noms de champs et de groupes qui forment le chemin vers le champ. |
NeedRecognize | Boolean | Lecture/écriture | Indique s’il faut extraire la valeur du champ à partir de la région lorsque les règles sont à nouveau vérifiées. |
Regions | {
| Lecture seule | Tableau de régions.
|
Champ de tableau
Champ de tableau
Lignes | {
| Lecture seule | Liste des lignes du tableau. Paramètres de l’objet ligne du tableau :
|
Intitulé | String | Lecture seule | Nom du champ personnalisé, intitulé |
FieldType | Number | Lecture seule | Type de champ. Valeur possible : 7 – tableau |
ID | Nombre | Lecture seule | ID du champ |
IsReadOnly | Boolean | Lecture seule | Indique si le champ ne peut pas être modifié. |
IsVisible | Booléen | Lecture seule | Indique si le champ est visible dans le formulaire de données. |
MaxRegions | Number | Lecture seule | Indique si le champ est visible dans le formulaire de données ; -1 signifie qu’un nombre quelconque de régions est autorisé. |
Name | string | Lecture seule | Nom de service du champ. |
NamePath | String[] | Lecture seule | Tableau des noms de champ et de groupe qui constituent le chemin d’accès au champ. |
NeedRecognize | Boolean | Lecture/écriture | Indique s’il faut récupérer la valeur du champ depuis la région lors d’une nouvelle vérification des règles. |
Régions | {
| Lecture seule | Tableau de régions.
|
Champ de saisie de texte
Champ de saisie de texte
Flags | Number[] | Lecture/écriture | tableau de même longueur que le champ Value. Il se compose de 0 et de 1. 0 – un caractère situé dans Value à la même position que le 0 dans Flags nécessite une vérification. |
Suggestions | String[] | Lecture seule | Liste de valeurs des champs suggérées |
Value | String | Lecture/écriture | Valeur du champ |
TextType | Number | Lecture seule | Type du champ Text. Valeurs possibles :
|
Libellé | String | Lecture seule | Nom du champ personnalisé, libellé |
FieldType | Number | Lecture seule | Type de champ. Valeur possible : 0 – champ Text |
ID | Numéro | Lecture seule | ID du champ |
IsReadOnly | Booléen | Lecture seule | Indique si la modification du champ est interdite. |
IsVisible | Boolean | Lecture seule | Indique si le champ est visible dans le formulaire de données. |
MaxRegions | Number | Lecture seule | Nombre maximal de régions associées au champ. Si la valeur est -1, n’importe quel nombre de régions est autorisé. |
Name | String | Lecture seule | Nom de service du champ. |
NamePath | String[] | Lecture seule | Tableau des noms de champs et de groupes constituant le chemin d’accès au champ. |
NeedRecognize | Boolean | Lecture/écriture | Indique si la valeur du champ doit être récupérée à partir de la région lors d’une nouvelle vérification des règles. |
Régions | {
| Lecture seule | Tableau de régions.
|
IsVerified | Booléen | Lecture/écriture | Indique si le champ a été vérifié. |
NeedVerification | Boolean | Lecture seule | Indique si le champ doit être vérifié. |
NeedDoubleVerification | Booléen | Lecture seule | Indique si le champ nécessite une double vérification |
IsSummary | Booléen | Lecture seule | Indique si le champ est utilisé pour générer le résumé des données dans le formulaire de données. |
Champ de coche
Champ de coche
Value | Booléen | Lecture/écriture | Valeur du champ |
Libellé | String | Lecture seule | Nom du champ personnalisé, libellé |
FieldType | Number | Lecture seule | Type de champ. Valeur possible : 2 – coche |
ID | Nombre | Lecture seule | ID du champ |
IsReadOnly | Booléen | Lecture seule | Indique si le champ ne peut pas être modifié. |
IsVisible | Booléen | Lecture seule | Indique si le champ est visible sur le formulaire de données. |
MaxRegions | Number | Lecture seule | Nombre maximal de régions de champ. Si la valeur est -1, tout nombre de régions est autorisé. |
Name | String | Lecture seule | Nom de service du champ. |
NamePath | String[] | Lecture seule | Tableau des noms de champ et de groupe constituant le chemin d’accès du champ. |
NeedRecognize | Booléen | Lecture/écriture | Indique si la valeur du champ doit être récupérée à partir de la région lorsque les règles sont à nouveau vérifiées. |
Régions | {
| Lecture seule | Tableau de régions.
|
IsVerified | Boolean | Lecture/écriture | Indique si le champ a été vérifié. |
NeedVerification | Booléen | Lecture seule | Indique si le champ doit être vérifié. |
NeedDoubleVerification | Boolean | Lecture seule | Indique si le champ nécessite une double vérification. |
IsSummary | Boolean | Lecture seule | Indique si le champ est utilisé pour générer le récapitulatif des données dans le formulaire de données. |
Champ de groupe de coches
Champ de groupe de coches
MaxSelectedCount | Number | Lecture seule | Nombre maximal de valeurs des champs sélectionnées. |
MinSelectedCount | Number | Lecture seule | Nombre minimum de valeurs de champ sélectionnées. |
Valeurs | Number[] | Lecture/écriture | Valeur du champ. Tableau d’ID d’enregistrements constituant la liste des valeurs possibles du champ (Variantes). |
Variantes | {Id:number, Name:string}[] | Lecture seule | Liste des valeurs possibles du champ :
|
Libellé | String | Lecture seule | Nom du champ personnalisé, libellé |
FieldType | Number | Lecture seule | Type de champ. Valeur possible : 3 – groupe de coches |
ID | Nombre | Lecture seule | ID du champ. |
IsReadOnly | Boolean | Lecture seule | Indique si la modification du champ est interdite. |
IsVisible | Boolean | Lecture seule | Indique si le champ est visible dans le formulaire de données. |
MaxRegions | Number | Lecture seule | Nombre maximal de régions de champ. Si la valeur est -1, un nombre quelconque de régions est autorisé. |
Name | String | Lecture seule | Nom de service du champ. |
NamePath | String[] | Lecture seule | Tableau des noms de champ et de groupe constituant le chemin du champ. |
NeedRecognize | Boolean | Lecture/écriture | Indique s’il faut récupérer la valeur du champ depuis la région lorsque les règles sont vérifiées à nouveau. |
Régions | {
| Lecture seule | Tableau de régions.
|
IsVerified | Booléen | Lecture/écriture | Indique si le champ a été vérifié. |
NeedVerification | Booléen | Lecture seule | Indique si le champ doit être vérifié. |
NeedDoubleVerification | Booléen | Lecture seule | Indique si le champ nécessite une double vérification. |
IsSummary | Booléen | Lecture seule | Indique si le champ est utilisé pour générer le résumé des données dans le formulaire de données. |
Champ image
Champ image
Caption | String | Lecture seule | Nom du champ personnalisé, légende |
FieldType | Number | Lecture seule | Type de champ. Valeur possible : 1 – image |
Id | Number | Lecture seule | ID du champ. |
IsReadOnly | Boolean | Lecture seule | Indique si la modification du champ est interdite. |
IsVisible | Boolean | Lecture seule | Indique si le champ est visible dans le formulaire de données. |
MaxRegions | Number | Lecture seule | Nombre maximal de régions du champ. Si la valeur est -1, un nombre quelconque de régions est autorisé. |
Name | String | Lecture seule | Nom interne du champ. |
NamePath | String[] | Lecture seule | Tableau des noms de champs et de groupes qui forment le chemin d’accès au champ. |
Regions | {
| Lecture seule | Tableau de régions.
|
Champ de groupe répétitif de sections
Champ de groupe répétitif de sections
Nom | Type | Droits | Description |
Id | Number | Lecture seule | ID du champ |
Name | String | Lecture seule | Nom du champ |
Sections | Section[] | Lecture seule | Tableau de champs de type Section |
FieldType | Number | Lecture seule | Type de champ. Valeur possible : 8 – groupe répétitif de sections. |
Propriétés de l’objet document
Propriétés de l’objet document
AssemblingErrors | {
| Lecture seule | Erreurs d’assemblage dans le document :
|
BatchId | Number | Lecture seule | L’ID du package |
Erreurs | {
| Lecture seule | Erreurs dans le document :
|
Fields | (Section | SectionsGroup)[] | Lecture seule | Liste des sections/sections dupliquées |
ID | Nombre | Lecture seule | Identifiant du document |
Index | Number | Lecture seule | Indice du document dans le package |
Pages | {
| Lecture seule | Liste des pages de document contenant les éléments suivants :
|
ProjectId | Nombre | Lecture seule | Identifiant du projet |
TaskId | Nombre | Lecture seule | ID de tâche |
TemplateId | Nombre | Lecture seule | ID de définition du document |
TemplateName | String | Lecture seule | Le nom du document de définitions |
TemplateVersion | Nombre | Lecture seule | Version de la définition du document |
Version | Nombre | Lecture seule | Version du document |
