Migrieren einer Ressource zu einer anderen Version

Eine vorhandene Ressource nimmt die neue Ressourcentypversion an, wenn der Systemverwalter die Type_version-Eigenschaft der Ressource bearbeitet. Dabei werden die gleichen Konventionen wie bei der Bearbeitung anderer Ressourceneigenschaften beachtet, mit der Ausnahme, dass einige Informationen von der neuen Ressourcentypversion abgeleitet bzw. übernommen werden statt von der aktuellen Version.

• Ressourceneigenschaftsattribute für alle Eigenschaften wie min, max, arraymin, arraymax, Standard und Einstellbarkeit werden von der neuen Ressourcentypversion übernommen.

• Die Einstellbarkeit, die auf die Type_version-Eigenschaft angewendet wird, wird aus den #$upgrade_from-Anweisungen in der RTR-Datei und der RT_Version-Eigenschaft des Ressourcentyps für die vorhandene Ressource übernommen. Diese Einstellbarkeit weicht von der unter property_attributes(5) beschriebenen Einstellbarkeit ab.

• Die Validate-Methode für die neue Ressourcentypversion wird angewendet. So wird sichergestellt, dass die Eigenschaftsattribute für den neuen Ressourcentyp gültig sind. Wenn die vorhandenen Ressourceneigenschaftsattribute nicht für die Validierungsbedingungen der neuen Ressourcentypversion ausreichen, muss der Systemverwalter gültige Werte für diese Eigenschaften an der scrgadm-Befehlszeile eingeben. Dieser Fall kann eintreten, wenn die neuere Ressourcentypversion eine Eigenschaft verwendet, die in der früheren Version nicht deklariert war und die keinen Standardwert hat. Zudem kann er eintreten, wenn die vorhandene Ressource bereits über eine Eigenschaft verfügt, der ein Wert zugewiesen wurde, der für die neuere Ressourcentypversion ungültig ist.

• Die Deklaration von Ressourceneigenschaften, die in einer älteren Ressourcentypversion deklariert wurden, kann in der neueren Version aufgehoben werden. Wenn die Ressource zu einer neueren Version migriert, wird die Eigenschaft aus der Ressource gelöscht.

Die Validate-Methode kann die aktuelle Type_version der Ressource mithilfe von scha_resource_get abfragen, ebenso wie die neue Type_version, die an der Validate-Befehlszeile eingegeben wird. Daher kann Validate Aufrüstungen von nicht unterstützten Versionen ausschließen.