Working with Presentations Leave feedback
On this page
Presentation documents are presented by many formats: PPT, PPTX, PPTM, PPS(X/M), POT(X/M) and others, which are supported by GroupDocs.Editor Cloud as a separate format family among all others. Same as for all other family formats, the Presentation family has its own load and saves options. There several steps that usage of GroupDocs.Editor Cloud consists of:
- Upload input document into cloud storage
- Load the document into editable representation in the cloud storage (HTML file and resources)
- Download HTML document (and resources, if needed) from storage
- Edit HTML document at client side
- Upload HTML document back into the storage
- Save the edited document into Spreadsheet format in the storage
- Download saved document
Steps 1, 3, 4, 5 are storage operations, please refer to this Storage Operations) for usage details. Step 4 is a custom edit operation that can be performed with the programming language or 3rd party tools.
Below is a detailed description of steps 2 and 6.
This REST API provides an ability to load the input documents into an editable representation.
HTTP POST ~/load
Swagger UI lets you call this REST API directly from the browser. The following properties of loading Presentation documents may be customized:
| Name | Description | Comment |
|---|---|---|
| FileInfo.FilePath | The file path in the storage | Required property |
| FileInfo.StorageName | Storage name | Could be omitted for default storage |
| FileInfo.VersionId | File version Id | Useful for storages that support file versioning |
| FileInfo.Password | The password to open file | Should be specified only for password-protected documents |
| OutputPath | The full output path | The directory in storage, where editable files will be stored |
| SlideNumber | Allows to specify the slide number, which should be opened for editing | Required |
| ShowHiddenSlides | Specifies whether the hidden slides should be included or not. Default is false |
* First get JSON Web Token
* Please get your Client Id and Client Secret from https://dashboard.groupdocs.cloud/applications. Kindly place Client Id in "client_id" and Client Secret in "client_secret" argument.
curl -v "https://api.groupdocs.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=xxxx&client_secret=xxxx" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
* cURL example to load document
curl -v "https://api.groupdocs.cloud/v1.0/editor/load" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer
<jwt token>"
-d "{
'FileInfo': { 'FilePath': 'Presentation/sample.pptx' },
'OutputPath': 'Output',
'SlideNumber': 0
}"
* Response will contain storage path to resultant documents
{
"resourcesPath": "output\sample.files",
"htmlPath": "output\sample.html"
}
Using an SDK (API client) is the quickest way for a developer to speed up the development. An SDK takes care of a lot of low-level details of making requests and handling responses and lets you focus on writing code specific to your particular project. Check out our GitHub repository for a complete list of GroupDocs.Editor Cloud SDKs along with working examples, to get you started in no time. Please check the article to learn how to add an SDK to your project.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| // For complete examples and data files, please go to https://github.com/groupdocs-editor-cloud/groupdocs-editor-cloud-dotnet-samples | |
| string MyAppKey = ""; // Get AppKey and AppSID from https://dashboard.groupdocs.cloud | |
| string MyAppSid = ""; // Get AppKey and AppSID from https://dashboard.groupdocs.cloud | |
| var configuration = new Configuration(MyAppSid, MyAppKey); | |
| // Create necessary API instances | |
| var editApi = new EditApi(configuration ); | |
| var fileApi = new FileApi(configuration ); | |
| // The document already uploaded into the storage. | |
| // Load it into editable state | |
| var loadOptions = new PresentationLoadOptions | |
| { | |
| FileInfo = new FileInfo | |
| { | |
| FilePath = "Presentation/with-notes.pptx" | |
| }, | |
| OutputPath = "output", | |
| SlideNumber = 0 | |
| }; | |
| var loadResult = editApi.Load(new LoadRequest(loadOptions)); | |
| // Download html document | |
| var stream = fileApi.DownloadFile(new DownloadFileRequest(loadResult.HtmlPath)); | |
| var htmlString = new StreamReader(stream, Encoding.UTF8).ReadToEnd(); | |
| // Edit something... | |
| htmlString = htmlString.Replace("Slide sub-heading", "Hello world!"); | |
| // Upload html back to storage | |
| fileApi.UploadFile(new UploadFileRequest(loadResult.HtmlPath, | |
| new MemoryStream(Encoding.UTF8.GetBytes(htmlString)))); | |
| // Save html back to pptx | |
| var saveOptions = new PresentationSaveOptions | |
| { | |
| FileInfo = loadOptions.FileInfo, | |
| OutputPath = "output/edited.pptx", | |
| HtmlPath = loadResult.HtmlPath, | |
| ResourcesPath = loadResult.ResourcesPath | |
| }; | |
| var saveResult = editApi.Save(new SaveRequest(saveOptions)); |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| // For complete examples and data files, please go to https://github.com/groupdocs-editor-cloud/groupdocs-editor-cloud-java-samples | |
| String MyAppKey = ""; // Get AppKey and AppSID from https://dashboard.groupdocs.cloud | |
| String MyAppSid = ""; // Get AppKey and AppSID from https://dashboard.groupdocs.cloud | |
| Configuration configuration = new Configuration(MyAppSid, MyAppKey); | |
| // Create necessary API instances | |
| EditApi editApi = new EditApi(configuration); | |
| FileApi fileApi = new FileApi(configuration); | |
| // The document already uploaded into the storage. | |
| // Load it into editable state | |
| FileInfo fileInfo = new FileInfo(); | |
| fileInfo.setFilePath("Presentation/with-notes.pptx"); | |
| PresentationLoadOptions loadOptions = new PresentationLoadOptions(); | |
| loadOptions.setFileInfo(fileInfo); | |
| loadOptions.setOutputPath("output"); | |
| loadOptions.setSlideNumber(0); | |
| LoadResult loadResult = editApi.load(new LoadRequest(loadOptions)); | |
| // Download html document | |
| File file = fileApi.downloadFile(new DownloadFileRequest(loadResult.getHtmlPath(), null, null)); | |
| // Edit something... | |
| List<String> lines = Files.readAllLines(file.toPath()); | |
| List<String> newLines = new ArrayList<String>(); | |
| for (String line : lines) { | |
| newLines.add(line.replaceAll("Slide sub-heading", "Hello world!")); | |
| } | |
| Files.write(file.toPath(), newLines); | |
| // Upload html back to storage | |
| fileApi.uploadFile(new UploadFileRequest(loadResult.getHtmlPath(), file, Common.MYStorage)); | |
| // Save html back to pptx | |
| PresentationSaveOptions saveOptions = new PresentationSaveOptions(); | |
| saveOptions.setFileInfo(fileInfo); | |
| saveOptions.setOutputPath("output/edited.pptx"); | |
| saveOptions.setHtmlPath(loadResult.getHtmlPath()); | |
| saveOptions.setResourcesPath(loadResult.getResourcesPath()); | |
| DocumentResult saveResult = editApi.save(new SaveRequest(saveOptions)); | |
| System.out.println("Document edited: " + saveResult.getPath()); |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| // For complete examples and data files, please go to https://github.com/groupdocs-editor-cloud/groupdocs-editor-cloud-php-samples | |
| use GroupDocs\Editor\Model; | |
| use GroupDocs\Editor\Model\Requests; | |
| $AppSid = ""; // Get AppKey and AppSID from https://dashboard.groupdocs.cloud | |
| $AppKey = ""; // Get AppKey and AppSID from https://dashboard.groupdocs.cloud | |
| $configuration = new GroupDocs\Editor\Configuration(); | |
| $configuration->setAppSid($AppSid); | |
| $configuration->setAppKey($AppKey); | |
| $editApi = new GroupDocs\Editor\EditApi($configuration); | |
| $fileApi = new GroupDocs\Editor\FileApi($configuration); | |
| // The document already uploaded into the storage | |
| // Load it into editable state | |
| $fileInfo = new Model\FileInfo(); | |
| $fileInfo->setFilePath("Presentation/with-notes.pptx"); | |
| $loadOptions = new Model\PresentationLoadOptions(); | |
| $loadOptions->setFileInfo($fileInfo); | |
| $loadOptions->setOutputPath("output"); | |
| $loadOptions->setSlideNumber(0); | |
| $loadResult = $editApi->load(new Requests\loadRequest($loadOptions)); | |
| // Download html document | |
| $htmlFile = $fileApi->downloadFile(new Requests\downloadFileRequest($loadResult->getHtmlPath())); | |
| $html = file_get_contents($htmlFile->getRealPath()); | |
| // Edit something... | |
| $html = str_replace("Slide sub-heading", "Hello world!", $html); | |
| // Upload html back to storage | |
| file_put_contents($htmlFile->getRealPath(), $html); | |
| $uploadRequest = new Requests\uploadFileRequest($loadResult->getHtmlPath(), $htmlFile->getRealPath()); | |
| $fileApi->uploadFile($uploadRequest); | |
| // Save html back to pptx | |
| $saveOptions = new Model\PresentationSaveOptions(); | |
| $saveOptions->setFileInfo($fileInfo); | |
| $saveOptions->setOutputPath("output/edited.pptx"); | |
| $saveOptions->setHtmlPath($loadResult->getHtmlPath()); | |
| $saveOptions->setResourcesPath($loadResult->getResourcesPath()); | |
| $saveResult = $editApi->save(new Requests\saveRequest($saveOptions)); | |
| // Done. | |
| echo "Document edited: " . $saveResult->getPath(); |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| # For complete examples and data files, please go to https://github.com/groupdocs-editor-cloud/groupdocs-editor-cloud-ruby-samples | |
| require 'groupdocs_editor_cloud' | |
| $app_sid = "XXXX-XXXX-XXXX-XXXX" # Get AppKey and AppSID from https://dashboard.groupdocs.cloud | |
| $app_key = "XXXXXXXXXXXXXXXX" # Get AppKey and AppSID from https://dashboard.groupdocs.cloud | |
| # Create necessary API instances | |
| fileApi = GroupDocsEditorCloud::FileApi.from_keys($app_sid, $app_key) | |
| editApi = GroupDocsEditorCloud::EditApi.from_keys($app_sid, $app_key) | |
| # The document already uploaded into the storage. | |
| # Load it into editable state | |
| fileInfo = GroupDocsEditorCloud::FileInfo.new | |
| fileInfo.file_path = 'Presentation/with-notes.pptx' | |
| loadOptions = GroupDocsEditorCloud::PresentationLoadOptions.new | |
| loadOptions.file_info = fileInfo | |
| loadOptions.output_path = "output" | |
| loadOptions.slide_number = 0 | |
| loadRequest = GroupDocsEditorCloud::LoadRequest.new(loadOptions) | |
| loadResult = editApi.load(loadRequest) | |
| # Download html document | |
| htmlFile = fileApi.download_file(GroupDocsEditorCloud::DownloadFileRequest.new loadResult.html_path) | |
| htmlFile.open | |
| html = htmlFile.read | |
| htmlFile.close | |
| # Edit something... | |
| html = html.gsub("Slide sub-heading", "Hello world!") | |
| # Upload html back to storage | |
| htmlFile = File.open(htmlFile.path, "w") | |
| htmlFile.write(html) | |
| htmlFile.close | |
| uploadRequest = GroupDocsEditorCloud::UploadFileRequest.new loadResult.html_path, File.open(htmlFile.path, "r") | |
| fileApi.upload_file(uploadRequest) | |
| # Save html back to pptx | |
| saveOptions = GroupDocsEditorCloud::PresentationSaveOptions.new | |
| saveOptions.file_info = fileInfo | |
| saveOptions.output_path = "output/edited.pptx" | |
| saveOptions.html_path = loadResult.html_path | |
| saveOptions.resources_path = loadResult.resources_path | |
| saveRequest = GroupDocsEditorCloud::SaveRequest.new(saveOptions) | |
| saveResult = editApi.save(saveRequest) | |
| puts("Document edited: " + saveResult.path) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| // For complete examples and data files, please go to https://github.com/groupdocs-editor-cloud/groupdocs-editor-cloud-node-samples | |
| global.editor_cloud = require("groupdocs-editor-cloud"); | |
| global.appSid = "XXXX-XXXX-XXXX-XXXX"; // Get AppKey and AppSID from https://dashboard.groupdocs.cloud | |
| global.appKey = "XXXXXXXXXXXXXXXX"; // Get AppKey and AppSID from https://dashboard.groupdocs.cloud | |
| global.editApi = editor_cloud.EditApi.fromKeys(appSid, appKey); | |
| global.fileApi = editor_cloud.FileApi.fromKeys(appSid, appKey); | |
| // The document already uploaded into the storage. | |
| // Load it into editable state | |
| let fileInfo = new editor_cloud.FileInfo(); | |
| fileInfo.filePath = "Presentation/with-notes.pptx"; | |
| let loadOptions = new editor_cloud.PresentationLoadOptions(); | |
| loadOptions.fileInfo = fileInfo; | |
| loadOptions.outputPath = "output"; | |
| let loadResult = await editApi.load(new editor_cloud.LoadRequest(loadOptions)); | |
| // Download html document | |
| let buf = await fileApi.downloadFile(new editor_cloud.DownloadFileRequest(loadResult.htmlPath)); | |
| let htmlString = buf.toString("utf-8"); | |
| // Edit something... | |
| htmlString = htmlString.replace("Slide sub-heading", "Hello world!"); | |
| // Upload html back to storage | |
| await fileApi.uploadFile(new editor_cloud.UploadFileRequest(loadResult.htmlPath, new Buffer(htmlString, "utf-8"))); | |
| // Save html back to docx | |
| let saveOptions = new editor_cloud.PresentationSaveOptions(); | |
| saveOptions.fileInfo = fileInfo; | |
| saveOptions.outputPath = "output/edited.pptx"; | |
| saveOptions.htmlPath = loadResult.htmlPath; | |
| saveOptions.resourcesPath = loadResult.resourcesPath; | |
| let saveResult = await editApi.save(new editor_cloud.SaveRequest(saveOptions)); | |
| // Done. | |
| console.log("Document edited: " + saveResult.path); |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| # For complete examples and data files, please go to https://github.com/groupdocs-editor-cloud/groupdocs-editor-cloud-python-samples | |
| import groupdocs_editor_cloud | |
| app_sid = "XXXX-XXXX-XXXX-XXXX" # Get AppKey and AppSID from https://dashboard.groupdocs.cloud | |
| app_key = "XXXXXXXXXXXXXXXX" # Get AppKey and AppSID from https://dashboard.groupdocs.cloud | |
| editApi = groupdocs_editor_cloud.EditApi.from_keys(app_sid, app_key) | |
| fileApi = groupdocs_editor_cloud.FileApi.from_keys(app_sid, app_key) | |
| # The document already uploaded into the storage. | |
| # Load it into editable state | |
| fileInfo = groupdocs_editor_cloud.FileInfo("Presentation/with-notes.pptx") | |
| loadOptions = groupdocs_editor_cloud.PresentationLoadOptions() | |
| loadOptions.file_info = fileInfo | |
| loadOptions.output_path = "output" | |
| loadOptions.slide_number = 0 | |
| loadResult = editApi.load(groupdocs_editor_cloud.LoadRequest(loadOptions)) | |
| # Download html document | |
| htmlFile = fileApi.download_file(groupdocs_editor_cloud.DownloadFileRequest(loadResult.html_path)) | |
| html = "" | |
| with open(htmlFile, 'r') as file: | |
| html = file.read() | |
| # Edit something... | |
| html = html.replace("Slide sub-heading", "Hello world!") | |
| # Upload html back to storage | |
| with open(htmlFile, 'w') as file: | |
| file.write(html) | |
| fileApi.upload_file(groupdocs_editor_cloud.UploadFileRequest(loadResult.html_path, htmlFile)) | |
| # Save html back to pptx | |
| saveOptions = groupdocs_editor_cloud.PresentationSaveOptions() | |
| saveOptions.file_info = fileInfo | |
| saveOptions.output_path = "output/edited.pptx" | |
| saveOptions.html_path = loadResult.html_path | |
| saveOptions.resources_path = loadResult.resources_path | |
| saveResult = editApi.save(groupdocs_editor_cloud.SaveRequest(saveOptions)) | |
| # Done | |
| print("Document edited: " + saveResult.path) |
Was this page helpful?
Any additional feedback you'd like to share with us?
Please tell us how we can improve this page.
Thank you for your feedback!
We value your opinion. Your feedback will help us improve our documentation.
