إضافة الخلفية في Workboo

يشير هذا REST API إلى إضافة background إلى مصنف Excel.

معلمة الاستعلام

اسم المعلمة	يكتب	وصف
picPath	خيط	موضع الصورة.
مجلد	خيط	مجلد المصنف الأصلي.
اسم التخزين	خيط	اسم التخزين.

معلمة نص الطلب

اسم المعلمة	يكتب	وصف
ملف البيانات	ملف البيانات	يتم حفظ ملف البيانات في نص الطلب.

الباقي API

API	يكتب	وصف	رابط المورد
/الخلايا/{الاسم}/الخلفية	يضع	إضافة الخلفية في ملف Excel	وضع خلفية المصنف

المواصفات OpenAPI يحدد واجهة برمجة يمكن الوصول إليها بشكل عام ويسمح لك بتنفيذ تفاعلات REST مباشرة من متصفح الويب.

يمكنك استخدامcURL أداة سطر أوامر للوصول بسهولة إلى خدمات الويب Aspose.Cells. يوضح المثال التالي كيفية إجراء مكالمات إلى Cloud API باستخدام cURL.

Request


curl -X PUT "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/background?picPath=DotnetFiles%2FWaterMark.png&folder=DotnetFiles" -H "accept: multipart/form-data" -H "Content-Type: multipart/form-data" -H "x-aspose-client: Containerize.Swagger"

Response


{

 "Code": 200,

  "Status": "OK"

}

عائلة SDK السحابية

يُعد استخدام حزمة تطوير برمجيات (SDK) أفضل طريقة لتسريع عملية التطوير. فهي تُعنى بالتفاصيل البسيطة وتُتيح لك التركيز على مهام مشروعك. يُرجى الاطلاع علىمستودع GitHub للحصول على قائمة كاملة بـ Aspose.Cells Cloud SDKs.

توضح أمثلة التعليمات البرمجية التالية كيفية إجراء مكالمات إلى خدمات الويب Aspose.Cells باستخدام مجموعات أدوات تطوير البرامج المختلفة:

	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;

	string CellsCloudClientId ="....";//get from https://dashboard.aspose.cloud/#/applications
	string CellsCloudClientSecret="...";//get from https://dashboard.aspose.cloud/#/applications
	string remoteFolder = "TestData/In";

	string localName = "Book1.xlsx";
	string waterMarkPNG = "WaterMark.png";
	string remoteName = "Book1.xlsx";


	this.UploadFile( waterMarkPNG, remoteFolder + "/WaterMark.png", "");

	var request = new PutWorkbookBackgroundRequest(
	name: remoteName,
	picPath: remoteFolder + "/WaterMark.png",
	folder: remoteFolder,
	storageName: ""
	);
	cellsApi.PutWorkbookBackground(request);

view raw ExamplePutWorkbookBackground.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 waterMarkPNG = "WaterMark.png";
	String remoteName = "Book1.xlsx";

	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);
	UploadFileRequest uploadFileRequest = new UploadFileRequest();
	uploadFileRequest.setPath( remoteFolder + "/WaterMark.png" );
	uploadFileRequest.setStorageName( "");
	HashMap<String,File> files = new HashMap<String,File>();
	files.put( waterMarkPNG , new File(waterMarkPNG ));
	uploadFileRequest.setUploadFiles(files);
	api.uploadFile(uploadFileRequest);

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

	request.setPicPath(remoteFolder + "/WaterMark.png");

	request.setFolder(remoteFolder);

	request.setStorageName("");

	this.api.putWorkbookBackground(request);

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

view raw Example_PutWorkbookBackground.java hosted with ❤ by GitHub

PHP

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

	$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";
	$waterMarkPNG = "WaterMark.png";
	$remoteName = "Book1.xlsx";


	CellsApiTestBase::ready( $this->instance,$waterMarkPNG ,$remoteFolder . "/WaterMark.png" , "");

	$request = new PutWorkbookBackgroundRequest();
	$request->setName( $remoteName);
	$request->setPicPath( $remoteFolder . "/WaterMark.png");
	$request->setFolder( $remoteFolder);
	$request->setStorageName( "");
	$cellsApi->putWorkbookBackground($request);

view raw Example_PutWorkbookBackground.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'
	water_mark_png = 'WaterMark.png'
	remote_name = 'Book1.xlsx'


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

	uploadrequest = AsposeCellsCloud::UploadFileRequest.new( { :UploadFiles=>mapFiles,:path=>remote_folder })
	@instance.upload_file(uploadrequest)
	request = AsposeCellsCloud::PutWorkbookBackgroundRequest.new(:name=>remote_name,:picPath=>remote_folder + '/WaterMark.png',:folder=>remote_folder,:storageName=>'');
	@instance.put_workbook_background(request);

view raw Example_PutWorkbookBackground.rb hosted with ❤ by GitHub

Node.js

	import { CellsApi, PutWorkbookBackgroundRequest,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"
	var waterMarkPNG = "WaterMark.png"

	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 waterMarkPNGRequest = new UploadFileRequest();
	waterMarkPNGRequest.uploadFiles ={waterMarkPNG:fs.createReadStream(localPath + waterMarkPNG)};
	waterMarkPNGRequest.path = remoteFolder + "/"+waterMarkPNG ;
	waterMarkPNGRequest.storageName ="";
	cellsApi.uploadFile(waterMarkPNGRequest );


	var request = new PutWorkbookBackgroundRequest();
	request.name = remoteName;
	request.picPath = remoteFolder + "/"waterMarkPNG;
	request.folder = remoteFolder;
	request.storageName = "";
	return cellsApi.putWorkbookBackground(request)



	});
	});

view raw Example_PutWorkbookBackground.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 = PutWorkbookBackgroundRequest( 'Book1.xlsx',pic_path= 'PythonTest' + '/WaterMark.png',folder= 'PythonTest',storage_name= '')
	api.put_workbook_background(request)

view raw Example_PutWorkbookBackground.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 $waterMarkPNG = 'WaterMark.png';
	my $remoteName = 'Book1.xlsx';

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

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


	my $request = AsposeCellsCloud::Request::PutWorkbookBackgroundRequest->new();
	$request->{name} = $remoteName;
	$request->{pic_path} = $remoteFolder . '/WaterMark.png';
	$request->{folder} = $remoteFolder;
	$request->{storage_name} = '';
	$instance->put_workbook_background(request=> $request);

view raw Example_PutWorkbookBackground.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"
	waterMarkPNG := "WaterMark.png"
	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)
	waterMarkPNGRequest := new(UploadFileRequest)
	waterMarkPNGRequest.UploadFiles = make(map[string]string)
	waterMarkPNGRequest.UploadFiles[waterMarkPNG] = waterMarkPNG
	waterMarkPNGRequest.Path = remoteFolder + "/WaterMark.png"
	waterMarkPNGRequest.StorageName = ""
	instance.UploadFile(waterMarkPNGRequest)

	request := new(PutWorkbookBackgroundRequest)
	request.Name = remoteName
	request.PicPath = remoteFolder + "/WaterMark.png"
	request.Folder = remoteFolder
	request.StorageName = ""
	_, httpResponse, err := instance.PutWorkbookBackground(request)
	if err != nil {
	println(err.Error())
	} else if httpResponse.StatusCode < 200 \|\| httpResponse.StatusCode > 299 {
	println("Fail")
	}
	}

view raw Example_PutWorkbookBackground.go hosted with ❤ by GitHub

أضف العلامة المائية إلى الملف Excel حذف الخلفية في دفتر العمل Excel