Search broken links in remote spreadsheet

Excel API : SearchBrokenLinksInRemoteSpreadsheet

Search broken links in the remoted spreadsheet.

Interface Details

Endpoint

PUT http://api.aspose.cloud/v4.0/cells/{name}/search/broken-links

Function Description

This method searches for broken links within a spreadsheet file stored in remote cloud storage.It scans all sheets and cells to identify hyperlinks that no longer point to valid destinations, such as dead URLs or missing external references.The operation is performed remotely within the cloud environment, without requiring the file to be downloaded to the local machine.Ensure that you have valid cloud storage credentials and proper access permissions to the target file.If the source file cannot be accessed, if it contains unsupported formats, or if an error occurs during the scanning process, an appropriate exception will be thrown.Depending on the implementation, the method may return a list of broken links with details such as sheet name, cell coordinates, and the invalid URL.Users should carefully review the results to update or remove outdated links in the spreadsheet.

The request parameters of searchBrokenLinksInRemoteSpreadsheet API are:

Parameter Name	Type	Path/Query String/HTTPBody	Description
name	String	Path	The name of the workbook file to be search.
worksheet	String	Query	Specify the worksheet for the lookup.
cellArea	String	Query	Specify the cell area for the lookup
folder	String	Query	The folder path where the workbook is stored.
storageName	String	Query	(Optional) The name of the storage if using custom cloud storage. Use default storage if omitted.
regoin	String	Query	The spreadsheet region setting.
password	String	Query	The password for opening spreadsheet file.

Response Description

{
  "Name": "BrokenLinksReponse",
  "Type": "Class",
  "ParentName": "CellsCloudResponse",
  "IsAbstract": false,
  "Properties": [
    {
      "Name": "BrokenLinks",
      "Nullable": true,
      "ReadOnly": false,
      "IsInherit": false,
      "DataType": {
        "Identifier": "Container",
        "Reference": "BrokenLink",
        "ElementDataType": {
          "Identifier": "Class",
          "Reference": "BrokenLink",
          "Name": "class:brokenlink"
        },
        "Name": "container"
      }
    },
    {
      "Name": "Code",
      "Nullable": true,
      "ReadOnly": false,
      "IsInherit": true,
      "DataType": {
        "Identifier": "Integer",
        "Name": "integer"
      }
    },
    {
      "Name": "Status",
      "Nullable": true,
      "ReadOnly": false,
      "IsInherit": true,
      "DataType": {
        "Identifier": "String",
        "Name": "string"
      }
    }
  ]
}

OpenAPI Specification

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

Excel API SDK

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:

	using Aspose.Cells.Cloud.SDK.Api;
	using Aspose.Cells.Cloud.SDK.Model;
	using Aspose.Cells.Cloud.SDK.Request;
	using System;
	using System.IO;
	using System.Collections.Generic;
	using Range = Aspose.Cells.Cloud.SDK.Model.Range;

	public static class Example40_SearchBrokenLinksInRemoteSpreadsheet
	{
	public static void Run()
	{
	CellsApi cellsApi = new CellsApi("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx");
	string remoteFolder = "TestData/In";
	string bookFormulaXlsx = "BookFormula.xlsx";

	var request = new SearchBrokenLinksInRemoteSpreadsheetRequest(
	name: bookFormulaXlsx,
	folder: remoteFolder
	);
	cellsApi.SearchBrokenLinksInRemoteSpreadsheet(request);
	}
	}

view raw Example40_SearchBrokenLinksInRemoteSpreadsheet.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 org.junit.Test;
	import java.util.ArrayList;
	import java.util.List;
	import java.io.File;
	import java.util.HashMap;

	public class ExampleSearchBrokenLinksInRemoteSpreadsheet {
	private CellsApi api;
	public ExampleSearchBrokenLinksInRemoteSpreadsheet(){
	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 bookFormulaXlsx = "BookFormula.xlsx";

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

	SearchBrokenLinksInRemoteSpreadsheetRequest request = new SearchBrokenLinksInRemoteSpreadsheetRequest();
	request.setName(bookFormulaXlsx);

	request.setFolder(remoteFolder);

	this.api.searchBrokenLinksInRemoteSpreadsheet(request);

	} catch (ApiException e) {
	// TODO Auto-generated catch block
	e.printStackTrace();
	}
	}
	}

view raw Example40_SearchBrokenLinksInRemoteSpreadsheet.java hosted with ❤ by GitHub

PHP

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

	$cellsApi = new CellsApi(getenv("CellsCloudClientId"),getenv("CellsCloudClientSecret"));

	$request = new UploadFileRequest();
	$request->setUploadFiles( "TestData/BookFormula.xlsx");
	$request->setPath( "TestData/BookFormula.xlsx");
	$cellsApi->uploadFile($request);

	$request = new SearchBrokenLinksInRemoteSpreadsheetRequest();
	$request->setName( "BookFormula");
	$request->setFolder( "TestData");
	$cellsApi->searchBrokenLinksInRemoteSpreadsheet($request);

view raw Example40_SearchBrokenLinksInRemoteSpreadsheet.php hosted with ❤ by GitHub

Ruby

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

	@instance = AsposeCellsCloud::CellsApi.new(ENV['CellsCloudClientId'], ENV['CellsCloudClientSecret'],'v3.0',ENV['CellsCloudApiBaseUrl'])

	remote_folder = 'TestData/In'
	book_formula_xlsx = 'BookFormula.xlsx'


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

	uploadrequest = AsposeCellsCloud::UploadFileRequest.new( { :UploadFiles=>mapFiles,:path=>remote_folder })
	@instance.upload_file(uploadrequest)
	request = AsposeCellsCloud::SearchBrokenLinksInRemoteSpreadsheetRequest.new(:name=>book_formula_xlsx,:folder=>remote_folder);
	@instance.search_broken_links_in_remote_spreadsheet(request);

view raw Example40_SearchBrokenLinksInRemoteSpreadsheet.rb hosted with ❤ by GitHub

Node.js

	var fs = require('fs');
	var path = require('path');
	const _ = require('asposecellscloud');

	const cellsApi = new CellsApi(process.env.CellsCloudClientId, process.env.CellsCloudClientSecret,"v3.0",process.env.CellsCloudApiBaseUrl);


	var remoteFolder = "TestData/In"
	var bookFormulaXlsx = "BookFormula.xlsx"

	var bookFormulaXlsxRequest = new model.UploadFileRequest();
	bookFormulaXlsxRequest.uploadFiles ={bookFormulaXlsx:fs.createReadStream(localPath + bookFormulaXlsx)};
	bookFormulaXlsxRequest.path = remoteFolder + "/" + bookFormulaXlsx ;
	bookFormulaXlsxRequest.storageName ="";
	cellsApi.uploadFile(bookFormulaXlsxRequest );


	var request = new model.SearchBrokenLinksInRemoteSpreadsheetRequest();
	request.name = bookFormulaXlsx;
	request.folder = remoteFolder;
	return cellsApi.searchBrokenLinksInRemoteSpreadsheet(request).then((result) => {
	expect(result.response.statusCode).to.equal(200);
	});

view raw Example40_SearchBrokenLinksInRemoteSpreadsheet.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 *

	api = CellsApi(os.getenv('CellsCloudClientId'),os.getenv('CellsCloudClientSecret'),"v3.0",os.getenv('CellsCloudApiBaseUrl'))
	remote_folder = 'TestData/In'
	book_formula_xlsx = 'BookFormula.xlsx'

	request = UploadFileRequest( book_formula_xlsx, remote_folder + '/' + book_formula_xlsx,storage_name= '')
	api.upload_file(request)

	request = SearchBrokenLinksInRemoteSpreadsheetRequest( book_formula_xlsx,folder= remote_folder)
	api.search_broken_links_in_remote_spreadsheet(request)

view raw Example40_SearchBrokenLinksInRemoteSpreadsheet.py hosted with ❤ by GitHub

Perl

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

	my $config = AsposeCellsCloud::Configuration->new( client_id => $ENV{'CellsCloudClientId'}, client_secret => $ENV{'CellsCloudClientSecret'});
	my $instance = AsposeCellsCloud::CellsApi->new(AsposeCellsCloud::ApiClient->new( $config));


	my $remoteFolder = 'TestData/In';
	my $bookFormulaXlsx = 'BookFormula.xlsx';

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


	my $request = AsposeCellsCloud::Request::SearchBrokenLinksInRemoteSpreadsheetRequest->new();
	$request->{name} = $bookFormulaXlsx;
	$request->{folder} = $remoteFolder;
	$instance->search_broken_links_in_remote_spreadsheet(request=> $request);

view raw Example40_SearchBrokenLinksInRemoteSpreadsheet.pl hosted with ❤ by GitHub

	package main

	import (
	"os"

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

	func main() {
	instance := asposecellscloud.NewCellsApiService(os.Getenv("ProductClientId"), os.Getenv("ProductClientSecret"))
	remoteFolder := "TestData/In"
	bookFormulaXlsx := "BookFormula.xlsx"

	bookFormulaXlsxRequest := new(asposecellscloud.UploadFileRequest)
	bookFormulaXlsxRequest.UploadFiles = bookFormulaXlsx
	bookFormulaXlsxRequest.Path = remoteFolder + "/" + bookFormulaXlsx
	bookFormulaXlsxRequest.StorageName = ""
	instance.UploadFile(bookFormulaXlsxRequest)

	request := new(asposecellscloud.SearchBrokenLinksInRemoteSpreadsheetRequest)
	request.Name = bookFormulaXlsx
	request.Folder = remoteFolder
	_, httpResponse, err := instance.SearchBrokenLinksInRemoteSpreadsheet(request)
	if err != nil {
	print(err.Error())
	} else if httpResponse.StatusCode < 200 \|\| httpResponse.StatusCode > 299 {
	print("Fail")
	}
	}

view raw Example40_SearchBrokenLinksInRemoteSpreadsheet.go hosted with ❤ by GitHub