Zum Inhalt springen

Microsoft Excel v3 (Beta) Aktivität „Zeilen lesen" in Jitterbit Studio

Einführung

Eine Microsoft Excel v3 (Beta) Zeilen lesen-Aktivität verwendet ihre Microsoft Excel v3 (Beta) Verbindung zum Lesen von Zeilen aus einem Arbeitsblatt und ist als Quelle konzipiert, um Daten in einem Vorgang bereitzustellen.

Hinweis

Dieser Connector befindet sich derzeit in der Beta-Phase. Um Feedback zu geben, kontaktieren Sie das Jitterbit Product Team.

Erstellen einer Microsoft Excel v3 (Beta) Aktivität „Zeilen lesen"

Eine Instanz einer Microsoft Excel v3 (Beta) Zeilen lesen-Aktivität wird aus einer Microsoft Excel v3 (Beta) Verbindung mit ihrem Aktivitätstyp Zeilen lesen erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Designoberfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Designoberfläche ein. Einzelheiten finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Microsoft Excel v3 (Beta) Zeilen lesen-Aktivität kann an diesen Orten bearbeitet werden:

Konfigurieren einer Microsoft Excel v3 (Beta) Aktivität „Zeilen lesen"

Führen Sie diese Schritte durch, um eine Microsoft Excel v3 (Beta) Zeilen lesen-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben und Arbeitsmappe auswählen

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und wählen Sie die Arbeitsmappe aus, aus der gelesen werden soll. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Endpunktmenü: Falls Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Endpunkt ändern in Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Microsoft Excel v3 (Beta) Zeilen lesen-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Arbeitsmappe auswählen: In diesem Bereich werden die Arbeitsmappendateien angezeigt, die im für den Endpunkt konfigurierten Ordner verfügbar sind.

    • Ausgewählte Arbeitsmappe: Nach Auswahl einer Arbeitsmappe wird sie hier aufgelistet.

    • Suche: Geben Sie einen Wert in das Suchfeld ein, um die Liste der Arbeitsmappendateien zu filtern. Die Suche beachtet keine Groß- und Kleinschreibung. Wenn Arbeitsmappendateien bereits in der Tabelle angezeigt werden, werden die Tabellenabfragen bei jeder Eingabe in Echtzeit gefiltert. Um Arbeitsmappendateien vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Arbeitsmappendateien vom Endpunkt neu zu laden. Dies kann nützlich sein, wenn Arbeitsmappendateien dem konfigurierten Ordner hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der angezeigten Tabelle der Arbeitsmappendateien in der Konfiguration verwendet werden.

  • Arbeitsmappe auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um eine Arbeitsmappe auszuwählen. Es kann nur eine Arbeitsmappe ausgewählt werden. Der Name jeder Arbeitsmappendatei wird aus dem konfigurierten Ordner des Endpunkts abgerufen.

    Tipp

    Wenn die Tabelle nicht mit verfügbaren Arbeitsmappendateien gefüllt wird, ist die Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und erneut testen.

  • Speichern & Beenden: Falls aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Klicken Sie nach vorgenommenen Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Arbeitsblatt auswählen

Wählen Sie in diesem Schritt das Arbeitsblatt in der Arbeitsmappe aus und geben Sie das Verhalten der Kopfzeile an. Jedes Element der Benutzeroberfläche dieses Schritts wird unten beschrieben.

  • Arbeitsblatt auswählen: In diesem Bereich werden die im Schritt 1 ausgewählten Arbeitsblätter in der Arbeitsmappe angezeigt.

    • Ausgewähltes Arbeitsblatt: Nachdem ein Arbeitsblatt ausgewählt wurde, wird es hier aufgelistet.

    • Suche: Geben Sie einen Wert in das Suchfeld ein, um die Liste der Arbeitsblätter zu filtern. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden. Wenn Arbeitsblätter bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um Arbeitsblätter vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Arbeitsblätter vom Endpunkt neu zu laden. Dies kann hilfreich sein, wenn der Arbeitsmappe Arbeitsblätter hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Arbeitsblatt-Tabelle verwendet werden.

    • Arbeitsblatt auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Arbeitsblatt auszuwählen. Es kann nur ein Arbeitsblatt ausgewählt werden. Der Name jedes Arbeitsblatts wird aus der ausgewählten Arbeitsmappe abgerufen.

  • Kopfzeile angeben: Aktivieren Sie diese Option, um anzugeben, dass das Arbeitsblatt eine Kopfzeile hat. Standardmäßig ausgewählt.

  • Kopfzeilennummer: Geben Sie die Zeilennummer der Kopfzeile ein. Akzeptiert nur numerische Werte. Der Standardwert ist 1. Nur verfügbar, wenn Kopfzeile angeben ausgewählt ist.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Klicken Sie nach vorgenommenen Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Leseoptionen festlegen

