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
    Table         string
    Cell          string
    Caption       string
    Macro         string
    Width         uint
    Height        uint
    DisplayHeader *bool
    ItemDesc      bool
    Format        GraphicOptions
}

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.

Table especifica el nombre de la tabla o tabla dinámica; 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.

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.

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,
})