GetFieldSelections() devuelve una cadena con las selecciones actuales de un campo.
Si se seleccionan todos los valores menos uno, se empleará el formato "NOT x,y" o "NOT y" respectivamente. Si selecciona todos los valores y la cuenta de todos ellos es mayor que max_values, el texto ALL se devolverá.
Sintaxis:
GetFieldSelections ( field_name [, value_sep [, max_values [, state_name]]])
Tipo de datos que devuelve: cadena
| Formato | Descripción |
|---|---|
| 'a, b, c' |
Si el número de valores seleccionados es max_values o menos, la cadena devuelta es una lista de los valores seleccionados. Los valores se separan con value_sep como delimitador. |
| 'NOT a, b, c' |
Si el número de valores no seleccionados es max_values o menos, la cadena devuelta es una lista de los valores no seleccionados con NOT como prefijo. Los valores se separan con value_sep como delimitador. |
| 'x of y' |
x = el número de valores seleccionados y = el número total de valores Esto se devuelve cuando max_values < x < ( y - max_values). |
| 'ALL' | Devuelto si se seleccionan todos los valores. |
| '-' | Devuelto si no se selecciona ningún valor. |
| <search string> | Si lo ha seleccionado mediante la búsqueda, se devuelve la cadena de búsqueda. |
Argumentos:
- field_name: El campo que contiene el rango de datos que se han de medir.
- value_sep: Es el separador que se ha de colocar entre valores de campo. Por defecto es ', '.
- max_values: Es el número máximo de valores de campo que se han de listar de manera individual. Cuando se seleccione un número mayor de valores se utilizará el formato 'valores x de y' en su lugar. El valor por defecto es 6.
- state_name: El nombre de un estado alterno que se ha elegido para la visualización específica. Si se utiliza el argumento state_name, solo se tienen en cuenta las selecciones asociadas con el nombre del estado especificado. Para más información, vea Estados Alternos.
Ejemplos
El ejemplo siguiente utiliza el campo First name cargado en un cuadro de lista.
Ejemplo 1: John seleccionado en First name
GetFieldSelections ([First name])
devuelve 'John'
Ejemplo 2: John y Peter seleccionados en First name
GetFieldSelections ([First name])
devuelve 'John,Peter'
Ejemplo 3: John y Peter seleccionados en First name
GetFieldSelections ([First name],'; ')
devuelve 'John; Peter'
Ejemplo 4: John, Sue, Mark seleccionados en First name
GetFieldSelections ([First name],';',2)
devuelve 'NOT Jane;Peter', ya que el valor 2 es el valor del argumento max_values. De lo contrario, el resultado habría sido John; Sue; Mark.
Datos utilizados en el ejemplo:
Names:
LOAD * inline [
"First name"|"Last name"|Initials|"Has cellphone"
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC |No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');
