Advertencia
Sunset Notice (01-24-2025)
This version of the EaaSI User Handbook was in active use during the platform’s grant-funded period, 2018-2024. As of 2025, we are in the process of revising the Handbook in anticipation of a collaboration with the Software Preservation Network later this year.
As a result, the information below may or may not accurately reflect the expected function and workflows of the EAASI software moving forward. This version of the User Handbook will be retired and shut down in early 2025. Please follow announcements and updates in the EAASI Forum to learn more about our product roadmap or email softwarepreservation@yale.edu for more information about our ongoing development transition!
Embedding Published Environments
EaaSI users may embed published Environments from their node into other web pages using the Emulation-as-a-Service JavaScript client library developed the OpenSLX team.
This method is currently brittle and pending improvements to the back-end EaaS server codebase may break existing embed links if/when the host server is updated. Support for this method is limited, employ at your own risk.
Nota
Para que el código eaas-cliente funcione, el objetivo Medio ambiente **debe ser publicado por primera vez a través de OAI-PMH. (En otras palabras, tener un estado de red de «Public» y «Saved Locally» en el nodo host/source). Por favor consulte publicshing para la guía y ramificaciones de elegir para publicar un entorno de su nodo EaaSI.
Advertencia
Issues with the methods described on this page may occur if there is a version mismatch between the eaas-client library used and the eaas-server on the EaaSI deployment hosting the target Environment. Future EaaSI deployments will co-locate and expose the relevant eaas-client JavaScript component on the same deployment to prevent mismatch rather than fetching the JS from source repo on GitLab.
Usando EaaS personalizados JavaScript Elementos en HTML
Para incorporar un entorno publicado en HTML arbitrario, primero debe importarse el módulo JavaScript de eaas-client:
<script type="module" src="https://emulation-as-a-service.gitlab.io/eaas-client/webcomponent.js"></script>
Nota
The webcomponent.js
can also be sourced from https://purl.archive.org/eaas/eaas.js
for a stable link using the Internet Archive’s PURL (Persistent URL) service.
A continuación, puede incluir un elemento `` detecteaas-environment ``` en su página web para seleccionar y estilo el medio ambiente que se vincularía a la incrustación, por ejemplo:
<eaas-environment id="example-env"
eaas-service="https://<your.eaasi.domain>/emil/"
environment-id="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
autoplay
style="border: black solid 10px;">
<strong>Please wait</strong> while the environment is being started ...
</eaas-environment>
Donde:
" id " es un nombre o una búsqueda arbitrarios para identificar el elemento en el estilo/CSS
``eaas-service` identifica la ubicación y el punto final necesario de la API para conseguir el Medio Ambiente; reemplazar «Sele.eaasi.domain confidencial» con el nodo fuente
``environment-id` es el UUID que identifica un recurso ambiental; reemplazar por el UUID de su entorno deseado
autoplay
es un atributo Booleano opcional que comenzará a cargar y ejecutar el Medio Ambiente tan pronto como el navegador del visitante carga la página (remove este atributo para deshabilitar el juego automático)style=
se puede utilizar opcionalmente para añadir estilo al elemento" Sestrong " Por favor, esperen identificado/strongilo mientras el ambiente está siendo iniciado …` es texto opcional y arbitrario que se mostrará al usuario mientras el Medio Ambiente carga y será reemplazado por el Medio Ambiente en ejecución. Esto se puede editar para incluir cualquier texto arbitrario, imágenes, otro HTML como se desee.
Tenga en cuenta que el UUID para un determinado entorno se puede encontrar ya sea utilizando el EaaSI API o mirando la barra de URL cuando navega a cualquier página de Detalles del Medio Ambiente dado:

Importar biblioteca para uso directo en JavaScript
With the `eaas-client ■https://gitlab.com/emulation-as-a-service/eaas-client repositorio clonado en su proyecto, utilice:
import { Client } from "./eaas-client.js";