Configuración del espacio de trabajo

Acceso a valores

  1. En el espacio de trabajo, pulse Archivo > Valores > Abrir preferencias.
  2. En el separador Preferencias, puede utilizar la lista de categorías de valores, situada a la izquierda, para ir rápidamente los valores que le interesen. Por ejemplo, pulse la entrada Zopeneditor para visualizar los valores relacionados con IBM Z Open Editor.
  3. Todas las preferencias que se muestran en el editor visual se representan como JSON. Las preferencias complejas que no son únicamente valores simples deben especificarse utilizando el editor JSON. Para abrirlo, seleccione en primer lugar el separador de ámbito: El separador Usuario o el separador Espacio de trabajo. Para obtener más información, consulte las diferencias entre las preferencias de usuario y las preferencias de espacio de trabajo.
  4. A continuación, abra la vista JSON pulsando Editar en settings.json o pulsando el icono Abrir preferencias en JSON en la parte superior derecha del editor.
  5. En la vista JSON resultante, establezca todas las configuraciones obligatorias y establezca las configuraciones opcionales, según sea necesario.

Configuraciones obligatorias

Se necesitan las siguientes configuraciones:

  • Los grupos de propiedades son necesarios para definir cómo los editores de COBOL, PL/I y HLASM buscan libros de copia e incluyen archivos al editar un programa. No se han configurado los valores predeterminados pero puede hacer referencia al fragmento de código JSON proporcionado en Establecer grupos de propiedades en la documentación de Wazi Developer for VS Code como punto de partida.
  • Para ejecutar una compilación de usuario, debe configurar primero la compilación de usuario de acuerdo con lo que se indica en Configurar compilación de usuario en la documentación de Wazi Developer for VS Code.
  • Para depurar las aplicaciones, antes de conectarse a una máquina de z/OS e iniciar la depuración, configure la conexión y las preferencias de IBM Z Open Debug según Configuración de IBM Z Open Debug.
Consejo: Para configurar los grupos de propiedades y la compilación de usuario, puede utilizar los archivos de configuración de espacios de trabajo o ZAPP. Para compartir fácilmente con sus compañeros de equipo y facilitar el mantenimiento con el formato YAML, utilice archivos ZAPP. Para los valores de depuración, utilice el valor de espacio de trabajo, ya que ZAPP todavía no recibe soporte.

Configuraciones opcionales

IBM Z Open Editor tiene valores predeterminados para identificar el lenguaje del archivo abierto en el editor, y puede personalizar adicionalmente las asociaciones de archivos de acuerdo con la Configuración de asociaciones de archivos en la documentación de Wazi Developer for VS Code.

También puede ajustar las configuraciones siguientes para controlar las características de su entorno de acuerdo con su preferencia. Las instrucciones son de la documentación de Wazi Developer for VS Code.

Las siguientes configuraciones opcionales son específicas de Wazi Developer for Workspaces:
Ubicación de la carpeta de descargas temporales de Zowe Explorer
Todas las pilas de Wazi Developer for Workspaces están preconfiguradas para almacenar archivos temporales cargados desde z/OS utilizando Zowe™ Explorer en la carpeta /projects/temp. De forma predeterminada, Zowe Explorer utiliza esta carpeta para mantener los archivos descargados para que se puedan abrir, escribir y guardar con el editor. Sin embargo, si crea su propio devfile o una ubicación de almacenamiento diferente, debe especificar la ubicación de la carpeta temporal de Zowe en el devfile o crear manualmente el valor de usuario. Puede encontrar más información sobre la personalización del devfile en Utilización de devfile personalizado para crear un espacio de trabajo. Los pasos para crear manualmente el valor de usuario son los siguientes:
  1. Abra el menú Archivo > Valores > Abrir preferencias. Se abre la ventana del editor de preferencias que muestra los valores específicos del usuario y el espacio de trabajo.
    Nota: En este caso, el término "Espacio de trabajo" es diferente de un espacio de trabajo dentro de Wazi Developer for Workspaces. Aquí, "Espacio de trabajo" hace referencia al directorio en el que se almacenan los archivos de proyecto.
  2. Seleccione el separador Usuario, abra la vista de JSON y a continuación añada el siguiente objeto JSON a los Valores de usuario para especificar la vía de acceso a la carpeta temporal de Zowe. Puede especificar el valor de folderPath en una vía de acceso de archivo distinta si desea que la carpeta temporal de Zowe se encuentre en una ubicación distinta del directorio /projects.
    "Zowe-Temp-Folder-Location": {
    "folderPath": "/projects"
}

    El editor se guarda automáticamente. Asegúrese de que el JSON no tenga errores de sintaxis y, a continuación, ciérrelo.

  3. Asegúrese de que no haya especificada ninguna carpeta temporal de Zowe en las preferencias del Espacio de trabajo. En el editor de preferencias abierto en el paso 1, seleccione el separador Espacio de trabajo y abra la vista de JSON. Si hay una entrada para Zowe-Temp-Folder-Location en el archivo settings.json del Espacio de trabajo, elimínela para evitar que este valor de espacio de trabajo sustituya el valor del usuario que ha añadido en el paso 2.
