5.3.1 Organization Information

Among the commands that operate organization information, the following three types of commands use XML:

fscsm_org create (organization information registration)
fscsm_org modify (organization information modification)
fscsm_org export (organization information output)

The formats of the XML files corresponding to each of these commands are explained below.

Elements of XML must be as the following stratum structure:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<orgs>

    <org rId="Resource ID of the Organization" tree="Organization attribute">

        <orgId>Organization ID</orgId>

        <orgAbbreviation> Abbreviation of the Organization Name</orgAbbreviation>

        <orgName>Organization Name</orgName>

        <parentOrgRId>Resource ID of the Parent Organization</parentOrgRId>

        <comment>Description</comment>

        <customFields>

            <customField no="1">Organization Custom Field 1</customField>

            <customField no="2">Organization Custom Field 2</customField>

            <customField no="3">Organization Custom Field 3</customField>

            <customField no="4">Organization Custom Field 4</customField>

            <customField no="5">Organization Custom Field 5</customField>

        </customFields>

    </org>

</orgs>

Element (Name or Attribute)	Omission or Display			Acceptable Value in Registration or Modification
Element (Name or Attribute)	Registration	Modification	Output	Acceptable Value in Registration or Modification
Resource ID of the Organization (org rId)	×	×	○	-
Organization Attribute (org tree)	○	○ *1	○	Specify one of the followings:
				Value	Description
				node	Owns child organizations.
				leaf	Owns platforms and representatives.
Organization ID (orgId)	○	○ *1	○	Specify a character string beginning with an alphanumeric character and containing 1 to 32 alphanumeric characters, underscores ("_"), hyphens ("-"), and periods ("."). The ID must not overlap other organization ID. Specify a unique value.
Organization Abbreviation (orgAbbreviation)	○	○	○	Specify a character string containing 1 to 64 characters.
Organization Name (orgName)	○	○	○	Specify a character string containing 1 to 64 characters.
Resource ID of the Parent Organization (parentOrgRId)	○	○	○	Resource ID of the registered parent organization. Specify an integer number within 8-digit. Use organization operation commands to get resource ID of the existing parent organization. Specify 0 if parent organization does not exist. Organization whose attribute is node, is only specified as parent organization. The level of the organization hierarchy cannot exceed the maximum number set in the system information (default: 3, maximum: 5), cannot be registered. And the level of the organization hierarchy cannot be loop structure.
Description (comment)	△	△	○	Specify a character string containing 0 to 256 characters.
Organization Custom Field N (customField no="N")	△	△	○	Specify a character string containing 0 to 256 characters as a value of the custom field. Specifying only custom fields to be made or modified is permitted. Specify a sequential number in the Ns if custom fields are specified. The Ns can be omitted and can be specified by five numbers. On the cloud management portal, custom fields are displayed to the number of gui.org.customfield.label.<n> specified in the system information.

Refer to the following about symbols of the "Omission or Display" column.

○: Entry is mandatory, or element is output.

△: Omission is permitted.

×: Specifying is not permitted, or element is not output.

*1: Modifying is not permitted.