Objets
Cet article fournit la description d'un modèle d'objet d'un script utilisateur utilisé pour le poste de vérification Web.
Fonctions pour travailler avec des champs
Définition | Description |
getCurrentField() | Renvoie un lien vers un objet de champ qui utilise le script utilisateur ouvert. |
getFieldByName(namesPath) (*) |
Renvoie un lien vers un objet de champ basé sur un tableau de noms dans la demande. Exemple :
|
getFieldValue(namesPath) (*) |
Renvoie :
namesPath | fieldObject :
|
setCurrentFieldValue(value, forced, onSaved) |
Modifie la valeur du champ pour lequel le script utilisateur a été ouvert. Paramètres :
|
setFieldValue(namesPath | field, value, forced, onSaved) (*) |
Modifie les valeurs de champ. Paramètres :
|
save() | Ferme la fenêtre dans laquelle le script personnalisé est exécuté et enregistre les modifications. |
cancel() | Ferme la fenêtre dans laquelle le script personnalisé est exécuté sans enregistrer les modifications. |
(*) Pour certaines fonctions énumérées ci-dessus, le chemin d'accès au champ est spécifié comme paramètre d'entrée. Il inclut 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 nombre d'instances en partant de 0 (zéro). Exemple : où [10] est le nombre d'instances du groupe répétitif. |
Fonctions pour travailler avec des jeux de données
Définition | Description |
addEntity(entityInfo: {cacheName, columns, values}, onResult(newId)) |
Ajoute une entrée dans la base de données. Paramètres :
|
editEntity(entityInfo: {cacheName, columns, values}, onResult()) |
Modifie une entrée de la base de données. Paramètres :
|
getDict({cacheName, filters: [{FieldName, FieldValue}], cursorPos, allowMultipleColumnResults}, onResult (param: { FieldName, FieldValue, BoldMask}[][]) ) |
Procède à la recherche d'un jeu de données pour une valeur donnée ou pour une partie de celle-ci. Renvoie les chaînes correspondantes au format suivant : [{FieldName Paramètres :
Si, par exemple, ce qui suit est présent dans un jeu de données : CompanyName : ABBYY Supposons qu'une recherche soit effectuée pour les symboles « ABB ». Voici ce qui sera alors renvoyé : [ [ { FieldName : CompanyName, FieldValue : ABBYY, BoldMask : 11100 }, ] ] Remarque : Le tableau renvoyé peut contenir plusieurs valeurs, y compris celles qui ne correspondaient pas initialement aux conditions de recherche. Les résultats de la recherche dans le tableau seront triés par la valeur du paramètre BoldMask en ordre décroissant (c'est-à-dire en commençant par les chaînes qui correspondent 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 pour la totalité de la valeur spécifiée. Renvoie les valeurs de tous les champs qui ont été trouvés. Paramètres :
[ [ { FieldName : CompanyName, FieldValue : ABBYY, BoldMask : 11000 }, ] ] Remarque : Le tableau renvoyé peut contenir plusieurs valeurs, y compris celles qui ne correspondaient pas initialement aux conditions de recherche. Les résultats de la recherche dans le tableau seront triés par la valeur du paramètre BoldMask en ordre décroissant (c'est-à-dire en commençant par les chaînes qui correspondent le mieux aux conditions de recherche). |
Exemple de script de recherche dans la base de données |
Fonctions permettant de travailler avec le formulaire d'un document
Fonction | Description |
---|---|
selectRow(tablePath, rowNumber) (*) |
Marque une ligne d'un 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 formulaires pour faire apparaître le champ.
|
getDomElementPosition(domId, onResult: (result?: {width, height, top, left, right, bottom})) |
Indique la position d'un élément dans la fenêtre de l'éditeur de formulaires et renvoie le résultat d'une fonction de rappel.
|
setStyles(styles, callback) |
Ajoute les styles CSS à la fenêtre du cadre d'action personnalisé.
|
(*) Pour certaines fonctions énumérées ci-dessus, le chemin d'accès au champ est spécifié comme paramètre d'entrée. Il inclut 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 nombre d'instances en partant de 0. Exemple : où [10] est le nombre d'instances du groupe répétitif. |
Propriétés de l'objet commandArgs
Variables
Variable | Type | Description |
---|---|---|
commandArgs.params.document | Document | Enregistre une copie objet d'un document ouvert. Ceci peut être utilisé pour accéder à toute erreur, tout champ ou toute région du document en cours. |
commandArgs.params.currentField | (Image | Coche | Groupes de coches | FieldsGroup | Tableau | TextField) |
Renvoie un lien vers un objet de champ qui reflète l'état du champ au moment où le script est appelé. Partie du document spécifié ci-dessus. Remarque : Si la valeur du champ a été modifiée après l'initialisation du script, les modifications ne seront pas appliquées. |
commandArgs.params.appPath | Chaîne | Le nom de domaine du serveur. |
commandArgs.params.coordinates | Objet [{X1,X2,Y1,Y2}] |
Les coordonnées de l'élément DOM qui a appelé le script personnalisé. |
commandArgs.params.currentElementDomId | Chaîne | L'ID de l'élément DOM qui a appelé le script personnalisé. |
Fonctions
Fonction | Description |
---|---|
commandArgs.events.addEventHandler | Ajoute un gestionnaire d'événements 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énements dans le contexte global du script personnalisé. |
Field Group field
Nom | Type | Accès | Description |
---|---|---|---|
Fields | (Image | Coche | Groupes de coches | FieldsGroup | Tableau | TextField)[] | Lecture seule | Tableau de champs |
HasTableLayout | Booléen | Lecture seule | Indique si la région du champ est un tableau. |
Caption | Chaîne | Lecture seule | Nom du champ personnalisé, légende |
FieldType | Nombre | Lecture seule |
Type de champ. Valeur possible : 4 - groupe de champs |
Id | Nombre | Lecture seule | Identifiant de champ |
IsReadOnly | Booléen | Lecture seule | Indique si la modification des champs est interdite. |
IsVisible | Booléen | Lecture seule | Indique si le champ est visible sur le formulaire de données. |
MaxRegions | Nombre | Lecture seule | Nombre maximum de régions de champ. Si la valeur est -1, n'importe quel nombre de régions est autorisé. |
Name | Chaîne | Lecture seule | Nom de service du champ. |
NamePath | Chaîne[] | Lecture seule | Tableau des noms des champs et des groupes qui constituent le chemin d'accès au champ. |
NeedRecognize | Booléen | Lecture/écriture | Indique si la valeur du champ doit être récupérée dans la région lorsque les règles sont à nouveau vérifiées. |
Regions | { Id : nombre ; Status : nombre; PageId : nombre ; IsNew : Booléen; Coordinates : Objet [{X1,X2,Y1,Y2}]; }[] |
Lecture seule |
Tableau de régions.
|
Champ Section
Nom | Type | Accès | Description |
---|---|---|---|
Fields | (Image | Coche | Groupes de coches | FieldsGroup | Tableau | TextField)[] | Lecture seule | Tableau de champs |
Pageids | Nombre[] | Lecture seule | Identificateurs des pages dans lesquelles se trouve la section. |
IsFlexible | Booléen | Lecture seule | Indique si la section est flexible. |
Caption | Chaîne | Lecture seule | Nom du champ personnalisé, légende |
FieldType | Nombre | Lecture seule |
Type de champ. Valeur possible : 6 – section |
Id | Nombre | Lecture seule | Identifiant de champ |
IsReadOnly | Booléen | Lecture seule | Indique si la modification du champ est interdite |
IsVisible | Booléen | Lecture seule | Indique si le champ est visible sur le formulaire de données. |
MaxRegions | Nombre | Lecture seule | Nombre maximum de régions de champ. Si la valeur est -1, n'importe quel nombre de régions est autorisé. |
Name | Chaîne | Lecture seule | Nom de service du champ |
NamePath | Chaîne[] | Lecture seule | Tableau des noms des champs et des groupes qui constituent le chemin d'accès au champ. |
NeedRecognize | Booléen | Lecture/écriture | Indique si la valeur du champ doit être récupérée dans la région lorsque les règles sont à nouveau vérifiées. |
Regions | { Id: number; Status: number; PageId: Nombre; IsNew : Booléen; Coordinates: Object [{X1,X2,Y1,Y2}]; }[] |
Lecture seule |
Tableau de régions.
|
Table field
Nom | Type | Accès | Description |
---|---|---|---|
Rows | { Id : nombre ; RowNumber : nombre ; HasColorImage : booléen ; TableBlockID : nombre []; Cells : (Image | Coche | CheckmarkGroup | TextField)[]; }[] |
Lecture seule |
Liste des lignes d'un tableau. Les paramètres de la ligne objet dans le tableau :
|
Caption | Chaîne | Lecture seule | Nom du champ personnalisé, légende |
FieldType | Nombre | Lecture seule |
Type de champ. Valeur possible : 7 - tableau |
Id | Nombre | Lecture seule | Identifiant de champ |
IsReadOnly | Booléen | Lecture seule | Indique si la modification du champ est interdite. |
IsVisible | Booléen | Lecture seule | Indique si le champ est visible sur le formulaire de données. |
MaxRegions | Nombre | Lecture seule | Indique si le champ est visible sur le formulaire de données -1, n'importe quel nombre de régions est autorisé. |
Name | Chaîne | Lecture seule | Nom de service du champ |
NamePath | Chaîne[] | Lecture seule | Tableau des noms des champs et des groupes qui constituent le chemin d'accès au champ. |
NeedRecognize | Booléen | Lecture/écriture | Indique si la valeur du champ doit être récupérée dans la région lorsque les règles sont à nouveau vérifiées. |
Regions | { Id : nombre ; Status : nombre ; PageId : Nombre ; IsNew : Booléen ; Coordinates : Objet [{X1,X2,Y1,Y2}] ; }[] |
Lecture seule |
Tableau de régions.
|
Champ d'entrée de texte
Nom | Type | Accès | Description |
---|---|---|---|
Flags | Nombre[] | Lecture/écriture |
tableau de la même longueur que le champ Valeur. Se compose de 0 et 1. 0 - un caractère qui, dans Valeur, est à la même position que celle occupée par 0 dans Indicateurs, nécessite une vérification. |
Suggests | Chaîne[] | Lecture seule | Liste des valeurs de champ suggérées |
Value | Chaîne | Lecture/écriture | Valeur du champ |
TextType | Nombre | Lecture seule |
Type de champ de texte. Valeur possible :
|
Caption | Chaîne | Lecture seule | Nom du champ personnalisé, légende |
FieldType | Nombre | Lecture seule |
Type de champ. Valeur possible : 0 - champ de texte |
Id | Nombre | Lecture seule | Identifiant de champ |
IsReadOnly | Booléen | Lecture seule | Indique si la modification du champ est interdite. |
IsVisible | Booléen | Lecture seule | Indique si le champ est visible sur le formulaire de données. |
MaxRegions | Nombre | Lecture seule | Nombre maximum de régions de champ. Si la valeur est -1, n'importe quel nombre de régions est autorisé. |
Name | Chaîne | Lecture seule | Nom de service du champ |
NamePath | Chaîne[] | Lecture seule | Tableau des noms des champs et des groupes qui constituent le chemin d'accès au champ. |
NeedRecognize | Booléen | Lecture/écriture | Indique si la valeur du champ doit être récupérée dans la région lorsque les règles sont à nouveau vérifiées. |
Regions | { Id : nombre ; Status : nombre ; PageId : Nombre ; IsNew : Booléen ; Coordinates : Objet [{X1,X2,Y1,Y2}] ; }[] |
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 nécessite une vérification. |
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 la constitution du récapitulatif des données sur le formulaire de données. |
Champ de coche
Nom | Type | Accès | Description |
---|---|---|---|
Value | Booléen | Lecture/écriture | Valeur du champ |
Caption | Chaîne | Lecture seule | Nom du champ personnalisé, légende |
FieldType | Nombre | Lecture seule |
Type de champ. Valeur possible : 2 - coche |
Id | Nombre | Lecture seule | Identifiant de champ |
IsReadOnly | Booléen | Lecture seule | Indique si la modification du champ est interdite. |
IsVisible | Booléen | Lecture seule | Indique si le champ est visible sur le formulaire de données. |
MaxRegions | Nombre | Lecture seule | Nombre maximum de régions de champ. Si la valeur est -1, n'importe quel nombre de régions est autorisé. |
Name | Chaîne | Lecture seule | Nom de service du champ |
NamePath | Chaîne[] | Lecture seule | Tableau des noms des champs et des groupes qui constituent le chemin d'accès au champ. |
NeedRecognize | Booléen | Lecture/écriture | Indique si la valeur du champ doit être récupérée dans la région lorsque les règles sont à nouveau vérifiées. |
Regions | { Id : nombre ; Status : nombre ; PageId : Nombre ; IsNew : Booléen ; Coordinates : Objet [{X1,X2,Y1,Y2}] ; }[] |
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 nécessite une vérification. |
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 la constitution du récapitulatif des données sur le formulaire de données. |
Champ groupe de coches
Nom | Type | Accès | Description |
---|---|---|---|
MaxSelectedCount | Nombre | Lecture seule | Nombre maximum de valeurs de champ sélectionnées. |
MinSelectedCount | Nombre | Lecture seule | Nombre minimum de valeurs de champ sélectionnées. |
Values | Nombre[] | Lecture/écriture | Valeur du champ. Un tableau des identifiants de l'enregistrement qui composent la liste des valeurs de champ possibles (Variantes). |
Variants | {Id:number, Name:string}[] | Lecture seule |
Liste des valeurs de champ possibles :
|
Caption | Chaîne | Lecture seule | Nom du champ personnalisé, légende |
FieldType | Nombre | Lecture seule |
Type de champ. Valeur possible : 3 - groupe de coches |
Id | Nombre | Lecture seule | Identifiant de champ. |
IsReadOnly | Booléen | Lecture seule | Indique si la modification du champ est interdite. |
IsVisible | Booléen | Lecture seule | Indique si le champ est visible sur le formulaire de données. |
MaxRegions | Nombre | Lecture seule | Nombre maximum de régions de champ. Si la valeur est -1, n'importe quel nombre de régions est autorisé. |
Name | Chaîne | Lecture seule | Nom de service du champ |
NamePath | Chaîne[] | Lecture seule | Tableau des noms des champs et des groupes qui constituent le chemin d'accès au champ. |
NeedRecognize | Booléen | Lecture/écriture | Indique si la valeur du champ doit être récupérée dans la région lorsque les règles sont à nouveau vérifiées. |
Regions | { Id: number; Status: number; PageId: Nombre; IsNew : Booléen; Coordinates: Object [{X1,X2,Y1,Y2}]; }[] |
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 nécessite une vérification. |
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 la constitution du récapitulatif des données sur le formulaire de données. |
Champ d'image
Nom | Type | Accès | Description |
---|---|---|---|
Caption | Chaîne | Lecture seule | Nom du champ personnalisé, légende |
FieldType | Nombre | Lecture seule |
Type de champ. Valeur possible : 1 - image |
Id | Nombre | Lecture seule | Identifiant de champ. |
IsReadOnly | Booléen | Lecture seule | Indique si la modification du champ est interdite. |
IsVisible | Booléen | Lecture seule | Indique si le champ est visible sur le formulaire de données. |
MaxRegions | Nombre | Lecture seule | Nombre maximum de régions de champ. Si la valeur est -1, n'importe quel nombre de régions est autorisé. |
Name | Chaîne | Lecture seule | Nom de service du champ |
NamePath | Chaîne[] | Lecture seule | Tableau des noms des champs et des groupes qui constituent le chemin d'accès au champ. |
Regions | { Id : nombre ; Status : nombre ; PageId : Nombre ; IsNew : Booléen ; Coordinates : Objet [{X1,X2,Y1,Y2}] ; }[] |
Lecture seule |
Tableau de régions.
|
Groupe répétitif de champ Sections
Nom | Type | Accès | Description |
Id | Nombre | Lecture seule | Identifiant de champ |
Name | Chaîne | Lecture seule | Nom du champ |
Sections | Section[] | Lecture seule | Tableau des champs de type Section |
FieldType | Nombre | Lecture seule |
Type de champ. Valeur possible : 8 - groupe de sections récurrent. |
Propriétés de l'objet du document
Nom | Type | Accès | Description |
---|---|---|---|
AssemblingErrors | { DocumentNodeRef : nombre[][]; Description : chaîne ; SectionName: chaîne[] }[] |
Lecture seule |
Erreurs de construction dans le document lorsque :
|
BatchId | Nombre | Lecture seule | L'identifiant du package |
Errors | { DocumentNodeRef : nombre[][] ; Severity : nombre ; Message : chaîne ; RuleName : chaîne ; }[] |
Lecture seule |
Erreurs dans le document lorsque :
|
Fields | (Section | SectionsGroup)[] | Lecture seule | Liste des sections/des sections en double |
Id | Nombre | Lecture seule | Identifiant de document |
Index | Nombre | Lecture seule | L'index du document dans le package. |
Pages | { Id : nombre ; Modification : nombre ; HasColorImage : booléen ; ImageResolution : nombre ; KeyValue : chaîne ; SectionTemplateId : nombre ; SectionTemplateName : chaîne ; FlexibleInstanceId : nombre ; SectionTemplatePageNumber : nombre ; Comment : chaîne ; ImageWidth : nombre ; ImageHeight : nombre ; }[] |
Lecture seule |
Liste des pages du 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 | Identifiant de la définition de document |
TemplateName | Chaîne | Lecture seule | Le nom des définitions de document |
TemplateVersion | Nombre | Lecture seule | La version de la définition de document |
Version | Nombre | Lecture seule | Version du document |
12.04.2024 18:16:03