Skapa och redigera rapporter

Ekonomi, utbildning, marknadsföring och andra branscher använder PDF för att dela data med sina kunder och intressenter. PDF gör det enkelt att dela interaktiva dokument med tabeller, grafik och interaktivt innehåll i ett format som alla kan visa. Adobe Acrobat Services API:er hjälper dessa företag att generera delbara PDF-rapporter från Microsoft Word, Microsoft Excel, grafik och andra olika dokumentformat.

Säg att du driver ett spårningsföretag för sociala medier. Dina kunder loggar in på en lösenordsskyddad del av webbplatsen för att se sina kampanjanalyser. Ofta vill de dela denna statistik med sina chefer, aktieägare, givare eller andra intressenter. Hämtningsbara PDF-dokument är ett bra sätt för dina kunder att dela siffror, diagram med mera.

Genom att använda PDF Services API på din webbplats kan du skapa PDF-rapporter när du är på språng för varje kund. Du kan skapa PDF och sedan kombinera dem till en enda, praktisk rapport som dina kunder kan hämta och skicka vidare till sina intressenter.

Vad du kan lära dig

I den här praktiska självstudiekursen får du lära dig hur du använder PDF Services SDK i en miljö med Node.js och Express.js (med bara vissa JavaScript, HTML och CSS) för att snabbt och enkelt lägga till PDF-orienterad funktionalitet på en befintlig webbplats. På den här webbplatsen finns en sida där administratörer överför rapporter, ett område där kunder visar en lista med tillgängliga rapporter och väljer dokument som ska konverteras till PDF samt användbara slutpunkter för att hämta PDF som genererats av systemet.

Relevanta API:er och resurser

Instrumentpanel för kampanjrapporter för kunder

Här har du ett grundläggande Express.js-webbprogram med ett kundrapporteringsområde och ett administratörsavsnitt. Den här appen kan visa upp rapporter för kampanjer i sociala medier. Den kan t.ex. visa hur många gånger en annons klickas.

Du kan hämta det här projektet från GitHub-databasen.

Låt oss nu utforska hur vi publicerar rapporterna.

Överför rapporter

För att göra det enkelt bör du bara använda den filsystemsbaserade överföringen och bearbetningen här. I Express.js kan du använda modulen fs för att lista alla tillgängliga filer under en katalog.

Aktivera administratören att överföra rapportfiler till servern så att kunderna kan se dem på samma sida. De här filerna kan ha många olika format, t.ex. Microsoft Word, Microsoft Excel, HTML och [andra dataformat]https://opensource.adobe.com/pdftools-sdk-docs/release/latest/howtos.html#create-a-pdf), inklusive grafikfiler. Administratörssidan ser ut så här:

När administratören väljer och överför en fil flyttas den till en offentlig databas där andra har åtkomst till den. Du använder samma databas för att publicera dokument från administratörssidan och visa tillgängliga marknadsföringsrapporter för kunder. Denna kod är:

router.get('/', (req, res) => {
try {
let files = fs.readdirSync('./public/documents/raw') // read the files
res.status(200).render("reports", { page: 'reports', files: files });
} catch (error) {
res.status(500).render("crash", { error: error });
}
});

Den här koden listar alla filer och visar fillistan.

Välja rapporter

På användarsidan har du ett formulär där kunderna kan välja de dokument som de vill inkludera i sin kampanjrapport för sociala medier. För enkelhetens skull kan du på exempelsidan bara visa dokumentnamnet och en kryssruta för att markera dokumentet. Man kan välja en enstaka rapport eller flera rapporter som ska kombineras i ett enda PDF-dokument.

Om du vill ha ett mer avancerat användargränssnitt kan du även visa en förhandsgranskning av rapporten här.

Generera en PDF-rapport

Använd PDF Services SDK för att skapa PDF-rapporter från dina dataindata. Data (som visas i skärmbilderna ovan) kan komma från olika dataformat som Microsoft Word, Microsoft Excel, HTML, grafik, med mera. Börja med att installera npm-paketet för PDF Services SDK.

$ npm install --save @adobe/documentservices-pdftools-node-sdk

Innan du startar måste du ha API-inloggningsuppgifter, gratis från Adobe. Använd ditt Acrobat Services-konto kostnadsfritt i sex månader och betala per användning för bara $0,05 per dokumenttransaktion.

Hämta arkivfilen och extrahera JSON-filen för inloggningsuppgifter och den privata nyckeln. I exempelprojektet placerar du filen i src-katalogen.

Nu när du har ställt in autentiseringsuppgifterna kan du skriva konverteringsaktiviteten PDF. För den här demonstrationen har du två åtgärder som du måste utföra i programmet:

Den övergripande proceduren är densamma för att köra alla operationer. Den enda skillnaden är den tjänst du använder. I följande exempel konverterar du raw-dokumentet till en PDF-fil:

async function createPdf(rawFile, outputPdf) {
try {
// configurations
const credentials = adobe.Credentials
.serviceAccountCredentialsBuilder()
.fromFile("./src/pdftools-api-credentials.json")
.build();
// Capture the credential from app and show create the context
const executionContext = adobe.ExecutionContext.create(credentials),
operation = adobe.CreatePDF.Operation.createNew();
// Pass the content as input (stream)
const input = adobe.FileRef.createFromLocalFile(rawFile);
operation.setInput(input);
// Async create the PDF
let result = await operation.execute(executionContext);
await result.saveAsFile(outputPdf);
} catch (err) {
console.log('Exception encountered while executing operation', err);
}
}

I koden ovan läser du autentiseringsuppgifterna och skapar körningskontexten. SDK för PDF-tjänster kräver körningskontexten för att autentisera dina förfrågningar.

Sedan kör du åtgärden Skapa PDF som konverterar raw-dokumenten till PDF-format. Slutligen använder du parametern outputPdf för att kopiera PDF-rapporten. I kodexemplet hittar du den här koden under filen src/helpers/pdf.js. Senare i den här självstudiekursen importerar du PDF-modulen och anropar den här metoden.

Som visas i föregående avsnitt kan dina kunder gå till följande sida för att välja de rapporter som de vill konvertera till PDF:

När en kund väljer en eller flera av dessa rapporter skapas PDF-filen.

Först ska vi se hur en enda PDF-fil fungerar. När en användare markerar en enskild rapport, behöver du bara konvertera den till PDF och ange hämtningslänken.

try {
console.log(`[INFO] generating the report...`);
await pdf.createPdf(`./public/documents/raw/${reports}`, `./public/documents/processed/output.pdf`);
console.log(`[INFO] sending the report...`);
res.status(200).render("download", { page: 'reports', filename: 'output.pdf' });
} catch(error) {
console.log(`[ERROR] ${JSON.stringify(error)}`);
res.status(500).render("crash", { error: error });
}

Den här koden skapar en rapport och delar hämtnings-URL:en med kunden. Här är webbsidan för utdata:

Och här är resultatet PDF:

Kunder kan välja flera filer för att generera en kombinerad rapport. När kunden markerar mer än ett dokument utför du två åtgärder: i det första skapas en partiell PDF för varje dokument och i det andra kombineras de i en PDF-rapport.

async function combinePdf(pdfs, outputPdf) {
try {
// configurations
const credentials = adobe.Credentials
.serviceAccountCredentialsBuilder()
.fromFile("./src/pdftools-api-credentials.json")
.build();
// Capture the credential from app and show create the context
const executionContext = adobe.ExecutionContext.create(credentials),
operation = adobe.CombineFiles.Operation.createNew();
// Pass the PDF content as input (stream)
for (let pdf of pdfs) {
const source = adobe.FileRef.createFromLocalFile(pdf);
operation.addInput(source);
}
// Async create the PDF
let result = await operation.execute(executionContext);
await result.saveAsFile(outputPdf);
} catch (err) {
console.log('Exception encountered while executing operation', err);
}
}

Den här metoden finns under filen src/helpers/pdf.js och visas som en del av modulexporten.

try {
console.log(`[INFO] creating a batch report...`);
// Create a batch report and send it back
let partials = [];
for (let index in reports) {
const name = `partial-${index}-${reports[index]}`;
await pdf.createPdf(`./public/documents/raw/${reports[index]}`, `./public/documents/processed/${name}`);
partials.push(`./public/documents/processed/${name.replace('docx', 'pdf').replace('xlsx', 'pdf')}`);
}
await pdf.combinePdf(partials, `./public/documents/processed/output.pdf`);
console.log(`[INFO] sending the combined report...`);
res.status(200).render("download", { page: 'reports', filename: 'output.pdf' });
} catch(error) {
console.log(`[ERROR] ${JSON.stringify(error)}`);
res.status(500).render("crash", { error: error });
}

Den här koden genererar en kompilerad rapport för flera inmatningsdokument. Den enda tillagda funktionen är combinePdf-metoden som tar en lista över PDF-filsökvägsnamn och returnerar ett enda PDF för utdata.

Nu kan dina kontrollpanelskunder för sociala medier välja aktuella rapporter från sitt konto och hämta dem som en behändig PDF. På den här instrumentpanelen kan de visa hur ledningen och andra intressenter lyckas med sina kampanjer med data, tabeller och diagram i ett allmänt lättöppnat format.

Nästa steg

Denna praktiska självstudiekurs gick igenom hur man använder PDF Services API för att hjälpa kunder att ladda ner rapporter som är enkla att dela PDF. Du har skapat ett Node.js-program för att visa upp kraften i PDF Services API för rapporterings- och lästjänster för PDF. Programmet visar hur dina kunder kan hämta ett enda rapportdokument eller kombinera och sammanfoga flera dokument till en enda PDF-rapport.

Med hjälp av det här Adobe-baserade programmet kan dina kunder med instrumentpaneler för sociala medier få och dela de rapporter de behöver, utan att behöva oroa sig för om alla mottagare har Microsoft Office eller annan programvara installerad på sin enhet. Du kan använda samma tekniker i ditt eget program till att hjälpa användarna att visa, kombinera och hämta dokument. Eller kolla in Adobe många andra API:er för att lägga till och spåra signaturer och mycket mer.

Kom igång genom att göra anspråk på ditt kostnadsfria Adobe Acrobat Services-konto och skapa sedan engagerande rapporteringsupplevelser för dina anställda och kunder. Utnyttja ditt konto kostnadsfritt i sex månader och sedan betala per användning när dina marknadsföringsinsatser utökas, bara $0,05 per dokumenttransaktion.