Bulk-textinfogning för Excel – Lägg till prefix, suffix och anpassad text i celler – Steg-för-steg-guide

Infoga text i flera Excel-cellr i ett enda åtgärd. Lägg till prefix, suffix, etiketter eller anpassade tecken i början, slutet eller före/efter en specifik text i cellerna med Aspose.Cells API.

Översikt

Infoga prefix, suffix eller ankarsträngar i alla celler i ett målintervall med ett enda API-anrop – inga formler, inga hjälpspalter.

  • Infoga anpassad text på valfri position i varje cell
Värde Beskrivning
None Ersätt originalinnehållet
AtTheBeginning Infoga i början (prefix)
AtTheEnd Infoga i slutet (suffix)
BeforeText Infoga före första förekomsten av selectText; hoppa över om inte hittad
AfterText Infoga efter första förekomsten av selectText; hoppa över om inte hittad
  • Fyra lägesalternativ: prefix, suffix, före/efter en delsträng.

  • Hoppa över tomma celler för att undvika oönskad fyllning.

  • API:t påverkar endast strängtyps-värden; tal, booleska värden och formler konverteras först till text.

  • Tomma celler

    • skipEmptyCells = true → tomma celler hoppas över.
    • skipEmptyCells = false → text läggs till i tomma celler (cellen blir av typen text).
  • Ankaren hittas inte: När position = BeforeText | AfterText och selectText inte finns, förblir cellens värde oförändrat.

Webb-API

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

Säkerhet och autentisering

Aspose.Cells Cloud API:er är säkra och kräver JWT-token-baserad autentisering.

-H "Authorization: Bearer {access_token}"

Parametrar för API:et AddText är

Parameternamn Typ Path/Query String/HTTPBody Beskrivning Krävs
Spreadsheet Fil FormData Kalkylbladsfilen som ska bearbetas. Stödda format inkluderar XLSX, XLS, ODS, CSV, etc. Ja
text Sträng Query Den text som ska läggas till i de angivna cellerna i kalkylbladet. Ja
position Sträng Query Anger var texten ska infogas i förhållande till befintligt cellinnehåll. Alternativ: AtTheBeginning, AtTheEnd, BeforeText, AfterText, None. Ja
selectText Sträng Query (Valfritt) Om angiven läggs texten till endast i celler som innehåller exakt denna delsträng. Används tillsammans med parametern position. Nej
skipEmptyCells Boolean Query Om true hoppas tomma celler över; om false läggs text till i tomma celler. Nej
worksheet Sträng Query (Valfritt) Namnet på det kalkylblad där texten kommer läggas till. Om utelämnas tillämpas operationen på första kalkylbladet som standard. Nej
range Sträng Query (Valfritt) Cellintervallet där texten kommer läggas till (t.ex. "A1:C10"). Om utelämnas tillämpas operationen på alla använda celler i angivet kalkylblad. Nej
outPath Sträng Query (Valfritt) Sökvägen till mappen i molnlagringen där den bearbetade arbetsboken sparas. Om utelämnas sparas filen i källmappen. Nej
outStorageName Sträng Query Namnet på molnlagringen där utdatafilen kommer lagras. Nej
region Sträng Query (Valfritt) Anger lokalspråk för formatering av tal, datum och valuta i utdatafilen (t.ex. "sv-SE", "en-US", "zh-CN", "de-DE"). Nej
password Sträng Query (Valfritt) Om den uppladdade kalkylfilen är lösenordsskyddad, ange lösenordet för att öppna och bearbeta filen. Nej

cURL-exempel

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

Svar

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

Felkoder

Kod Beskrivning
400 Bad Request Ogiltig URI för Aspose.Cells Cloud API eller saknar nödvändiga parametrar.
401 Unauthorized Ogiltig access token eller ogiltigt klient-ID och hemlighet.
404 Not Found Kalkylbladsfilen är inte tillgänglig.
500 Server Error Kalkylbladet stötte på ett problem vid hämtning av beräkningsdata.

Var bör vi använda API:et för att lägga till text i kalkylblad?

  • Dynamisk rapportetikettering: Lägg till dynamiska titlar, datumtaggar eller anteckningar i automatiskt genererade finansrapporter och försäljningsrapporter.
  • Bulk-filvattenstämplning: Lägg till företagslogotyper, sekretessvattenstämplar eller versionsinformation i en batch Excel-filer.
  • Malldatautfyllnad: Fyll automatiskt i kundnamn, belopp och annan text på fördefinierade positioner i kontrakt- eller fakturamallar.
  • Dataklassificeringsetikettering: Lägg automatiskt till klassificeringsetiketter eller statusetiketter (t.ex. “Väntar på granskning”, “Godkänd”) i datarader baserat på analyseresultat.
  • Datakvalitetsanteckningar: Lägg till anteckningar om problematisk data under datarengöring.
  • Bulk-textformatering: Lägg enhetligt till prefix eller suffix till produktnamn eller kundnamn.

Varför bör du använda API:et för att lägga till text i kalkylblad?

  • Bulk-textinfogning: Lägg till text i hundratals celler eller filer samtidigt, vilket sparar upp till 95 % tid jämfört med manuellt arbete.
  • Exakt positionsstyrning: Stöder infogning av text med hög precision på sex positioner, inklusive början, slutet eller före/efter specifik text i en cell.
  • Smart villkorshantering: Bestäm om text ska läggas till beroende på om en cell är tom eller innehåller specifik text.
  • Stöd för flera positioneringsstrategier:
    • AtTheBeginning: Lägg till samma text före innehållet i alla valda celler.
    • AtTheEnd: Lägg till text efter innehållet i alla valda celler.
    • BeforeText / AfterText: Lägg till text endast före eller efter celler som innehåller specifik text.
    • None: Ersätt originalinnehållet.
  • Exakt intervallstyrning: Tillåter specifikation av specifika kalkylblad eller cellintervall för operationer.
  • Villkorsstyrning för att hoppa över: Stöder att hoppa över tomma celler för att undvika onödig textinfogning.
  • Utvecklarvänligt: Aspose.Cells Cloud erbjuder SDK-bibliotek i flera språk, vilket möjliggör snabb utveckling och kommer med omfattande dokumentation. Jämfört med att bygga egna lösningar för diagramrendering minskas utvecklingsarbetet avsevärt.
  • Kostnadseffektivt: Du kan lägga till text i en cell utan att först ladda upp arbetsboken, vilket sparar lagringsutrymme och minskar kostnaderna.

OpenAPI-specifikation

OpenAPI-specifikationen definierar ett offentligt tillgängligt programmeringsgränssnitt och låter dig utföra REST-interaktioner direkt från en webbläsare.

Använd Aspose.Cells Cloud SDK:er

Att använda SDK är det bästa sättet att påskynda utvecklingen. SDK hanterar de underliggande detaljerna så att du enkelt kan implementera Add Text för celler med minimal kod. Se GitHub-förrådet för en komplett lista över Aspose.Cells Cloud SDK:er.

Följande kodexempel illustrerar hur man gör anrop till Aspose.Cells-webbtjänster med diverse SDK:er: