Jump to

• Request
• Response

Update Employee EMC Visibility

post

/config/sim/v1/employees/updateEmployeeVisibility

Updates the hierarchy unit visibility to the Employee. If hierarchy unit is not found, it assigns the hierarchy unit to the Employee

Request

Supported Media Types

• application/json
• multipart/form-data

Header Parameters

• Simphony-AuditTrailRef(optional): string(string)
  Detail that Identifies that who made the change
• Simphony-OrgShortName: string(string)
  Org Identifier

Body ()

Employee EMC Visibility Object

Root Schema : EmployeeEMCVisibility

Type: object

Model for an Employee EMC Visibility Object

Show Source

• hierObjNum(optional): integer
  Object number of the hierarchy unit where the employee EMC visibility is configured

  Example: 26
• hierUnitId: integer
  Unique reference of the hierarchy unit where the employee EMC visibility is configured

  Example: 3599
• hierUnitName(optional): object HierUnitNameTranslatedString
  A string that contains translations of hierarchy unit name into multiple languages
• objectNum: integer
  Unique reference of the employee in the system.

  Example: 1
• propagateToChildren(optional): boolean
  Boolean flag indicating if the EMC visibility is propagated to child nodes of the hierarchy unit

  Example: true

{
    "description":"Model for an Employee EMC Visibility Object",
    "type":"object",
    "required":[
        "hierUnitId",
        "objectNum"
    ],
    "properties":{
        "objectNum":{
            "description":"Unique reference of the employee in the system.",
            "type":"integer",
            "example":1
        },
        "hierUnitId":{
            "description":"Unique reference of the hierarchy unit where the employee EMC visibility is configured",
            "type":"integer",
            "example":3599
        },
        "hierObjNum":{
            "description":"Object number of the hierarchy unit where the employee EMC visibility is configured",
            "type":"integer",
            "example":26
        },
        "hierUnitName":{
            "$ref":"#/definitions/HierUnitNameTranslatedString"
        },
        "propagateToChildren":{
            "description":"Boolean flag indicating if the EMC visibility is propagated to child nodes of the hierarchy unit",
            "type":"boolean",
            "example":true
        }
    }
}

Nested Schema : HierUnitNameTranslatedString

Type: object

A string that contains translations of hierarchy unit name into multiple languages

Example:

{
    "en-US":"Property",
    "de-DE":"Eigentum",
    "ar-AR":"??????????"
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

Employee EMC Visibility object of the organization.

Body ()

Root Schema : EmployeeEMCVisbilityResponse

Type: object

Model for the response

Show Source

• hierUnitId: integer
  Unique hierarchy unit value
• objectNum: integer
  Unique reference of the Employee

{
    "description":"Model for the response",
    "type":"object",
    "required":[
        "objectNum",
        "hierUnitId"
    ],
    "properties":{
        "objectNum":{
            "description":"Unique reference of the Employee",
            "type":"integer"
        },
        "hierUnitId":{
            "description":"Unique hierarchy unit value",
            "type":"integer"
        }
    }
}

400 Response

400 Bad Request

Body ()

Root Schema : ErrorDetails

Type: object

Response body when the request returns an error.

Show Source

• detail(optional): string
  A short, human-readable summary of the problem.

  Example: Specified Data is invalid
• errorDetails(optional): string
  A human-readable explanation specific to this occurrence of the problem.

  Example: Entity Does Not Exist
• o:errorCode(optional): integer
  Error code of the problem

  Example: 55223
• status(optional): integer
  HTTP status code.

  Example: 400
• title(optional): string
  A short, human-readable summary of the problem type.

  Example: VALIDATION ERROR
• type(optional): string
  A URI reference that identifies the problem type. When this member is not present, its value is assumed to be "about:blank".

  Example: http://www.abc.org/xyz.html

{
    "description":"Response body when the request returns an error.\n",
    "type":"object",
    "properties":{
        "o:errorCode":{
            "description":"Error code of the problem",
            "type":"integer",
            "example":55223
        },
        "detail":{
            "description":"A short, human-readable summary of the problem.",
            "type":"string",
            "example":"Specified Data is invalid"
        },
        "status":{
            "description":"HTTP status code.",
            "type":"integer",
            "example":400
        },
        "type":{
            "description":"A URI reference that identifies the problem type. When this member is not present, its value is assumed to be \"about:blank\".",
            "type":"string",
            "example":"http://www.abc.org/xyz.html"
        },
        "title":{
            "description":"A short, human-readable summary of the problem type.",
            "type":"string",
            "example":"VALIDATION ERROR"
        },
        "errorDetails":{
            "description":"A human-readable explanation specific to this occurrence of the problem.",
            "type":"string",
            "example":"Entity Does Not Exist"
        }
    }
}

Back to Top