Guía de usuario de creación de tarefas de fluxo de traballo personalizadas de cisco

Cisco UCS Director Orchestrator ofrece unha lista de tipos de entrada ben definidos para tarefas personalizadas. Cisco UCS Director tamén permítelle crear unha entrada de fluxo de traballo personalizada para unha tarefa de fluxo de traballo personalizada. Podes crear un novo tipo de entrada clonando e modificando un tipo de entrada existente.

Requisitos previos

Antes de escribir tarefas personalizadas, debes cumprir os seguintes requisitos previos:

Cisco UCS Director está instalado e en execución no seu sistema. Para obter máis información sobre como instalar Cisco UCS Director, consulte a Guía de instalación e configuración de Cisco UCS Director.
Tes un inicio de sesión con privilexios de administrador. Debes usar este inicio de sesión cando crees e modifiques tarefas personalizadas.

Debes ter o permiso de escritura de CloupiaScript para escribir unha tarefa personalizada usando CloupiaScript.
Debes ter o permiso de execución de CloupiaScript para executar unha tarefa personalizada creada mediante CloupiaScript.

Creación dunha entrada de fluxo de traballo personalizada

Podes crear unha entrada personalizada para unha tarefa de fluxo de traballo personalizada. A entrada móstrase na lista de tipos de entrada que pode asignar a entradas de tarefas personalizadas cando crea unha tarefa de fluxo de traballo personalizada.

Paso 1 Escolla Orquestración.

Paso 2 Faga clic en Entradas de fluxo de traballo personalizadas.
Paso 3 Fai clic en Engadir.

Paso 4 Na pantalla Engadir entrada de fluxo de traballo personalizado, complete os seguintes campos:
- Nome do tipo de entrada personalizado: un nome único para o tipo de entrada personalizado.
- Tipo de entrada: marque un tipo de entrada e faga clic en Seleccionar. En función da entrada seleccionada, aparecen outros campos. Por example, cando escolle Enderezo de correo electrónico como tipo de entrada, aparece unha lista de valores (LOV). Use os novos campos para limitar os valores da entrada personalizada.
Paso 5 Fai clic en Enviar.

A entrada de fluxo de traballo personalizado engádese a Cisco UCS Director e está dispoñible na lista de tipos de entrada.

Validación de entrada personalizada

É posible que os clientes necesiten validar as entradas do fluxo de traballo mediante recursos externos. Fóra da caixa, Cisco UCS Director non pode satisfacer as necesidades de validación de todos os clientes. Para cubrir este oco, Cisco UCS Director ofrece unha opción para validar calquera entrada en tempo de execución mediante un script proporcionado polo cliente. O script pode marcar erros na entrada e pode requirir unha entrada válida antes de executar unha solicitude de servizo. O script pódese escribir en calquera idioma, pode acceder a calquera recurso externo e ten acceso a todos os valores de entrada do fluxo de traballo.
Podes escribir scripts de validación personalizados usando JavaScript, Python, un script de shell bash ou calquera outra linguaxe de script.

Os seguintes exampOs scripts de validación de ficheiros pódense atopar en Cisco UCS Director en Orquestration > Custom Workflow Inputs:

Example-bash-script-validator

Example-javascript-validator
Example-python-validator

Podes copiar ou clonar o exampentradas de fluxo de traballo con script para crear unha nova entrada validada. Tamén podes usar o exampas entradas do fluxo de traballo con script como guía para desenvolver os seus propios scripts.

Independentemente da linguaxe de script, as seguintes funcións e regras aplícanse á validación de entrada personalizada por script:

Toda a validación por secuencias de comandos execútase nun proceso separado, de modo que un proceso de validación que falle non afecte ao proceso de Cisco UCS Director.
Só se poden validar as entradas de texto xenéricas mediante scripts.

Os scripts de validación execútanse un a un, en secuencia, na mesma orde na que aparecen as entradas na páxina de entradas do fluxo de traballo. Iníciase un proceso separado para cada entrada validada.
Un valor de retorno distinto de cero do script indica un fallo de validación. Opcionalmente, pode devolver unha mensaxe de erro ao formulario de entrada do fluxo de traballo.

Todas as entradas do fluxo de traballo pásanse ao script de validación de dúas formas:
- Como argumentos para o script na forma "key"="valor".
- Como variables de ambiente para o proceso de guión. Os nomes das variables son as etiquetas de entrada.
  Por exampse o fluxo de traballo ten unha entrada etiquetada como Product-Code e o valor de entrada é AbC123, a variable pásase ao script validador como "Product-Code"="AbC123".
  Estas variables de entrada poden ser usadas polo script se é necesario para implementar a validación. Excepción: os valores da táboa conteñen só o número de fila da selección da táboa e, polo tanto, probablemente sexan inútiles.
A páxina Editar entrada de fluxo de traballo personalizado fai que o script estea dispoñible no editor de tarefas personalizadas. A sintaxe está resaltada para todos os idiomas. Os erros de sintaxe compróbanse só para validadores de JavaScript.

Clonación dunha entrada de fluxo de traballo personalizada

Pode utilizar unha entrada de fluxo de traballo personalizada existente en Cisco UCS Director para crear unha entrada de fluxo de traballo personalizada.

Antes de comezar
Debe estar dispoñible unha entrada de fluxo de traballo personalizada en Cisco UCS Director.

Paso 1 Escolla Orquestración.
Paso 2 Faga clic en Entradas de fluxo de traballo personalizadas.
Paso 3 Fai clic na fila coa entrada de fluxo de traballo personalizada que queres clonar.
A icona Clonar aparece na parte superior da táboa de entradas de fluxo de traballo personalizado.
Paso 4 Faga clic en Clonar.
Paso 5 Introduza o nome do tipo de entrada personalizado.
Paso 6 Use os outros controis da pantalla Clonar entrada de fluxo de traballo personalizado para personalizar a nova entrada.
Paso 7 Fai clic en Enviar.
A entrada da tarefa de fluxo de traballo personalizado clonase despois da confirmación e está dispoñible para usar na tarefa de fluxo de traballo personalizado.

Creación dunha tarefa personalizada

Para crear unha tarefa personalizada, faga o seguinte:

Paso 1 Escolla Orquestración.
Paso 2 Faga clic en Tarefas de fluxo de traballo personalizado.
Paso 3 Fai clic en Engadir.
Paso 4 Na pantalla Engadir tarefa de fluxo de traballo personalizado, complete os seguintes campos:
- Campo Nome da tarefa: un nome único para a tarefa de fluxo de traballo personalizado.
- Campo Etiqueta de tarefa: unha etiqueta para identificar a tarefa de fluxo de traballo personalizado.
- Campo Rexistrarse baixo a categoría: a categoría de fluxo de traballo na que se debe rexistrar a tarefa de fluxo de traballo personalizado.
- Caixa de verificación Activar tarefa: se está marcada, a tarefa de fluxo de traballo personalizado rexístrase en Orchestrator e pódese utilizar inmediatamente nos fluxos de traballo.
- Campo de descrición breve: unha descrición da tarefa de fluxo de traballo personalizado.
- Campo Descrición detallada: unha descrición detallada da tarefa de fluxo de traballo personalizado.

Paso 5 Faga clic en Seguinte.
Aparece a pantalla de entradas de tarefas personalizadas.
Paso 6 Fai clic en Engadir.
Paso 7 Na pantalla Engadir entrada ás entradas, complete os seguintes campos:
- Campo de nome de campo de entrada: un nome único para o campo. O nome debe comezar con carácter analfabetico e non debe conter espazos nin caracteres especiais.
- Campo de etiqueta de campo de entrada: unha etiqueta para identificar o campo de entrada.
- Lista despregable Tipo de campo de entrada: escolla o tipo de datos do parámetro de entrada.
- Campo Asignar ao tipo de entrada (sen asignación): escolla un tipo de entrada ao que se pode asignar este campo, se este campo se pode asignar desde outra saída de tarefa ou entrada de fluxo de traballo global.
- Caixa de verificación obrigatoria: se está marcada, o usuario debe proporcionar un valor para este campo.
- Campo RBID: introduza a cadea RBID para o campo.
- Lista despregable Tamaño do campo de entrada: escolla o tamaño do campo para entradas de texto e táboas.
- Campo de axuda do campo de entrada—(Opcional) Unha descrición que se mostra cando pasa o rato sobre o campo.
- Campo de anotación do campo de entrada: (Opcional) Texto de indicación para o campo de entrada.
- Campo de nome do grupo de campos: se se especifica, todos os campos con nomes de grupo coincidentes colócanse no grupo de campos.
- Área ATRIBUTOS DO CAMPO DE TEXTO: complete os seguintes campos cando o tipo de campo de entrada sexa texto.
- Caixa de verificación de entrada múltiple: se está marcada, o campo de entrada acepta varios valores en función do tipo de campo de entrada:
- Para un LOV: o campo de entrada acepta varios valores de entrada.
- Para un campo de texto: o campo de entrada pasa a ser un campo de texto de varias liñas.
- Lonxitude máxima do campo de entrada: especifique o número máximo de caracteres que pode introducir no campo de entrada.
- Área ATRIBUTOS LOV: complete os seguintes campos cando o tipo de entrada sexa Lista de valores (LOV) ou LOV cos botóns de radio.
- Campo Lista de valores: unha lista de valores separados por comas para os LOV incorporados.
  Campo Nome do provedor de LOV: o nome do provedor de LOV para os LOV non incorporados.
