DataCompositionDetailsProcess.ChooseAction

DataCompositionDetailsProcess

ChooseAction

Disponible desde la versión 8.2.

Sintaxis:

ChooseAction(<DetailsId>, <ChosenAction>, <ChosenActionParameter>, <AvailableAction>, <AdditionalMenuItems>, <UseMainAction>, <FormElement>)

Parámetros:

<DetailsId> (requerido)

Tipo: DataCompositionDetailsID.
El identificador de los detalles procesables.

<ChosenAction> (requerido)

El procesamiento de los detalles devuelve en el parámetro el valor de la acción elegida.

<ChosenActionParameter> (requerido)

El procesamiento de los detalles devuelve en el parámetro el valor de la acción elegida.
Si es la acción “Abrir”, entonces el parámetro contiene el valor a abrir.
Si es la acción “Desglosar”, “Abrir”, “Filtrar por”, “Ordenar por”, “Agrupar por”, “Aplicar apariencia”, entonces el parámetro contiene configuraciones que se pueden usar en el método ApplySettings.
Si se elige una acción adicional, entonces el parámetro no se rellena.

<AvailableAction> (opcional)

Tipo: Array.
Acciones de procesamiento disponibles. Los elementos del array deben consistir en valores de enumeración DataCompositionDetailsProcessingAction
Si no se especifica este parámetro, se permiten todas las acciones.

<AdditionalMenuItems> (opcional)

Tipo: ValueList.
Permite transferir acciones adicionales al procesamiento de los detalles.
En función de la lista de valores, se crearán y agregarán elementos de menú a los estándar. En caso de que la lista de valores sea un valor del elemento de la lista, se creará un submenú a partir de él. En caso de que se seleccione una acción adicional, el valor correspondiente de la lista se establecerá en el parámetro “Acción ejecutada”.

<UseMainAction> (opcional)

Tipo: Boolean.
Especifica si es necesario utilizar la acción principal de los detalles.
Si no hay una acción predeterminada o es ambigua, se muestra el menú completo al usuario.
Si hay acciones predeterminadas y es definida, entonces el método la devuelve como acción elegida. Al mismo tiempo, si la acción necesita un diálogo adicional, se muestra el diálogo.
Valor predeterminado: False.

<FormElement> (opcional)

Tipo: FormField, FormTable.
Especifica desde qué elemento de formulario se utiliza el menú contextual en el menú de los detalles.

Descripción:

La selección interactiva de acciones de procesamiento de datos detallados proporciona al usuario un conjunto de acciones disponibles como menú y solicita información adicional si es necesario.
El menú contiene operaciones posibles con los detalles: Detalles, Abrir, Filtrar, Ordenar, Agrupar, Formato. Para todas las operaciones excepto los detalles, el programa intenta seleccionar la parametrización más probable basada en los datos de los detalles.
Si solo hay una acción disponible, se realiza inmediatamente después de elegir el elemento.
Abrir: selecciona los campos del elemento de detalles dado que tienen valores de tipo no primitivo y no son enumeraciones. Si el elemento de detalles no tiene campos con valores establecidos (de cualquier tipo), se utilizan los campos del elemento padre de los detalles.
Filtrar: selecciona los campos del elemento de detalles dado que tienen valores, están disponibles para su uso en el filtro principal o en los filtros de los elementos de estructura y tienen tipos de comparación Igual o En grupo disponibles para los campos con valores jerárquicos. Si el elemento de detalles no tiene campos con valores establecidos (de cualquier tipo), se utilizan los campos del elemento padre de los detalles.
Ordenar: selecciona los campos del elemento de detalles dado que están disponibles para su uso en la ordenación. Si el elemento de detalles no tiene campos con valores establecidos (de cualquier tipo), se utilizan los campos del elemento padre de los detalles.
Agrupar: selecciona los campos del elemento de detalles dado que están disponibles para su uso en las agrupaciones y no se utilizan en las agrupaciones de nivel superior. Si el elemento de detalles no tiene campos con valores establecidos (de cualquier tipo), se utilizan los campos del elemento padre de los detalles.
Formato: selecciona los campos del elemento de detalles dado que tienen valores, están disponibles para su uso en el filtro adicional y tienen tipos de comparación Igual o En grupo disponibles para los campos con valores jerárquicos. Si el elemento de detalles no tiene campos con valores establecidos (de cualquier tipo), se utilizan los campos del elemento padre de los detalles.
Detalles: operación no disponible si el elemento de detalles dado son registros de detalles, a menos que contengan campos de recursos.

Disponibilidad:

Cliente ligero, cliente pesado.

Nota:

Si la configuración tiene la propiedad ModalityUseMode establecida en DontUse, utilice el método ShowActionChoice en su lugar.

Consulte también:

DataCompositionDetailsProcess, método ChooseActionAsync
DataCompositionDetailsProcess, método ShowActionChoice

Disponible desde:

Disponible desde la versión 8.2.

Descripción cambiada en la versión 8.3.18.