update_organizational_entity

Updates the organizational entity by changing the entity name. You can also change the entity type and create associated cost centers.

Standard Mode

emcli update_organizational_entity
      -entity_name="entity name"
      [-entity_type="entity type"]
      [-new_entity_name="new entity name"]
      [-parent_entity_name="parent entity name"]
      [-tenant_name="tenant name"]
      [-cost_centers="cost centers"[;"cost centers"...]]
      [-separator=argument_name="separator_value"])

[ ]  indicates that the parameter is optional.

Interactive or Script Mode

update_organizational_entity
      (,entity_name="entity name"
      [,entity_type="entity type"]
      [,new_entity_name="new entity name"]
      [,parent_entity_name="parent entity name"]
      [,tenant_name="tenant name"]
      [,cost_centers="cost centers"[;"cost centers"...]]
      [,separator=argument_name="separator_value"])

[ ]  indicates that the parameter is optional.

Options

• entity_name

  Name of the organizational entity to be updated.

• entity_type

  New entity type if changing from department to lob or vice versa.

• new_entity_name

  New name of the original entity.

• parent_entity_name

  Specifies a parent of the organizational entity being updated. The parent must already exist and can be either a department or LOB, regardless of the type being updated. Default is no parent.

• tenant_name

  Specifies the name of the tenant to which the organizational entity being updated belongs. Default is the tenant of the logged-in user.

• cost_centers

  Specifies one or more cost centers to create and associate with the organizational entity being updated. Default is no cost centers. You can create cost centers and associate them independently, using the create_cost_centers verb.

• separator

  Overrides the separator for multi-value input arguments, which is a semicolon (;). For information about overriding the separator or subseparator, see "Overriding the Separator and Subseparator" .

Exit Codes

0 if successful. A non-zero value indicates that verb processing was unsuccessful.

Examples

Example 1

The following example changes the name of the finance organizational entity to investments and creates three associated cost centers, C4, C5, C6.

emcli create_organizational_entity
      -entity_name="finance"
      -new_entity_name="investments"
      -cost_centers="c4;c5;c6"

Example 2

The following example changes the entity type of the finance organizational entity to LOB. It also changes the tenant to which the entity belongs to corporate.

emcli create_organizational_entity
      -entity_name="finance"
      -entity_type="lob"
      -tenant_name="corporate"