✕
✕

ReadCellsFromRow

TwinCAT TIA
Lokal Datei- und Ordner-Zugriff Excel

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

Der Befehl liest die Inhalte von Zellen einer Zeile mit angegebenen Start- und Endspaltenindex des angegebenen Exceltabellenblatts in einem angegebenen Pfad aus.

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:

    ReadCellsFromRow
    Eine Variable vom Typ OpcMethodReturnValueString.
      Result
      Ausgelesene Inhalte aus dem Exceltabellenblatt mit angegebenen Trennzeichen getrennt.

Beispiele:

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

Beckhoff Parameter:

    bExcelReadCellsFromRow
    Eine boolesche Variable, über welche die Ausführung des ReadCellsFromRow-Befehls getriggert werden kann.
    OutputDataReadCellsFromRow
    Eine Instanz der "ST_StringOutputData", in welche der Rückgabewert der ReadCellsFromRow-Methode geschrieben wird.
    hrExcelReadCellsFromRow
    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.
    nStartColumnNumber
    Eine DINT-Variable, welche den Startspaltenindex der zu lesenden Zellen enthält.
    nEndColumnNumber
    Eine DINT-Variable, welche den Endspaltenindex der zu lesenden Zellen enthä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
     bExcelReadCellsFromRow     : BOOL;
     OutputDataReadCellsFromRow    : ST_StringOutputData;
     hrExcelReadCellsFromRow     : HRESULT;

     fbExcel : FB_Excel;
END_VAR

hrExcelReadCellsFromRow := fbExcel.ReadCellsFromRow(
          bExecute    := bExcelReadCellsFromRow,   
          ConnectionHandle := depragSmartConnection.ConnectionHandle, 
          sFileFullPath  := 'C:\Test\TestFile.xlsx',
          sWorksheetName  := 'Testsheet',
          nRowNumber   := 1,
          nStartColumnNumber := 2,
          nEndColumnNumber := 5,
          Separator   := ',',
          OutputData   => OutputDataReadCellsFromRow);
IF hrExcelReadCellsFromRow <> S_FALSE THEN 
     bExcelReadCellsFromRow := 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.