- Área de ATRIBUTOS DA TÁBOA: complete os seguintes campos cando o tipo de campo de entrada sexa Táboa, Táboa emerxente ou Táboa con caixa de verificación de selección.
- Campo Nome da táboa: un nome do informe tabular para os tipos de campo da táboa.
- Área de VALIDACIÓN DE ENTRADA DE CAMPO: móstranse un ou máis dos seguintes campos dependendo do tipo de datos seleccionado. Complete os campos para especificar como se validan os campos de entrada.
- Lista despregable do validador de entrada: escolla un validador para a entrada do usuario.
- Campo Expresión regular: un patrón de expresión regular para coincidir co valor de entrada.
- Campo Mensaxe de expresión regular: unha mensaxe que se mostra cando falla a validación da expresión regular.
- Campo Valor mínimo: un valor numérico mínimo.
- Campo Valor máximo: un valor numérico máximo.
- Área OCULTAR NO CAMPO CONDICIÓN: complete os seguintes campos para establecer a condición para ocultar o campo nun formulario.
- Ocultar no campo Nome de campo: un nome interno para o campo para que o programa que manexa o formulario poida identificar o campo.
- Ocultar no campo Campo de valor: o valor que se debe enviar unha vez que se envía o formulario.
- Lista despregable Ocultar na condición do campo: escolla unha condición na que se debe ocultar o campo.
- Campo de axuda HTML: as instrucións de axuda para o campo oculto.

Paso 8 Fai clic en Enviar.
A entrada de entrada engádese á táboa.
Paso 9 Faga clic en Engadir para engadir máis entradas ás entradas.
Paso 10 Cando remate de engadir entradas, faga clic en Seguinte.
Aparece a pantalla Saídas de tarefas de fluxo de traballo personalizado.

Paso 11 Fai clic en Engadir.
Paso 12 Na pantalla Engadir entrada ás saídas, complete os seguintes campos:
- Campo de nome de campo de saída —Un nome único para o campo de saída. Debe comezar cun carácter alfabético e non debe conter espazos nin caracteres especiais.
- Campo de descrición do campo de saída: unha descrición do campo de saída.
- Campo de tipo de campo de saída: marque un tipo de saída. Este tipo determina como se pode asignar a saída a outras entradas de tarefas.
Paso 13 Fai clic en Enviar.
A entrada de saída engádese á táboa.

Paso 14 Faga clic en Engadir para engadir máis entradas ás saídas.
Paso 15 Faga clic en Seguinte
Aparece a pantalla Controller
Paso 16 (Opcional) Faga clic en Engadir para engadir un controlador.

Paso 17 Na pantalla Engadir entrada ao controlador, complete os seguintes campos:
- Lista despregable de métodos: escolla un método de clasificación ou descomposición para personalizar as entradas e/ou saídas para a tarefa de fluxo de traballo personalizado. O método pode ser un dos seguintes:
- Antes de Marshall: use este método para engadir ou definir un campo de entrada e crear e configurar dinámicamente o LOV nunha páxina (formulario).
- After Marshall: use este método para ocultar ou mostrar un campo de entrada.
- Antes de Unmarshall: use este método para converter un valor de entrada dun formulario a outro, por exemploample, cando quere cifrar un contrasinal antes de envialo á base de datos.
- Despois de Unmarshall: use este método para validar a entrada do usuario e establecer a mensaxe de erro na páxina.
  Ver ExampLe: Usando controladores, na páxina 14.
- Área de texto do script: para o método que escolleu na lista despregable Método, engada o código para o script de personalización da GUI.
  Nota Fai clic en Engadir se queres engadir código para máis métodos.
  Se hai algunha validación para os contrasinais introducidos, asegúrate de cambiar a validación do controlador para os contrasinais para poder editar as tarefas personalizadas nos fluxos de traballo.
  Nota
Paso 18 Fai clic en Enviar.
O controlador engádese á táboa.
Paso 19 Faga clic en Seguinte.
Aparece a pantalla Script.

Paso 20 Na lista despregable Idioma de execución, escolla un idioma.
Paso 21 No campo Script, introduza o código CloupiaScript para a tarefa de fluxo de traballo personalizado.
O código Cloupia Script validase cando introduce o código. Se hai algún erro no código, móstrase unha icona de erro (cruz vermella) xunto ao número de liña. Pase o rato sobre a icona de erro para view a mensaxe de erro e a solución
Paso 22 Faga clic en Gardar script.

Paso 23 Fai clic en Enviar.
Créase a tarefa de fluxo de traballo personalizado e está dispoñible para usar no fluxo de traballo

Tarefas e repositorios personalizados

Cando crea unha tarefa personalizada, en lugar de escribir o código da tarefa personalizada na xanela do script ou cortar e pegar código dun editor de texto, pode importar o código dun file almacenados nun repositorio de GitHub ou BitBucket. Para facelo, ti:

