Managing External Organizations

The following table describes the impact on JasperReports Server when modifying organizations defined in the external authority:

Action in External
Authority

Impact on JasperReports Server

Adding an organization

Organizations are not directly mapped to JasperReports Server, rather a new organization ID is mapped when synchronizing the first user in the organization that accesses the server. At that time, synchronization creates the organization and the user within it, along with any roles assigned to the user. Determine which of the following cases applies:

• Your organization definitions and mappings create the same role names in every organization. You should configure the organization folder templates so the default contents and permissions work with the known role names. Your external organization definitions should then map to organizations that work as soon as the first user logs in.
• Each of your externally defined organizations has different role names or requires specific repository contents. You should create test users in the new organizations first, so you can configure the new organization folder, synchronize external roles, and assign repository permissions before actual users have access. See the procedure in Initialization of JasperReports Server for External Users.

Modifying an organization

Changing the users or roles in organizations defined in the external authority is the same as adding users or roles to one organization and removing them from the other. See the corresponding actions in Managing External Users and Managing External Role Definitions.

Deleting an organization

Because organization definitions are not mapped directly, deleting an organization has the same effect as removing each of its users. The organization remains in the internal database and repository, along with the external roles and users who last accessed it. The unused organization has no impact on the server. You can safely delete it.
Changing the default admin users of organizations Default admin users are created only when the organization is created. Therefore, changes to the default admin users appear only in organizations created after the changes were made. In particular, if you add or delete default admin users, your changes affect only new organizations.