Convert an Excel File to Different Formats

This REST API indicates to convert an Excel file to a different format. It supports different formats. It can also set page setup and save options before converting.

Request Body Parameter

Parameter Name	Type	Description
ConvertWorkbookOptions	object	Convert Workbook Options.

Response

FileInfo

REST API

API	Type	Description	Swagger Link
/cells/convert	POST	Converts workbook from request content to some format	PostConvertWorkBook

The OpenAPI Specification defines a publicly accessible programming interface and lets you carry out REST interactions directly from a web browser.

You can use cURL command-line tool to access Aspose.Cells web services easily. The following example shows how to make calls to Cloud API with cURL.

Request


curl -X POST "https://api.aspose.cloud/v3.0/cells/convert" 
     -H "accept: multipart/form-data" 
     -H "Content-Type: multipart/form-data" 
     -H "x-aspose-client: curl" 
     -d {}

Response


{
  "Filename": "filename",
  "FileSize": xxxx,
  "FileContent": "File Content: base64_encoded_string"
}

Cloud SDK Family

Using an SDK is the best way to speed up the development. An SDK takes care of low-level details and lets you focus on your project tasks. Please check out the GitHub repository for a complete list of Aspose.Cells Cloud SDKs.

The following code examples demonstrate how to make calls to Aspose.Cells web services using various SDKs:

	namespace Aspose.Cells.Cloud.SDK.Tests.Api.Example
	{
	using Microsoft.VisualStudio.TestTools.UnitTesting;
	using Aspose.Cells.Cloud.SDK.Request;
	using System.Collections.Generic;
	using Aspose.Cells.Cloud.SDK.Api;
	using System;
	using System.IO;

	[TestClass]
	public class CellsApiExample
	{
	string CellsCloudClientId ="....";//get from https://dashboard.aspose.cloud/#/applications
	string CellsCloudClientSecret="...";//get from https://dashboard.aspose.cloud/#/applications
	CellsApi cellsApi = new CellsApi(CellsCloudClientId, CellsCloudClientSecret);

	string localName = "Book1.xlsx";
	string localPath = "D:/TestData/CellsCloud";
	string outputFilePath = "D:/Outpath";
	[TestCategory("Cells")]
	[TestMethod]
	public void Example()
	{
	IDictionary<string, Stream> mapFiles = new Dictionary<string, Stream>();
	mapFiles.Add(localName, File.OpenRead(localPath +"/"+ localName));
	PutConvertWorkbookRequest request = new PutConvertWorkbookRequest { File = mapFiles, format = "pdf" };
	var response = cellsApi.PutConvertWorkbook(request);
	File.WriteAllBytes(outputFilePath, response);
	}


	}
	}

view raw ExamplePutConvertWorkbook.cs hosted with ❤ by GitHub

Java

	package com.aspose.cloud.cells.api;
	import com.aspose.cloud.cells.client.*;
	import com.aspose.cloud.cells.model.*;
	import com.aspose.cloud.cells.request.*;
	import java.io.IOException;
	import org.junit.Test;
	import java.util.ArrayList;
	import java.util.List;
	import java.io.File;
	import java.util.HashMap;

	public class Example {
	private CellsApi api;
	public Example(){
	try {
	String CellsCloudClientId ="....";//get from https://dashboard.aspose.cloud/#/applications
	String CellsCloudClientSecret="...";//get from https://dashboard.aspose.cloud/#/applications

	api = new CellsApi(CellsCloudClientId, CellsCloudClientSecret);
	} catch (ApiException e) {
	e.printStackTrace();
	}
	}
	public void Run(){
	try{

	String localName = "Book1.xlsx";
	String localPath = "D:/TestData/CellsCloud";
	String format = "pdf";
	PutConvertWorkbookRequest request = new PutConvertWorkbookRequest();
	request.setFormat(format);
	HashMap<String,File> fileMap = new HashMap<String,File>();
	fileMap.put(localName ,CellsApiUtil.GetFileHolder(localPath"+"localName) );
	request.setFile(fileMap);
	this.api.putConvertWorkbook(request);

	} catch (ApiException e) {
	e.printStackTrace();
	}catch (IOException e) {
	e.printStackTrace();
	}
	}
	}

view raw Example_PutConvertWorkbook.java hosted with ❤ by GitHub

PHP

	<?php
	require_once('vendor\autoload.php');
	use \Aspose\Cells\Cloud\Api\CellsApi;
	use \Aspose\Cells\Cloud\Request\PutConvertWorkbookRequest;

	$CellsCloudClientId = "...." ; # get from https://dashboard.aspose.cloud/#/applications
	$CellsCloudClientSecret = "...."; # get from https://dashboard.aspose.cloud/#/applications
	$cellsApi = new CellsApi($CellsCloudClientId , $CellsCloudClientSecret );
	$request = new PutConvertWorkbookRequest();
	$request->setFile( 'TestData/Book1.xlsx');
	$request->setFormat("pdf");
	$response = $cellsApi->putConvertWorkbook($request);
	copy($response->getPathname(),"Book1.pdf");

