Función RSTRING( )

Devuelve un valor de cadena calculado por un script o una función Rvachev. El procesamiento de datos en R se hace fuera de Analytics.

Sintaxis

RSTRING(rScript|rCódigo; longitud <;campo|valor <;...n>>)

Parámetros

Nombre Tipo Descripción
rScript | rCódigo

carácter

La ruta completa o relativa al script de R o un fragmento de código R que se debe ejecutar.

Si introduce directamente código R en lugar de utilizar un archivo externo, no puede utilizar el carácter de comillas para encerrar texto en su código, ni siquiera utilizando el carácter de escape:

  • válido 'var <- "\"prueba\"" '
  • no válido 'var <- "\'prueba\'" '
longitud numérico La longitud que se debe asignar para la cadena de retorno.
campo | valor <;...n>

opcional

carácter

numérico

fechahora

lógico

La lista de campos, expresiones o valores literales que se deben utilizar como argumentos para el fragmento de código o script R.

Los valores se pasan la función que invoque en el orden en que lo especifique y usted hace referencia a ellos utilizando valor1, valor2 ... valorN en el código R.

Puede incluir tantos argumentos como sea necesario para satisfacer la definición de la función en el código R.

Nota

Utilice la función ALLTRIM() para quitar los espacios al principio o al final en las entradas de caracteres: ALLTRIM(str). Si desea obtener más información, consulte Función ALLTRIM( ).

Salida

Carácter.

Ejemplos

Ejemplos básicos

Devuelve "abc123":

RSTRING("print(paste(value1,value2,sep=""))",6,"abc","123")

Ejemplos avanzados

Uso de un script externo de R

Concatena x e y en una única cadena delimitada por un carácter de espacio:

RSTRING("a<-source('./sample.r');a[[1]]";50; FirstName; LastName)

Script externo de R (sample.r):

conc<-function(x, y) {
    paste(x, y, sep=" ")
}
print(conc(value1, value2))

Uso de código R almacenado en una variable

Concatena x e y en una única cadena delimitada por un carácter de espacio:

ASSIGN v_script = "conc <- function(x, y){paste(x, y, sep=' ')};conc(value1, value2)"
RSTRING(v_script; 50; Nombre; Apellido)

Uso de R para generar un UUID para una tabla

Está preparando una tabla de excepciones para cargar a Resultados y necesita un identificador único garantizado para cada registro. Para generar este campo, utiliza el paquete uuid de R para crear un valor clave primario exclusivo para cada registro:

EXTRACT RSTRING("uuid::UUIDgenerate()", 36) AS "id"; primer_nombre; apellido; segundo_nombre; fecha_nacimiento TO tabla_exportada

Consejo

Para abrir el paquete uuid, abra R.exe y ejecute el siguiente comando:

install.packages("uuid")

Observaciones

Datos devueltos por R

Al invocar scripts de R, utilice la función source y asigne el objeto de retorno a una variable. Puede acceder al valor que devolvió su función Rvachev desde el objeto devuelto:

# 'a' contiene el objeto de respuesta y a[[1]] accede al valor de los datos
"a<-source('c:\\scripts\\r_scripts\\sample.r');a[[1]]"

Archivo de log de R

Analytics registra los mensajes del lenguaje R en un archivo aclrlang.log en la carpeta del proyecto. Utilice este archivo de log para depurar los errores de R.

Consejo

El archivo de log está disponible en la carpeta Resultados de los trabajos de estudio analítico de Analytics Exchange.

Ejecución de scripts de R externos en el Servidor de AX

Si está escribiendo una aplicación de análisis para ejecutarla en el Servidor de AX y desea trabajar con scripts de R externos:

  1. Cargue el archivo como un archivo relacionado con la aplicación de análisis.
  2. Utilice la etiqueta de estudio analítico FILE para identificar el o los archivos.
  3. Haga referencia a los archivos utilizando la ruta relativa ./nombre_del_archivo.r.

Nota

El uso de un archivo relacionado garantiza que la cuenta del servidor de la aplicación TomEE cuente con permisos suficientes para acceder al archivo al ejecutar R con Analytics Exchange.

Guía de creación de scripts de ACL 14.1