Crea un ou varios textos files nun repositorio GitHub ou BitBucket, xa sexa en github.com ou nun repositorio GitHub de empresa privada.
Nota Cisco UCS Director só admite GitHub (github.com ou unha instancia de GitHub empresarial) e/ou BitBucket. Non admite outros servizos de hospedaxe de Git, incluídos GitLab, Perforce ou Codebase.

Registre o repositorio en Cisco UCS Director. Consulte Engadir un repositorio de GitHub ou BitBucket en Cisco UCS Director, na páxina 7.
Seleccione o repositorio e especifique o texto file que contén o script de tarefas personalizado. Consulte Descargar código de script de tarefas personalizadas desde un repositorio de GitHub ou BitBucket, na páxina 8.

Engadir un repositorio GitHub ou BitBucket en Cisco UCS Director
Para rexistrar un repositorio de GitHub ou BitBucket en Cisco UCS Director, faga o seguinte:

Antes de comezar
Crea un repositorio GitHub ou BitBucket. O repositorio pode estar en calquera servidor GitHub ou BitBucket, público ou privado, ao que se poida acceder desde o seu Director de Cisco UCS.
Rexistra un ou máis files que conteñen código JavaScript para as súas tarefas personalizadas no seu repositorio.

Paso 1 Seleccione Administración > Integración.
Paso 2 Na páxina de integración, faga clic en Xestionar repositorios.

Paso 3 Fai clic en Engadir.
Paso 4 Na páxina Engadir repositorio, complete os campos obrigatorios, incluídos os seguintes:
- No campo Alcume do repositorio, introduza un nome para identificar o repositorio dentro de Cisco UCS Director.
- No Repositorio URL campo, introduza o URL do repositorio de GitHub ou BitBucket.
- No campo Nome da rama, introduza o nome da rama do repositorio que quere usar. O nome predeterminado é rama principal.
- No campo Usuario do repositorio, introduza o nome de usuario para a súa conta de GitHub ou BitBucket.
- Para engadir o repositorio de GitHub, no campo Contrasinal/Ficha de API, introduza o token de API xerado para o seu GitHub.
  Para xerar o token da API usando GitHub, fai clic en Configuración e vai a Configuración do programador > Tokens de acceso persoal e fai clic en Xerar novo token.
  Para engadir o repositorio de BitBucket, no campo Contrasinal/Token API, introduza o contrasinal do seu BitBucket.
- Para utilizar este repositorio por defecto cando crea unha nova tarefa personalizada, marque Facer deste o meu repositorio predeterminado.
- Para probar se Cisco UCS Director pode acceder ao repositorio, faga clic en Probar conectividade.
  O estado de conectividade co repositorio móstrase nun banner na parte superior da páxina.
  Se non pode conectarse e comunicarse co repositorio de GitHub ou BitBucket de Cisco UCS
  Director, actualice Cisco UCS Director para acceder a Internet a través dun servidor proxy. Consulte a Guía de administración de Cisco UCS Director.
  Nota

Paso 5 Cando estea seguro de que a información do repositorio é correcta, faga clic en Enviar.

Descargando código de script de tarefas personalizadas desde un repositorio de GitHub ou BitBucket

Para crear unha nova tarefa personalizada importando texto dun repositorio de GitHub ou BitBucket, faga o seguinte:

Antes de comezar
Crea un repositorio de GitHub ou BitBucket e rexistra un ou máis textos files que conteñen o código JavaScript para as súas tarefas personalizadas no seu repositorio.

Engade o repositorio de GitHub a Cisco UCS Director. Consulte Engadir un repositorio de GitHub ou BitBucket en Cisco UCS Director, na páxina

Paso 1 Na páxina Orquestración, faga clic en Tarefas de fluxo de traballo personalizadas.

Paso 2 Fai clic en Engadir.
Paso 3 Complete os campos obrigatorios da páxina Información da tarefa personalizada. Consulte Crear unha tarefa personalizada, na páxina 3.
Paso 4 Complete os campos obrigatorios da páxina Entradas de tarefas personalizadas. Consulte Crear unha tarefa personalizada, na páxina 3.

Paso 5 Complete os campos obrigatorios da páxina Saídas de tarefas personalizadas. Consulte Crear unha tarefa personalizada, na páxina 3.
Paso 6 Complete os campos obrigatorios da páxina Controlador. Consulte Creación dunha tarefa personalizada, na páxina 3.
Paso 7 Na páxina Script, complete os campos obrigatorios:
- Na lista despregable Idioma de execución, seleccione JavaScript.
- Marque Usar repositorio para scripts para habilitar a tarefa personalizada para usar un script file desde un repositorio. Isto permítelle seleccionar o repositorio e especificar o script file para usar.
- Na lista despregable Seleccionar repositorio, selecciona o repositorio de GitHub ou BitBucket que contén o script files. Para obter máis información sobre como engadir repositorios, consulte Engadir un repositorio de GitHub ou BitBucket en Cisco UCS Director, na páxina 7.
- Introduza o camiño completo ao script file no Guión filecampo de texto do nome.
- Para descargar o script, fai clic en Cargar script.
  O texto do file cópiase na área de edición de texto do script.
