Compartir a través de

Empaquetar aplicaciones de biz en plantillas de lista de la organización

Hay una serie de pasos por los que puede crear una plantilla de lista de SharePoint empaquetada que contiene flujos personalizados integrados. El objetivo es ensamblar y registrar un archivo empaquetado que contenga las acciones de script de sitio necesarias para crear la lista y los flujos, y un archivo de solución Dataverse (zip) que contenga las definiciones de flujo.

Una vez que haya configurado la lista de SharePoint de origen y esté listo para trabajar en la integración de flujos con ella y en el ensamblado de una plantilla con estos componentes, siga estos pasos:

Obtención del archivo ZIP de la solución

  1. Inicie sesión en el portal de Power Automate iniciando https://flow.microsoft.com/ (o elija Integrar > Power Automate > Ver los flujos" en el Portal de SharePoint).

  2. Cree una nueva solución de Dataverse haciendo referencia a Información general de los flujos compatibles con la solución.

    Para obtener una introducción a las soluciones de Dataverse, consulte Conceptos de soluciones.

  3. Agregue un nuevo flujo o personalice los flujos existentes a esta solución haciendo referencia a Creación de un flujo de nube en una solución.

  4. Asegúrese de que los flujos usan referencias de conexión para cada desencadenador y acción que use. Para obtener más información sobre cómo usar una referencia de conexión, consulte Uso de una referencia de conexión en una solución.

  5. Una vez que esté satisfecho con el contenido de la solución (incluidas las referencias de conexión o las variables de entorno que desea configurar), exporte y descárguela en un disco.

  6. Extraiga todos los archivos del archivo ZIP en una carpeta independiente.

  7. Vaya a la subcarpeta Flujos de trabajo de la carpeta.

  8. Abra cada archivo de .json relacionado con el flujo y, a continuación, busque y reemplace todas las instancias de los elementos siguientes:

    1. Dirección URL del sitio de SharePoint en el que residía la lista original: Reemplace por {ContextSharePointSiteUrl}.
    2. Identificador de la lista original de SharePoint: reemplace por {ContextSharePointListId}.

    Por ejemplo:

    [Antes de los reemplazos]

    "parameters": {
   "dataset": "https://microsoft.sharepoint-df.com/teams/AlinTest ",
   "table": "d6ac2804-7a1c-4cd4-98c8-56b85a9294b7"
            }

    Por ejemplo:

    [Después de los reemplazos]

    "parameters": {
   "dataset": "{ContextSharePointSiteUrl}",
   "table": "{ContextSharePointListId}"
            }

  9. Guarde los cambios y cierre todos los editores de archivos que ha abierto para estos archivos.

  10. Volver a la carpeta raíz de la solución; seleccione todos los archivos (solution.xml, customizations.xml, etc.) y carpetas; haga clic con el botón derecho y elija Comprimir en archivo ZIP en el menú contextual.

    Seleccionar todos los archivos y comprimirlos en un archivo ZIP.

    Puede conservar este archivo zip resultante y también puede optar por descartar el archivo zip de la solución original que descargó anteriormente (como se especifica en el paso 6 de este procedimiento).

Obtención del archivo de acción de script de sitio (manifest.json)

Importante

Antes de realizar los pasos de esta sección, asegúrese de que ha probado la lista de prototipos y fluye a su satisfacción.

  1. Asegúrese de que ha instalado Shell de administración de SharePoint Online en el equipo.

  2. Inicie Shell de administración de SharePoint Online.

  3. Ejecute el siguiente comando para conectarse al servicio de administración del inquilino:

    [Connect-SPOService](/powershell/module/sharepoint-online/connect-sposervice) -Url <Link to SPO admin portal> -Credential <full username of the admin user>

  4. Ejecute el siguiente comando para extraer un archivo de script de sitio de la lista de destino:

[Get-SPOSiteScriptFromList](/powershell/module/sharepoint-online/get-spositescriptfromlist) -ListUrl <full URL of the target list> | Out-File manifest.json

  1. Abra el archivo manifest.json en el editor de texto (o código) favorito y agregue manualmente una acción con el verbo "importBusinessApps", la ruta de acceso relativa del archivo de solución dentro del paquete de plantilla general y el nombre de lista de destino (en este caso, el título del enlace listName). Este valor debe ser el mismo que la propiedad listName de la acción "CreateSPList".

Por ejemplo:

Agregar un verbo en el archivo .json.

Ensamblado del archivo zip del paquete final de SharePoint

  1. Asegúrese de que el archivo ZIP de la solución y el archivo manifest.json (del paso anterior) están en la misma ubicación de carpeta.
  2. Seleccione estos dos archivos; Haga clic con el botón derecho y, a continuación, seleccione Comprimir en archivo ZIP (o Enviar al > archivo ZIP, dependiendo del sistema operativo).

Registro de la nueva plantilla como diseño de lista

  1. Para cargar el archivo ZIP (creado en Ensamblar el archivo zip del paquete final de SharePoint) como un paquete de script de sitio, ejecute el siguiente comando en la misma ventana del shell de administración:

    $pkg = Add-SPOSiteScriptPackage -Title "<script title>" -Description "<script description>" -ContentPath '<relative path to zip file from previous step>'

    Nota:

    La inclusión de la propiedad Description en el comando es opcional.

  2. Eche un vistazo al nuevo paquete imprimiendo sus propiedades mediante el siguiente comando:

    "$pkg"

    La salida debe contener una propiedad Id necesaria en los pasos siguientes.

    Nota:

    (Opcional) Ejecute Get-SPOListDesign para asegurarse de que no va a agregar un duplicado con el mismo título o descripción, o para inspeccionar lo que ya está allí.

  3. Ejecute el siguiente comando:

    Add-SPOListDesign -Title "<list design title>" -Description "<list design description>" -SiteScripts $pkg.Id

    Si el diseño de lista se creó correctamente, debería poder verlo en el área Desde su organización" del cuadro de diálogo Crear lista .