Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

XML Request

JSON Request


content

/content

description

/description

sysId

/sysId

text

/text

title

/title

opswiseGroups

/opswiseGroups

resolveVariables

/resolveVariables

scriptName

/scriptName

scriptType

/scriptType

sysId

/sysId
<script retainSysIds="true">
	<content>echo %*</content>
	<description>description</description>
        <notes>
              <note>
                    <sysId>a8756a120a00010357097d05fa5c558e</sysId>
                    <text>test</text>
                    <title>note 1</title>
              </note>
        </notes>
	<opswiseGroups>
              <opswiseGroup>1</opswiseGroup>
              <opswiseGroup>2</opswiseGroup>
	</opswiseGroups>
	<resolveVariables>false</resolveVariables>
	<scriptName>test.bat</scriptName>
	<scriptType>Script</scriptType>
	<sysId>f8756a120a00010357097d05fa5c558e</sysId>
</script>
Expand
titleXML Request
Panel



content

description

sysId

text

title

opswiseGroups

resolveVariables

scriptName

scriptType

sysId
{
  "content": "echo", 
  "description": "description",
  "notes": [ {
    "sysId": "a8756a120a00010357097d05fa5c558e",
    "text": "test",
    "title": "note"
  } ],
  "opswiseGroups": ["1","2"],
  "resolveVariables": false,
  "retainSysIds": true,
  "scriptName": "test.bat",
  "scriptType": "Script",
  "sysId": "f8756a120a00010357097d05fa5c558e"
}


Expand
titleJSON Request
Panel


Anchor
Create a Script Script Properties
Create a Script Script Properties
Create a Script: Script Properties

Property

UI Field Name

Description

Specifications

Required

Anchor
content - SCR
content - SCR
content

Content

Content of the script or SAP definition file.


Y

Anchor
description - SCR
description - SCR
description

Description

User-defined; description of this record.


N

Anchor
excludeRelated - SCR
excludeRelated - SCR
excludeRelated

n/a

Specification for whether or not to exclude related records (Notes) from an update, even if they are provided in the request.

Valid values: true/false (default is false).

N

Anchor
exportReleaseLevel - SCR
exportReleaseLevel - SCR
exportReleaseLevel

n/a

Universal Controller release that the record was exported from.

read onlyN

Anchor
exportTable - SCR
exportTable - SCR
exportTable

n/aRecord table information.read onlyN

Anchor
opswiseGroups - SCR
opswiseGroups - SCR
opswisewGroups

Member of Business Services

Business Services that this record belongs to.
 
XML

Panel
<opswiseGroups>
      <opswiseGroup>group1</opswiseGroup>
      <opswiseGroup>group2</opswiseGroup>
</opswiseGroups>

 
JSON

Panel
"opswiseGroups": ["group1","group2"]



N

Anchor
resolveVariables - SCR
resolveVariables - SCR
resolveVariables

Resolve UAC Variables

Controls whether or not the Script will be parsed in pursuit of Universal Controller variables. It allows the Controller to avoid the overhead of parsing a Script that does not contain variables.


N

Anchor
retainSysIds - SCR
retainSysIds - SCR
retainSysIds

n/a

Specification for whether or not the Create a Script web service will persist the sysId property.

  • If retainSysIds="true" and sysId is included in the request/response, sysId will be persisted to the database.
  • If retainSysIds="false" and sysId is included in the request/response, sysId will be ignored; it will be autogenerated by the Controller.
Note
titleNote

In XML web services, retainSysIds is specified as an attribute in the <script> element.


Valid values: true/false (default is true).

N

Anchor
scriptName - SCR
scriptName - SCR
scriptName

Script Name

Name of the script.

This name can be the same as the name of the script file.
 
You also can specify a file extension; the default file extension for Windows is .bat.
 
If the name has the extension .ps1, Windows will run the script as a powershell script.
 
You may have to create the appropriate file association and security for this to work.

Y

