Massenhafte Texteinbindung für Excel – Fügt Präfixe, Suffixe und benutzerdefinierten Text zu Zellen hinzu – Schritt-für-Schritt-Anleitung

Fügen Sie Text in mehrere Excel-Zellen mit einem einzigen Vorgang hinzu. Fügen Sie Präfixe, Suffixe, Bezeichnungen oder benutzerdefinierte Zeichen am Anfang, am Ende oder vor/after einem bestimmten Text innerhalb der Zellen mithilfe der Aspose.Cells API ein.

Übersicht

Einzelner Aufruf für Masseneinfügung von Präfixen, Suffixen oder positionsgesteuerten Zeichenketten in jede Zelle eines Zielbereichs – keine Formeln, keine Hilfsspalten erforderlich.

  • Einfügen von benutzerdefiniertem Text an beliebiger Position innerhalb jeder Zelle
Wert Beschreibung
None Ersetzen des ursprünglichen Inhalts
AtTheBeginning Einfügen am Anfang (Präfix)
AtTheEnd Einfügen am Ende (Suffix)
BeforeText Einfügen vor dem ersten Vorkommen von selectText; überspringen, falls nicht gefunden
AfterText Einfügen nach dem ersten Vorkommen von selectText; überspringen, falls nicht gefunden
  • Vier Positionsmodi: Präfix, Suffix, vor/nach einem Teilstring.

  • Leerzellen überspringen, um Unordnung zu vermeiden.

  • Die API bearbeitet ausschließlich Werte vom Typ String; Zahlen, Boolesche Werte und Formeln werden vorher in Text konvertiert.

  • Leere Zellen

    • skipEmptyCells = true → leere Zellen werden übersprungen.
    • skipEmptyCells = false → Text wird in leere Zellen eingefügt (Zelle wird zum Texttyp).
  • Anker nicht gefunden: Wenn position = BeforeText | AfterText und selectText nicht vorhanden ist, bleibt der Zellwert unverändert.

Web-API

PUT https://api.aspose.cloud/v4.0/cells/content/add/text

Sicherheit und Authentifizierung

Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.

-H "Authorization: Bearer {access_token}"

Die Anforderungsparameter der AddText-API lauten

Parametername Typ Pfad/Abfragezeichenfolge/HTTP-Body Beschreibung Erforderlich
Spreadsheet Datei FormData Die zu verarbeitende Tabellendatei. Unterstützte Formate umfassen XLSX, XLS, ODS, CSV usw. Ja
text String Abfrage Der Textinhalt, der in die angegebenen Zellen der Tabellendatei eingefügt werden soll. Ja
position String Abfrage Gibt an, wo der Text relativ zum vorhandenen Zellinhalt eingefügt werden soll. Optionen: AtTheBeginning, AtTheEnd, BeforeText, AfterText, None. Ja
selectText String Abfrage (Optional) Wenn angegeben, wird der Text nur in Zellen eingefügt, die diesen genauen Teilstring enthalten. Wird in Verbindung mit dem Parameter position verwendet. Nein
skipEmptyCells Boolean Abfrage Wenn true, werden leere Zellen übersprungen; wenn false, wird Text in leere Zellen eingefügt. Nein
worksheet String Abfrage (Optional) Der Name des Arbeitsblatts, in das der Text eingefügt werden soll. Wenn weggelassen, gilt der Vorgang standardmäßig für das erste Arbeitsblatt. Nein
range String Abfrage (Optional) Der Zellbereich, in den der Text eingefügt werden soll (z. B. "A1:C10"). Wenn weggelassen, gilt der Vorgang für alle genutzten Zellen im angegebenen Arbeitsblatt. Nein
outPath String Abfrage (Optional) Der Ordnerpfad im Cloud-Speicher, in dem die verarbeitete Arbeitsmappe gespeichert wird. Wenn weggelassen, wird die Datei im Quellordner gespeichert. Nein
outStorageName String Abfrage Der Name des Cloud-Speichers, in dem die Ausgabedatei gespeichert wird. Nein
region String Abfrage (Optional) Legt die Lokalisierung für die Formatierung von Zahlen, Datumsangaben und Währungen in der Ausgabedatei fest (z. B. "en-US", "zh-CN", "de-DE"). Nein
password String Abfrage (Optional) Falls die hochgeladene Tabellendatei passwortgeschützt ist, geben Sie das Passwort an, um die Datei zu öffnen und zu verarbeiten. Nein

cURL-Beispiel

curl -X PUT "https://api.aspose.cloud/v4.0/cells/content/add/text?text=Report&position=AtTheBeginning&skipEmptyCells=true" \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@/path/to/workbook.xlsx" \
  -F "outPath=output/workbook_modified.xlsx"

Antwort

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

Fehlercodes

Code Beschreibung
400 Bad Request Ungültige Aspose.Cells Cloud API-URI oder fehlende erforderliche Parameter.
401 Unauthorized Ungültiges Zugriffstoken oder ungültige Client-ID und -Geheimnis.
404 Not Found Die Tabellendatei ist nicht zugänglich.
500 Server Error Bei der Tabellendatei trat beim Abrufen von Berechnungsdaten eine Abweichung auf.

Wo sollte die Add Text für Tabellenkalkulation API verwendet werden?

  • Dynamische Berichtsbezeichnung: Dynamische Titel, Datumsangaben oder Anmerkungen zu automatisch generierten Finanzberichten und Verkaufsberichten hinzufügen.
  • Batch-Dateiwassermarkierung: Firmenlogos, Vertraulichkeits-Wasserzeichen oder Versionsinformationen zu einer Gruppe von Excel-Dateien hinzufügen.
  • Vorlagen-Datenerfassung: Automatisches Einfügen von Kundennamen, Beträgen und anderen Texten an festgelegten Positionen in Vertrags- oder Rechnungsvorlagen.
  • Datenklassifizierungsbezeichnung: Automatisches Hinzufügen von Klassifizierungsbezeichnungen oder Statusbezeichnungen (z. B. „Zur Überprüfung ausstehend“, „Genehmigt“) zu Datenzeilen basierend auf Analyseergebnissen.
  • Datenqualitätsanmerkung: Anmerkungen für problematische Daten während der Datenbereinigung hinzufügen.
  • Massentextformatierung: Einheitliches Hinzufügen von Präfixen oder Suffixen zu Produkt- oder Kundenbezeichnungen.

Warum sollten Sie die Add Text für Tabellenkalkulation API verwenden?

  • Massen-Texteinbindung: Fügen Sie Text gleichzeitig in Hunderte von Zellen oder Dateien ein und sparen Sie bis zu 95 % der Zeit im Vergleich zur manuellen Arbeit.
  • Präzise Positionssteuerung: Unterstützt das Einfügen von Text an sechs Positionen präzise, einschließlich am Anfang, am Ende oder vor/nach einem bestimmten Text innerhalb einer Zelle.
  • Intelligente bedingte Handhabung: Entscheiden Sie, ob Text basierend darauf eingefügt werden soll, ob eine Zelle leer ist oder bestimmten Text enthält.
  • Unterstützung mehrerer Positionsstrategien:
    • AtTheBeginning: Fügt denselben Text vor dem Inhalt aller ausgewählten Zellen ein.
    • AtTheEnd: Fügt Text nach dem Inhalt aller ausgewählten Zellen ein.
    • BeforeText / AfterText: Fügt Text nur vor oder nach Zellen ein, die bestimmten Text enthalten.
    • None: Ersetzt den ursprünglichen Inhalt.
  • Präzise Bereichssteuerung: Ermöglicht die Angabe bestimmter Arbeitsblätter oder Zellbereiche für Vorgänge.
  • Bedingte Überspringoption: Unterstützt das Überspringen leerer Zellen, um unnötige Texteinblendungen zu vermeiden.
  • Entwicklerfreundlich: Aspose.Cells Cloud bietet SDK-Bibliotheken in mehreren Sprachen an, die eine schnelle Entwicklung ermöglichen und umfangreiche Dokumentation bereitstellen. Im Vergleich zum Aufbau eigener Diagramm-Renderlösungen wird die Entwicklungsarbeit erheblich reduziert.
  • Kosteneffizient: Sie können Text in einer Zelle anhängen, ohne die Arbeitsmappe zuvor hochzuladen, was Speicherplatz spart und Kosten senkt.

OpenAPI-Spezifikation

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt aus einem Webbrowser.

Verwenden Sie Aspose.Cells Cloud SDKs

Die Verwendung des SDKs ist der beste Weg, die Entwicklung zu beschleunigen. Das SDK übernimmt die zugrunde liegenden Details, sodass Sie Add Text für Zellen mit minimalem Codeaufwand implementieren können. Weitere Informationen finden Sie im GitHub-Repository für eine vollständige Liste der Aspose.Cells Cloud SDKs.

Die folgenden Codebeispiele zeigen, wie Aufrufe an Aspose.Cells-Webservices mithilfe verschiedener SDKs durchgeführt werden: