Propiedades del complemento Establecer columna

« Volver a la tabla de complementos

Temas relacionados

El complemento Establecer columna permite establecer valores en un campo de formulario o en una o varias columnas de una lista de SharePoint.

En esta página

Tabla de parámetros del complemento Establecer columna

Volver al principio

Pares de valores

Los parámetros de pares de valores se relacionan con las columnas de la lista de SharePoint. Cuando se publica un formulario, se crea la lista de SharePoint correspondiente. Esta nueva lista incluye columnas basadas en campos del formulario que se han exportado como columnas de la biblioteca de formularios en sitios de FormEx. En estos sitios, el usuario debe definir columnas de la lista de SharePoint personalizadas.

NOTA: En los parámetros site y list, introduzca el valor de sitio en primer lugar y, a continuación, list se rellenará en la lista desplegable.

Par de valores

Descripción

list

Nombre de la lista de SharePoint en la que quiere configurar la columna.

site

Sitio de SharePoint que contiene la lista en la que quiere configurar la columna.

column

Nombre de la columna cuyo valor desea actualizar. Añada este parámetro por cada columna que desee actualizar.

query

Parámetros de consulta para buscar un listado de registros en la lista de SharePoint. Solo se actualizará el primer registro del conjunto de resultados de la consulta.

Tenga en cuenta que el parámetro query no funciona con valores de campo de formulario; es decir, no puede especificar una ruta Xpath en la parte derecha de la consulta. Por ejemplo, [Title] == @[//my:myFields/my:field1] no funcionará.

expression

El parámetro expression se usa para establecer el valor que enrutará automáticamente el formulario.

Crear una operación de ejecución manualmente

Volver al principio

  1. Establezca Uselinkeddocument en Yes.
  2. Haga clic en Añadir.
  3. El parámetro Runner ahora debe estar visible en el editor de argumentos del complemento. Establezca el nombre del ejecutor en este parámetro. (Para SharePoint 2010 use el formato sin notificaciones y para SharePoint 2013 use el formato de notificaciones).
  4. Cuando el ejecutor designado abre el archivo de datos del complemento de Excel, el botón Ejecutar debe estar visible. Al hacer clic en el botón, la operación se ejecuta manualmente.

Nota: En algunos casos, los elementos de SharePoint se configuran para desprotegerse para la edición. En este caso, si el flujo de trabajo actualiza una columna de SharePoint, el parámetro autocheckout se debe establecer en true.

Tabla de lista de funciones del complemento Establecer columna

Volver al principio

Función

Descripción

$Date

Establece un valor que es relativo a la fecha actual. El argumento especifica el número de días que se van a añadir a la fecha actual.

$Format

Permite dar formato a un valor de una columna con una cadena de formato .NET estándar. Las cadenas de formato .NET se describen en la documentación de Microsoft. El primer argumento es la cadena de formato y el segundo es el nombre de la columna que se va a formatear.

$Expression

Puede establecerse en «True» o «False». El valor predeterminado es «False».

Ejemplo: Si la columna se va a establecer en «2+3»:

Si falta el parámetro expression o se establece en false (valor predeterminado), la columna de destino se establecerá en «2+3» como una cadena.

Si el parámetro expression = «true», la columna de destino se establecerá en 5 (es decir, se evaluará la expresión usada en el valor).

$ListFields

El parámetro establece un valor en una columna de SharePoint.

$Name

Invoca una plantilla de nombre y sustituye la columna de destino por el nombre resultante. En este caso, el valor de inicialización se mantiene con la plantilla de nombre.

$RegExpExtract

Permite que el complemento Establecer columna extraiga información de un valor de una columna y la coloque en otra columna. El primer argumento de la función es la expresión regular entre comillas y el segundo es el nombre del campo al que se va a aplicar. La expresión regular se ejecuta en el valor. Se extrae la primera referencia y se coloca en la columna de destino de SharePoint.

$Revision

Invoca una plantilla de nombre y sustituye la columna de destino por el nombre resultante. En este caso, el valor de inicialización procede de una columna de SharePoint del elemento.

Ejemplos de funciones del complemento Establecer columna

Volver al principio

Función

Descripción

$Date(-2)

En este ejemplo se establece la columna de destino en dos días antes de la fecha actual.

$Format("D", [MyDate])

En este ejemplo se formatea la columna MyDate con el formato de fecha larga. Por ejemplo, 12/31/2010 1:45:30 PM.

$Name([SelectedTemplate])

En este ejemplo se establece la columna de destino en el siguiente valor de plantilla de nombre definido por el contenido de la columna SelectedTemplate. Si la columna SelectedTemplate contiene el valor Plantilla A de proyecto, será la plantilla de nombre que se usa para el valor.

  • Para usar la plantilla de nombre de nivel global (con el nombre «MyGlobalNameTemplate»), proporcione la información con el formato: $Name(MyGlobalNameTemplate)
  • Para usar una plantilla de nombre específica de solución (con el nombre «MySolutionNameTemplate» publicado con el nombre de la solución «MySolution»), debemos proporcionar la información con el formato: $Name(MySolution:MySolutionNameTemplate)

$RegExpExtract(".*([0-9]+).*",[MyField])

En este ejemplo se extrae el primer conjunto contiguo de dígitos del campo MyField.

$Revision(MyTemplate:TemplateSeed)

En este ejemplo se genera un nombre nuevo con la plantilla de nombre llamada MyTemplate con el nombre de inicialización en la columna de SharePoint TemplateSeed.

[Review] – off

En este ejemplo se establece la columna de SharePoint Revisión en el valor off.

Ejemplo

  • site: http://acme.com/sv/FormEx
  • list: empleado
  • query: [Employee Name] == ‘Testuser’
  • [SharePointColumn1]: Value1
  • [SharePointColumn2]: Value2

En este ejemplo se consulta la lista Empleado en el sitio http://acme.com/sv/FormEx en busca de la fila en la que la columna Nombre de empleado coincide con «Testuser».

Si se devuelve alguna fila, se establece la columna SharePointColumn1 en value1 y la SharePointColumn2 en value2 en la primera fila de los campos de SharePoint del conjunto de resultados.