Gestire i commenti della presentazione in Node.js
Panoramica
Questo articolo spiega come gestire i commenti della presentazione con Aspose.Slides per Node.js via Java. Introduce i principali tipi relativi ai commenti e dimostra come aggiungere commenti alle diapositive, accedere ai commenti esistenti, lavorare con le risposte e i commenti moderni, e rimuovere i commenti da una presentazione.
Gli esempi coprono scenari comuni di revisione e collaborazione in PowerPoint, come assegnare commenti agli autori, leggere il testo e i metadati dei commenti, costruire catene di risposte e rimuovere commenti selezionati o tutti i commenti.
In PowerPoint, i commenti appaiono come annotazioni sulle diapositive. Selezionare un commento ne visualizza il testo e la discussione correlata.
Per richiedere che i commenti siano mostrati o nascosti quando una presentazione viene aperta senza modificare i commenti stessi, vedere Show or Hide Comments When Opening a Presentation.
Perché aggiungere commenti alle presentazioni?
Puoi utilizzare i commenti per fornire feedback e collaborare con i colleghi durante la revisione delle presentazioni.
Aspose.Slides per Node.js via Java fornisce le seguenti API per lavorare con i commenti:
- La classe Presentation fornisce l’accesso agli autori dei commenti della presentazione.
- La classe CommentCollection rappresenta i commenti associati a un singolo autore.
- La classe Comment fornisce informazioni su un commento, inclusi autore, data di creazione, posizione e testo.
- La classe CommentAuthor fornisce informazioni su un autore, inclusi nome, iniziali e commenti associati.
Aggiungere commenti alle diapositive
L’esempio crea due diapositive e registra un autore di commenti con addAuthor. Utilizza addComment per inserire un commento su ciascuna diapositiva, quindi recupera i commenti della prima diapositiva per quell’autore con getSlideComments. La console visualizza il testo del primo commento due volte, dimostrando l’accesso sia tramite la diapositiva sia tramite l’autore, e la presentazione salvata contiene entrambi i commenti.
var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");
const presentation = new aspose.slides.Presentation();
try {
const firstSlide = presentation.getSlides().get_Item(0);
const secondSlide = presentation.getSlides().addEmptySlide(presentation.getLayoutSlides().get_Item(0));
const author = presentation.getCommentAuthors().addAuthor("Jawad", "MF");
const position = java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(0.2), java.newFloat(0.2));
const createdTime = java.newInstanceSync("java.util.Date");
author.getComments().addComment("Hello Jawad, this is a slide comment", firstSlide, position, createdTime);
author.getComments().addComment("Hello Jawad, this is the second slide comment", secondSlide, position, createdTime);
const comments = firstSlide.getSlideComments(author);
if (comments.length > 0) {
const firstComment = comments[0];
console.log(firstComment.getText());
const commentText = firstComment.getAuthor().getComments().get_Item(0).getText();
console.log(commentText);
}
presentation.save("Comments_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Trova o crea un autore di commenti
Quando una revisione automatizzata elabora la stessa presentazione più volte, cerca nella raccolta restituita da getCommentAuthors prima di aggiungere un autore. findByNameAndInitials confronta sia il nome sia le iniziali e restituisce un array di autori corrispondenti, o un array vuoto se non vi sono corrispondenze. Al contrario, findByName ricerca solo per nome, indipendentemente dalle iniziali. Chiamare addAuthor con un nome e iniziali già presenti nella raccolta genera un’eccezione.
L’esempio richiede un file di presentazione con almeno una diapositiva. In ciascuna delle due passate, riutilizza il primo autore corrispondente, o ne crea uno solo quando il risultato è vuoto. Se vi sono più corrispondenze, seleziona il primo elemento dell’array senza unire o rimuovere gli altri autori. Quindi chiama addComment per l’autore selezionato e salva la presentazione. La seconda passata apre l’output della prima passata e ripete l’operazione.
var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");
const authorName = "Reviewer";
const authorInitials = "RV";
let inputFile = "input.pptx";
const position = java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(20), java.newFloat(20));
for (let pass = 1; pass <= 2; pass++) {
const presentation = new aspose.slides.Presentation(inputFile);
try {
const matches = presentation.getCommentAuthors().findByNameAndInitials(authorName, authorInitials);
const author = matches.length > 0 ? matches[0] : presentation.getCommentAuthors().addAuthor(authorName, authorInitials);
const createdTime = java.newInstanceSync("java.util.Date");
author.getComments().addComment("Please review this slide.", presentation.getSlides().get_Item(0), position, createdTime);
const outputFile = "review_pass_" + pass + ".pptx";
presentation.save(outputFile, aspose.slides.SaveFormat.Pptx);
inputFile = outputFile;
} finally {
presentation.dispose();
}
}
La seconda passata aggiunge un altro commento senza aggiungere un nuovo autore né rimuovere i commenti esistenti. Il file finale, review_pass_2.pptx, contiene entrambi i nuovi commenti insieme a eventuali commenti originali. Riutilizzare un autore non deduplica i commenti: per evitare di aggiungere più volte lo stesso commento, implementa un rilevamento duplicati separato prima di aggiungerlo.
Accedere ai commenti delle diapositive
L’esempio apre una presentazione esistente e legge la raccolta restituita da getCommentAuthors. Per ciascun autore, itera attraverso la raccolta restituita da getComments e stampa il numero della diapositiva, il testo del commento, il nome dell’autore e la data di creazione. La presentazione di input deve contenere commenti per produrre output nella console.
var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const presentation = new aspose.slides.Presentation("Comments1.pptx");
try {
const authors = presentation.getCommentAuthors();
for (let authorIndex = 0; authorIndex < authors.size(); authorIndex++) {
const author = authors.get_Item(authorIndex);
const comments = author.getComments();
for (let commentIndex = 0; commentIndex < comments.size(); commentIndex++) {
const comment = comments.get_Item(commentIndex);
console.log("Slide: " + comment.getSlide().getSlideNumber());
console.log("Comment: " + comment.getText());
console.log("Author: " + comment.getAuthor().getName());
console.log("Posted at: " + comment.getCreatedTime());
console.log();
}
}
} finally {
presentation.dispose();
}
Rispondere ai commenti
Un commento genitore è il commento originale in cima a una gerarchia di risposte. I metodi Comment.getParentComment e Comment.setParentComment consentono di ottenere o impostare il commento genitore.
L’esempio crea commenti da due autori e utilizza setParentComment per costruire risposte, inclusa una risposta a un’altra risposta. Passare null a getSlideComments recupera i commenti da tutti gli autori; la console rientra ogni voce in base alla profondità nella gerarchia di risposte. L’esempio salva la discussione completa, chiama remove sul primo commento radice e salva una seconda presentazione con quel commento e le sue risposte rimosse.
var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");
const presentation = new aspose.slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
const position = java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(10), java.newFloat(10));
const createdTime = java.newInstanceSync("java.util.Date");
const originalAuthor = presentation.getCommentAuthors().addAuthor("Author_1", "A.A.");
const rootComment = originalAuthor.getComments().addComment("comment 1", slide, position, createdTime);
const reviewer = presentation.getCommentAuthors().addAuthor("Author_2", "B.B.");
const firstReply = reviewer.getComments().addComment("reply 1 for comment 1", slide, position, createdTime);
firstReply.setParentComment(rootComment);
const secondReply = reviewer.getComments().addComment("reply 2 for comment 1", slide, position, createdTime);
secondReply.setParentComment(rootComment);
const subReply = originalAuthor.getComments().addComment("subreply 3 for reply 2", slide, position, createdTime);
subReply.setParentComment(secondReply);
reviewer.getComments().addComment("comment 2", slide, position, createdTime);
const separateComment = reviewer.getComments().addComment("comment 3", slide, position, createdTime);
const separateReply = originalAuthor.getComments().addComment("reply 4 for comment 3", slide, position, createdTime);
separateReply.setParentComment(separateComment);
const comments = slide.getSlideComments(null);
for (let index = 0; index < comments.length; index++) {
let comment = comments[index];
let indentation = "";
while (comment.getParentComment() != null) {
indentation += "\t";
comment = comment.getParentComment();
}
console.log(indentation + comments[index].getAuthor().getName() + ": " + comments[index].getText());
}
presentation.save("parent_comment.pptx", aspose.slides.SaveFormat.Pptx);
rootComment.remove();
presentation.save("remove_comment.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Warning
- Quando il metodo Comment.remove viene usato per eliminare un commento, tutte le risposte a quel commento vengono eliminate.
- Se Comment.setParentComment crea un riferimento circolare, viene sollevata una PptxEditException.
Aggiungere commenti moderni
I commenti moderni possono essere associati alla diapositiva stessa, a una forma specifica o a un intervallo di testo all’interno di un’AutoShape. Il metodo CommentCollection.addModernComment accetta un argomento Shape oltre alla diapositiva e alle coordinate del marcatore del commento.
Quando null viene passato per l’argomento shape, il commento è un commento a livello di diapositiva. Il suo marcatore è posizionato dalle coordinate fornite, ma non è associato a una forma specifica, quindi ModernComment.getShape restituisce null. Quando viene fornita una Shape, il commento è ancorato a quella forma. Le coordinate definiscono comunque la posizione del marcatore del commento sulla diapositiva, mentre l’associazione alla forma può essere recuperata tramite ModernComment.getShape.
Ancorare un commento moderno a una forma
L’esempio chiama addModernComment due volte: una volta con una shape null per un commento a livello di diapositiva e una volta con un rettangolo come ancoraggio. Leggere getShape stampa true per il controllo null del commento a livello di diapositiva e Revenue title per il commento ancorato. Entrambi i commenti vengono salvati con la presentazione.
var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");
const presentation = new aspose.slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
const author = presentation.getCommentAuthors().addAuthor("Reviewer", "RV");
const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 300, 80);
shape.setName("Revenue title");
shape.getTextFrame().setText("Quarterly revenue");
const createdTime = java.newInstanceSync("java.util.Date");
const slideCommentPosition = java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(20), java.newFloat(20));
const shapeCommentPosition = java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(60), java.newFloat(60));
const slideComment = author.getComments().addModernComment("Review the overall slide layout.", slide, null, slideCommentPosition, createdTime);
const shapeComment = author.getComments().addModernComment("Check this title.", slide, shape, shapeCommentPosition, createdTime);
console.log(slideComment.getShape() == null);
console.log(shapeComment.getShape().getName());
presentation.save("modern_comments.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Ancorare commenti a diversi tipi di forma
Qualsiasi oggetto della diapositiva derivato da Shape può essere usato come ancoraggio di forma. Esempi comuni includono AutoShape, PictureFrame, GroupShape, Connector e istanze di GraphicalObject come i grafici.
L’esempio utilizza addModernComment per associare un commento a ciascuno dei cinque tipi di forma: un’AutoShape, un picture frame, un gruppo, un connettore e un grafico. L’immagine è incorporata, quindi non è necessario un file immagine esterno. Ogni commento ha la propria posizione del marcatore e la presentazione salvata conserva tutte e cinque le associazioni di forma.
var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");
const presentation = new aspose.slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
const author = presentation.getCommentAuthors().addAuthor("Reviewer", "RV");
const createdTime = java.newInstanceSync("java.util.Date");
const autoShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 20, 20, 180, 60);
autoShape.getTextFrame().setText("AutoShape");
const autoShapeCommentPosition = java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(30), java.newFloat(30));
author.getComments().addModernComment("Comment on an AutoShape.", slide, autoShape, autoShapeCommentPosition, createdTime);
const imageBase64 = "iVBORw0KGgoAAAANSUhEUgAAAAIAAAACCAIAAAD91JpzAAAAFklEQVR4nGP8//8/AwMDEwMDAwMDAwAkBgMB/DXemwAAAABJRU5ErkJggg==";
const imageData = java.newArray("byte", Array.from(Buffer.from(imageBase64, "base64")));
const image = presentation.getImages().addImage(imageData);
const pictureFrame = slide.getShapes().addPictureFrame(aspose.slides.ShapeType.Rectangle, 220, 20, 120, 80, image);
const pictureCommentPosition = java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(230), java.newFloat(30));
author.getComments().addModernComment("Comment on a picture.", slide, pictureFrame, pictureCommentPosition, createdTime);
const groupShape = slide.getShapes().addGroupShape();
groupShape.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 0, 0, 80, 40);
groupShape.getShapes().addAutoShape(aspose.slides.ShapeType.Ellipse, 100, 0, 80, 40);
const groupCommentPosition = java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(40), java.newFloat(150));
author.getComments().addModernComment("Comment on a group.", slide, groupShape, groupCommentPosition, createdTime);
const connector = slide.getShapes().addConnector(aspose.slides.ShapeType.StraightConnector1, 220, 150, 140, 40);
const connectorCommentPosition = java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(240), java.newFloat(150));
author.getComments().addModernComment("Comment on a connector.", slide, connector, connectorCommentPosition, createdTime);
const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 400, 20, 250, 180);
const chartCommentPosition = java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(420), java.newFloat(40));
author.getComments().addModernComment("Comment on a graphical object.", slide, chart, chartCommentPosition, createdTime);
presentation.save("modern_comment_shape_types.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Ancorare un commento a del testo e impostarne lo stato
Per un commento moderno associato a un'AutoShape, ModernComment.getTextSelectionStart e ModernComment.setTextSelectionStart accedono alla posizione iniziale del testo selezionato nella casella di testo della forma. ModernComment.getTextSelectionLength e ModernComment.setTextSelectionLength accedono alla lunghezza della selezione. Insieme, questi valori associano il commento a un intervallo di testo specifico all’interno dell’AutoShape.
I metodi ModernComment.getStatus e ModernComment.setStatus accedono a un valore dell’enumerazione ModernCommentStatus:
NotDefined— nessuno stato specifico del commento moderno è definito.Active— il commento è attivo.Resolved— il commento è stato risolto.Closed— il commento è chiuso.
L’esempio ancorra un commento moderno alle parole “quarterly revenue” nel testo di un rettangolo. Calcola l’inizio della selezione zero‑based dal testo e lo passa a setTextSelectionStart, quindi utilizza setTextSelectionLength per impostare il numero di caratteri selezionati. Dopo aver chiamato setStatus con Resolved, salva e riapre la presentazione. I quattro controlli nella console dovrebbero stampare tutti true, confermando che l’ancoraggio della forma, l’intervallo di testo e lo stato sono stati preservati.
var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");
const outputFile = "modern_comment_text_anchor.pptx";
const shapeText = "Review the quarterly revenue forecast.";
const selectedText = "quarterly revenue";
const expectedSelectionStart = shapeText.indexOf(selectedText);
const presentation = new aspose.slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 400, 100);
shape.setName("Forecast text");
shape.getTextFrame().setText(shapeText);
const author = presentation.getCommentAuthors().addAuthor("Reviewer", "RV");
const commentPosition = java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(60), java.newFloat(60));
const createdTime = java.newInstanceSync("java.util.Date");
const comment = author.getComments().addModernComment("Verify this forecast wording.", slide, shape, commentPosition, createdTime);
comment.setTextSelectionStart(expectedSelectionStart);
comment.setTextSelectionLength(selectedText.length);
comment.setStatus(java.newByte(aspose.slides.ModernCommentStatus.Resolved));
presentation.save(outputFile, aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
const reopenedPresentation = new aspose.slides.Presentation(outputFile);
try {
const reopenedSlide = reopenedPresentation.getSlides().get_Item(0);
const reopenedComments = reopenedSlide.getSlideComments(null);
for (let index = 0; index < reopenedComments.length; index++) {
const reopenedComment = reopenedComments[index];
if (!java.instanceOf(reopenedComment, "com.aspose.slides.IModernComment")) {
continue;
}
const shapeMatches = reopenedComment.getShape() != null && reopenedComment.getShape().getName() === "Forecast text";
const selectionStartMatches = reopenedComment.getTextSelectionStart() === expectedSelectionStart;
const selectionLengthMatches = reopenedComment.getTextSelectionLength() === selectedText.length;
const statusMatches = reopenedComment.getStatus() === aspose.slides.ModernCommentStatus.Resolved;
console.log("Shape anchor preserved: " + shapeMatches);
console.log("Text selection start preserved: " + selectionStartMatches);
console.log("Text selection length preserved: " + selectionLengthMatches);
console.log("Resolved status preserved: " + statusMatches);
}
} finally {
reopenedPresentation.dispose();
}
Esaminare i commenti moderni esistenti
L’esempio richiede una presentazione esistente contenente commenti moderni e stampa il loro testo, stato e dettagli di ancoraggio. Per esaminarli, verifica quali commenti sono istanze di ModernComment, quindi esamina ModernComment.getShape, ModernComment.getTextSelectionStart, ModernComment.getTextSelectionLength e ModernComment.getStatus. Una shape null indica un commento a livello di diapositiva. Per un ancoraggio a un'AutoShape, i metodi di selezione del testo identificano l’intervallo associato nella casella di testo della forma.
var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");
const presentation = new aspose.slides.Presentation("comments.pptx");
try {
const slides = presentation.getSlides();
for (let slideIndex = 0; slideIndex < slides.size(); slideIndex++) {
const slide = slides.get_Item(slideIndex);
const comments = slide.getSlideComments(null);
for (let commentIndex = 0; commentIndex < comments.length; commentIndex++) {
const comment = comments[commentIndex];
if (!java.instanceOf(comment, "com.aspose.slides.IModernComment")) {
continue;
}
console.log("Slide: " + slide.getSlideNumber());
console.log("Text: " + comment.getText());
console.log("Status: " + comment.getStatus());
const shape = comment.getShape();
if (shape == null) {
console.log("Anchor: slide level");
} else {
console.log("Anchor shape: " + shape.getName());
console.log("Anchor type: " + shape.getClass().getSimpleName());
if (java.instanceOf(shape, "com.aspose.slides.IAutoShape")) {
console.log("Text selection start: " + comment.getTextSelectionStart());
console.log("Text selection length: " + comment.getTextSelectionLength());
}
}
console.log();
}
}
} finally {
presentation.dispose();
}
Rimuovere i commenti
Aspose.Slides per Node.js via Java consente di rimuovere tutti i commenti e i loro autori da una presentazione o di eliminare commenti selezionati mantenendo gli altri. Gli esempi seguenti dimostrano entrambi gli approcci e salvano la presentazione aggiornata.
Rimuovere tutti i commenti e gli autori dei commenti
L’esempio apre una presentazione esistente e chiama CommentCollection.clear per ciascun autore, quindi chiama CommentAuthorCollection.clear per rimuovere gli autori stessi. La presentazione salvata non contiene né commenti né autori di commenti. Usa una presentazione con commenti per osservare la rimozione.
var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const presentation = new aspose.slides.Presentation("example.pptx");
try {
const authors = presentation.getCommentAuthors();
for (let index = 0; index < authors.size(); index++) {
authors.get_Item(index).getComments().clear();
}
authors.clear();
presentation.save("example_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Rimuovere commenti specifici
L’esempio crea due commenti su una diapositiva e utilizza getSlideComments per trovare i commenti di ciascun autore. Raccoglie i commenti il cui testo è uguale a “comment 1” prima di chiamare CommentCollection.remove, evitando modifiche alla raccolta durante la selezione. La presentazione salvata mantiene solo “comment 2”.
var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");
const presentation = new aspose.slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
const author = presentation.getCommentAuthors().addAuthor("Author", "A");
const createdTime = java.newInstanceSync("java.util.Date");
const firstCommentPosition = java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(0.2), java.newFloat(0.2));
const secondCommentPosition = java.newInstanceSync("com.aspose.slides.Point2DFloat", java.newFloat(0.3), java.newFloat(0.2));
author.getComments().addComment("comment 1", slide, firstCommentPosition, createdTime);
author.getComments().addComment("comment 2", slide, secondCommentPosition, createdTime);
const authors = presentation.getCommentAuthors();
for (let authorIndex = 0; authorIndex < authors.size(); authorIndex++) {
const commentAuthor = authors.get_Item(authorIndex);
const commentsToRemove = [];
const comments = slide.getSlideComments(commentAuthor);
for (let commentIndex = 0; commentIndex < comments.length; commentIndex++) {
const comment = comments[commentIndex];
if (comment.getText() === "comment 1") {
commentsToRemove.push(comment);
}
}
for (const comment of commentsToRemove) {
commentAuthor.getComments().remove(comment);
}
}
presentation.save("pres.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
FAQ
Aspose.Slides supporta uno stato risolto per i commenti moderni?
Sì. ModernComment.getStatus e ModernComment.setStatus accedono a un valore di ModernCommentStatus, incluso Resolved. Lo stato è memorizzato nella presentazione e può essere letto nuovamente dopo aver riaperto il file.
Le discussioni a thread (catene di risposte) sono supportate e c’è un limite di nidificazione?
Sì. Ogni commento può fare riferimento al proprio parent comment, abilitando catene di risposte. L’API non definisce un limite specifico di profondità di nidificazione.
In quale sistema di coordinate è definita la posizione del marcatore di un commento sulla diapositiva?
La posizione del marcatore è definita da coordinate a virgola mobile nel sistema di coordinate della diapositiva, consentendo di posizionarlo con precisione sulla diapositiva.