Konsola CLC obsługuje szyfrowanie plików wejściowych, które zawierają dane poufne, takie jak hasła.
Format:
java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd encrypt "input file path"
Przegląd interfejsu Używanie konsoli wiersza polecenia (CLC)
Szyfrowane pliki wejściowe są przechowywane w lokalizacji określonej przez parametr"encrypted output file path". Jeśli plik już istnieje w tej lokalizacji, zostanie zastąpiony.
Przykład:
java -jar gaxclc.jar -u:default -p:password spd -encrypted "c:\GAX\input.txt" "c:\GAX\
encrypted.txt"
java -jar gaxclc.jar -u:default -p:password spd -encrypted "input.txt" "encrypted.txt"
• "input file"— określa plik wejściowy zawierający parametry definicji SPD. Jeśli flaga-encryptedjest ustawiona, plik wejściowy jest szyfrowany.
Plik wejściowy musi mieć format JSONObject i zawierać parametry definicji SPD dotyczące konkretnego profilu. Plik musi być zakodowany w formacie UTF-8.
[+] Pokaż składnię
Typ STRING
Poniżej opisano strukturę wejściową typu string (ciąg znaków):
{
"Dialog name" : {
"Input name" : "string"
}
<input name="NAME_PARAM1" title="PERSON NAME" default="birit" type="string"
required="true">
<description>Please enter the person name</description>
</input>
</dialog>
<dialog step="Step2">
<input name="NAME_PARAM2" title="PERSON NAME" default="birit" type="string"
required="true">
<description>Please enter the person name</description>
</input>
Przegląd interfejsu Używanie konsoli wiersza polecenia (CLC)
Plik wejściowy na potrzeby profilu instalacji
Poniżej opisano strukturę wejściową typu boolean (typ logiczny):
{
"Dialog name" : {
"Input name" : true/false }
<input name="STATUS" title="status" type="boolean" required="true">
<description>status field</description>
Plik wejściowy na potrzeby profilu instalacji
{
"Step1" : {
"STATUS" : true }
}
Przegląd interfejsu Używanie konsoli wiersza polecenia (CLC)
Typ INTEGER
Poniżej opisano strukturę wejściową typu integer (liczba całkowita):
{
"Dialog name" : {
"Input name" : <integer>
}
<input name="NUMBER" title="number" type="integer" required="true">
<description>number field</description>
Plik wejściowy na potrzeby profilu instalacji
{
Poniżej opisano strukturę wejściową typu password (hasło):
{
"Dialog name" : {
"Input name" : "password"
} }
Przegląd interfejsu Używanie konsoli wiersza polecenia (CLC)
Ważne
Pliki wejściowe zawierające dane poufne, takie jak hasła, powinny być szyfrowane przy użyciu operacji szyfrowania definicji SPD.
Przykład
Profil definicji SPD
<profile name="Install">
<dialog step="Step1">
<input name="PASSWORD" title="password" type="password" required="true">
<description>password field</description>
Plik wejściowy na potrzeby profilu instalacji
{
Poniżej opisano strukturę wejściową typu selectOne (wybór jednokrotny) ze znacznikiem
<objectselect>:
{
"Dialog name" : {
"Input name" : {
"objectselect" : {
"filter" : [{
"value" : "filter value",
"name" : "filter name"
} ]
} }
Przegląd interfejsu Używanie konsoli wiersza polecenia (CLC)
Ważne
Konsola CLC nakłada na siebie (operator logiczny AND) filtry zdefiniowane w pliku definicji SPD oraz pliku wejściowym dla typu selectOne. Kryteria filtrowania powinny być inne w pliku wejściowym definicji SPD, a nazwy filtrów w obrębie tej samej definicji filtru powinny się różnić.
Przykład
Profil definicji SPD
<profile name="Install">
<dialog step="Step1">
<input name="APP_OBJ_SELECT_ONE" title="Application Name" hidden="false"
type="selectOne" default="">
log('test select one' );
</script>
</execution>
Plik wejściowy na potrzeby profilu instalacji
{
"name" : "name"
}
Przegląd interfejsu Używanie konsoli wiersza polecenia (CLC)
Poniżej opisano strukturę wejściową typu selectMultiple (wybór wielokrotny) ze znacznikiem
<objectselect>:
{
"Dialog name" : {
"Input name" : {
"objectselect" : {
"filter" : [{
"value" : "filter value",
"name" : "filter name"
}
Filtry zdefiniowane w pliku wejściowym definicji SPD są łączone (operator logiczny OR) lub nakładane na siebie (operator logiczny AND) z filtrami zdefiniowanymi w pliku wejściowym dla typu
selectMultiple.
Przykład
Profil definicji SPD
<profile name="Install">
<dialog step="Step1">
<input name="APP_OBJ_SELECT_MULTIPLE" title="Application Name" hidden="false"
type="selectMultiple" default="">
log('test select multiple' );
</script>
</execution>
Plik wejściowy na potrzeby profilu instalacji
{
"Step1" : {
"APP_OBJ_SELECT_MULTIPLE" : {
"objectselect" : {
"filter" : [{
Przegląd interfejsu Używanie konsoli wiersza polecenia (CLC)
"value" : "SIP_lrm27",
"name" : "name"
}
Operacja zwraca dwie aplikacje o nazwach SIP_lrm26 i SIP_lrm27.
Typ SELECTONE
|Poniżej opisano strukturę wejściową typu selectOne/selectMultiple/boolean ze znacznikiem
<selection>:
{
"Dialog name" : {
"Input name" : {
"selection" : {
"option" : [{
"value" : "option value assigned to the input parameter",
"name" : "option name is displayed in UI"
}
Konsola CLC wybiera opcje zdefiniowane w pliku wejściowym definicji SPD. Wiele opcji można określić tylko dla typu wejścia selectMultiple.
Przykład
Profil definicji SPD
<profile name="Install">
<dialog step="Application Parameters">
<input name="DATA_MODEL" title="Binary Version (32-bit or 64-bit)" default="64"
type="selectOne" required="true">
<description>This parameter defines the 32-bit or the 64-bit version of the binary to be deployed. </description>
<selection>
Przegląd interfejsu Używanie konsoli wiersza polecenia (CLC)
</execution>
Plik wejściowy na potrzeby profilu instalacji
{
"Application Parameters" : {
"DATA_MODEL" : {
"selection" : {
"option" : [{
"value" : "64",
"name" : "64"
}
• Jeśli w pliku wejściowym nie określono wartości parametru SPD, zostanie użyta wartość zdefiniowana atrybutem default elementu wejściowego.
• Jeśli w elemencie wejściowym SPD atrybut required jest ustawiony natrue, ale odpowiednia wartość wejściowa nie znajduje się ani w definicji SPD (domyślnie), ani w pliku wejściowym, wykonywanie definicji SPD kończy się niepowodzeniem.
• Jeśli w elemencie wejściowym SPD atrybut readonly jest ustawiony natrue, wtedy podczas wykonywania jest używana wartość atrybutu default (pod warunkiem że ją zdefiniowano). Jeśli atrybut readonly jest ustawiony na true, atrybut required na false, a atrybut default nie został określony, do wyznaczenia wartości wejściowej jest stosowany następujący algorytm:
1. W przypadku typu wejściowego boolean wartość wejściowa jest ustawiana nafalse.
2. W przypadku typów wejściowych string i password wartość wejściowa jest ustawiana na"".
3. W przypadku typu wejściowego integer wejście nie jest propagowane.
• Jeśli wartość atrybutu cond okna dialogowego jest obliczana jako false, okno dialogowe jest pomijane przez narzędzie CLC. Przykład:
<dialog step="Role input" cond="false">
<input name="ROLE" title="Role" hidden="false" type="selectOne"
required="true">
<description>Please indicate the role</description>
<objectselect>
<filter value="CfgRole" name="type"/>
Przegląd interfejsu Używanie konsoli wiersza polecenia (CLC)
</input>
</dialog>
Przykład
java -jar gaxclc.jar -u:default -p:password -s -h:localhost:8080 spd execute 10054 -profileID:1 "C:/GAX/input.txt"
java -jar gaxclc.jar -u:default -p:password -h:localhost:8080 spd execute 10054 -profileName:"Install profile" "C:/GAX/input.txt"
java -jar gaxclc.jar -u:default -p:password -s -h:localhost:8080 spd execute 10054 1 -encrypted "C:/GAX/encryptedinput.txt"