El complemento Update Solution Data Library permite introducir, actualizar o eliminar elementos de una biblioteca de datos de soluciones.
Valores del campo de solución
Si el usuario no proporciona el valor del campo de solución (aparte del campo de tipo cadena) o está vacío por otras razones, se guarda un valor nulo de forma predeterminada para estos campos. Estos campos se pueden consultar mediante el valor «nulo». Consulte la siguiente tabla para ver los valores predeterminados de cada tipo de datos.
| Tipo de datos | Valores predeterminados (Evolve 20.0) | Valores predeterminados (Evolve 20.1 y posterior) |
|---|---|---|
| Ent. | 0 | nulo |
| Decimal | 0,0 | nulo |
| Fecha | 1900/01/01 | nulo |
| Boolean (booleano) | Falso | nulo |
| Texto/cadena | Cadena en blanco | Cadena en blanco |
Si el campo de solución está asignado a un campo calculado en la biblioteca de datos de soluciones, los desarrolladores de soluciones reciben un mensaje de advertencia y el valor de ese campo no se extrae del formulario (no se guarda). El valor del campo de solución se omite y la columna calculada usa el valor de la fórmula. Esto también es así cuando un campo calculado está asignado a un campo de solución de una propiedad promocionada.
Propiedades
|
Nombre |
Descripción |
Obligatorio |
|---|---|---|
|
SolutionDataLibrary (anteriormente: list) |
Nombre de la biblioteca de datos de soluciones que desea actualizar. Este parámetro incluye una lista desplegable de bibliotecas de datos de soluciones creada en el nivel global o en el nivel de aplicación actual. |
Sí |
|
operation |
Acción que desea realizar. Los posibles valores para esta operación son: Delete: Elimina una o varias filas existentes de una biblioteca de datos de soluciones. Insert: Introduce una o varias filas nuevas en una biblioteca de datos de soluciones. Update: Actualiza uno o varios elementos en una biblioteca de datos de soluciones. Upsert: Cuando no hay filas, inserta una fila nueva en una biblioteca de datos de soluciones. Cuando las hay, actualiza una fila existente. |
Sí |
|
consulta |
Parámetros de consulta que se usan para buscar filas en la biblioteca de datos de soluciones. Ejemplo: Valor directo: Title == 1 (aquí, Title es una columna en la biblioteca de datos de soluciones) Title == [field1] (aquí, Title es una columna en una biblioteca de datos de soluciones y field1 es el campo de solución) Title == [/my:myFields/my:field2] (aquí, Title es una columna en una biblioteca de datos de soluciones y field2 es el campo de formulario) Title == NewTitle (aquí, tanto Title como NewTitle son columnas en la biblioteca de datos de soluciones) |
No |
|
onmultiple |
Define qué quiere que haga la operación si coinciden varios elementos (filas) con la consulta. Nota: Nota: Los valores de first y all de la propiedad Onmultiple (a continuación) son válidos para las operaciones Update y Delete. Los valores first y error de la propiedad Onmultiple (a continuación) solo son válidos para las operaciones Upsert.
Los valores son: First: La primera opción opera en el primer registro del conjunto de resultados. Se trata del primer registro que se ha añadido (el registro más antiguo). Error: Genera una excepción si se devuelven varias filas y no se reanuda el proceso de workflow. El mensaje de error tendrá este aspecto: La consulta '[Age] == 21' ha devuelto varios elementos. Donde [Age] == 21 es una consulta mencionada en el parámetro de consulta. All: Realiza la operación definida en todos los elementos/filas. |
No |
Si se usa un valor directo en una consulta, los valores de cadena deben añadirse entre comillas simples.
Ejemplos
Insertar
Library – MasterLibrary
Operation – Insert
En este ejemplo se insertan los valores de los campos de solución (que existen con el mismo nombre en la biblioteca de datos de soluciones) en la biblioteca de datos de soluciones denominada MasterLibrary.
Actualizar
Library – MasterLibrary
Operation – update
Query – Name == 'John'
En este ejemplo se actualizan los valores de todos los registros que tienen el valor «John» en la columna «Name» de la biblioteca de datos de soluciones «MasterLibrary», con los valores en los campos de solución (que existen con el mismo nombre en la biblioteca de datos de soluciones).
Upsert
Library – MasterLibrary
Operation – insert
Query – Name == 'John'
Este ejemplo buscará el valor «John» en la columna «Name» de la biblioteca de datos de soluciones «MasterLibrary». Si existe el registro, actualizará los que tienen los valores en los campos de solución (que existen con el mismo nombre en la biblioteca de datos de soluciones). Si el registro no existe, insertará los valores de los campos de solución (que existen con el mismo nombre en la biblioteca de datos de soluciones) en la biblioteca de datos de soluciones denominada MasterLibrary.
Eliminar
Library – MasterLibrary
Operation – delete
Query – Name == 'John'
Onmultiple – first
En este ejemplo se buscará el valor «John» en la columna «Name» de la biblioteca de datos de soluciones «MasterLibrary» y se eliminará la primera repetición.