- Opcionalmente, fai cambios no script descargado na área de edición de texto de Script.
- Para gardar o guión tal e como aparece na área de edición de texto do guión, faga clic en Gardar guión.
  Cando preme Gardar script, o script gárdase na súa sesión de traballo actual. Debes facer clic en Enviar para gardar o script na tarefa personalizada que estás editando.
  Nota
Paso 8 Para gardar a tarefa personalizada, faga clic en Enviar.
Se fixo cambios no script descargado na área de edición de texto de Script, os cambios gárdanse na tarefa personalizada. Non se gardan cambios no repositorio de GitHub ou BitBucket. Se desexa descartar o script cargado e introducir o seu propio script, faga clic en Descartar script para borrar a xanela do script.

Que facer a continuación
Podes usar a nova tarefa personalizada nun fluxo de traballo.

Importación de fluxos de traballo, tarefas personalizadas, módulos de script e actividades

Para importar artefactos a Cisco UCS Director, faga o seguinte:

Nota As variables globais asociadas a un fluxo de traballo importaranse mentres se importa un fluxo de traballo se a variable global non está dispoñible na aplicación.

Paso 1 Escolla Orquestración.

Paso 2 Na páxina Orquestración, faga clic en Fluxos de traballo.
Paso 3 Faga clic en Importar.
Paso 4 Na pantalla Importar, faga clic en Seleccionar a File.

Paso 5 No Escolla File para Cargar pantalla, escolla o file para ser importado. Importación e exportación de Cisco UCS Director files teñen un .wfdx file extensión.
Paso 6 Faga clic en Abrir.
Cando o file está cargado, o File A pantalla de carga/validación aparece File listo para usar e clave.
Paso 7 Introduza a clave que se introduciu ao exportar o ficheiro file.

Paso 8 Faga clic en Seguinte.
A pantalla Políticas de importación mostra unha lista de obxectos de Cisco UCS Director contidos no ficheiro cargado file.
Paso 9 (Opcional) Na pantalla Políticas de importación, especifique como se manexan os obxectos se duplican os nomes que xa están no cartafol do fluxo de traballo. Na pantalla Importar, complete os seguintes campos

Nome	Descrición
Fluxos de traballo	Escolla entre as seguintes opcións para especificar como se manexan os fluxos de traballo con nomes idénticos: Substitúe— Substitúe o fluxo de traballo existente polo fluxo de traballo importado. Mantén os dous—Importa o fluxo de traballo como unha nova versión. Saltar—Non importe o fluxo de traballo.
Tarefas personalizadas	Escolla entre as seguintes opcións para especificar como se manexan as tarefas personalizadas con nomes idénticos: Substitúe Mantén os dous Saltar

Nome	Descrición
Módulos de script	Escolla entre as seguintes opcións para especificar como se manexan os módulos de script con nomes idénticos: Substitúe Mantén os dous Saltar
Actividades	Escolla entre as seguintes opcións para especificar como se manexan as actividades con nomes idénticos: Substitúe Mantén os dous Saltar
Importar fluxos de traballo ao cartafol	Check Import Workflows to Folder para importar os fluxos de traballo. Se non marca Importar fluxos de traballo ao cartafol e se non existe unha versión dun fluxo de traballow existe, ese fluxo de traballo non se importa.
Seleccione Cartafol	Escolla un cartafol no que importar os fluxos de traballo. Se escolleches [Novo Cartafol..] na lista despregable, o Novo cartafol aparece campo.
Novo cartafol	Introduza o nome do novo cartafol para crear como cartafol de importación.

Paso 10 Faga clic en Importar.

Exportación de fluxos de traballo, tarefas personalizadas, módulos de script e actividades

Para exportar artefactos de Cisco UCS Director, faga o seguinte:

Nota As variables globais asociadas a un fluxo de traballo exportaranse automaticamente mentres se exporta un fluxo de traballo.

Paso 1 Faga clic en Exportar.
Paso 2 Na pantalla Seleccionar fluxos de traballo, escolla os fluxos de traballo que quere exportar.
Os fluxos de traballo, as tarefas e os scripts personalizados creados en Cisco UCS Director antes da versión 6.6 poden fallar ao importarse se conteñen datos XML.
Nota
Paso 3 Faga clic en Seguinte.
Paso 4 Na pantalla Seleccionar tarefas personalizadas, escolla as tarefas personalizadas que desexa expor
Nota A tarefa personalizada exportada contén todas as entradas personalizadas utilizadas por esa tarefa personalizada.
Paso 5 Faga clic en Seguinte.
Paso 6 Na pantalla Exportar: seleccionar módulos de script, escolla os módulos de script que desexa exportar.
Paso 7 Faga clic en Seguinte.
Paso 8 Na pantalla Exportar: Seleccionar actividades, escolla as actividades que desexa exportar.
Paso 9 Faga clic en Seguinte.
Paso 10 Na pantalla Exportar: seleccione Abrir APIs, seleccione as API que desexa exportar.
Paso 11 Na pantalla Exportar: Confirmación, complete os seguintes campos:

