Video Screencast Help

Get Computer Info

Created: 13 Jun 2012 • Updated: 10 Jul 2013
Language Translations
Collaborators: SymantecWorkflowTeam
SymantecWorkflowTeam's picture
0 0 Votes
Login to vote

Get Computer Info

Component definition

This component gathers information from the local computer and produces a complex data type as an output. This complex data type is called ComputerInfo. This component uses your operating system's API to retrieve data.

Component icon


Description of component output paths

The component output paths are described in the following table:


Property

Description

Unknown

Unknown

Description of component tabs and their properties

The properties on the Outputs tab in the Get Computer Info component are listed and described in the following table:


Property

Description

Computer Info Variable Name

Unknown

The properties on the Settings tab in the Get Computer Info component are listed and described in the following table:


Property

Description

Component Class Name

The class name of this component. This property is not editable, but useful if you call Symantec support.

Description

The description of this component. This property lets you describe how the component is used. You can use it to provide any wanted
documentation for this component.

This description is included in
the model reports that are created when you click Plugins > Generate Business Model.

Location

The physical location of the top left point of this component on the
workflow model.

Name

The name of this component. You can change the name.

If you changed the component name when you double-clicked it on the workflow model, the changed name appears here.

Override Background Color

This property lets you change the background color of this component.

To Do

This property lets you record what you still need to do with the
component. Use this property to help you remember the configuration that you want to apply to this component.

The text that you enter for this property appears at the bottom of the component editor. If you enter text for this property, a checklist symbol appears on the component in the workflow model.

Is Enabled

This property lets you enable or disable the component. By default,
components are enabled. When a component is disabled, it has no
effect on the Project. Uncheck Is Enabled to disable the component.

  • Execution Outcome

    If a component with more than one outcome
    path is disabled, you must select which outcome path you want the component to take. Click the Execution Outcome drop-down list and select the outcome path for the workflow to follow.

  • Disabled Mapping

    If the component has output parameters, you must configure all output parameters with fixed data to pass on. This configuration can be performed in the Disabled Mapping option.

The properties on the Remote Connect tab in the Get Computer Info component are listed and described in the following table:


Property

Description

Remote Host

Unknown

UseImpersonation

Unknown

UserName

Password

Unknown

Description of component information

The following tables describe all the values the GetComputerInfo component produces:

The component output paths are described in the following table:


Value Name

Description

ComputerName

Name of the local computer. String data type.

CurrentTimeZone

Current international time zone of the local computer. Number (integer) data type.

DayLightInEffect

True/false value designating whether day light savings time is currently in effect on the local computer. Logical/boolean data type.

Description

Description of the local computer as found in computer properties. String data type.

Disks

Array of complex data types with values describing the hard disks on the local (or mapped) computer.

These values are described in a separate table.

Domain

Domain to which the local computer is assigned. A computer is either part of a domain or a workgroup. String data type.

IsPartOfDomain

True/false value designating whether the local computer is part of a domain. Logical/boolean data type.

IP address

An array of strings describing the IP addresses currently or formerly assigned to the local computer.

Manufacturer

Name of manufacturer of the local computer. String data type.

Model

The model number of the local computer. String data type.

NumberOfProcessors

Number of processors on the local computer. Number (integer) data type.

OperatingSystem

Name of operating system on the local computer. String type data.

TotalPhysicalMemory

Total number of bytes on all hard disks on the local computer. Number (integer) data type.

Workgroup

Name of workgroup to which the local computer is assigned. A computer is either part of a workgroup or part of a domain. String data type.

Description of component tabs and their properties

The following values pertain to the local computer on which the process is running.

The component output paths are described in the following table:


Value Name

Description

BlockSize

Total number of bytes in a storage block. If no block exists, this value registers 0. Number (integer) data type.

Compressed

True/false variable indicating whether a hard disk has been compressed. Logical/boolean data type.

Description

Description of a hard disk. String data type.

DeviceID

Disk ID on local computer (for example, C:). String data type.

FileSystem

File system a hard disk uses: FAT or NTFS. String data type.

FreeSpace

Total number of bytes available on a hard disk. Number (integer) data type.

Name

Name of a hard disk (for example, C:). May be the same as the DeviceID. String data type.

Size

Total number of bytes (used and unused) on a hard disk. Number (integer) data type.

Status

Status of a hard disk. String data type.

SupportsDiskQuotas

True/false value designating whether a hard disk supports disk quota. Logical/boolean data type.

SupportsFileBasedCompression

True/false value designating whether a hard disk supports file based compression. Logical/boolean data type.

VolumeName

Name of a certain volume, hard disk or otherwise. String data type.

VolumeSerialNumber

Serial number of a volume, hard disk or otherwise. String data type.

Connection information

Not applicable

Component settings

Unknown

Use cases

An example for the Get Computer Info component is as follows:

  • Server information site

    A website displays current information for the local server.

Server information site

Scenario: The network administrator is tired of manually checking and compiling various pieces of information about a given server. Instead, the network administrator wants to be able to go to a website that displays the information.

Process: This process is created as a Forms (Web) Project type.

The following screen shot shows the process:

A GetComputerInfo component begins the process by retrieving data from the local computer. This component gets this data only from the local computer (the computer on which the process is published).

The following screen shot shows the editor for the GetComputerInfo component:

Here we see that the GetComputerInfo component outputs only one variable into the process called ComputerInfo. This variable is a complex data type that you can rename.

Next, a Form Builder component displays the information the GetComputerInfo component gathered.

The following screen shot shows the form at design-time:

Here we see that this form displays seven different values from the variable ComputerInfo. This variable, along with some of its individual values, is displayed on the left side in the Variables panel. Seven of these values have been dragged onto the form to be displayed in the run-time form.

The following screen shot shows the run-time form:

Here we see the actual values as retrieved by the GetComputerInfo component. Any value that the GetComputerInfo component cannot retrieve (such as the Manufacturer here) is displayed as not found.

The Refresh button sends the process back to the GetComputerInfo component to retrieve updated information. The Print View button renders the information in a printer-friendly version. This button is a PrintButtonComponent. The Done button ends the process.

Other components in this example are as follows:

  • Form Builder

The GetComputerInfo component is most useful in monitoring or information-display processes like in the screen shot.

You can also use this component to check hard disk capacity on mapped drives. You can stop publishing an individual process to each computer that needs to be monitored. Instead, you can map their hard drives onto a local computer and run one process locally.

If you notice back in the design-time form screen shot, not all of the values from the variable ComputerInfo are displayed in the variables panel. Some of the values are contained in arrays, such as all the individual values for each hard disk. To display these values, use an ACSII or HTML merge text component on your form. Then find the desired value through the text editor variable list.