Crear y empaquetar un kit de datos

Objetivos de aprendizaje

Después de completar esta unidad, podrá:

Crear un kit de datos.
Empaquetar un kit de datos.

¿Por qué utilizar kits de datos?

Vamos a profundizar en qué son los kits de datos y para qué se utilizan.

Un kit de datos es como un contenedor especial para los componentes de Data Cloud que, después, puede poner en un paquete. El uso de kits de datos optimiza la experiencia de empaquetado.

Con los kits de datos puede hacer lo siguiente:

Reutilizar esquemas mediante plantillas. Al agregar su configuración de Data Cloud en un kit de datos, los colaboradores y usuarios pueden reutilizar fácilmente su configuración mediante la implementación del kit de datos en su propia organización.
Implementar el kit de datos en varios espacios de datos en la misma organización. Una vez que haya instalado el paquete con el kit de datos en su organización, puede elegir el espacio de datos de esa organización en el que quiera implementarlo.
Mejorar la flexibilidad. En lugar de modificar los metadatos de tiempo de ejecución, las mejoras del paquete actualizan la plantilla, lo que permite que los usuarios del paquete conserven los elementos sin cambios si no se quiere de inmediato.

Existen algunos componentes de Data Cloud que no puede poner en su kit de datos. Para consultar los componentes que pueden ponerse en u kit de datos, revise la matriz de preparación para la capacidad de ampliación de Data Cloud. Merece la pena observar que los metadatos implementados desde un kit de datos no pueden modificarse ni eliminarse.

Con los kits de datos, los usuarios pueden desarrollar soluciones de Data Cloud exhaustivas e integrales, e implementar metadatos de forma selectiva en la organización de un cliente.

Crear un kit de datos

Get Cloudy ha configurado su organización de Dev Hub, su organización con espacio de nombre y su organización borrador. Ahora es el momento de crear un kit de datos.

En la organización borrador, el equipo de Get Cloudy crea elementos de Data Cloud y los agrega a un kit de datos. Este kit de datos funciona como contenedor para las funciones de Data Cloud que desean incluir en la aplicación.

Vamos a ver un vídeo sobre cómo se crea y se carga un kit de datos.

Damos por hecho que usted es desarrollador de paquetes y que cuenta con los permisos adecuados para crear e instalar paquetes en Data Cloud. Si no cuenta con esos permisos, no hay ningún problema. Continúe leyendo para saber cómo los administradores siguen los pasos en una organización de producción. No intente seguir estos pasos en su Trailhead Playground. Data Cloud no está disponible en un Trailhead Playground típico. Antes de empezar, asegúrese de que tiene activado Data Cloud para las organizaciones borrador, tal y como se describe en la unidad dos.

Vaya a Data Cloud Setup (Configuración de Data Cloud) en su organización borrador.
En el cuadro Quick Find (Búsqueda rápida) busque y haga clic en Data Kits (Kits de datos).
Haga clic en New (Nuevo).
Asígnele un nombre a su kit de datos y agregue una descripción opcional. A continuación, haga clic en Save (Guardar).
Haga clic en Add (Agregar) en la sección Data Stream Bundles (Paquetes de transmisiones de datos).
A continuación, seleccione el tipo de conector según la fuente de datos compatible.
Agregue un nombre de paquete (sin espacios) y una descripción opcional.
Seleccione las transmisiones de datos que desee empaquetar y haga clic en Next (Siguiente).
Agregue un modelo de datos si lo desea y, después, haga clic en Save (Guardar).
Agregue una perspectiva calculada si lo desea y, después, haga clic en Save (Guardar).
Agregue componentes adicionales si lo desea.

A continuación, el equipo de Get Cloudy debe especificar el orden en el que deberían implementarse los componentes, lo cual se conoce como secuencia de publicación.