Configuración de Git

Si tiene previsto integrar Git en el espacio de trabajo, siga unos pasos adicionales para configurar SSH y Git para que pueda utilizar Git mediante SSH con servidores como GitHub o GitLab. Estos pasos son distintos de los necesarios para VS Code o Eclipse. Para ver los pasos detallados, consulte Control de versiones in la documentación de Red Hat CodeReady Workspaces.

Referencia: Preferencias del usuario frente a preferencias del espacio de trabajo

En el panel del editor, se muestra una lista de grupos de preferencias, junto con las pestañas del editor correspondiente a las Preferencias de usuario, de espacio de trabajo y de carpeta. Conmute estas pestañas para decidir en qué ámbito desea añadir una preferencia. Las preferencias de espacio de trabajo reemplazan las preferencias de usuario.

Preferencias de usuario
Las preferencias de usuario se aplican al usuario actual en diferentes espacios de trabajo. Las preferencias de usuario no solo incluyen las preferencias de usuario típicas relacionadas con la accesibilidad, tales como los tamaños de font y el comportamiento del editor para la terminación de código, sino que también incluyen información de conexión del host de z/OS. Estos valores no se comparten con otros usuarios. Se almacenan en el contenedor Theia en la vía de acceso /home/theia/.theia/settings.json.
Preferencias del espacio de trabajo
Las preferencias de espacio de trabajo se aplican al espacio de trabajo actual y se almacenan dentro del archivo .theia/settings.json en la raíz de ese espacio de trabajo. Aquí, puede establecer las preferencias que deben aplicarse independientemente de quién realice las ediciones, tales como el tamaño de tabulación y los nombres de vías de acceso para los archivos de inclusión y otras preferencias. A diferencia de VS Code, estos valores del espacio de trabajo no se almacenan automáticamente como parte del proyecto en Git, aunque puede configurarlos como se describe en Compartir valores del espacio de trabajo.
Compartir valores del espacio de trabajo
Como se ha descrito anteriormente, la forma predeterminada de Wazi Developer for Workspaces para almacenar los valores del espacio de trabajo se encuentra en una carpeta .theia un nivel por encima del repositorio de código (o repositorios, si está trabajando con varios proyectos). Dado que la carpeta no está ubicada en el repositorio, los valores del espacio de trabajo no se comparten automáticamente como parte del repositorio. No obstante, si el equipo desea compartir los valores del espacio de trabajo como parte del repositorio, puede hacerlo colocando .theia/settings.json en el nivel más alto de la carpeta del repositorio.
A continuación, para que se apliquen estos valores cuando trabaja con este repositorio, debe abrir un espacio de trabajo con la carpeta de repositorio como la carpeta de espacio de trabajo de nivel superior siguiendo estos pasos:
  1. En un espacio de trabajo predeterminado, seleccione Archivo > Abrir espacio de trabajo....
  2. En el diálogo Abrir espacio de trabajo, vaya a la carpeta del repositorio, selecciónela y pulse Abrir.
Se abrirá una nueva pestaña del navegador con un espacio de trabajo que tiene la carpeta de repositorio como la carpeta de nivel superior del espacio de trabajo. Ahora, en este espacio de trabajo podrá utilizar los valores del espacio de trabajo que se almacenan en la carpeta del repositorio.
Nota:
  • Las preferencias de carpeta no funcionan como se esperaba en Wazi Developer 1.4.0 debido a un defecto en Eclipse Che. Por lo tanto, debe utilizar las preferencias de usuario o de espacio de trabajo.
  • Las preferencias de espacio de trabajo también han cambiado su ámbito desde el release anterior. Las preferencias de espacio de trabajo se aplican ahora a todas las carpetas del directorio del espacio de trabajo actual. El directorio de espacio de trabajo predeterminado es /projects. Dentro de ese directorio de proyecto, puede utilizar las preferencias de carpeta para modificar los valores de cada subcarpeta, lo cual actualmente no funcionan como se esperaba.
  • Por lo general, se recomienda definir estos valores de espacio de trabajo en el archivo devfile, ya que el cambio en un espacio de trabajo en ejecución no es permanente.