Geben Sie in diesem Schritt an, welche Zeilen gelesen werden sollen und wie Leerzeilen und Zellmetadaten behandelt werden. Jedes Element der Benutzeroberfläche dieses Schritts wird unten beschrieben.

  • Lesen nach: Wählen Sie aus, wie bestimmt wird, welche Zeilen gelesen werden:

    • Zeilenlimit definieren: (Standard.) Liest einen begrenzten Bereich vollständiger Zeilen, der mit den Feldern Von und Bis festgelegt wird.
    • Excel-Bereich definieren: Liest den spezifischen Excel-Bereich, der im Feld Bereich eingegeben wird.

  • Bereich: Geben Sie den zu lesenden Excel-Bereich ein, z. B. A1:D100. Nur verfügbar, wenn Lesen nach auf Excel-Bereich definieren eingestellt ist.

  • Von: Geben Sie die erste zu lesende Zeilennummer ein. Der Standardwert ist 1. Nur verfügbar, wenn Lesen nach auf Zeilenlimit definieren eingestellt ist.

  • Bis: Geben Sie die letzte zu lesende Zeilennummer ein. Der Standardwert ist 100. Nur verfügbar, wenn Lesen nach auf Zeilenlimit definieren eingestellt ist.

  • Leere Zeilen nicht lesen: Aktivieren Sie diese Option, um leere Zeilen von den gelesenen Zeilen auszuschließen. Standardmäßig nicht ausgewählt.

  • Metadaten der Zelle einschließen: Aktivieren Sie diese Option, um Zellmetadaten einzubeziehen. Standardmäßig nicht ausgewählt.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu gehen. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach vorgenommenen Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 4: Datenschemas überprüfen

Alle Request- oder Response-Schemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Datenschema: Das Request-Datenschema enthält entweder ein range-Feld oder rowFrom- und rowTo-Felder, die der Auswahl Gelesen nach in Schritt 3 entsprechen, zusammen mit einem includeMetadata-Feld. Das Response-Datenschema gibt für jede gelesene Zeile die rowNumber zusammen mit einem Feld für jede Spalte im ausgewählten Arbeitsblatt (abgeleitet aus der Kopfzeile) zurück.

    Dieses Datenschema wird von benachbarten Transformationen geerbt und wird erneut während der Datenmapping-Transformation angezeigt.

    Hinweis

    Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im gesamten Projekt neu, an denen dasselbe Schema referenziert wird, z. B. in einer benachbarten Transformation.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzugehen.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Klicken Sie nach vorgenommenen Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Schließen Sie nach der Konfiguration einer Microsoft Excel v3 (Beta) Zeilen lesen-Aktivität die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten, Transformationen oder Skripts als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder unterschiedlichen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Entwurfsfläche zugänglich. Weitere Informationen finden Sie unter Aktivitätsaktion-Menü in Connector-Grundlagen.

Microsoft Excel v3 (Beta) Zeilen lesen-Aktivitäten können als Quelle mit diesen Vorgangsmustern verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie dann diesen temporären Speicherort in der Skriptfunktion.

Wenn Sie bereit sind, stellen Sie den Vorgang bereit und führen Sie ihn aus, und validieren Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.