Actividades de SharePoint

Importante

Esta versión de Orchestrator ha llegado al final del soporte técnico. Se recomienda actualizar a Orchestrator 2022.

Las siguientes instrucciones de configuración se aplican a todas las actividades de este paquete de integración. Los vínculos a esta sección se incluyen en las instrucciones de configuración de cada actividad.

Los procedimientos de este artículo se realizan en una actividad que se ha colocado en el área de trabajo de Runbook Designer.

Propiedades de la actividad

Cada actividad tiene un conjunto de propiedades obligatorias o opcionales que definen la configuración de esa actividad. La configuración incluye cómo la actividad se conecta a otras actividades o cómo la actividad realiza sus acciones. Puede ver o modificar las propiedades de la actividad cuando la actividad se coloca en el área de trabajo de Runbook Designer.

Para ver y configurar las propiedades de una actividad

  1. Haga doble clic en la actividad. Como alternativa, puede hacer clic con el botón derecho en la actividad y seleccionar Propiedades.

  2. Vea o configure las propiedades de actividad según sea necesario.

  3. Para guardar las entradas de configuración, seleccione Finalizar.

En el cuadro de diálogo Propiedades de la actividad, varias pestañas proporcionan acceso a la configuración general y específica de la actividad. El número de pestañas disponibles para las propiedades de actividad varía según la actividad.

Pestaña General

Esta pestaña contiene las propiedades Name y Description de la actividad. De forma predeterminada, el nombre de la actividad es el mismo que su tipo de actividad y la descripción está en blanco. Puede modificar estas propiedades para crear un nombre más descriptivo o para proporcionar descripciones detalladas de las acciones de la actividad.

Pestaña Propiedades

Esta pestaña contiene propiedades específicas de la actividad. Todas las actividades de este paquete de integración tienen la propiedad Nombre de configuración en la parte superior de la pestaña Propiedades o Filtros. Esta propiedad se usa para especificar la conexión a Microsoft Exchange Server.

Para configurar la propiedad Nombre de configuración

  1. Seleccione el botón de puntos suspensivos (...) situado junto al cuadro Nombre .

  2. Seleccione el nombre de conexión aplicable. Connections que se muestran en la lista se han configurado previamente como se describe en System Center Integration Pack para Microsoft SharePoint.

Comportamiento del filtro

Las actividades Get usan filtros para determinar los valores que invocan un runbook o recuperan actividades. Los valores de propiedad de los posibles candidatos se comparan con los valores de los filtros para determinar si cumplen los criterios. Al hacer coincidir los valores de propiedad con los valores de filtro, puede seleccionar uno de los métodos de comparación disponibles. Se proporciona una opción para que coincida o no con el filtro mediante cada método. Por ejemplo, la versión "No es igual" de un método busca mensajes que no coinciden con el filtro para iniciar la actividad. Todos los filtros de texto distinguen mayúsculas de minúsculas.

  • Igual a: el elemento de lista coincide con el texto o el número especificado en el filtro.
  • No es igual a: el elemento de lista no coincide con el texto o el número especificado en el filtro.
  • Es menor que: el elemento de lista es menor que el número especificado en el filtro.
  • Es menor o igual que: el elemento de lista es menor o igual que el número especificado en el filtro.
  • Es mayor que: el elemento de lista es mayor que el número del filtro.
  • Es mayor o igual que: el elemento de lista es mayor o igual que el número especificado en el filtro.
  • Contiene: el elemento de lista contiene el texto exacto especificado en el filtro. A diferencia del comportamiento Equals, otro texto puede rodear el texto coincidente.
  • Comienza con: el elemento de lista comienza con el texto exacto que se especifica en el filtro. A diferencia del comportamiento Equals, otro texto puede seguir el texto coincidente.

Pestaña Comportamiento de ejecución

Esta pestaña contiene las propiedades que determinan cómo la actividad controla los datos publicados con varios valores y qué notificaciones se envían si se produce un error en la actividad o se ejecuta durante un período de tiempo excesivo.

Varios valores en datos publicados

Las actividades Get recuperan información de Microsoft SharePoint y pueden publicar datos para varios elementos. Por ejemplo, cuando se usa la actividad Obtener elementos de lista, la salida de datos publica el título de cada elemento de lista que se recuperó.

De forma predeterminada, los datos de la actividad Get se pasan como varias salidas individuales. Este proceso invoca la siguiente actividad tantas veces como hay elementos en la salida. Como alternativa, para proporcionar una única salida para la actividad, habilite hacer clic en Acoplar. Al seleccionar esta opción, debe seleccionar una de las siguientes opciones de formato:

  • Separado con saltos de línea. Cada elemento está en una nueva línea. Este formato se usa para crear archivos de texto legibles para la salida.
  • Separado con. Cada elemento está separado por uno o varios caracteres de su elección.
  • Use el formato CSV. Todos los elementos están en un formato de valor separado por comas (CSV). Este formato se usa para importar datos en hojas de cálculo u otras aplicaciones.

La actividad genera un nuevo conjunto de datos cada vez que se ejecuta. La característica Flatten no aplana los datos entre varias instancias de la misma actividad.

Tiempo de espera y notificaciones de eventos de error

Se espera que algunas actividades finalicen en un período de tiempo limitado. Si no finalizan dentro de ese tiempo, es posible que se detengan u otro problema podría impedir que finalicen. Puede definir el número de segundos que se esperarán para completar la acción. Después de este período, se envía un evento de plataforma y se notifica el problema. También puede elegir si desea generar un evento de plataforma en caso de error en la actividad.

Para recibir una notificación cuando la actividad tarda más de un tiempo especificado en ejecutarse o cuando no se puede ejecutar

  1. En el cuadro Notificaciones de eventos, escriba el número de segundos de tiempo de ejecución antes de que se genere una notificación.

  2. Seleccione Notificar si la actividad no se puede ejecutar para generar notificaciones de error de ejecución.

Datos publicados

Los datos publicados son los datos que se generan como resultado de las acciones de una actividad. Estos datos se publican en un bus de datos interno que es único para cada runbook. Los datos publicados son la base de un runbook de trabajo. Las actividades posteriores del runbook pueden suscribirse a estos datos y usarlas en su configuración. Las condiciones de vínculo también usan esta información para agregar funcionalidades de toma de decisiones a runbooks.

Una actividad solo puede suscribirse a datos de las actividades vinculadas antes que en el runbook. Puede usar datos publicados para rellenar automáticamente los valores de propiedad que requieren las actividades.

Para usar datos publicados

  1. Haga clic con el botón derecho en el cuadro de valor de propiedad, seleccione Suscribirse y seleccione Datos publicados.

  2. Seleccione la lista Actividad y seleccione la actividad desde la que desea obtener los datos. Para ver elementos de datos adicionales que son comunes a todos los runbooks, seleccione Mostrar datos publicados comunes.

  3. Seleccione el elemento Datos publicados que desea usar y seleccione Aceptar.

Para obtener una lista de los elementos de datos publicados por cada actividad, vea la tabla Datos publicados en el tema que describe esa actividad. Para obtener información sobre los elementos comunes de datos publicados, vea Datos publicados comunes.

Actividades

Este paquete de integración agrega la categoría Microsoft SharePoint al panel Actividades del Designer runbook. Esta categoría contiene las actividades siguientes: