{"type":"doc","content":[{"type":"rule"},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"style":{"value":"none"}},"macroMetadata":{"macroId":{"value":"ad14181d-1050-4467-ac87-8355653dfd01"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"77c6eff4-1f1f-45a6-9bf2-0b3f686a24ee"}},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"Organizational units can be created manually or automatically in primedocs. Organizational units can be synchronized with an external system via ","type":"text"},{"text":"OrgSync","type":"text","marks":[{"type":"code"}]},{"text":". ","type":"text"}]},{"type":"paragraph","content":[{"text":"As organizational units are organized hierarchically, a 1:1 comparison as with users is not possible. An XML file is, therefore, used as the synchronization source, which must be filled in with the data from the external system.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following data can be synchronized to primedocs:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Title of the organizational unit","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fields to be set for the organizational unit","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Permissions of the organizational unit","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Organizational unit hierarchy","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The organizational unit is identified via a unique characteristic in primedocs, i.e., the external system specifies a \"key/technical characteristic\" and this characteristic is saved in primedocs when the organizational units are imported.","type":"text"}]},{"type":"paragraph","content":[{"text":"The generated file must then be imported into the primedocs data source via the ","type":"text"},{"text":"JobHost","type":"text","marks":[{"type":"code"}]},{"text":", e.g. as a time-controlled task.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"XML structure","type":"text"}]},{"type":"paragraph","content":[{"text":"The following XML structure is required:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n \n\t \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Permission synchronization","type":"text"}]},{"type":"paragraph","content":[{"text":"Permissions","type":"text","marks":[{"type":"code"}]},{"text":", specified in this file are ","type":"text"},{"text":"overwritten","type":"text","marks":[{"type":"strong"}]},{"text":" with the organizational unit found in the primedocs data source, i.e. all desired ","type":"text"},{"text":"Permissions","type":"text","marks":[{"type":"code"}]},{"text":" must be present in ","type":"text"},{"text":"primedocsOrgSync","type":"text","marks":[{"type":"code"}]},{"text":". Manually set permissions are overwritten.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Field synchronization","type":"text"}]},{"type":"paragraph","content":[{"text":"Fields","type":"text","marks":[{"type":"code"}]},{"text":" on the other hand, are merged with the existing fields in the organizational unit, i.e. unspecified fields are not emptied but left as they are.","type":"text"}]},{"type":"paragraph","content":[{"text":"No fields can be deleted via ","type":"text"},{"text":"primedocsOrgSync","type":"text","marks":[{"type":"code"}]},{"text":" either, in order for the inheritance mechanism of primedocs to take effect. This must be done manually.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Synchronization behaviour","type":"text"}]},{"type":"paragraph","content":[{"text":"All organizational units that exist below the ","type":"text"},{"text":"SyncRoot","type":"text","marks":[{"type":"code"}]},{"text":" but are not included in the import are ","type":"text"},{"text":"deleted","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Profiles that are attached to the deleted organizational units are moved to the ","type":"text"},{"text":"FallBackOu","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Organizational units that are outside the ","type":"text"},{"text":"SyncRoot","type":"text","marks":[{"type":"code"}]},{"text":" in the database but are specified as a child of the ","type":"text"},{"text":"SyncRoot","type":"text","marks":[{"type":"code"}]},{"text":" in the import are ","type":"text"},{"text":"moved","type":"text","marks":[{"type":"strong"}]},{"text":" according to the import.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"JobHost","type":"text"}]},{"type":"paragraph","content":[{"text":"As with ","type":"text"},{"text":"UserSync","type":"text","marks":[{"type":"code"}]},{"text":", a ","type":"text"},{"text":"DataSourceId","type":"text","marks":[{"type":"code"}]},{"text":" can be specified for ","type":"text"},{"text":"OrgSync","type":"text","marks":[{"type":"code"}]},{"text":" - if this is not specified, ","type":"text"},{"text":"OrgSync","type":"text","marks":[{"type":"code"}]},{"text":" is executed on all databases. If no ","type":"text"},{"text":"DataSourceId","type":"text","marks":[{"type":"code"}]},{"text":" is specified, the minimum call is ","type":"text"},{"text":"...\\primedocs.JobHost.exe OrgSync -i \"P:\\ath\\To\\InputFile.xml\"","type":"text","marks":[{"type":"code"}]},{"text":" with the path to the XML file as the only mandatory parameter.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"The following call parameters are available for ","type":"text"},{"text":"OrgSync","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"32a1b457-b64d-46db-80a8-6c1c311d82e5"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[59.0]},"content":[{"type":"paragraph","content":[{"text":"Short","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"Long","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[402.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[59.0]},"content":[{"type":"paragraph","content":[{"text":"-i","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"--InputFile","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"true","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"String.Empty","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[402.0]},"content":[{"type":"paragraph","content":[{"text":"Path to import file","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[59.0]},"content":[{"type":"paragraph","content":[{"text":"-d","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"--DataSourceId","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"null","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[402.0]},"content":[{"type":"paragraph","content":[{"text":"GUID of the target database on the server. If omitted, the ","type":"text"},{"text":"OrgSync","type":"text","marks":[{"type":"code"}]},{"text":" is executed on all configured databases.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[59.0]},"content":[{"type":"paragraph","content":[{"text":"-r","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"--SyncRoot","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"String.Empty","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[402.0]},"content":[{"type":"paragraph","content":[{"text":"Root OU for the sync process. The content from the InputFile (","type":"text"},{"text":"-i","type":"text","marks":[{"type":"code"}]},{"text":") is synchronized in the OU tree below the ","type":"text"},{"text":"SyncRoot","type":"text","marks":[{"type":"code"}]},{"text":". If the ","type":"text"},{"text":"SyncRoot","type":"text","marks":[{"type":"code"}]},{"text":" itself is part of the import, it is also synchronized. Can be a GUID (primedocs-Id of the OU), or the identifier from the import file. If no ","type":"text"},{"text":"SyncRoot","type":"text","marks":[{"type":"code"}]},{"text":" is specified, an attempt is made to determine a ","type":"text"},{"text":"SyncRoot","type":"text","marks":[{"type":"code"}]},{"text":" using the import file: The top-level OU of the import file is searched for using the identifier in the DB. If there are several top-level OUs in the import file, the DB is searched for an OU that has at least one of the top-level OUs from the import file as a child. If no ","type":"text"},{"text":"SyncRoot","type":"text","marks":[{"type":"code"}]},{"text":" can be determined, the import is created by default as a child / as children of the existing root (if there are several existing root OUs in the database, the first one found is used). The ","type":"text"},{"text":"-c","type":"text","marks":[{"type":"code"}]},{"text":" option can be used to set the import to be created as a new root OU(s) as a sibling to the existing root.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[59.0]},"content":[{"type":"paragraph","content":[{"text":"-c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"--CreateNewRootAsSibling","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[402.0]},"content":[{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", the import is created as a sibling to the existing root. If ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":", the import is created as a child of the existing root. ","type":"text"},{"text":"Only applies if the specified SyncRoot (","type":"text","marks":[{"type":"strong"}]},{"text":"-r","type":"text","marks":[{"type":"code"}]},{"text":") does not exist or no ","type":"text","marks":[{"type":"strong"}]},{"text":"SyncRoot","type":"text","marks":[{"type":"code"}]},{"text":" can be determined.","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[59.0]},"content":[{"type":"paragraph","content":[{"text":"-f","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"--FallBackOu","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"String.Empty","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[402.0]},"content":[{"type":"paragraph","content":[{"text":"OU to which profiles of deleted OUs are attached. If this is not specified, the existing root OU is used. If there are several existing root OUs in the database, the first one found is used.","type":"text"}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Limitations","type":"text"}]},{"type":"paragraph","content":[{"text":"The purpose of ","type":"text"},{"text":"OrgSync","type":"text","marks":[{"type":"code"}]},{"text":" is to import a predefined organizational structure into primedocs and keep it synchronized.","type":"text"}]},{"type":"paragraph","content":[{"text":"If an organizational structure already exists in primedocs, there is currently no automatic way to synchronize it with an external system.","type":"text"},{"type":"hardBreak"},{"text":"There is also no interface for setting or changing the ","type":"text"},{"text":"Identifier","type":"text","marks":[{"type":"code"}]},{"text":"s for synchronization.","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"If you have any questions, please contact our support team - we are happy to help you.","type":"text"}]}]},{"type":"paragraph"}],"version":1}

Browser not supported