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 | AfterTextundselectTextnicht 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: