Extraer hojas de trabajo de Excel
PDF4me Extraer hojas de trabajo es un REST punto final que extrae hojas seleccionadas de un Excel y los devuelve como nuevo contenido del libro de trabajo. POST el archivo como Base64 a office/ApiV2Excel/ExcelExtractWorksheet, nombre las hojas o enumere sus índices basados en 0 y guarde el resultado decodificado. No envíe ningún selector y se extraerán todas las hojas de cálculo.
Divide un libro de trabajo por hojas. Envías el archivo completo una vez y describes qué hojas quieres incluir. ExtraerHojaDeCálculoALaAcciónDeExcel: por nombre exacto de pestaña (distingue mayúsculas y minúsculas), por índice basado en cero o ambos a la vez (se toma la unión). Reemplaza la rutina manual de clic derecho, Mover o Copiar para la distribución de informes, divisiones por equipo y cualquier flujo de trabajo donde los destinatarios solo deban ver su propia hoja.
Autenticando su API Pedido
Cada PDF4me REST La llamada debe incluir su API clave en el Authorization Encabezado como autenticación básica. Obtenga o cambie su clave desde el panel de desarrollador.
Punto final
Office/ApiV2Excel/ExtractWorksheetDatos importantes que no debes perderte
nombres de las hojas de cálculo, Índices de la hoja de trabajoo ambas; se extrae cualquier hoja que coincida con cualquiera de las listas. Si se omiten ambas, se extraen TODAS las hojas de cálculo, lo cual rara vez es lo que se desea para una división específica.Office/ApiV2Excel/ en el mismo host, no bajo /api/v2/. El cuerpo también está anidado: un objeto de acción (ExtraerHojaDeCálculoALaAcciónDeExcel) en lugar de campos de raíz planos.HTTP configuración
Método: POST
URL: https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractWorksheet
Tipo de contenido: aplicación/json
Authorization: Básico <tu PDF4me API clave>
La respuesta es JSON: comprobar el success bandera, entonces Base64-decodificar el contenido del libro de trabajo devuelto y guardarlo con un .xlsx extensión.
¿Qué hojas se extraen: nombres o índices?
La selección es declarativa. Nunca se reordenan ni se crean bucles; se describen las hojas de destino una sola vez y el motor las resuelve en función del libro de trabajo.
| Nombres frente a índices | Tú envías | Lo que se extrae |
|---|---|---|
| Solo nombres | "worksheetNames": ["Sheet1", "Summary"] | Hojas cuyo nombre de pestaña coincida exactamente (distingue entre mayúsculas y minúsculas) |
| Solo índices | "worksheetIndexes": [0, 2] | Hojas en esas posiciones basadas en 0 |
| Ambos | nombres + índices | El sindicato: cualquier cosa que coincida con cualquiera de las listas |
| Ni | {} objeto de acción | Cada hoja de trabajo del libro de ejercicios |
API campos corporales
| Parámetro | Requerido | Tipo | Lo que hace | Ejemplo |
|---|---|---|---|---|
document | Required | object | Document reference carrying Name, the source Excel filename with its extension. | { "Name": "data.xlsx" } |
docContent | Required | string | Base64-encoded bytes of the source workbook. | UEsDBBQABgAIAAAA... |
extractWorksheetToExcelAction | Required | object | Action configuration object. Holds the worksheet selectors below; send it even when empty to extract all sheets. | { "worksheetNames": [...] } |
worksheetNames | Conditional | string[] | Inside the action object. Exact, case-sensitive sheet tab names to extract. Combine with indexes for a union. | ["Sheet1", "Summary"] |
worksheetIndexes | Conditional | int[] | Inside the action object. 0-based sheet positions to extract. Combine with names for a union. | [0, 2] |
cultureName | Optional | string | Inside the action object. Culture code applied during processing. | en-US |
Cargas útiles de ejemplo
Extraer dos hojas por nombre
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractWorksheetToExcelAction": {
"worksheetNames": ["Sheet1", "Summary"]
}
}
Extracción por índice basado en 0
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"extractWorksheetToExcelAction": {
"worksheetIndexes": [0, 2]
}
}
Consejos para el cobro de carteros
Ejemplo de curl
curl -X POST https://api.pdf4me.com/office/ApiV2Excel/ExcelExtractWorksheet \
-H "Content-Type: application/json" \
-H "Authorization: Basic YOUR_API_KEY" \
-d '{
"document": { "Name": "data.xlsx" },
"docContent": "'"$(base64 -w 0 data.xlsx)"'",
"extractWorksheetToExcelAction": {
"worksheetNames": ["Summary"]
}
}' \
--output response.json
¿Qué significa el API ¿devolver?
A JSON resultado que describe la extracción y el transporte del nuevo contenido del libro de trabajo como Base64.
| Campo | Tipo | Lo que contiene |
|---|---|---|
document / documents | String (Base64) / Array | The extracted workbook content. A single extraction returns one document; multi-sheet extraction can return an array, so handle both shapes. |
fileName | String | Output filename for the extracted workbook. |
success | Boolean | true when extraction succeeded. Check this before decoding content. |
errorMessage | String | Populated when success is false; explains what went wrong. |
Ejemplos de código
Excel Los puntos finales de la oficina aún no están cubiertos por per-language carpetas de muestra; el repositorio de muestras contiene el patrón de solicitud utilizado por cada PDF4me familia de puntos finales:
Preguntas frecuentes
¿Por qué extraer hojas de cálculo mediante...? API ¿En lugar de hacerlo manualmente?
La ruta manual es Mueva o copie las hojas de trabajo en Excel: haga clic con el botón derecho en la pestaña, Mover o Copiar, marque Crear una copia, guardar como un archivo nuevo, repita por hoja, por libro de trabajo, por ciclo de informes. El API Reemplaza ese bucle con una solicitud determinista por división, que es lo que se desea cuando el libro de trabajo llega según un cronograma y la división alimenta otros sistemas. La salida sigue siendo estándar. Oficina abierta XML libro de trabajo que ExcelLibreOffice y Google Sheets se abren sin problemas.