SaveAs Excel

This REST API indicates to save excel file as different format file.

Path Parameter

Parameter Name	Type	Description
name	string	The file name.

Query Parameter

Parameter Name	Type	Description
newfilename	string	new file name
isAutoFitRows	string	Auto-fits all rows in this workbook. The default value is false.
isAutoFitColumns	string	Auto-fits the columns width in this workbook. The default value is false.
folder	string	Original workbook folder.
storageName	string	The storage name where the file is situated.
outStorageName	string	The storage name where the saved file is situated.
checkExcelRestriction	bool	Whether check restriction of excel file when user modify cells related objects.
region	string	The regional settings for workbook.
pageWideFitOnPerSheet	bool	The page wide fit on worksheet.
pageTallFitOnPerSheet	bool	The page tall fit on worksheet.
sheetName	string	Convert the specified worksheet.
pageIndex	string	Convert the specified page of worksheet, sheetName is required.
onePagePerSheet	bool	When converting to PDF format, one page per sheet.

Request Body Parameter

Parameter Name	Type	Description
SaveOptions	Object	Save option save into the second part of the multipart content.

REST API

API	Type	Description	Resource Link
/cells/{name}/saveAs	POST	Export workbook to Format	PostDocumentSaveAs

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/sampleBook.xlsx/SaveAs?newfilename=sample.pdf&isAutoFitRows=true&isAutoFitColumns=true" -H "accept: multipart/form-data"

Response


{
  "SaveResult": {
    "SourceDocument": {
      "Href": "test.xlsx",
      "Rel": null,
      "Title": null,
      "Type": null
    },
    "DestDocument": {
      "Href": "test.pdf",
      "Rel": null,
      "Title": null,
      "Type": null
    },
    "AdditionalItems": []
  },
  "Code": 200,
  "Status": "OK"
}

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
	private readonly string remoteFolder = "TestData/In";
	string localName = "Book1.xlsx";
	string remoteName = "remote_book1.xlsx";
	string localPath = "D:/TestData/CellsCloud";
	[TestCategory("Cells")]
	[TestMethod]
	public void Example()
	{


	UploadFileRequest uploadFileRequest = new UploadFileRequest();
	FileInfo fileInfo = new FileInfo(localPath + "/" + localName);
	uploadFileRequest.path = remoteFolder + "/" + remoteName;
	uploadFileRequest.storageName = "";
	uploadFileRequest.UploadFiles = new Dictionary<string, Stream>() { { localName, File.OpenRead(localPath +"/"+ localName) } };
	cellsApi.UploadFile(uploadFileRequest);



	var saveOptions = new PdfSaveOptions()
	{
	SaveFormat = format
	};
	var request = new PostWorkbookSaveAsRequest(
	name: remoteName,
	newfilename: newfilename,
	saveOptions: saveOptions,
	folder: remoteFolder
	);
	cellsApi.PostWorkbookSaveAs(request);






	}


	}
	}

