✕
✕

ReadAllUsedCellsFromRow

TwinCAT TIA
Lokal Datei- und Ordner-Zugriff Excel

ns=2;s=DEPRAG Smart/Local/FileAndDirectoryAccess/Excel/ReadAllUsedCellsFromRow

Der Befehl liest die Inhalte von der ersten gefüllten bis zur letzten gefüllten Zelle einer Zeile des angegebenen Exceltabellenblatts in einem angegebenen Pfad aus. Sind zwischen der ersten und der letzten gefüllten Zelle leere Einträge enthalten werden diese in die Ausgabe übernommen.

Parameter:

    FileFullPath
    Pfad der Datei. Die Datei kann entweder eine lokale Datei sein oder eine Datei, die auf einem Netzwerklaufwerk abgelegt ist.
    Separator
    Trennzeichen zwischen den ausgelesenen Inhalten der Zellen.

Rückgabewert:

Beispiele:

Neben den bereits erläuterten Parametern sind für die Implementierung in TwinCAT 3 nachfolgende Variablen anzulegen / zu übergeben:

Beckhoff Parameter:

    bExcelReadAllUsedCellsFromRow
    Eine boolesche Variable, über welche die Ausführung des ReadAllUsedCellsFromRow-Befehls getriggert werden kann.
    OutputDataReadAllUsedCellsFromRow
    Eine Instanz der "ST_StringOutputData", in welche der Rückgabewert der ReadAllUsedCellsFromRow-Methode geschrieben wird.
    hrExcelReadAllUsedCellsFromRow
    Hiermit kann die Ausführung des Befehls überwacht werden. Fehler-Codes haben den Typ "HRESULT".
    fbExcel
    Eine Instanz des, mit der DEPRAG Smart-Bibliothek gelieferten, "FB_Excel" Funktionsbausteins.
    sFileFullPath
    Eine STRING-Variable, die den vollständigen Pfad der Excel-Datei enthält.
    sWorksheetName
    Eine STRING-Variable, die den Name des Exceltabellenblatts enthält.
    nRowNumber
    Eine DINT-Variable, welche den Zeilenindex enhält.
    Separator
    Eine STRING(255)-Variable, welche die Trennzeichen zwischen den ausgelesenen Inhalten der Zellen enthält.
    ConnectionHandle
    Beim Verbindungsaufbau zwischen DEPRAG Smart Server und Ihrem OPC UA Client erhaltenes "ConnectionHandle". 


VAR
     bExcelReadAllUsedCellsFromRow   : BOOL;
     OutputDataReadAllUsedCellsFromRow  : ST_StringOutputData;
     hrExcelReadAllUsedCellsFromRow   : HRESULT;

     fbExcel : FB_Excel;
END_VAR

hrExcelReadAllUsedCellsFromRow := fbExcel.ReadAllUsedCellsFromRow(
          bExecute    := bExcelReadAllUsedCellsFromRow,   
          ConnectionHandle := depragSmartConnection.ConnectionHandle, 
          sFileFullPath  := 'C:\Test\TestFile.xlsx',
          sWorksheetName  := 'Testsheet',
          nRowNumber   := 1,
          Separator   := ',',
          OutputData   => OutputDataReadAllUsedCellsFromRow);
IF hrExcelReadAllUsedCellsFromRow <> S_FALSE THEN 
     bExcelReadAllUsedCellsFromRow := FALSE;
END_IF

Für Beispiele und Erklärungen bezüglich der Aufrufe von Knoten via Siemens TIA Portal sei an dieser Stelle auf den Unterpunkt "Siemens TIA Portal" in Abschnitt "Erste Schritte" verwiesen.