Esta librería permite incorporar las funcionalidades de RPA Forms Connect en cualquier aplicación Javascript.
npm install @entaconsulting/rpaforms-connect-sdk
yarn add @entaconsulting/rpaforms-connect-sdk
<script src="https://unpkg.com/@entaconsulting/rpaforms-connect-sdk"></script>
En el caso de utilizar el sdk como referencia global, todas las funciones se encuentran disponibles dentro del espacio de nombres "rpaFormsConnectSdk". Por ejemplo:
rpaFormsConnectSdk.authentication.selectAccount();
Ver ejemplo de este tipo de uso en samples/html-static
- En el portal Azure, registrar una nueva aplicación en Azure AD
- Copiar el Client ID de la aplicación registrada, que se utilizará más adelante en la inicialización del SDK
-
En la sección "Autenticación" de la configuración del registro de aplicación Azure AD, agregar plataforma "Single Page Application" y configurar la URL de redirección a la ruta de la aplicación. Esta ruta debe coincidir con la página en donde se inicializará el SDK.
Por ejemplo:
https://myconnectapp.entaconsulting.com/
En la sección "Permisos de API" de la configuración del registro de aplicación Azure AD
- Agregar un permiso
- Seleccionar "APIs que usa mi organización"
- Buscar y seleccionar "RPA Forms" (b782e2e8-9682-4898-b211-a304714f4f6b)
- Seleccionar "Permisos delegados"
- Seleccionar permiso "access_as_user"
- Finalmente seleccionar "Otorgar consentimiento de administrador" (esto sólo puede hacerlo un administrador global de Azure)
El SDK debe ser configurado al cargar la página donde será utilizado.
initialize({
authentication: {
clientId: "{0000000-0000-0000-000000000000}",
authority: "https://login.microsoftonline.com/<ID tenant Azure>",
redirectUri: "<URI de la página donde se inicializa el SDK>",
}
});
Es el ClientID de la app registrada anteriormente en el paso Registrar una nueva aplicación Azure AD.
Es la URL de Microsoft Identity seguida del ID del tenant donde se registró tu aplicación
Es la URI de la página donde se inicializa el SDK, y debe coincidir con la URL de redirección configurada en el paso Configurar autenticación SPA.