Nome	Descrición
Exportado por	O teu nome ou unha nota sobre quen é o responsable da exportación.
Comentarios	Comentarios sobre esta exportación.
Cifra o exportado file	Comprobe o cifrado exportado file caixa de verificación para cifrar o file para ser exportado. Por defecto, a caixa de verificación está marcada.
Chave	Introduza a clave para cifrar file. Este campo móstrase só cando o Cifrar o exportado file a caixa de verificación está marcada. Conserva a chave tal e como é necesaria mentres importas o fluxo de traballo para descifrar.
Confirmar chave	Introduza a clave de novo para confirmala. Este campo móstrase só cando o Cifrar o exportado file a caixa de verificación está marcada.
Exportouse File Nome	O nome do file no seu sistema local. Escriba só a base filenome; o file a extensión de tipo (.wfdx) engádese automaticamente.

Paso 12 Faga clic en Exportar.
Solicitarase que garde o file.

Clonación dunha tarefa de fluxo de traballo personalizada desde a biblioteca de tarefas

Podes clonar tarefas na biblioteca de tarefas para usalas na creación de tarefas personalizadas. Tamén pode clonar unha tarefa personalizada para crear unha tarefa personalizada.

A tarefa clonada é un marco coas mesmas entradas e saídas da tarefa que a tarefa orixinal. Non obstante, a tarefa clonada é só un marco. Isto significa que debes escribir toda a funcionalidade para a nova tarefa en CloupiaScript.

Teña en conta tamén que os valores de selección para entradas de lista, como listas despregábeis e listas de valores, transfórmanse á tarefa clonada só se os valores da lista non dependen do sistema. As cousas como os nomes e enderezos IP dos sistemas existentes dependen do sistema; cousas como as opcións de configuración admitidas por Cisco UCS Director non o son. Por exampo le, os grupos de usuarios, os nomes de nube e os grupos de portos dependen do sistema; Os roles de usuario, os tipos de nubes e os tipos de grupos de portos non o son.

Paso 1 Escolla Orquestración.
Paso 2 Faga clic en Tarefas de fluxo de traballo personalizado.
Paso 3 Faga clic en Clonar da biblioteca de tarefas.
Paso 4 Na pantalla Clonar da biblioteca de tarefas, marque a fila coa tarefa que desexa clonar.
Paso 5 Faga clic en Seleccionar.
A partir da biblioteca de tarefas créase unha tarefa de fluxo de traballo personalizada. A nova tarefa personalizada é a última tarefa personalizada do informe Tarefas de fluxo de traballo personalizado. A nova tarefa personalizada recibe o nome da tarefa clonada, coa data engadida.
Paso 6 Faga clic en Enviar

Que facer a continuación
Edita a tarefa de fluxo de traballo personalizado para asegurarte de que o nome e a descrición correctos están no lugar da tarefa clonada.

Clonación dunha tarefa de fluxo de traballo personalizada

Pode utilizar unha tarefa de fluxo de traballo personalizada existente en Cisco UCS Director para crear unha tarefa de fluxo de traballo personalizada.

Antes de comezar
Debe estar dispoñible unha tarefa de fluxo de traballo personalizada en Cisco UCS Director.

Paso 1 Escolla Orquestración.
Paso 2 Faga clic en Tarefas de fluxo de traballo personalizado.
Paso 3 Fai clic na fila coa tarefa de fluxo de traballo personalizado que queres clonar.
A icona Clonar aparece na parte superior da táboa de tarefas de fluxo de traballo personalizado.
Paso 4 Faga clic en Clonar.
Paso 5 Na pantalla Clonar tarefa de fluxo de traballo personalizado, actualice os campos obrigatorios.
Paso 6 Faga clic en Seguinte.
Aparecen as entradas definidas para as tarefas de fluxo de traballo personalizado.
Paso 7 Faga clic na fila coa entrada de tarefa que quere editar e prema en Editar para editar as entradas de tarefa.
Paso 8 Faga clic en Engadir para engadir unha entrada de entrada de tarefa.
Paso 9 Faga clic en Seguinte.
Edita as saídas da tarefa.
Paso 10 Faga clic en Engadir para engadir unha nova entrada de saída.
Paso 11 Faga clic en Seguinte.
Paso 12 Edite os scripts do controlador. Consulte Controlar as entradas de tarefas de fluxo de traballo personalizados, na páxina 13.
Paso 13 Faga clic en Seguinte.
Paso 14 Para personalizar a tarefa personalizada, edite o script da tarefa.
Paso 15 Faga clic en Enviar

Control de entradas de tarefas de fluxo de traballo personalizado

