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é usar kits de datos?

Analicemos en detalle qué son los kits de datos y porqué los usa.

Un kit de datos es similar a un contenedor especial de los componentes de Data Cloud que posteriormente puede colocar en un paquete. El uso de kits de datos optimiza la experiencia de empaquetado.

Con los kits de datos, podrá hacer lo siguiente:

Volver a usar el esquema a través de plantillas. Si coloca la configuración de Data Cloud en un kit de datos, los colaboradores y usuarios pueden volver a usarla con facilidad implementando el kit de datos en su propia organización.
Implementar el kit de datos para multiplicar los espacios de datos en la misma organización. Una vez instalado el paquete con el kit de datos en su organización, puede elegir qué espacio de datos en la organización desea implementar.
Mejorar la flexibilidad. En lugar de alterar los metadatos de tiempo de ejecución, las actualizaciones del paquete modifican la plantilla, lo que permite que los usuarios del paquete retengan los elementos que no cambiaron, si no se requiere de forma inmediata.

Existen algunos componentes de Data Cloud que no se deben colocar en un kit de datos. Para comprobar qué componentes se pueden colocar en un kit de datos, revise la Matriz de preparación de capacidad de extensión de Data Cloud. Vale la pena mencionar que los metadatos que se implementen desde un kit de datos no se pueden editar ni borrar.

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

Crear un kit de datos

Get Cloudy configuró su organización de Dev Hub, organización de espacio de nombres y organización borrador. Ahora es momento de crear un kit de datos.

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

Veamos un video sobre cómo se crea y se carga un kit de datos.

Suponemos que es un desarrollador de paquetes con los permisos necesarios para crear e instalar paquetes en Data Cloud. Si no tiene esos permisos, no hay problema. Siga leyendo para conocer cómo podría realizar los pasos su administrador en una organización de producción. No intente seguir estos pasos en su Trailhead Playground. Data Cloud no se encuentra disponible en un Trailhead Playground típico. Antes de comenzar, asegúrese de tener las organizaciones borrador de Data Cloud habilitadas, como se describió en la unidad dos.

Vaya a Data Cloud Setup (Configuración) en su organización borrador.
En el cuadro de búsqueda rápida, busque la opción Data Kits (Kits de datos) y haga clic en ella.
Haga clic en New (Nuevo).
Asigne un nombre a su kit de datos y agregue una descripción opcional, luego, haga clic en Save (Guardar).
Haga clic en Add (Agregar) desde la sección Data Stream Bundles (Paquetes de transmisión de datos).
A continuación, seleccione el tipo de conector según el origen de datos admitido.
Agregue un nombre de paquete (sin espacios) y una descripción opcional.
Seleccione las transmisiones de datos que desea empaquetar y, a continuación, haga clic en Next (Siguiente).
Si lo desea, agregue un modelo de datos y, a continuación, haga clic en Save (Guardar).
Si lo desea, agregue una perspectiva calculada y, luego, haga clic en Save (Guardar).
Agregue los componentes adicionales que desee.

A continuación, el equipo de Get Cloudy debe especificar el orden en el que los componentes deben implementarse, lo que se denomina “secuencia de publicación”.

Si la secuencia de publicación no se define correctamente, es posible que ocurran errores en la implementación. Por ejemplo, si intenta implementar una perspectiva calculada que es dependiente en un DMO, pero no se implementa DMO antes de la perspectiva calculada, se encontrará con un error en la implementación.

Haga clic en la ficha Publishing Sequence (Secuencia de publicación) y, luego, en Edit Sequence (Editar secuencia). Por lo general, el orden de la instalación usa la siguiente secuencia: Conectores, Transmisiones de datos, Transformaciones, Perspectivas calculadas, DMO.
Cuando el kit de datos esté listo, descargue el archivo package.xml desde la interfaz de usuario.
Mueva el archivo package.xml al directorio del proyecto.

Crear un paquete gestionado con el kit de datos

Get Cloudy creó correctamente el kit de datos. Ahora es el momento de empaquetarlo.

En el proyecto de Salesforce DX, el equipo de Get Cloudy r ecupera los metadatos de los datos haciendo referencia al archivo package.xml que se descargó desde la IU. Cuando se recuperan los metadatos del kit de datos, aparecen una carpeta de proyecto independiente separada de otros tipos de metadatos como los conjuntos de permisos, objetos personalizado y Apex.

A continuación, debe determinar si es necesaria una dependencia en el paquete SSOT de Data Cloud. SSOT contiene los objetos del modelo de datos central que potencian a Data Cloud. Si los DMO en el paquete tienen relaciones con el individuo unificado u otros DMO con un prefijo ssot__ en el nombre de la API, su proyecto tiene una dependencia y debe agregar lo siguiente a 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 de Salesforce gestionado que apunte a la carpeta de metadatos del kit de datos.

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

Cuando se crea ese paquete, se generará una Id. 0ho. Copie la Id. A continuación, cree una versión de paquete gestionado con esa 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 demorar un par de minutos y devolverá una Id. 04t que asignará la versión del paquete. La versión del paquete será considerada “beta”, lo que significa que solo se puede instalar en organizaciones borrador. Luego de comprobar la funcionalidad del paquete beta, puede ejecutar sf package version promote -v DEVHUB_ALIAS -p 04t para crear una versión que se pueda instalar en Developer Edition y las organizaciones de producción.

Colaborar

El equipo de Get Cloudy creó y empaquetó un kit de datos. Luego, confirman los cambios en su sistema de control de versiones y envían las actualizaciones a GitHub, su plataforma de alojamiento del repositorio, para colaborar con otros desarrolladores.

Otros desarrolladores pueden descargar el proyecto e implementar el kit de datos en una organización borrador para realizar cambios adicionales. Luego, repiten el proceso. Los nuevos desarrolladores agregan las versiones anteriores y las nuevas a un nuevo kit de datos, recuperan los metadatos del kit de datos en su propio proyecto y, por último, vuelven a cargar el proyecto en su 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é usar kits de datos?

Crear un kit de datos

Crear un paquete gestionado con el kit de datos

Colaborar

Recursos