Document Builder för Ruby

Ruby bibliotek för att skapa mycket anpassade rapporter med REST API

Integrera sömlöst genereringen av olika Word-, PDF- och webbdokument baserade på mallar och datakällor i ditt företags Ruby-programvara.

Automatisera dokumentgenerering i Ruby, skapa utskriftsklara rapporter av alla komplexiteter med Ruby SDK. Denna molnbaserade lösning är byggd kring mallar, datakällor och en kraftfull LINQ-syntax, vilket ger Ruby utvecklare flexibiliteten att passa exakta tekniska och affärsmässiga krav.

Med hjälp av detta Ruby bibliotek kan du programmässigt bygga mycket anpassade rapporter på vilket operativsystem som helst. Riktigt formaterade dokument som kontrakt, beställningar, fakturor, leveransrapporter, försäljningsförslag, inventarier kan sättas ihop i farten som en del av din Ruby programvara.

Effektivisera dokumentgenerering med Ruby

Betydelsen av dokumentautomatisering och rapportgenerering har vuxit enormt under de senaste decennierna. Nästan alla företag har ett behov av att generera dokument och leverera dem till partners eller kunder i tid. Dessutom är det vanligtvis en avgörande faktor för ekonomisk framgång. Att implementera sådana tekniker kan resultera i betydande ekonomiska besparingar genom att minska manuell datainmatning, mänskliga fel, korrekturläsning och pappersarbete. Av dessa skäl är dokumentautomatisering och rapporteringsverktyg en integrerad del av många moderna mjukvarulösningar som syftar till att tillhandahålla avancerade analytiska funktioner till användarna.

Generellt sett är rapportgenerering en process som kombinerar text, data och grafik till en enda enhet och exporterar resultatet i en bekväm visuell form till önskat dokumentformat, såsom DOCX, PDF, ODT, HTML, PPTX, XLSX, etc.

Vad är GroupDocs Assembly for Ruby

GroupDocs Assembly for Ruby är en molnbaserad lösning för att generera dokument med hjälp av mallar och datakällor. Dokumentmallen fungerar som en basram, som förutom standardinnehållet (text, tabeller, diagram, etc.), innehåller speciella platshållarfält för att infoga värden från datakällan. Inte bara individuella värden kan infogas utan även hela datamatriser i form av tabeller och grafer.

Mallen innehåller också programmeringskonstruktioner - regler för dokumentgenerering - som styr dataurval och villkorsbearbetning. Att binda data till en dokumentmall använder LINQ-uttryckssyntax, vilket gör att utvecklare kan bearbeta data på ett generiskt sätt, oavsett vilken typ av datakälla som används. På så sätt ger vår Ruby Cloud SDK dig flexibilitet i innehållsgenerering och en kraftfull uppsättning metoder för databehandling.

Den här produkten stöder även Mail Merge funktionalitet om du vill skapa och skicka partier av personliga brev till kunder. Du behöver bara infoga Mail Merge fält i dokumentmallen och skicka den till Cloud API tillsammans med en datakälla.

Oavsett omfattning och typ av dokumentautomatisering du ska implementera finns det tre steg för att skapa en rapport i Ruby:

  • Skapa en Word-dokumentmall med platshållarfält och regler för dokumentgenerering som reglerar struktur- och innehållsvariationer
  • Skapa en datakälla i XML eller JSON format
  • Skriv några rader Ruby kod för att skicka allt till Document Building API och få tillbaka det sammansatta resultatet

Designa en dokumentmall och använda regler för dokumentgenerering

Att designa mallar är en svår uppgift. Förutom en tydlig förståelse för kraven för slutdokumentet krävs analytiska och programmeringsfärdigheter. En bra malldesign bör spegla kundens syn på en viss fråga. Det mest effektiva tillvägagångssättet är att kombinera tabelldata och grafik i rätt balans, bestämt av affärskrav.

Som nämnts ovan innehåller mallstrukturen vanligtvis några fasta innehållsblock (text, bilder, logotyper etc.) blandat med speciella programmeringskonstruktioner som styr dokumentsammansättningslogik. Dessa dokumentgenereringsregler definieras med en speciell uttryckssyntax, som gör det möjligt för utvecklare att göra följande:

  • bädda in externt dokumentinnehåll, bilder, diagram, listor, tabeller, hyperlänkar, bokmärken, etc.
  • arbeta med data med hjälp av formler och sekventiella dataoperationer
  • ange presentationsformatet för numeriska, text-, grafik-, grafik- och datum- och tidselement
  • infoga innehållsblock beroende på villkorliga uttryck
  • definiera speciella variabler för "dyra" beräkningar som bara beräknas en gång
  • beräkna formler när du sammanställer kalkylbladsdokument
  • tilldela e-postmeddelandetextattribut och skapa bilagor dynamiskt
  • skapa och infoga streckkoder
  • ställ in bakgrundsfärg för HTML dokument

