Skip to main content
OnCommand Workflow Automation 5.1
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Pautas para las variables

Colaboradores
PDF

Debe tener en cuenta las directrices para PowerShell y las variables Perl de OnCommand Workflow Automation (WFA) cuando cree un comando o un tipo de origen de datos.

Variables de PowerShell

Directrices Ejemplo

Para parámetros de entrada de script:

  • Utilice la caja Pascal.

  • No utilice guiones bajos.

  • No utilice abreviaturas.

$VolumeName

$AutoDeleteOptions

$Size

Para variables internas de script:

  • Utilice la funda Camel.

  • No utilice guiones bajos.

  • No utilice abreviaturas.

$newVolume

$qtreeName

$time

Para funciones:

  • Utilice la caja Pascal.

  • No utilice guiones bajos.

  • No utilice abreviaturas.

GetVolumeSize

Los nombres de variables no distinguen entre mayúsculas y minúsculas. Sin embargo, para mejorar la legibilidad, no debe utilizar mayúsculas diferente para el mismo nombre.

$variable es igual que $Variable.

Los nombres de variables deben estar en inglés sin formato y deben estar relacionados con la funcionalidad del script.

Uso $name y no $a.

Declare explícitamente el tipo de datos de cada variable.

[cadena]nombre

tamaño [int]

No utilice caracteres especiales (! @ # & % , .) y espacios de aplicaciones.

Ninguno

No utilice palabras clave reservadas de PowerShell.

Ninguno

Agrupe los parámetros de entrada colocando primero los parámetros obligatorios seguidos de los parámetros opcionales.

 
param(
[parameter(Mandatory=$true)]
[string]$Type,

[parameter(Mandatory=$true)]
[string]$Ip,

[parameter(Mandatory=$false)]
[string]$VolumeName
)

Comentar todas las variables de entrada mediante HelpMessage anotación con un mensaje de ayuda significativo.

 
[parameter(Mandatory=$false,HelpMessage="LUN to map")]
[string]$LUNName

No utilice «'Archivador'» como nombre de variable; utilice «'Array'» en su lugar.

Ninguno

Uso ValidateSet anotación en los casos en los que el argumento obtiene valores enumerados. Esto se traduce automáticamente al tipo de datos Enum para el parámetro.

 
[parameter(Mandatory=$false,HelpMessage="Volume state")]
[ValidateSet("online","offline","restricted")]
[string]$State

Agregue un alias a un parámetro que termine con "'_Capacity'" para indicar que el parámetro es de tipo capacidad.

El comando «'Create Volume'» utiliza alias de la siguiente forma:

[parameter(Mandatory=$false,HelpMessage="Volume increment size in MB")]
[Alias("AutosizeIncrementSize_Capacity")]
[int]$AutosizeIncrementSize

Agregue un alias a un parámetro que termine con "'_Password'" para indicar que el parámetro es de tipo de contraseña.

 
param (
  [parameter(Mandatory=$false, HelpMessage="In order to create an Active Directory machine account for the CIFS server or setup CIFS service for Storage Virtual Machine, you must supply the password of a Windows account with sufficient privileges")]  [Alias("Pwd_Password")]  [string]$ADAdminPassword
)

Variables Perl

Directrices Ejemplo

Para parámetros de entrada de script:

  • Utilice la caja Pascal.

  • No utilice guiones bajos.

  • No utilice abreviaturas.

$VolumeName

$AutoDeleteOptions

$Size

No utilice abreviaturas para las variables internas del script.

$new_volume

$qtree_name

$time

No utilice abreviaturas para las funciones.

get_volume_size

Los nombres de variables distinguen mayúsculas de minúsculas. Para mejorar la legibilidad, no debe utilizar mayúsculas diferente para el mismo nombre.

$variable no es lo mismo que $Variable.

Los nombres de variables deben estar en inglés sin formato y deben estar relacionados con la funcionalidad del script.

Uso $name y no $a.

Agrupe los parámetros de entrada colocando primero los parámetros obligatorios, seguidos de los parámetros opcionales.

Ninguno

En la función GetOptions, declare explícitamente el tipo de datos de cada variable para los parámetros de entrada.

 
GetOptions(
	"Name=s"=>\$Name,
	"Size=i"=>\$Size
)

No utilice «'Archivador'» como nombre de variable; utilice «'Array'» en su lugar.

Ninguno

Perl no incluye la ValidateSet anotación para valores enumerados. Utilice declaraciones explícitas «'if'» para casos en los que el argumento obtenga valores enumerados.

 
if
(defined$SpaceGuarantee&&!($SpaceGuaranteeeq'none'

$SpaceGuaranteeeq'volume'

$SpaceGuaranteeeq'file')) { die'Illegal SpaceGuarantee argument: \''.$SpaceGuarantee.'\''; } ----

Todos los comandos Perl WFA deben utilizar el pragma "strict" para desalentar el uso de construcciones inseguras para variables, referencias y subrutinas.

 
use strict;
# the above is equivalent to
use strictvars;
use strictsubs;
use strictrefs;

Todos los comandos Perl de WFA deben utilizar los siguientes módulos Perl:

  • Getopt

    Se utiliza para especificar parámetros de entrada.

  • WFAUtil

    Esto se utiliza para las funciones de utilidad que se proporcionan para el registro de comandos, la generación de informes sobre el progreso de comandos, la conexión con las controladoras de la cabina, etc.

 
use Getopt::Long;
use NaServer;
use WFAUtil;