Zum Inhalt springen

Microsoft Excel v3 (Beta) Aktivität „Zeilen einfügen" in Jitterbit Studio

Einführung

Eine Microsoft Excel v3 (Beta) Zeilen einfügen-Aktivität schreibt mit ihrer Microsoft Excel v3 (Beta)-Verbindung ein oder mehrere Zeilen in ein Arbeitsblatt und ist als Ziel zum Verbrauch von Daten in einem Vorgang vorgesehen.

Hinweis

Dieser Connector befindet sich derzeit in der Beta-Phase. Senden Sie Feedback an das Jitterbit-Produktteam.

Eine Microsoft Excel v3 (Beta) Aktivität „Zeilen einfügen" erstellen

Eine Instanz einer Microsoft Excel v3 (Beta) Zeilen einfügen-Aktivität wird aus einer Microsoft Excel v3 (Beta)-Verbindung mit dem Aktivitätstyp Zeilen einfügen erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Microsoft Excel v3 (Beta) Zeilen einfügen-Aktivität kann von diesen Orten aus bearbeitet werden:

Eine Microsoft Excel v3 (Beta) Aktivität „Zeilen einfügen" konfigurieren

Folgen Sie diesen Schritten, um eine Microsoft Excel v3 (Beta) Zeilen einfügen-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben und Arbeitsmappe auswählen

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

  • Endpoint-Menü: Wenn mehrere Endpoints desselben Connector-Typs konfiguriert sind, wird oben auf dem Bildschirm ein Menü mit dem Namen des aktuellen Endpoints angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpoint zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpoint ändern in Konfigurationsbildschirme.

    • Endpoint bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den Namen des aktuellen Endpoints bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpoints 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 einfügen-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Arbeitsmappe auswählen: In diesem Abschnitt werden im konfigurierten Ordner des Endpoints verfügbare Arbeitsmappendateien angezeigt.

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

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

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

  • Arbeitsmappe auswählen: Klicke 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, war die Verbindung möglicherweise nicht erfolgreich. Stelle sicher, dass du verbunden bist, indem du die Verbindung erneut öffnest und neu testest.

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

    • Bei Fehler fortfahren: Wähle diese Option, um die Aktivitätsausführung fortzusetzen, wenn bei einem Datensatz in einer Batch-Anfrage ein Fehler auftritt. Falls Fehler auftreten, werden diese im Vorgangsprotokoll protokolliert.

  • Speichern und beenden: Wenn aktiviert, klicke, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicke, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn du auf der letzten Stufe auf die Schaltfläche Fertig klickst.

  • Änderungen verwerfen: Nachdem du Änderungen vorgenommen hast, klicke, um die Konfiguration zu schließen, ohne die in einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert dich auf zu bestätigen, dass du die Änderungen verwerfen möchtest.

Schritt 2: Arbeitsblatt auswählen

Wähle in diesem Schritt das Arbeitsblatt in der Arbeitsmappe aus und gib 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 Arbeitsblätter in der Arbeitsmappe an.

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

    • Suche: Gib einen Wert in das Suchfeld ein, um die Liste der Arbeitsblätter zu filtern. Die Suche berücksichtigt die Groß- und Kleinschreibung nicht. Wenn Arbeitsblätter bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Arbeitsblätter vom Endpunkt beim Suchen neu zu laden, gib Suchkriterien ein und aktualisiere dann wie nachfolgend beschrieben.

    • Aktualisieren: Klicke auf das Aktualisierungssymbol oder 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: Klicke 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: Wähle diese Option, um anzugeben, dass das Arbeitsblatt eine Kopfzeile hat. Standardmäßig ausgewählt.

  • Kopfzeilennummer: Gib die Zeilennummer der Kopfzeile ein. Akzeptiert nur numerische Werte. Standardmäßig 1. Nur verfügbar, wenn Kopfzeile angeben ausgewählt ist.

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

  • Weiter: Klicke, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn du auf der letzten Stufe auf die Schaltfläche Fertig klickst.

  • Änderungen verwerfen: Nachdem du Änderungen vorgenommen hast, klicke, um die Konfiguration zu schließen, ohne die in einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert dich auf zu bestätigen, dass du die Änderungen verwerfen möchtest.

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 Feld für jede Spalte im ausgewählten Arbeitsblatt (abgeleitet aus der Kopfzeile) zusammen mit einem rowNumber-Feld, das die einzufügende Zeile angibt. Das Antwortdatenschema gibt für jede verarbeitete Zeile den path, den sheetName und die rowNumber, einen status von success oder error und bei einem Fehler ein error-Objekt mit cause- und detailedMessage-Feldern zurück.

    Jedes Feld im Anfragedatenschema ist als String typisiert, aber der tatsächlich in jede Zelle geschriebene Wert wird durch das Format der Zelle bestimmt, wie unter How values are written to cells beschrieben.

Diese Datenschemas werden von benachbarten Transformationen geerbt und während der Datenzuordnung erneut 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 zu regenerieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen auf das gleiche Schema verwiesen 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ückzukehren.

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

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

Wie Werte in Zellen geschrieben werden

Wenn eine Microsoft Excel v3 (Beta) Insert 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: Beginnt der Wert mit einem Gleichheitszeichen =, 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.

  • Boolescher Wert: Ist der Wert genau true oder false (Groß-/Kleinschreibung irrelevant), wird er als boolescher Wert geschrieben.

  • Datum oder Uhrzeit: Hat das Zahlenformat der Zelle ein Datums- oder Uhrzeitformat, wird der Wert gegen gängige Datums- und Zeitmuster geparst (z. B. yyyy-MM-dd oder HH:mm:ss). Stimmt der Wert mit einem dieser Muster überein, wird er als Datumswert geschrieben, sonst als Text.

  • Prozentsatz: Hat das Zahlenformat der Zelle ein Prozentformat, wird der Wert (mit oder ohne nachfolgendes %) als Zahl geparst und durch 100 dividiert.

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

  • Zahl: Hat das Zahlenformat der Zelle den Typ General oder ein Zahlenformat und lässt sich der Wert als Zahl parsen, wird er als Zahl geschrieben.

  • Text: Ein Wert, der keinem der oben aufgeführten Datentypen entspricht, wird als Text geschrieben.

Hinweis

Das in diesen Prüfungen verwendete Zahlenformat der Zelle ist das Format der Arbeitsblattspalte selbst. Hat die Spalte kein spezifisches Zahlenformat, wird stattdessen das Format einer vorhandenen Zelle an dieser Zeilen- und Spaltenposition verwendet.

Nächste Schritte

Nach dem Konfigurieren einer Microsoft Excel v3 (Beta) Insert 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 verknüpfen, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Design-Canvas verfügbar. Weitere Informationen finden Sie unter Aktivitätsaktionsmenü in Connector-Grundlagen.

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

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

Wenn Sie bereit sind, stellen Sie den Vorgang bereit und führen ihn aus, und überprüfen Sie das Verhalten durch Kontrolle der Vorgangsprotokolle.