====== ReplicationService ======
Im [[Abschnitte|Abschnitt]] **ReplicationService** wird definiert wie der [[PrimusReplicationService]] (PRS) zu erreichen ist und an welchem Standort sich dieser Client befindet.

Folgende Attribute sind erforderlich:
^Attribut ^Funktion ^
|**server** | Netzwerkname des Servers auf dem der Replikationsdienst läuft|
|port | TCP-IP Port über den der Replikationsdienst auf dem Server erreichbar ist |
|location| Standortkürzel des Clients, dieses muß mit dem Eintrag in der [[PrimusReplicationService#PrimusReplicationService.xml]] übereinstimmen. Der Wert kann mit dem [[Liste aller Platzhalter|Platzhalter]] ''%LOCATION%'' zb. zur Generierung der [[Replikations ID|RepID]] abgerufen werden.|

====== Beispiel ======
Der Server ist unter dem [[Glossar#DNS_Namen]] ''Primus'' erreichbar, der PRS ist mit Port ''9091'' verbunden. Der Standort des Clients ist **HU**.
<code xml>
<ReplicationService server="primus" port="9091" location="HU"/>
</code>

====== Menübefehle ======
Die Replikation kann über folgende [[Menübefehl]]e gesteuert werden:
^Befehl^Funktion^
| [[prmReplicationServiceTestConnection]]| Testet die Verbindung zum PRS|
| [[prmReplicationServiceStartTimer]]| {{tag>Klärungsbedarf}}|
| [[prmReplicationServiceStopTimer]]|:::|
| [[prmReplicationServiceReloadSettings]]| Lädt die Replikationseinstellungen neu|
| [[prmReplicationServiceGetStatus]]| Fragt den Status des PRS ab|
| [[prmProjectSetDirectoriesToReplicate]]| Ermöglicht es ein Verzeichnis oder eine Struktur als replizierbar zu definieren|
| [[prmProjectGenerateRepIDs]]| Generiert die für die Replikation notwendigen eindeutigen IDs für die gewählten Verzeichnisse|
| [[prmProjectReplicateDirectories]]| Repliziert eine leere Verzeichnisstruktur|
| [[prmProjectReplicateDocuments]]| Repliziert ausgewählte Dokumente|
| [[prmProjectRequestLocationForDocuments]]| Fordert den aktuellen Standort als Bearbeitungsstandort für die gewählten Dokumente an|
| [[prmElementReplicateDocumentWithComponents]]| Repliziert ein Element nebst Verknüpfungen und ggf. übergeordneten Elementen|
| [[prmElemenRequestLocationWithComponents]]| Legt den Bearbeitungsstandort für ein Element nebst Verknüpfungen und ggf. übergeordneten Elementen auf den aktuellen Standort fest|
| [[prmElementGenerateRepIDs]]| Generiert die für die Replikation notwendigen eindeutigen IDs für die gewählten Elemente|

====== Tipp ======
Da es bei einer Replication auch immer mehrere Server gibt, die jeweils einen anderen **ReplicationService** Eintrag in der [[CFG.XML|Konfiguration]] haben müssen, kann man bei Konfigurationsänderungen diese nicht einfach auf einen anderen Server kopieren.
Zu diesem Zweck empfiehlt es sich mit [[IncludeConfigLayers]] zu arbeiten. Dabei steht in der Konfiguration nur das IncludeConfigLayers Tag und der eigentliche Eintrag liegt in einer separaten Datei. Diese ist für jeden Server eine andere und wird jeweils nicht mitkopiert, muß aber i.d.R. auch nicht geändert werden.

===== Beispiel =====
<code xml>
<!-- Da für die Replication jeder Server einen eigenen Eintrag für seinen Standort braucht, ist dieser nicht direkt in dieser CFG.XML abgelegt,
     sondern in einer CFGLAYER.XML die den jeweiligen Standort konfiguriert.
     Dadurch kann bei Anpassungen an dieser Konfiguration diese einfach auf den anderen Server übertragen werden. -->
  <IncludeConfigLayers>
    <Layer path=".\CFGLayers\ReplicationService.CFGLAYER.xml" />
  </IncludeConfigLayers>
</code>


{{tag> Replikation PrimusService Tipps&Tricks}}