ReadExcelFile (FPScript)
Lit un ou plusieurs ensembles de données à partir d'un fichier Excel.
Syntaxe
ReadExcelFile(Path, [ Schema ], [ Sheet = 0 ], [ ChannelIdentifier ], [ CalendarTime = FALSE ], [ Signal = FALSE ], [ DataRange = READEXCEL_DR_COMPLETE ], [ RangeFrom ], [ RangeTo ] [ , Duration ])
La syntaxe de la fonction ReadExcelFile se compose des éléments suivants :
Section |
Description |
||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Path |
Chaîne de caractères avec le chemin du fichier à lire. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères (nom du fichier). Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste. |
||||||||||||
Schema |
Nom d'alias d'un schéma stocké dans la base de données projet qui contient tous les paramètres nécessaires à l'importation, ou le chemin d'un schéma XML stocké sur le disque dur, ou tous les paramètres nécessaires sous forme de chaîne XML. Les structures de données autorisées sont Scalaire. Tous les types de données sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
||||||||||||
Sheet |
Nom ou index (à partir de 0) de la feuille de calcul Excel à utiliser. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Entier de 16 bits, Entier de 32 bits, Entier de 64 bits et Chaîne de caractères. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut 0 . |
||||||||||||
ChannelIdentifier |
Numéro du ou des canaux à lire (en commençant par 1). Si aucun numéro de canal n'est spécifié, tous les canaux sont retournés ou, s'ils sont présents, la sélection du schéma choisi est utilisée. Si une valeur scalaire est spécifiée en tant que ChannelIdentifier le canal est renvoyé sous forme de série de données ou de signal. Sinon, les canaux sont renvoyés sous forme de liste. Les structures de données autorisées sont Scalaire et Séries de données. Tous les types de données entiers sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
||||||||||||
CalendarTime |
Valeur booléenne indiquant que les données temporelles doivent être lues en tant que temps calendaires. Sinon, la composante X fournit le temps en secondes depuis le début de la mesure. Cet argument peut ne pas être pris en charge par le format sélectionné et, dans ce cas, il peut être ignoré. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Valeur booléenne. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut FALSE . |
||||||||||||
Signal |
Valeur booléenne spécifiant que les éléments doivent être importés en tant que signaux. Cet argument peut ne pas être pris en charge par le format sélectionné et, dans ce cas, peut être ignoré. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Valeur booléenne. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut FALSE . |
||||||||||||
DataRange |
Valeur qui spécifie le type de plage de données à créer. L'argument DataRange peut avoir les valeurs suivantes :
Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut READEXCEL_DR_COMPLETE . |
||||||||||||
RangeFrom |
Temps absolu ou relatif de la première valeur à lire si les données ne doivent pas être lues depuis le début. Si l'ensemble de données X contient des valeurs de temps calendaire, une valeur de temps calendaire est attendue ici ; sinon, une valeur à virgule flottante est attendue. Si l'argument n'est pas spécifié ou si aucun ensemble de données X n'est affecté aux ensembles de données, les données sont lues depuis la première valeur. Les structures de données autorisées sont Scalaire. Tous les types de données réels sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
||||||||||||
RangeTo |
Temps absolu ou relatif de la dernière valeur à lire si les données ne doivent pas être lues jusqu'à la fin. Si l'ensemble de données X contient des valeurs de temps calendaire, une valeur de temps calendaire est attendue ici ; sinon, une valeur à virgule flottante est attendue. Si l'argument n'est pas spécifié ou si aucun ensemble de données X n'est affecté aux ensembles de données, les données sont lues jusqu'à la dernière valeur. Les structures de données autorisées sont Scalaire. Tous les types de données réels sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
||||||||||||
Duration |
Durée de la plage de données. Cette valeur doit être spécifiée si l'élément DataRange a la valeur READEXCEL_DR_FROMDURATION, READEXCEL_DR_DURATIONLAST ou READEXCEL_DR_FIRSTDURATION. Cet argument n'est pris en charge que lorsqu'un ensemble de données X a été spécifié. Les structures de données autorisées sont Scalaire. Tous les types de données réels sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
Remarques
Lors de l'importation d'un fichier à l'aide de l'assistant d'importation, il est possible d'enregistrer le schéma avec les paramètres dans la base de données des modèles. Dans ce cas, le nom d'alias peut être utilisé pour accéder aux paramètres. Si les paramètres ne sont pas enregistrés sous forme de schéma, vous pouvez également transmettre les paramètres directement à la fonction sous forme de chaîne XML. Dans la boîte de dialogue Organizer, vous pouvez enregistrer un schéma sauvegardé dans un fichier XML. Vous pouvez également accéder à ce type de fichier XML directement dans la base de données des modèles ReadExcelFile. Si une entrée du fichier ne peut pas être interprétée comme un nombre, une valeur à virgule flottante invalide est saisie à l'emplacement correspondant dans le résultat.
Disponible dans
FlexPro View, Basic, Professional, Developer Suite
Exemples
ReadExcelFile("c:\\examples\\file.xlsx", 1, "", 2)
Lit le deuxième canal à partir du fichier c:\examples\file.xlsx. Les paramètres par défaut sont utilisés pour l'importation.