Usando controladores
Pode modificar o aspecto e o comportamento das entradas de tarefas personalizadas mediante a interface do controlador dispoñible en Cisco UCS Director.

Cando usar os controladores
Use controladores nos seguintes escenarios:

Para implementar un comportamento complexo de mostrar e ocultar a GUI, incluíndo un control máis fino de listas de valores, listas de valores tabulares e outros controis de entrada que se mostran ao usuario.
Para implementar unha lóxica complexa de validación de entrada de usuario.

Con controladores de entrada podes facer o seguinte:

Mostrar ou ocultar os controis da GUI: pode mostrar ou ocultar de forma dinámica varios campos da GUI, como caixas de verificación, caixas de texto, listas despregábeis e botóns, segundo as condicións. Por exampse un usuario selecciona UCSM dunha lista despregábel, pode solicitar as credenciais de usuario para Cisco UCS Manager ou cambiar a lista de valores (LOV) na lista despregable para mostrar só os portos dispoñibles nun servidor.
Validación de campos de formulario: pode validar os datos introducidos por un usuario ao crear ou editar fluxos de traballo no Workflow Designer. Para os datos non válidos introducidos polo usuario, pódense mostrar erros. Os datos introducidos polo usuario pódense modificar antes de que se conserven na base de datos ou antes de que se conserven nun dispositivo.
Recuperar dinámicamente unha lista de valores: pode obter dinámicamente unha lista de valores dos obxectos de Cisco UCS Director e utilizalos para encher obxectos do formulario da GUI.

Marshalling and Unmarshalling GUI Form Objects
Os controladores están sempre asociados cun formulario na interface de entrada de tarefas do Workflow Designer. Hai unha asignación un a un entre un formulario e un controlador. Os controladores funcionan en dous stages, ordenación e descomposición. Ambos stages teñen dous substages, antes e despois. Para usar un controlador, debes agrupar (controlar os campos do formulario da interface de usuario) e/ou desmarcar (validar as entradas do usuario) os obxectos do formulario da GUI relacionados mediante os scripts do controlador.

A seguinte táboa resume estes stages.

Stage	Sub-stage
Marshalling — Utilízase para ocultar e mostrar campos de formulario e para o control avanzado dos LOV e os LOV tabulares.	antes de Marshall — Úsase para engadir ou definir un campo de entrada e crear e configurar dinámicamente o LOV nunha páxina (formulario). despois de Marshall — Úsase para ocultar ou mostrar un campo de entrada.

Stage	Sub-stage
Descomposición – Úsase para a validación da entrada do usuario do formulario.	antes de Unmarshall — Úsase para converter un valor de entrada dun formulario a outro, por exemploample, para cifrar o contrasinal antes de envialo á base de datos. despois de Unmarshall — Utilízase para validar unha entrada de usuario e establecer a mensaxe de erro na páxina.

Construír scripts de controladores
Os controladores non requiren que se importe ningún paquete adicional.
Non pasa parámetros aos métodos do controlador. No seu lugar, o framework Cisco UCS Director fai que os seguintes parámetros sexan dispoñibles para o seu uso na agrupación e descomposición:

Parámetro	Descrición	Example
Páx	A páxina ou formulario que contén todas as entradas da tarefa. Podes usar este parámetro para facer o seguinte: Obter ou establecer os valores de entrada nun formulario GUI. Mostra ou oculta as entradas nun formulario GUI.	page.setHidden(id + “.portList”, verdadeiro); page.setValue(id + “.status”, “Ningún porto está activo. A lista de portos está oculta”);
id	O identificador único do campo de entrada do formulario. O framework xera un ID e pódese usar co nome do campo de entrada do formulario.	page.setValue(id + “.status”, “Ningún porto está activo. A lista de portos está oculta”);// aquí “estado” é o nome do campo de entrada.
Pojo	POJO (obxecto Java antigo simple) é un bean Java que representa un formulario de entrada. Cada páxina da GUI debe ter un POJO correspondente que conteña os valores do formulario. O POJO úsase para conservar os valores na base de datos ou para enviar os valores a un dispositivo externo.	pojo.setLunSize(asciiValue); //Establece o valor do campo de entrada 'lunSize'

Ver ExampLe: Usando controladores, na páxina 14 para un código de traballo sample que demostra a funcionalidade do controlador.

Example: Usando controladores

