Zum Inhalt springen

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

Einführung

Eine Microsoft Excel v3 (Beta) Update Rows-Aktivität aktualisiert mithilfe ihrer Microsoft Excel v3 (Beta)-Verbindung ein oder mehrere vorhandene Zeilen in einem Arbeitsblatt und wird als Ziel zum Verarbeiten von Daten in einem Vorgang verwendet.

Hinweis

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

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

Eine Instanz einer Microsoft Excel v3 (Beta) Update Rows-Aktivität wird aus einer Microsoft Excel v3 (Beta)-Verbindung mit dem Aktivitätstyp Update Rows erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Designfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Designfläche ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz unter Komponenten wiederverwenden.

Eine vorhandene Microsoft Excel v3 (Beta) Update Rows-Aktivität kann an den folgenden Orten bearbeitet werden:

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

Führen Sie diese Schritte aus, um eine Microsoft Excel v3 (Beta) Update Rows-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein und wählen Sie die Arbeitsmappe aus

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

  • Endpunkt-Menü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, zeigt ein Menü oben auf dem Bildschirm den Namen des aktuellen Endpunkts an. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern unter Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den Namen des aktuellen Endpunkts 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) Update Rows-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Arbeitsmappe auswählen: In diesem Bereich werden die in dem für den Endpunkt konfigurierten Ordner verfügbaren Arbeitsmappendateien angezeigt.

    • Ausgewählte Arbeitsmappe: Nachdem eine Arbeitsmappe ausgewählt wurde, wird sie hier aufgelistet.

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

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Arbeitsmappendateien vom Endpunkt zu laden. Dies kann nützlich sein, wenn Arbeitsmappendateien zum konfigurierten Ordner hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der Tabelle der im Konfigurationsbereich angezeigten Arbeitsmappendateien 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.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

    • Bei Fehler fortfahren: Wählen Sie diese Option, um die Aktivitätsausführung fortzusetzen, wenn bei einem Dataset in einer Batch-Anforderung ein Fehler auftritt. Sollten Fehler auftreten, werden diese in das Operationsprotokoll geschrieben.

  • Speichern und 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 gehen. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach dem Vornehmen von Änderungen klicken Sie, 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 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 nachfolgend beschrieben.

  • Arbeitsblatt auswählen: Dieser Abschnitt zeigt die im Schritt 1 ausgewählten Arbeitsmappen verfügbaren Arbeitsblätter.

    • Ausgewähltes Arbeitsblatt: Nach der Auswahl eines Arbeitsblattes wird es hier aufgelistet.

    • Suchen: Geben Sie einen Wert in das Suchfeld ein, um die Liste der Arbeitsblätter zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Wenn Arbeitsblätter bereits in der Tabelle angezeigt werden, werden die Tabellenresultate bei jedem Tastendruck in Echtzeit gefiltert. Geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben, um Arbeitsblätter vom Endpunkt erneut zu laden.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Arbeitsblätter vom Endpunkt erneut zu laden. Dies kann hilfreich sein, wenn der Arbeitsmappe Arbeitsblätter hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der Tabelle der in der Konfiguration angezeigten Arbeitsblätter 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 Arbeitsblattes wird aus der ausgewählten Arbeitsmappe abgerufen.

  • Kopfzeile angeben: Wählen 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. 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 gehen. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach dem Vornehmen von Änderungen klicken Sie, 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 3: Datenschemas überprüfen

Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Element der Benutzeroberfläche dieses Schritts wird nachfolgend beschrieben.

  • Datenschema: Das Anfragedatenschema enthält ein rowNumber-Feld, das die zu aktualisierende Zeile angibt, zusammen mit einem verschachtelten content-Objekt, das ein Feld für jede Spalte im ausgewählten Arbeitsblatt enthält (abgeleitet aus der Kopfzeile). Das Antwortdatenschema gibt für jede verarbeitete Zeile path, sheetName und rowNumber zurück, einen status von success oder error und bei Auftreten eines Fehlers ein error-Objekt mit cause- und detailedMessage-Feldern.

    Jedes Feld im verschachtelten content-Objekt ist als String typisiert, aber der tatsächlich in jede Zelle geschriebene Wert wird durch das Format der Zelle bestimmt, wie in Wie Werte in Zellen geschrieben werden beschrieben.

Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden erneut während der Datenzuordnung angezeigt.

Hinweis

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

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

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

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

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, 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.

Wie Werte in Zellen geschrieben werden

Wenn eine Microsoft Excel v3 (Beta) Update Rows-Aktivität einen zugeordneten Wert in eine Zelle schreibt, bestimmt sie den Datentyp des Werts anhand des Werts selbst und des Formats der Zielzelle in dieser Reihenfolge:

  • Formel: Wenn der Wert mit einem Gleichheitszeichen = beginnt, wird er als Formel geschrieben und von Excel ausgewertet, wenn die Arbeitsmappe geöffnet wird. Wenn der Text nach dem Gleichheitszeichen keine gültige Formel ist, schlägt die Aktivität mit einem Fehler fehl.

  • Boolean: Wenn der Wert genau true oder false (Groß-/Kleinschreibung wird ignoriert) ist, wird er als boolescher Wert geschrieben.

  • Datum oder Uhrzeit: Wenn das Zahlenformat der Zelle ein Datums- oder Uhrzeitformat ist, wird der Wert gegen häufige Datums- und Zeitmuster analysiert (z. B. yyyy-MM-dd oder HH:mm:ss). Wenn der Wert mit einem dieser Muster übereinstimmt, wird er als Datumswert geschrieben; andernfalls wird er als Text geschrieben.

  • Prozentsatz: Wenn das Zahlenformat der Zelle ein Prozentsatzformat ist, wird der Wert (mit oder ohne nachfolgendes %) als Zahl analysiert und durch 100 geteilt.

  • Bruch: Wenn das Zahlenformat der Zelle ein Bruchformat ist und der Wert einen Schrägstrich / enthält, wird der Wert als Zähler und Nenner analysiert und als resultierende Zahl geschrieben.

  • Zahl: Wenn das Zahlenformat der Zelle General oder ein numerisches Format ist und der Wert als Zahl analysiert werden kann, wird er als Zahl geschrieben.

  • Text: Jeder Wert, der keinem der oben genannten Datentypen entspricht, wird als Text geschrieben.

Hinweis

Das Zahlenformat der Zelle, das in diesen Überprüfungen verwendet wird, ist das aktuelle Format der Zelle, die aktualisiert wird. Wenn diese Zelle noch keinen Wert hat, wird stattdessen das Zahlenformat der Arbeitsblattspalte verwendet.

Nächste Schritte

Nach der Konfiguration einer Microsoft Excel v3 (Beta) Update Rows-Aktivität schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten, Transformationen oder Skripte 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 im Projektbereich und auf der Designoberfläche zugänglich. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

Microsoft Excel v3 (Beta) Update Rows-Aktivitäten können mit diesen Vorgangsmustern als Ziel verwendet werden:

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

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