Anchor
scriptType - SCR
scriptType - SCR
scriptType

Script Type

Type of Script

Valid Values:

  • As String = Script, As Value = 1 (for use in Windows or Linux/Unix tasks)
  • As String = SAP Definition, As Value = 2 (for use in SAP tasks)
  • As String = UDM Script, As Value = 3 (for use in UDM File Transfer tasks)
  • As String = Web Service Payload, As Value = 4 (for use in Web Service tasks)
  • As String = Data, As Value = 5 (for use in a script or task)

Default is Script (1).

N

Anchor
sysId - SCR
sysId - SCR
sysId

n/a

System ID field in the database for this Script record.

Persisted only if retainSysIds is set to true.

N

...


Description

URI

http://host_name/uc/resources/script/list

HTTP Method

GET

Description

Retrieves information on all Scripts.

Example URI

http://localhost:8080/uc/resources/script/list

Authentication

HTTP Basic

Consumes Content-Type

n/a

Produces Content-Type

application/xml, application/json

Example Response

See List Scripts: Example Response, below.

Script Properties

See Create a Script: Script Properties.

Notes Properties

See Create a Script: Notes Properties.

...

List Scripts: Example

...

XML Response

...

Response


content

/content

description

/description

sysId

/sysId

text

/text

title

/title

opswiseGroups

/opswiseGroups

resolveVariables

/resolveVariables

scriptName

/scriptName

scriptType

/scriptType

sysId

/sysId

content

/content

description

/description

sysId

/sysId

text

/text

title

/title

opswiseGroups

/opswiseGroups

resolveVariables

/resolveVariables

scriptName

/scriptName

scriptType

/scriptType

sysId

/sysId
<scripts>
    <script exportReleaseLevel="7.2.0.0" exportTable="ops_script" version="2">
	<content>echo %*</content>
	<description>description</description>
        <notes>
              <note>
                    <sysId>a8756a120a00010357097d05fa5c558e</sysId>
                    <text>test</text>
                    <title>note 1</title>
              </note>
        </notes>
	<opswiseGroups>
              <opswiseGroup>group1</opswiseGroup>
              <opswiseGroup>group2</opswiseGroup>
	</opswiseGroups>
	<resolveVariables>false</resolveVariables>
	<scriptName>test.bat</scriptName>
	<scriptType>Script</scriptType>
	<sysId>f8756a120a00010357097d05fa5c558e</sysId>
    </script>
    <script exportReleaseLevel="7.2.0.0" exportTable="ops_script" version="3">
	<content>echo ?*</content>
	<description>description</description>
        <notes>
              <note>
                    <sysId>a8756a120a00010357097d05fa5c558f</sysId>
                    <text>test</text>
                    <title>note 1</title>
              </note>
        </notes>
	<opswiseGroups>
              <opswiseGroup>group1</opswiseGroup>
              <opswiseGroup>group2</opswiseGroup>
	</opswiseGroups>
	<resolveVariables>false</resolveVariables>
	<scriptName>test2.bat</scriptName>
	<scriptType>Script</scriptType>
	<sysId>f8756a120a00010357097d05fa5c558f</sysId>
    </script>
</scripts>


Expand
titleXML Response
Panel



content

description

sysId

text

title

opswiseGroups

resolveVariables

scriptName

scriptType

sysId

content

description

sysId

text

title

opswiseGroups

resolveVariables

scriptName

scriptType

sysId
[
  {
  "content": "echo", 
  "description": "description",
"exportReleaseLevel": "7.2.0.0",
"exportTable": "ops_script", "notes": [ { "sysId": "a8756a120a00010357097d05fa5c558e", "text": "test", "title": "note" } ], "opswiseGroups": ["group1","group2"], "resolveVariables": false, "scriptName": "test.bat", "scriptType": "Script", "sysId": "f8756a120a00010357097d05fa5c558e", "version": 2 }, { "content": "echo", "description": "description",
"exportReleaseLevel": "7.2.0.0",
"exportTable": "ops_script", "notes": [ { "sysId": "a8756a120a00010357097d05fa5c558f", "text": "test", "title": "note" } ], "opswiseGroups": ["group1","group2"], "resolveVariables": false, "scriptName": "test2.bat", "scriptType": "Script", "sysId": "f8756a120a00010357097d05fa5c558f", "version": 3 } ]
Expand
titleJSON Response


Panel



Anchor
Modify a Script
Modify a Script
Modify a Script

...

XML Request

JSON Request


content

/content

description

/description

sysId

/sysId

text

/text

title

/title

opswiseGroups

/opswiseGroups

resolveVariables

/resolveVariables

scriptName

/scriptName

scriptType

/scriptType

sysId

/sysId
<script retainSysIds="true">
	<content>echo %*</content>
	<description>description</description>
        <notes>
              <note>
                    <sysId>a8756a120a00010357097d05fa5c558e</sysId>
                    <text>test</text>
                    <title>note 1</title>
              </note>
        </notes>
	<opswiseGroups>
              <opswiseGroup>1</opswiseGroup>
              <opswiseGroup>2</opswiseGroup>
	</opswiseGroups>
	<resolveVariables>false</resolveVariables>
	<scriptName>test.bat</scriptName>
	<scriptType>Script</scriptType>
	<sysId>f8756a120a00010357097d05fa5c558e</sysId>
</script>


Expand
titleXML Request
Panel



content

description

sysId

text

title

opswiseGroups

resolveVariables

scriptName

scriptType

sysId
{
  "content": "echo", 
  "description": "description",
  "notes": [ {
    "sysId": "a8756a120a00010357097d05fa5c558e",
    "text": "test",
    "title": "note"
  } ],
  "opswiseGroups": ["1","2"],
  "resolveVariables": false,
  "retainSysIds": true,
  "scriptName": "test.bat",
  "scriptType": "Script",
  "sysId": "f8756a120a00010357097d05fa5c558e"
}


Expand
titleJSON Request
Panel


Anchor
Read a Script
Read a Script
Read a Script

...

Parameter

Description

Specifications

Required

Mutually Exclusive With

scriptid

ID used within the Controller to identify this Script.

String; URI parameter.

Y
(unless scriptname
is specified)

scriptname

scriptname

Name used within the Controller to identify this Script.

String; URI parameter.

Y
(unless scriptid
is specified)

scriptid

...

Read a Script: Example

...

Response

JSON Response


content

/content

description

/description

sysId

/sysId

text

/text

title

/title

opswiseGroups

/opswiseGroups

resolveVariables

/resolveVariables

scriptName

/scriptName

scriptType

/scriptType

sysId

/sysId
<script exportReleaseLevel="7.2.0.0" exportTable="ops_script" retainSysIds="true" version="1">
	<content>echo %*</content>
	<description>description</description>
        <notes>
              <note>
                    <sysId>a8756a120a00010357097d05fa5c558e</sysId>
                    <text>test</text>
                    <title>note 1</title>
              </note>
        </notes>
	<opswiseGroups>
              <opswiseGroup>group1</opswiseGroup>
              <opswiseGroup>group2</opswiseGroup>
	</opswiseGroups>
	<resolveVariables>false</resolveVariables>
	<scriptName>test.bat</scriptName>
	<scriptType>Script</scriptType>
	<sysId>f8756a120a00010357097d05fa5c558e</sysId>
</script>


Expand
titleXML Response
Panel


...

{
  "content": "echo", 
  "description": "description",
"exportReleaseLevel": "7.2.0.0",
"exportTable": "ops_script", "notes": [ { "sysId": "a8756a120a00010357097d05fa5c558e", "text": "test", "title": "note" } ], "opswiseGroups": ["group1","group2"], "resolvableVariables": false, "retainSysIds": true, "scriptName": "test.bat", "scriptType": "Script", "sysId": "f8756a120a00010357097d05fa5c558e", "version": 2 }