Power Apps alojado en portal en marketing saliente

  • Artículo

Nota

Dynamics 365 Marketing y Dynamics 365 Customer Insights son ahora Customer Insights - Journeys y Customer Insights - Data. Para obtener más información, consulte Preguntas frecuentes de Dynamics 365 Customer Insights

Los nuevos clientes de Customer Insights - Journeys solo reciben características de recorridos en tiempo real. Para obtener más información, consulte Instalación de recorridos en tiempo real predeterminada.

Importante

Este artículo solo se aplica a marketing saliente.

Antes de empezar a hospedar un sitio web del evento personalizado, complete las acciones mencionadas en el tema Requisitos previos. El sitio web del evento personalizado viene como una aplicación web hospedada del portal de Power Apps cuando se instala la solución Administración de eventos.

La parte frontal de la aplicación se empaqueta en dos archivos de recursos que se almacenan archivos web del portal de Power Apps. El punto de entrada único a la página de la aplicación se almacena como plantilla web del portal de Power Apps.

Aunque la definición de front-end se hospeda en los portales de Power Apps, todavía puede personalizarla por completo. La parte back-end de la aplicación web no se puede personalizar ya que los extremos API de REST se hospedan en el portal de Power Apps como un conjunto de páginas web. El código que contiene la lógica de negocios detrás de ello reside en complementos de administración de eventos que no se pueden personalizar.

Portal hospedado.

Configuración adicional del proyecto

Configuración de entorno

  1. Duplique el archivo de configuración environment.d365.ts de la carpeta \src\environments y asígnele el nombre environment.ts.

  2. Abra el archivo de configuración environment.ts en el entorno de desarrollo que prefiera.

  3. Cambie la variable apiEndpoint para que apunte al valor Enlaces de sitios web.

    Enlace de sitio web.

    Nota

    Debe agregar una barra diagonal final al final de la dirección URL.

  4. Asegúrese de que la variable useRestStack se establece en false.

Desarrollo local

Omitir CSRF

Debe omitir el símbolo (token) anti-CSRF para una implementación local. Para ello, vaya a Dynamics 365 > Portales > Plantillas web, abra la plantilla web PortalAPI y cambie la marca bypassTokenVerification a true. Reinicie los portales para asegurarse de que se aplica la configuración.

Nota

La plantilla web PortalAPI se agrega de forma predeterminada cuando instala los datos de Administración de eventos.

Servir la página localmente

Para servir la aplicación localmente, necesita seguir los pasos que se describen a continuación:

  1. Abra Símbolo del sistema o Windows PowerShell.

  2. Ejecute el comando para instalar de que todas las dependencias.

    npm install

  3. Ejecute el comando para generar el archivo style.css

    ng build --prod --output-hashing none

  4. Ejecute el comando para iniciar el servidor de desarrollo local para ver los cambios inmediatamente.

    ng serve

    Nota

    Puede obtener más información sobre cómo servir localmente una aplicación Angular aquí Servir una aplicación Angular localmente

Implementación

Para crear personalizaciones visible en la página web de eventos, actualice los archivos web en Portales. Esto se puede hacer automáticamente utilizando el script DeployToDynamics365Instance.ps1 proporcionado.

Implementación automática

Para implementar la aplicación Angular personalizada, ejecute el script DeployToDynamics365Instance.ps1 de PowerShell que se encuentra en el directorio Scripts. El script compila la aplicación y prepara los archivos de salida para que puedan hospedarse en la instancia del portal de Power Apps. Toma los archivos de localización Localization de la carpeta y los prepara para hospedar.

Tras agregar todos los archivos, le pedirá que inicie sesión en la instancia de Dynamics 365 Customer Insights - Journeys que desea usar para hospedar su aplicación. Una vez iniciada la sesión, inserta los archivos en la instancia. Si no ve los cambios, desactive caché del explorador y reinicie sus Portales.

Si desea implementar algunos archivos específicos en lugar de todos los archivos a la vez, puede especificar la lista de archivos como parámetro para el script: .\DeployToDynamics365Instance.ps1 -inputFiles main.es. Puede encontrar la lista con todos los archivos compatibles en el contenido de los scripts.

Nota

  • Si no puede ejecutar el script de Powershell debido a la regla de ejecución, necesita deshabilitar u omitir la directiva de ejecución.
  • Recomendamos no cargar archivos manualmente debido a problemas de accesibilidad. Use el script DeployToDynamics365Instance.ps1 para llevar sus personalizaciones automáticamente a su instancia.

Configurar Cross Origin Resource Sharing (CORS)

Si desea presentar el sitio web de evento personalizado desde un dominio personalizado, debe configurar CORS para permitir ese dominio personalizado. Para ello:

  1. Vaya a Dynamics 365: personalizada>Portales>Configuración de sitios y seleccione Nuevo para crear un registro de configuración de sitios.

  2. Inserte HTTP/Access-Control-Allow-Origin en el campo Nombre.

  3. Seleccione su sitio web.

  4. Agregue el origen personalizado que se debe permitir. Por ejemplo, si el sitio web de evento personalizado se hospeda en el dominio personalizado https://contoso.com/, el campo Valor debe establecerse en https://contoso.com/.

  5. Seleccione Guardar.

  6. Reinicie los portales para asegurarse de que se aplica la configuración.

    Nuevo valor del sitio para permitir

    Nota

    Aquí puede encontrar más información sobre CORSAccess-Control-Allow-Origin

Sobrescribir manualmente el sitio web de ejemplo

Si desea sobrescribir el sitio web de ejemplo para que coincida con la versión de administración de eventos que tiene actualmente, consulte Sobrescribir manualmente el sitio web de ejemplo