view raw Example_PutConvertWorkbook.php hosted with ❤ by GitHub

Ruby

	require 'openssl'
	require 'bundler'
	require 'aspose_cells_cloud'


	CellsCloudClientId = "...." # get from https://dashboard.aspose.cloud/#/applications
	CellsCloudClientSecret = "...." # get from https://dashboard.aspose.cloud/#/applications
	@instance = AsposeCellsCloud::CellsApi.new(CellsCloudClientId, CellsCloudClientSecret)

	local_name = 'Book1.xlsx'
	format = "pdf"
	mapFiles = { }
	mapFiles[local_name]= ::File.open(File.expand_path("TestData/"+local_name),"r")
	request = AsposeCellsCloud::PutConvertWorkbookRequest.new(:File=>mapFiles,:format=>format);
	@instance.put_convert_workbook(request);

view raw Example_PutConvertWorkbook.rb hosted with ❤ by GitHub

Node.js

	import { CellsApi, PutConvertWorkbookRequest } from "asposecellscloud";
	var fs = require('fs');
	var path = require('path');
	var process = require('process');
	const _ = require('asposecellscloud');

	const CellsCloudClientId ="....";//get from https://dashboard.aspose.cloud/#/applications
	const CellsCloudClientSecret="...";//get from https://dashboard.aspose.cloud/#/applications
	const cellsApi = new CellsApi(CellsCloudClientId, CellsCloudClientSecret);

	var localPath = "TestData/CellsCloud/"
	var localName = "Book1.xlsx"

	describe('example', function(){
	it("should call successfully" , function(){

	var format = "pdf"
	var mapFiles = {};
	mapFiles[localName]= fs.createReadStream(localPath +localName) ;

	var request = new PutConvertWorkbookRequest();
	request.file = mapFiles;
	request.format = format;
	return cellsApi.putConvertWorkbook(request)

	});
	});

view raw Example_PutConvertWorkbook.ts hosted with ❤ by GitHub

Python

	import os
	import shutil
	import sys

	from asposecellscloud.apis.cells_api import CellsApi
	from asposecellscloud.models import *
	from asposecellscloud.requests import *

	CellsCloudClientId ='....' # get from https://dashboard.aspose.cloud/#/applications
	CellsCloudClientSecret='....' # get from https://dashboard.aspose.cloud/#/applications
	api = CellsApi(CellsCloudClientId,CellsCloudClientSecret)

	response = api.put_convert_workbook(PutConvertWorkbookRequest("Book1.xlsx",format= "pdf"))
	shutil.move( response ,"Book12.pdf")

view raw Example_PutConvertWorkbook.py hosted with ❤ by GitHub

Perl

	use lib 'lib';
	use strict;
	use warnings;
	use File::Slurp;
	use MIME::Base64;
	use AsposeCellsCloud::CellsApi;

	my $CellsCloudClientId = "...."; # get from https://dashboard.aspose.cloud/#/applications
	my $CellsCloudClientSecret = "...."; # get from https://dashboard.aspose.cloud/#/applications
	my $config = AsposeCellsCloud::Configuration->new( client_id => $CellsCloudClientId , client_secret => $CellsCloudClientSecret );

	my $instance = AsposeCellsCloud::CellsApi->new(AsposeCellsCloud::ApiClient->new( $config));

	my $localName = 'Book1.xlsx';
	my $format = 'pdf';
	my $mapFiles = {};
	$mapFiles->{$localName}= "TestData/".$localName ;
	my $request = AsposeCellsCloud::Request::PutConvertWorkbookRequest->new();
	$request->{file} = $mapFiles;
	$request->{format} = $format;
	$instance->put_convert_workbook(request=> $request);

view raw Example_PutConvertWorkbook.pl hosted with ❤ by GitHub

	package main

	import (
	"os"

	. "github.com/aspose-cells-cloud/aspose-cells-cloud-go/v25"
	)

	func main() {
	println("Hello Aspose.Cells Cloud!")
	CellsCloudClientId := "...." // get from https://dashboard.aspose.cloud/#/applications
	CellsCloudClientSecret := "...." // get from https://dashboard.aspose.cloud/#/applications
	instance := NewCellsApiService(CellsCloudClientId, CellsCloudClientSecret)
	request := PutConvertWorkbookRequest{File: map[string]string{"Book1.xlsx": "TestData/Book1.xlsx"}, Format: "pdf"}
	data, _, err := instance.PutConvertWorkbook(&request)
	if err == nil {
	file, _ := os.OpenFile("Book1.pdf", os.O_WRONLY\|os.O_CREATE\|os.O_APPEND, 0644)
	file.Write(data)
	defer file.Close()
	}
	}

view raw Example_PutConvertWorkbook.go hosted with ❤ by GitHub

SaveAs Excel