Creación de cargadores de la nube personalizada

Pasos básicos

Introduzca la configuración del origen de datos
Defina parámetros.
Escriba JavaScript con las API de CCDS en el Espacio de nombres ai.
Definición de reglas de negocio.
Ejecución o programación del cargador.

Requisitos previos

Verifique que tenga el permiso de Desarrollador de integración.
Verifique que
Adaptive Planning
los datos de plan que desea exportar ya existen en una tabla de almacenamiento provisional.
Cree una credencial de OAuth para su sistema externo u obtenga credenciales que pueda incluir directamente en su JavaScript.
Conozca los parámetros que debe pasar a su sistema externo y qué valores por defecto espera el sistema externo.
Comprenda cómo escribir en el punto final del sistema externo

Navegación

En el menú de navegación, vaya a

Integración

Diseño de integraciones

.

Configuración del origen de datos

Creación de un nuevo cargador de la nube personalizada

Acceda al Diseñador de datos desde
Integración > Diseño de integraciones
.
En la carpeta Cargadores de la biblioteca de componentes, seleccione
Crear nuevo cargador
.
Seleccione
Cargador de la nube personalizada
como tipo de cargador e introduzca un nombre para él.
Si no ve el cargador de la nube personalizada como opción, es porque no está activado para la instancia o no cuenta con el permiso de Desarrollador de integración que se requiere para acceder a él.
Seleccione
Crear
.

Seleccionar la tabla de origen, la credencial y el nivel de registro

Introduzca la siguiente información del cargador de la nube personalizada:
Tabla de origen:
seleccione una tabla de almacenamiento provisional que contenga
Adaptive Planning
los datos de Planning que desea exportar.
Credencial obligatoria:
seleccione esta opción si el sistema externo requiere OAuth y usted requiere que un usuario con permiso de Operador de integración seleccione la credencial de OAuth adecuada.
Credencial:
seleccione una credencial preexistente de OAuth.
Nivel de registro:
seleccione la cantidad de detalles que se registrarán cuando se ejecute el cargador:
Error
:
solo registra errores.
Información
:
registra toda la información básica, como el momento en que se actualiza el origen de datos.
Detallado
:
proporciona información muy detallada sobre todas las fases y acciones. Se utiliza principalmente para depuración o auditoría, ya que puede producir más información de registro de la necesaria para el uso común.
Haga clic en
Guardar
en el menú de acciones.

Definición de parámetros

Seleccione
Configuración de diseñador.
Arrastre los elementos de configuración parametrizados o estáticos del panel
Componente de configuración
a
Configuración de diseñador.
Los valores de configuración parametrizados introducidos aquí se convierten en valores por defecto del cargador si no proporciona otros en el tiempo de ejecución del cargador.
Los ajustes de configuración estáticos que introduzca aquí se utilizarán cada vez que se ejecute el cargador y no requieren valores de entrada en el tiempo de ejecución.
Booleano: un valor representado como uno o cero.
Dimensión: una dimensión del administrador de dimensión dentro de
Adaptive Planning
.
Valor entero: un número entero no negativo.
Contraseña: una contraseña. Este valor no se puede ver una vez guardado.
Rango de periodo: un rango de periodo dentro de
Adaptive Planning
.
Texto: un valor alfanumérico.
Haga doble clic en un elemento de parámetro para introducir un nombre y cambiar su valor.
Arrastre tantos elementos como necesite para hacer referencia en su JavaScript.
Guarde el cargador.
Para hacer referencia a un parámetro, utilice el nombre del parámetro en su JavaScript.

Escritura de JavaScript

Seleccione
Secuencia de comandos
.
Seleccione la plantilla preexistente y cámbiela o seleccione
Nueva secuencia de comandos
para crear la suya propia.
Escriba el código JavaScript que desea que el cargador ejecute mediante las API de CCDS en el Espacio de nombres ai.
Verifique que la secuencia de comandos incluya lo siguiente:
testConnection
función para crear una solicitud https para publicar en su sistema externo
exportData
función desde la que exportar datos
Adaptive Planning
. Consulte Función de exportación de datos (solo cargador de nube personalizada) en el tema Funciones de Adaptive Planning.
Haga referencia a cualquier parámetro que haya creado en Configuración de diseñador mediante su nombre.
Guarde la secuencia de comandos.

Uso de OAuth en secuencias de comandos del cargador de la nube personalizada

Seleccione
Solicitar autorización
antes de ejecutar el cargador.
Proporcione los detalles de autorización adicionales, como el ámbito, necesarios para el punto final del sistema externo.
Seleccione
Prueba de conexión
para verificar que las credenciales de OAuth se hayan transferido correctamente al punto final.
Anote la fecha de autorización y el ID de usuario en Estado de la autorización. Las fechas de vencimiento de las autorizaciones varían según el sistema externo. Seleccione Restablecer autorización en el panel Acciones para volver a autorizar cuando sea necesario.

Definición de reglas de negocio

Seleccione la ficha
Reglas de negocio
.
Seleccione
Editar
.
Introduzca una expresión SQL. Puede hacer clic en un elemento de la lista de Columnas disponibles para incorporar la columna a la expresión SQL en lugar de escribirla.
Seleccione
Aplicar
para comprobar la sintaxis de la expresión. Si hay errores de sintaxis, el borde alrededor de la expresión será rojo. Mantenga el puntero sobre la expresión para ver la información sobre los errores.
Corrija los errores de sintaxis y seleccione
Aplicar
. Solo se cargarán las filas de almacenamiento provisional que coincidan con la expresión SQL.

Introducción del cargador de la nube personalizada en una tarea de integración

Secuencia de comandos CCL de muestra

Definición de un origen de datos de hoja de cálculo.
Cree un nuevo cargador de la nube personalizada en el panel
Cargadores
.
Vaya a la ficha
Configuración de origen de datos
y seleccione su origen de datos de la hoja de cálculo en el campo
Tabla de origen
.
Copie la siguiente secuencia de comandos de muestra en la ficha
Secuencias de comandos
.
 // Manually invoke this method via 'Test connection'
function testConnection(context) {
    return true;
}
// Manually invoke this method via 'Run manually'
function exportData(context) {
   //"xxx" is the name of your Amazon S3 bucket. 
    var bucketName = 'xxx';
    //Name of the sample CSV file to which data from your spreadsheet data source is exported
    var key = 'exampleTest.csv';
    //"xxxx" is the access key for your AWS S3 bucket.
    var awsAccessKey = 'xxxx';
    //"xxxx" is the secret key of your AWS S3 bucket. 
    var awsSecretKey = 'xxxx';
    var region = 'us-west-1';
    // Step 1: Get the data
    var reader = context.createTableReader();
    // Step 2: Process and export the data
    var result = "Column,Heading,Names\n";
    var row = null;
    while ((row = reader.readRow()) !== null) {
       // remove meta columns we don't need
       row.length = row.length - 2;
       result += row.join() + '\n';
   }
    ai.awss3.putFile(bucketName, key, result, region, awsAccessKey, awsSecretKey);
} 
Seleccione
Guardar
en el panel
Acciones
.
Para ejecutar la secuencia de comandos, seleccione
Ejecución manual
en el panel
Acciones
.