5.3.1 Organization Information

Among the commands for organization information operations, the following four subcommands use XML:

fscsm_org create (Addition of organization information)
fscsm_org modify (Modification of organization information)
fscsm_org export (Export of organization information)
fscsm_org import (Batch addition, modification, and check of batch addition information of organization information)

The format of the XML file corresponding to the command above is explained below.

The elements of the XML must be specified using the following hierarchical structure:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<orgs>
    <org>
        <orgId>Organization ID</orgId>
        <orgAbbreviation>Abbreviation of the Organization Name</orgAbbreviation>
        <orgName>Organization Name</orgName>
        <parentOrgId>Organization ID of the Parent Organization</parentOrgId>
        <comment>Comment</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 (Element Name or Element Name and Attribute)	Required or Displayed			Specifiable Values During Addition or Modification
Element (Element Name or Element Name and Attribute)	Addition	Modification	Output	Specifiable Values During Addition or Modification
Organization ID (orgId)	Yes	Yes *1	Yes	The ID must not overlap with the IDs of other organizations. Specify a unique value. Specify a character string beginning with a lower-case alphanumeric character and containing 1 to 32 alphanumeric characters, underscores ("_"), hyphens ("-"), and periods (".").
Organization Short Name (orgAbbreviation)	Yes	Yes	Yes	Specify a character string containing 1 to 64 characters.
Organization Name (orgName)	Yes	Yes	Yes	Specify a character string containing 1 to 64 characters.
Organization ID of Parent Organization (parentOrgId)	Yes	Yes	Yes	Specify the organization ID of an already added organization which is the parent of the created organization. Specify a character string beginning with a lower-case alphanumeric character and containing 1 to 32 alphanumeric characters, underscores ("_"), hyphens ("-"), and periods ("."). Specify a character string beginning with a lower-case alphanumeric character and containing 1 to 32 alphanumeric characters, underscores ("_"), hyphens ("-"), and periods ("."). Use organization operation commands to obtain the organization ID of an existing organization. Specify "!root" if no parent organization exists. The number of levels in the organization hierarchy cannot exceed the maximum number set in the system information (default: 3, maximum: 5). In addition, an organization structure which creates a loop may not be specified.
Description (comment)	No	No	Yes	Specify a character string containing 0 to 256 characters.
Organization Custom Field N (customField no="N")	No	No	Yes	Specify a character string for the custom field. Only the specification of custom fields to be created or modified is permitted. Specify a character string containing 0 to 256 characters. When specifying values for custom fields, be sure to specify a sequential number for N. The sequential number cannot be omitted and as many as 5 different numbers can be specified. The content of each organization custom field is defined using gui.org.customfield.label.<n>, which is defined in the system information definition file. Specify the value for N according to the content of this definition.

The meanings of the entries listed under "Required or Displayed" are as follows:

Yes: Entry is required, or element is output.

No: Can be omitted.

-: Specification is not permitted, or element is not output.

*1: Modification is not possible.