O seguinte código example mostra como implementar a funcionalidade do controlador en tarefas de fluxo de traballo personalizadas mediante os distintos métodos: antes de Marshall, despois de Marshall, antes de Unmarshall e despois de Unmarshall.
/*

Descricións do método:
Antes de Marshall: use este método para engadir ou definir un campo de entrada e crear e establecer dinámicamente o LOV nunha páxina (formulario).
Despois de Marshall: use este método para ocultar ou mostrar un campo de entrada.
Antes de UnMarshall: use este método para converter un valor de entrada dun formulario a outro,
por example, cando quere cifrar o contrasinal antes de envialo á base de datos. Despois de UnMarshall: use este método para validar unha entrada de usuario e establecer a mensaxe de erro no
páxina.
*/
//Antes de Marshall:
/*
Use o método beforeMarshall cando se produza un cambio no campo de entrada ou para crear dinámicamente LOV e para establecer o novo campo de entrada no formulario antes de que se cargue.
No exampa continuación, engádese un novo campo de entrada 'portList' na páxina antes de que se mostre o formulario nun navegador.
*/
importPackage(com.cloupia.model.cIM);
importPackage(java.util);
importPackage(java.lang);
var portList = new ArrayList();
var lovLabel = "eth0";
var lovValue = "eth0";
var portListLOV = new Array();
portListLOV[0] = new FormLOVPair (lovLabel, lovValue);//crear o campo de entrada lov
//O parámetro 'page' úsase para establecer o campo de entrada no formulario
page.setEmbeddedLOVs(id + “.portList”, portListLOV);// establece o campo de entrada no formulario =========================== ===================================================== ==================================
//Despois de Marshall:
/*
Use este método para ocultar ou mostrar un campo de entrada.
*/
page.setHidden(id + “.portList”, verdadeiro); //oculta o campo de entrada 'portList'.
page.setValue(id + “.status”, “Ningún porto está activo. A lista de portos está oculta”);
page.setEditable(id + “.status”, false);
===================================================== ===================================================== =========
//Antes de Unmarshall:
/*
Use o método beforeUnMarshall para ler a entrada do usuario e convertela noutro formulario antes de inserila na base de datos. Por example, pode ler o contrasinal e almacenar o contrasinal na base de datos despois de convertelo en codificación base64, ou ler o nome do empregado e convertelo ao ID do empregado cando se envía o nome do empregado á base de datos.
No código example por debaixo do tamaño lun e convértese nun valor ASCII.
*/
importPackage(org.apache.log4j);
importPackage(java.lang);
importPackage(java.util);
var size = page.getValue(id + “.lunSize”);
var logger = Logger.getLogger(“o meu logger”);
if(tamaño!= nulo){
logger.info ("Valor de tamaño "+ tamaño);
if((new java.lang.String(size)).matches(“\\d+”)){ var byteValue = size.getBytes(“US-ASCII”); //converte o tamaño do lun e obtén a matriz de caracteres ASCII

var asciiValueBuilder = new StringBuilder();
para (var i = 0; i < byteValue.length; i++) {
asciiValueBuilder.append(byteValue[i]);
}
var asciiValue = asciiValueBuilder.toString()+” – Ascii
valor"
//id + ".lunSize" é o identificador do campo de entrada
page.setValue(id + “.lunSize”,asciiValue); //o parámetro
'page' úsase para establecer o valor no campo de entrada .
pojo.setLunSize(asciiValue); //define o valor no pojo.
Este pojo enviarase a DB ou dispositivo externo
}
===================================================== ===================================================== =========
// Despois de unMarshall:
/*
Use este método para validar e establecer unha mensaxe de erro.
*/
importPackage(org.apache.log4j);
importPackage(java.lang);
importPackage(java.util);
//var size = pojo.getLunSize();
var size = page.get Value(id + “.lunSize”);
var logger = Logger .get Logger(“o meu logger”);
logger.info ("Valor de tamaño "+ tamaño);
if (tamaño > 50) {//validar o tamaño
páxina. set Erro (id+.lunSize", "O tamaño do LUN non pode ser superior a 50 MB "); //conxunto
a mensaxe de erro na páxina
páxina .set Mensaxe de páxina ("O tamaño do LUN non pode ser superior a 50 MB");
//páxina. establecer o estado da páxina (2);
}

Usando a saída dunha tarefa anterior nun fluxo de traballo

Podes usar a saída dunha tarefa anterior como entrada para outra tarefa nun fluxo de traballo directamente desde o script dunha tarefa personalizada e unha tarefa Executar Script Cloupia da biblioteca de tarefas.
Para acceder a esta saída, pode utilizar unha das seguintes formas:

Recupere a variable do contexto do fluxo de traballo usando o método get Input().
Consulte a saída usando a notación de variables do sistema.

Para recuperar unha saída usando o método context getInput(), use:
var name = ctxt.getInput(“PreviousTaskName.outputFieldName”);

Por exampLe:
var name = ctxt.getInput("tarefa_personalizada1_1684.NAME"); // NAME é o nome da saída task1
campo ao que desexa acceder
Para recuperar unha saída usando a notación de variables do sistema, use:
var name = “${Nome da tarefa anterior. Nome do campo de saída}”;

Por exampLe:
var name = "${custom_task1_1684.NAME}"; // NOME é o nome do campo de saída task1 ao que desexa acceder

Example: Crear e executar unha tarefa personalizada