Du kan lära dig mer om mallsyntax i vår utvecklarguide.

Krav

GroupDocs Assembly for Ruby kräver ingen extern programvara eller tredjepartsverktyg för att installeras. Detta är en molnbaserad lösning, där all programmeringsinteraktion utförs över nätverket med hjälp av REST API.

Dokumentformat som stöds

  • Word: DOCX, DOC, DOT, DOTX, DOTM, DOCM, RTF
  • Excel: XLSX, XLS, XLSM, XLSB, XLT, XLTM, XLTX
  • PowerPoint: PPTX, PPT, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM
  • Outlook: MSG, EML, EMLXL
  • OpenOffice: ODT, OTT, ODS, ODP, OTP
  • Adobe Acrobat: PDF
  • Utskrift: PCL, PS, XPS, OXPS
  • Vektorgrafik: SVG, EMF
  • Bitmappsgrafik: PNG, JPEG, GIF, TIFF, BMP
  • Andra filformat: HTML, MHTML, MHT, MD, XAML, EPUB, TXT

För mer information om stödda I/O-format, besök vår dokumentation.

säkerhet

Alla GroupDocs produkter är helt kompatibla med industrisäkerhetsstandarder: dataöverföring utförs med SSL-protokollet, vilket eliminerar möjligheten att information fångas upp av tredje part. För att ansluta till GroupDocs Cloud Services måste du använda personliga åtkomstnycklar. Se snabbstartsguiden.

Skapa ett dokument i Ruby

Följande kodexempel visar hur du genererar rapporter med Ruby.

Skapa ett dokument i Ruby
Inmatningsfiler
Ladda upp en dokumentmall
Utmatningsformat
Välj målformat från listan
require_relative '../lib/groupdocs_assembly_cloud'

GroupDocsAssemblyCloud.configure do |config|
  config.client_data['app_sid'] = '####-####-####-####-####'
  config.client_data['api_key'] = '##################'
end
@assembly_api = AssemblyApi.new
file_name= 'Input1.docx'
data_file= 'Input2.docx'

request_file_content = File.open(file_name)
upload_document_request = UploadFileRequest.new(
    file_content: request_file_content, path: file_name)
@assembly_api.upload_file(upload_document_request)

template_file_info = TemplateFileInfo.new(:FilePath => file_name)
assemble_options = AssembleOptions.new(
    :TemplateFileInfo => template_file_info, 
	    :SaveFormat => "docx", 
		    :ReportData => File.open(data_file, 'rb') { |f| f.read })
request = AssembleDocumentRequest.new assemble_options
@assembly_api.assemble_document request
  
Kopiera koden Ruby till urklipp

Så här genererar du ett dokument med Ruby

  1. Installera 'GroupDocs.Assembly Cloud SDK for Ruby'.
  2. Lägg till en biblioteksreferens (importera biblioteket) till ditt Ruby-projekt.
  3. Skapa ett malldokument, lägg till programmeringskonstruktioner som kontrollerar infogningen av data från datakällan.
  4. Skapa en datakälla.
  5. Ladda upp dokumentmallen till GroupDocs Cloud Storage (du måste logga in på ditt personliga konto).
  6. Skapa ett dokument genom att skicka din mall och data till Cloud API.

Så här installerar du Cloud Report Generator för Ruby

Installera GroupDocs.Assembly Cloud SDK for Ruby med RubyGems värdtjänst. Kör gem install groupdocs_assembly_cloud för att installera paketet. Som ett alternativ kan du manuellt klona GroupDocs.Assembly Cloud SDK for Ruby källkod från GitHub och använda den i ditt projekt. Följ dessa Instructions för att snabbt få nödvändiga säkerhetsuppgifter och få tillgång till vårt REST API.

Systemkrav

Ruby 2.6 eller nyare

Se Repository Documentation för att se detaljerna.

De mest populära formaten för dokumentgenerering

5%

Prenumerera på Aspose produktuppdateringar

Få månatliga nyhetsbrev och erbjudanden direkt levererade till din brevlåda.

© Aspose Pty Ltd 2001-2024. Alla rättigheter förbehållna.