Datos

Agregar validación de datos

func (f *File) AddDataValidation(sheet string, dv *DataValidation)

AddDataValidation proporciona una validación de datos establecida en un rango de la hoja de trabajo por objeto de validación de datos y nombre de la hoja de trabajo. El objeto de validación de datos puede ser creado por la función NewDataValidation. Los operadores y el tipo de validación de datos se pueden encontrar en la sección Constants.

Ejemplo 1, configure la validación de datos en Hoja1!A1:B2 con la configuración de los criterios de validación, Mostrar alerta de error después de ingresar datos no válidos con el estilo "Detener" y el título personalizado "cuerpo de error":

dv := excelize.NewDataValidation(true)
dv.SetSqref("A1:B2")
dv.SetRange(10, 20, excelize.DataValidationTypeWhole, excelize.DataValidationOperatorBetween)
dv.SetError(excelize.DataValidationErrorStyleStop, "error title", "cuerpo de error")
f.AddDataValidation("Hoja1", dv)

Ejemplo 2, configure la validación de datos en Hoja1!A3:B4 con la configuración de los criterios de validación y muestre el mensaje de entrada cuando se seleccione la celda:

dv = excelize.NewDataValidation(true)
dv.SetSqref("A3:B4")
dv.SetRange(10, 20, excelize.DataValidationTypeWhole, excelize.DataValidationOperatorGreaterThan)
dv.SetInput("input title", "input body")
f.AddDataValidation("Hoja1", dv)

Ejemplo 3, configure la validación de datos en Hoja1!A5:B6 con la configuración de los criterios de validación, cree un menú desplegable en la celda permitiendo la fuente de la lista:

dv = excelize.NewDataValidation(true)
dv.SetSqref("A5:B6")
dv.SetDropList([]string{"1", "2", "3"})
f.AddDataValidation("Hoja1", dv)

Si escribe los elementos en el cuadro de diálogo de validación de datos (una lista delimitada), el límite es de 255 caracteres, incluidos los separadores. Si la fórmula de origen de su lista de validación de datos supera el límite de longitud máxima, establezca los valores permitidos en las celdas de la hoja de trabajo y utilice la función SetSqrefDropList para establecer la referencia para sus celdas.

Ejemplo 4, configure la validación de datos en Hoja1!A7:B8 con la fuente de criterios de validación Hoja1!E1:E3, cree un menú desplegable en la celda permitiendo la fuente de la lista:

dv := excelize.NewDataValidation(true)
dv.SetSqref("A7:B8")
dv.SetSqrefDropList("E1:E3")
f.AddDataValidation("Hoja1", dv)

Hay límites en la cantidad de elementos que se mostrarán en una lista desplegable de validación de datos: la lista puede mostrar hasta 32768 elementos de una lista en la hoja de trabajo. Si necesita más elementos, puede crear una lista desplegable dependiente, desglosada por categoría.

Obtener validación de datos

func (f *File) GetDataValidations(sheet string) ([]*DataValidation, error)

GetDataValidations devuelve la lista de validaciones de datos por nombre de hoja de trabajo dado.

Eliminar validación de datos

func (f *File) DeleteDataValidation(sheet string, sqref ...string) error

DeleteDataValidation elimina la validación de datos por el nombre de la hoja de trabajo y la secuencia de referencia. Todas las validaciones de datos en la hoja de trabajo se eliminarán si no se especifica el parámetro de secuencia de referencia.

Agregar rebanadora

SlicerOptions representa la configuración de la segmentación de datos.

type SlicerOptions struct {
    Name            string
    Cell            string
    TableSheet      string
    TableName       string
    Caption         string
    Macro           string
    Width           uint
    Height          uint
    DisplayHeader   *bool
    ItemDesc        bool
    Format          GraphicOptions
    SelectedItems   []string
}

Name especifica el nombre de la segmentación de datos; debe ser un nombre de campo existente de la tabla o tabla dinámica dada; esta configuración es obligatoria.

Cell especifica que la celda superior izquierda coordina la posición para insertar la segmentación; esta configuración es obligatoria.

TableSheet especifica el nombre de la hoja de cálculo de la tabla o tabla dinámica; esta configuración es obligatoria.

TableName especifica el nombre de la tabla o tabla dinámica; esta configuración es obligatoria.

Caption especifica el título de la segmentación de datos; esta configuración es opcional.

Macro se usa para configurar la macro para la segmentación, la extensión del libro de trabajo debe ser XLSM o XLTM.

Width especifica el ancho de la segmentación, esta configuración es opcional.

Height especifica la altura de la segmentación de datos, esta configuración es opcional.

DisplayHeader especifica si se muestra el encabezado de la segmentación de datos, esta configuración es opcional, la configuración predeterminada es visualización.

ItemDesc especifica la clasificación de elementos descendente (Z-A), esta configuración es opcional y la configuración predeterminada es false (representa ascendente).

Format especifica el formato de la segmentación, esta configuración es opcional.

SelectedItems se utiliza para especificar los elementos seleccionados por defecto en un segmentador de datos. Actualmente, solo es compatible con segmentadores de datos en tablas dinámicas. Los elementos seleccionados deben estar dentro del rango de elementos seleccionados en la tabla dinámica. Si la tabla dinámica se crea mediante la función AddPivotTable, también se debe especificar el rango de elementos seleccionados para ese mismo campo al crear la tabla dinámica.

func (f *File) AddSlicer(sheet string, opts *SlicerOptions) error

La función AddSlicer inserta una segmentación de datos proporcionando el nombre de la hoja de trabajo y la configuración de la segmentación. Por ejemplo, inserte una segmentación de datos en Hoja1!E1 con el campo Column1 para la tabla denominada Table1:

err := f.AddSlicer("Hoja1", &excelize.SlicerOptions{
    Name:       "Column1",
    Cell:       "E1",
    TableSheet: "Hoja1",
    TableName:  "Table1",
    Caption:    "Column1",
    Width:      200,
    Height:     200,
})

Conseguir rebanadora

func (f *File) GetSlicers(sheet string) ([]SlicerOptions, error)

GetSlicers proporciona el método para obtener todas las segmentaciones de datos de una hoja de cálculo con un nombre de hoja de cálculo determinado. Tenga en cuenta que, actualmente, esta función no admite la obtención de la altura, el ancho y las opciones gráficas de la forma de la segmentación de datos.

Eliminar rebanadora

func (f *File) DeleteSlicer(name string) error

DeleteSlicer proporciona el método para eliminar una segmentación de datos con un nombre de segmentación de datos determinado.