view raw ExamplePostWorkbookSaveAs.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 {
	api = new CellsApi(
	System.getenv("CellsCloudClientId"),
	System.getenv("CellsCloudClientSecret"),
	"v3.0",
	System.getenv("CellsCloudApiBaseUrl")
	);
	} catch (ApiException e) {
	e.printStackTrace();
	}
	}
	public void Run(){
	try{
	String remoteFolder = "TestData/In";

	String localName = "Book1.xlsx";
	String remoteName = "Book1.xlsx";

	String format = "csv";
	String newfilename = "OutResult/PostExcelSaveAs.csv";

	UploadFileRequest uploadFileRequest = new UploadFileRequest();
	uploadFileRequest.setPath( remoteFolder + "/" + remoteName );
	uploadFileRequest.setStorageName( "");
	HashMap<String,File> files = new HashMap<String,File>();
	files.put( localName , new File(localName ));
	uploadFileRequest.setUploadFiles(files);
	api.uploadFile(uploadFileRequest);

	PostWorkbookSaveAsRequest request = new PostWorkbookSaveAsRequest();
	request.setName(remoteName);

	request.setNewfilename(newfilename);

	PdfSaveOptions saveOptions = new PdfSaveOptions();
	saveOptions.setSaveFormat(format);

	request.setSaveOptions(saveOptions);

	request.setFolder(remoteFolder);

	this.api.postWorkbookSaveAs(request);

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

view raw Example_PostWorkbookSaveAs.java hosted with ❤ by GitHub

PHP

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

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

	$remoteFolder = "TestData/In";

	$localName = "Book1.xlsx";
	$remoteName = "Book1.xlsx";

	$format = "csv";
	$newfilename = "outResult/PostExcelSaveAs.csv";

	$saveOptions = new \Aspose\Cells\Cloud\Model\PdfSaveOptions();
	$saveOptions->setSaveFormat($format );


	$request = new PostWorkbookSaveAsRequest();
	$request->setName( $remoteName);
	$request->setNewfilename( $newfilename);
	$request->setSaveOptions( $saveOptions);
	$request->setFolder( $remoteFolder);
	$cellsApi->postWorkbookSaveAs($request);

view raw Example_PostWorkbookSaveAs.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)

	remote_folder = 'TestData/In'

	local_name = 'Book1.xlsx'
	remote_name = 'Book1.xlsx'

	format = "csv"
	newfilename = "OutResult/PostExcelSaveAs.csv"


	mapFiles = { }
	mapFiles[local_name] = ::File.open(File.expand_path("TestData/"+local_name),"r")

	uploadrequest = AsposeCellsCloud::UploadFileRequest.new( { :UploadFiles=>mapFiles,:path=>remote_folder })
	@instance.upload_file(uploadrequest)
	saveOptions = AsposeCellsCloud::PdfSaveOptions.new(:SaveFormat=>format );
	request = AsposeCellsCloud::PostWorkbookSaveAsRequest.new(:name=>remote_name,:newfilename=>newfilename,:saveOptions=>saveOptions,:folder=>remote_folder);
	@instance.post_workbook_save_as(request);

view raw Example_PostWorkbookSaveAs.rb hosted with ❤ by GitHub

Node.js

	import { CellsApi,PdfSaveOptions,PostWorkbookSaveAsRequest,UploadFileRequest } 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 remoteFolder = "TestData/In"
	var localPath = "TestData/CellsCloud/"
	var localName = "Book1.xlsx"
	var remoteName = "Book1.xlsx"


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

	var localNameRequest = new UploadFileRequest();
	localNameRequest.uploadFiles ={localName:fs.createReadStream(localPath + localName)};
	localNameRequest.path = remoteFolder + "/" + remoteName ;
	localNameRequest.storageName ="";
	cellsApi.uploadFile(localNameRequest );

	var format = "csv"
	var newfilename = "OutResult/PostExcelSaveAs.csv"

	var saveOptions = new PdfSaveOptions();
	saveOptions.saveFormat = format ;

	var request = new PostWorkbookSaveAsRequest();
	request.name = remoteName;
	request.newfilename = newfilename;
	request.saveOptions = saveOptions;
	request.folder = remoteFolder;
	return cellsApi.postWorkbookSaveAs(request)

	});
	});

view raw Example_PostWorkbookSaveAs.ts hosted with ❤ by GitHub

Python

	import os
	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)
	request = PostWorkbookSaveAsRequest( 'Book1.xlsx', "Book1.pdf",save_options= None,folder= 'PythonTest')
	api.post_workbook_save_as(request)

view raw Example_PostWorkbookSaveAs.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 $remoteFolder = 'TestData/In';

	my $localName = 'Book1.xlsx';
	my $remoteName = 'Book1.xlsx';

	my $upload_file_request = AsposeCellsCloud::Request::UploadFileRequest->new( 'UploadFiles'=>{ $localName => $localName } ,'path'=>$remoteFolder . '/' . $remoteName );

	my $format = 'csv';
	my $newfilename = 'outResult/PostExcelSaveAs.csv';

	my $save_options = AsposeCellsCloud::Object::PdfSaveOptions->new();
	$save_options->{save_format} = $format ;

	my $request = AsposeCellsCloud::Request::PostWorkbookSaveAsRequest->new();
	$request->{name} = $remoteName;
	$request->{newfilename} = $newfilename;
	$request->{save_options} = $save_options;
	$request->{folder} = $remoteFolder;
	$instance->post_workbook_save_as(request=> $request);

view raw Example_PostWorkbookSaveAs.pl hosted with ❤ by GitHub

	package main

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

	func main() {
	CellsCloudClientId := "...." // get from https://dashboard.aspose.cloud/#/applications
	CellsCloudClientSecret := "...." // get from https://dashboard.aspose.cloud/#/applications
	instance := NewCellsApiService(CellsCloudClientId, CellsCloudClientSecret)
	remoteFolder := "TestData/In"

	localName := "Book1.xlsx"
	remoteName := "Book1.xlsx"

	localNameRequest := new(UploadFileRequest)
	localNameRequest.UploadFiles = make(map[string]string)
	localNameRequest.UploadFiles[localName] = localName
	localNameRequest.Path = remoteFolder + "/" + remoteName
	localNameRequest.StorageName = ""
	instance.UploadFile(localNameRequest)

	format := "csv"
	newfilename := "OutResult/PostExcelSaveAs.csv"

	var saveOptions = new(PdfSaveOptions)
	saveOptions.SaveFormat = format

	request := new(PostWorkbookSaveAsRequest)
	request.Name = remoteName
	request.Newfilename = newfilename
	request.SaveOptions = saveOptions
	request.Folder = remoteFolder
	_, httpResponse, err := instance.PostWorkbookSaveAs(request)
	if err != nil {
	println(err.Error())
	} else if httpResponse.StatusCode < 200 \|\| httpResponse.StatusCode > 299 {
	println("Fail")
	}
	}

view raw Example_PostWorkbookSaveAs.go hosted with ❤ by GitHub

Gets Excel file to other formats Advanced Convert Excel file