Si la secuencia de publicación no se ha definido correctamente, es posible que se encuentre con algunos problemas de implementación. Por ejemplo, si intenta implementar una perspectiva calculada que depende de un DMO pero no implementa el DMO antes de la perspectiva calculada, se producirá un error de implementación.

Haga clic en la ficha Publishing Sequence (Secuencia de publicación) y haga clic en Edit Sequence (Modificar secuencia). El orden de instalación debería adherirse a la siguiente secuencia: Conectores, Transmisiones de datos, Transformaciones, Perspectivas calculadas, DMO.
Una vez que el kit de datos esté listo, descárguese el archivo package.xml de la interfaz de usuario.
Mueva el archivo package.xml al directorio de su proyecto.

Crear un paquete gestionado con el kit de datos

Get Cloudy ha creado su kit de datos correctamente. Ahora es el momento de empaquetarlo.

En el proyecto de Salesforce DX, el equipo de Get Cloudy r ecupera los metadatos de los datos consultando el archivo package.xml que se descargaron de la IU. Al recuperar los metadatos del kit de datos, debería encontrarse en una carpeta del proyecto independiente, separada de otros tipos de metadatos, como los conjuntos de permisos, objetos personalizados y Apex.

A continuación, determine si es necesaria una dependencia en el paquete SSOT de Data Cloud. SSOT contiene los objetos del modelo de datos principal que potencia Data Cloud. Si un DMO de su paquete tiene relaciones con el perfil individual o con otro DMO que tenga el prefijo ssot__ en el nombre de API, su proyecto tendrá una dependencia y debería agregar lo siguiente a su sfdx-project.json.

{
  "packageDirectories": [
    {
      "versionName": "ver 0.1",
      "versionNumber": "0.1.0.NEXT",
      "path": "data-app",
      "default": false,
      "package": "yourDCPackage",
      "versionDescription": "My data kit extension package",
      "dependencies": [
        {
          "package": "04t5Y0000015oSB"
        }
      ]
    }
  ]
}

A continuación, cree un paquete gestionado de Salesforce que lleve a su carpeta de metadatos del kit de datos.

sf package create -n PACKAGE_NAME -t Managed -v DEVHUB_ALIAS -p PATH_TO_DATA_KIT

Una vez creado el paquete gestionado, se producirá un Id. 0ho. Copie el Id. Después, cree una versión del paquete gestionado mediante el Id. 0ho.

sf package version create -v DEVHUB_ALIAS -k INSTALLATION_KEY -p 0ho_ID -w 45 -f config/project-scratch-def.json

Este proceso puede tardar unos minutos y devolverá un Id. 04t que denotará la versión del paquete. La versión del paquete se considerará beta, lo que significa que solo se puede instalar en organizaciones borrador. Cuando haya verificado la funcionalidad del paquete beta, podrá ejecutar sf package version promote -v DEVHUB_ALIAS -p 04t para crear una versión que se pueda instalar en Developer Edition y en organizaciones de producción.

Colaborar

El equipo de Get Cloudy ha creado y empaquetado un kit de datos. Después, introducen los cambios en el sistema de control de versiones y envían las actualizaciones a GitHub, la plataforma en la que alojan el repositorio, para colaborar con otros desarrolladores.

Otros desarrolladores pueden descargarse el proyecto e implementar el kit de datos en una organización borrador para realizar cambios adicionales. A continuación, repiten el proceso. Los nuevos desarrolladores agregan las funciones antiguas y nuevas al nuevo kit de datos, recuperan los metadatos del kit de datos en su propio proyecto y, después, vuelven a cargar el proyecto en la plataforma de alojamiento del repositorio.

Estimación de tiempo

Temas

¿Necesita ayuda?

Recursos de Data Cloud

Recursos de Salesforce Platform

Crear y empaquetar un kit de datos

Objetivos de aprendizaje

¿Por qué utilizar kits de datos?

Crear un kit de datos

Crear un paquete gestionado con el kit de datos

Colaborar

Recursos