Correos electrónicos de R: Blastula 0.3

publicado en: rstudio | 0

Nos complace anunciar la blástula, un paquete para crear hermosas costumbres
correos electrónicos en R. En RStudio, nos encantan los tableros interactivos, pero algunas situaciones
requieren un mecanismo de comunicación diferente. Usar la blástula para:

  • Componer cuerpos de correo electrónico personalizados basados en el código, la salida del código y la reducción de la marca

  • Enviar correos electrónicos usando servidores SMTP – incluso GMail – o integrarse con servicios de producción como RStudio Connect

Blástula facilita el envío de notificaciones para todo, desde detección de anomalías hasta resultados de baloncesto de fantasía, todo sin dejar a R.

Para empezar, instale la blástula de CRAN:

instalar.paquetes($0027blastula$0027)

Creación de correo electrónico

La fuerza única de Blástula es crear cuerpos de correo electrónico HTML personalizados que se renderizan en un
variedad de clientes de correo electrónico, incluyendo el móvil. La forma recomendada de crear correo electrónico
está usando el formato de salida R Markdown de Blastula. blastula::blastula_email. El
El cuerpo del correo electrónico respetará la salida de la marca R, incluyendo la sintaxis de la marcación.
y salidas de trozos de código.

---
salida: blastula::blastula_email
---
Hola equipo,
Este *importante* pronóstico tiene que salir hoy.
```{r echo=FALSO}
modelo <- arima(presidentes, c(1, 0, 0))
predecir(modelo, 3)
````

Para crear el correo electrónico a partir del documento R Markdown, utiliza render_email:

email <- render_email($0027email.Rmd$0027)

El objeto de correo electrónico resultante se puede ver previamente en RStudio.

Alternativamente, es posible crear un correo electrónico sin R Markdown, usando
la función «componer_correo electrónico» para combinar texto, imágenes e incluso gráficos:

biblioteca (blástula)
biblioteca(ggplot2)
biblioteca(pegamento)
plot(disp, hp, data = mtcars, color = mpg)
plot_email <- add_ggplot(plot)
correo electrónico... componer_correo electrónico...
  cuerpo = md(c(
     "Equipo, ¿cómo trazaría la relación entre estas 3 variables?",
      plot_email
  ))
)

Visite la documentación para aprender a incrustar
imágenes, establecer encabezados y pies de página de los correos electrónicos, e incluso añadir botones de llamada a la acción.

Envío de correos electrónicos personalizados con SMTP

Para enviar correo electrónico, la blástula incluye funciones para acceder a servidores SMTP como GMail, Outlook y Office365.

Primero, dile a Blastula de forma segura sobre tu servidor SMTP:

create_smtp_creds_key(
  id = "gmail",
  usuario = "user_name@gmail.com",
  proveedor = "gmail"
)

A continuación, utilice el servicio SMTP para enviar su correo electrónico personalizado:

email % ...
  smtp_send(
    de = "personal@email.net",
    a = "personal@email.net",
    subject = "Probando la función `smtp_send()`",
    credenciales = creds_key(id = "gmail")
  )

Envío de correos electrónicos personalizados con RStudio Connect

Las organizaciones pueden usar la blástula en la producción en RStudio Connect. Por ejemplo, nosotros
usar la blástula para rastrear servicios críticos como nuestro ticket de soporte
volumen y los horarios de entrenamiento de nuestro personal.

Una forma fácil de empezar es acceder a los ejemplos de RStudio Connect:

blastula::prepare_rsc_example_files()

Publicar el documento resultante de la reducción de la marca R en RStudio Connect, donde puede ser
programado para el regular
ejecución
y distribuido a los interesados.

Blástula ofrece tres funciones adicionales para facilitar la creación de correos electrónicos
para RStudio Connect.

  • render_connect_email añade automáticamente un pie de página al correo electrónico con útiles enlaces al contenido de RStudio Connect.

  • attach_connect_email asegura que RStudio Connect envíe el correo electrónico personalizado, y también facilita la personalización de la línea de asunto, la inclusión de adjuntos de correo electrónico adicionales y, opcionalmente, la salida del informe.

  • suppress_scheduled_email() te permite omitir el envío del correo electrónico. Este patrón es muy poderoso. Por ejemplo, los informes pueden ser ejecutados una vez al día, pero sólo se distribuyen si se cumplen ciertas condiciones.

Juntas, estas tres funciones pueden utilizarse para enviar notificaciones proactivas:

if (demand_forecast > 1000) {
  render_connect_email(input = "alert-supply-team-email.Rmd") %...
  attach_connect_email(
    subject = sprintf("Necesitamos preparar unidades %d!", demand_forecast),
    attach_output = TRUE,
    attachments = c("demand_forecast_data.csv")
  )
} más {
  suppress_scheduled_email()
}

Por favor, asegúrese de visitar la blástula
sitio web para encontrar más
recursos. Después de todo, ¿quién no quiere un ggplot en su bandeja de entrada?

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *