Versions Compared

Key

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

Overview

Returns list of available positions by name. Empty positions (no active employee exist) are not returned by this function. Id property of these positions correspond to the Id column on OrganizationUnitPosition table.

Array<Identity> $Membership.FindPosition(position: string)

Returns list of available positions by name. Empty positions (no active employee exist) are not returned by this function. Id property of these positions correspond to the Id column on OrganizationUnitPosition table.

Array<Identity> $Membership.FindPosition(position: string, organizationUnit: string)

Returns list of available positions by name. Empty positions (no active employee exist) are not returned by this function. Id property of these positions correspond to the Id column on OrganizationUnitPosition table.

Array<Identity> $Membership.FindPosition(position: string, organizationUnit: string, direction: ( "Up" | "Down" ))

Arguments

string position
Position to find.
string organizationUnit
Organization unit context to search on. Either organization unit path or Id is valid.
string organizationUnit
Specifies the search direction. Optional but can be set to one of following values. Up Search on specified organization unit and upper units. (Default) Down Search on specified organization unit and below units. None Search only on specified organization unit.
( "Up" | "Down" ) direction

Remarks

If organization unit provided, position only searches with specified unit scope. Direction parameter specifies the scope of search.

Organization unit parameter can be specified as Id (guid value) of unit to search or path of organization (e.g. 'MyDepartment/MyChildUnit')

Example

Find "Accounting Specialist" on current organization.
Code Block
languagejs
var positions = $Membership.FindPosition('Accounting Specialist');

Example

Find "Accounting Specialist" on "General Management" department.
Code Block
languagejs
var positions = $Membership.FindPosition('Accounting Specialist', 'General Management');

Example

Find "Accounting Specialist" on "General Management/Accounting" department.
Code Block
languagejs
var positions = $Membership.FindPosition('Accounting Specialist', 'General Management/Accounting');

Example

Find "Accounting Specialist" on "General Management/Accounting" department by using department Id.
Code Block
languagejs
var organizationUnit = $Membership.FindIdentity('General Management/Accounting', 'OrganizationUnit');
var positions = $Membership.FindPosition('Accounting Specialist', organizationUnit);

Remarks

If organization unit provided, position only searches with specified unit scope. Direction parameter specifies the scope of search.

Organization unit parameter can be specified as Id (guid value) of unit to search or path of organization (e.g. 'MyDepartment/MyChildUnit')

Example

Find "Accounting Specialist" on current organization.
Code Block
languagejs
var positions = $Membership.FindPosition('Accounting Specialist');

Example

Find "Accounting Specialist" on "General Management" department.
Code Block
languagejs
var positions = $Membership.FindPosition('Accounting Specialist', 'General Management');

Example

Find "Accounting Specialist" on "General Management/Accounting" department.
Code Block
languagejs
var positions = $Membership.FindPosition('Accounting Specialist', 'General Management/Accounting');

Example

Find "Accounting Specialist" on "General Management/Accounting" department by using department Id.
Code Block
languagejs
var organizationUnit = $Membership.FindIdentity('General Management/Accounting', 'OrganizationUnit');
var positions = $Membership.FindPosition('Accounting Specialist', organizationUnit);

Remarks

If organization unit provided, position only searches with specified unit scope. Direction parameter specifies the scope of search.

Organization unit parameter can be specified as Id (guid value) of unit to search or path of organization (e.g. 'MyDepartment/MyChildUnit')

Example

Find "Accounting Specialist" on current organization.
Code Block
languagejs
var positions = $Membership.FindPosition('Accounting Specialist');

Example

Find "Accounting Specialist" on "General Management" department.
Code Block
languagejs
var positions = $Membership.FindPosition('Accounting Specialist', 'General Management');

Example

Find "Accounting Specialist" on "General Management/Accounting" department.
Code Block
languagejs
var positions = $Membership.FindPosition('Accounting Specialist', 'General Management/Accounting');

Example

Find "Accounting Specialist" on "General Management/Accounting" department by using department Id.
Code Block
languagejs
var organizationUnit = $Membership.FindIdentity('General Management/Accounting', 'OrganizationUnit');
var positions = $Membership.FindPosition('Accounting Specialist', organizationUnit);

Examples

Find "Accounting Specialist" on current organization.
Code Block
languagejs
var positions = $Membership.FindPosition('Accounting Specialist');
Find "Accounting Specialist" on "General Management" department.
Code Block
languagejs
var positions = $Membership.FindPosition('Accounting Specialist', 'General Management');
Find "Accounting Specialist" on "General Management/Accounting" department.
Code Block
languagejs
var positions = $Membership.FindPosition('Accounting Specialist', 'General Management/Accounting');
Find "Accounting Specialist" on "General Management/Accounting" department by using department Id.
Code Block
languagejs
var organizationUnit = $Membership.FindIdentity('General Management/Accounting', 'OrganizationUnit');
var positions = $Membership.FindPosition('Accounting Specialist', organizationUnit);