Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Princípios

Princípios para modificar conjuntos de referências incluem:

  • Conjuntos de referências podem ser modificados por
    • Adição ou inativação de membros do conjunto de referências. Por favor consulte as instruções em 

Principles

Principles for modifying reference sets include:

  • Reference sets can be modified by
    • Adding or inactivating reference set members. Please refer to the guidance on 6.3.3.1 Adicionando Membros a um Conjunto de Referências or 6.3.3.3 6.3.3.3 Remove Members from a Reference Set.
    • Modifying mutable attribute values of reference set members. To see what attributes are mutable for each reference set type, please refer to the specification of the specific reference set type in the reference set release files specification. If the reference set type is a locally defined reference set, please consider any mutability constraints on the individual attributes.
  • Don't modify immutable attributes of a reference set.
    • In the case where the modification of an immutable attribute is required, this should be done by inactivating the reference set member and creating a new reference set member with the required, updated values.
  • If circumstances require you to modify reference set members that belong to another module than the producers extension, following options exist:
    • Inactivating the specific reference set member in your own module and create a new reference set member with the updated value
      • The benefit of this approach is that you retain the definition and representation of the reference set member as it was intended by its original authors, and the new reference set member will be easily identified as a local reference set member, as the identifier of that reference set member is not available in the original reference set 
    • Create a new version of the specific reference set member in your own module, and make the necessary modifications

Proces

The table below provides a summary of the process to follow when modifying an existing member in a Reference Set.

  • Não modifique atributos imutáveis de um conjunto de referências.
    • Caso seja requerida a modificação de um atributo imutável, isso deve ser feito mediante a inativação do membro do conjunto de referências e a criação de um novo membro do conjunto de referências com os valores requeridos atualizados.
  • Se as circunstâncias requerem que você modifique membros do conjunto de referências que pertençam a outro módulo que não a extensão dos produtores, há as seguintes opções:
    • inative o membro específico do conjunto de referências no seu próprio módulo e crie um novo membro do conjunto de referências com o valor atualizado
      • O benefício dessa abordagem é que você retém a definição e representação do membro do conjunto de referências da maneira pretendida por seus autores originais, e o novo membro do conjunto de referências será facilmente identificado como um membro local do conjunto de referências, uma vez que o identificador daquele membro do conjunto de referências não está disponível no conjunto de referências original
    • Crie uma nova versão do membro específico do conjunto de referências em seu próprio módulo e faça as modificações necessárias

Processo

A tabela abaixo fornece um resumo do processo a ser seguido para modificar um membro existente de um conjunto de referências.

Tabela 6.3.3.2-1: Modificando um membro de conjunto de referências





Tipo de arquivoProcesso
Conceito

O conceito de metadados que representa o conjunto de referências é mantido

Conjunto de referências

Uma nova linha de conjunto de referências é criada e o id é mantido da versão prévia do membro do conjunto de referências.

Atributos de versão e identificação de módulo são determinados da seguinte maneira:

  • effectiveTime é determinado para a data na qual a extensão será publicada
  • active é determinado para refletir o status do membro do conjunto de referências, isto é '1' para ativo e '0 'para inativo

moduleId é determinado para identificar um módulo gerenciado pelo produtor da extensão

Atributos comuns a todos os tipos de conjunto de referências são determinados da seguinte maneira:

  • refsetId é mantido como o valor da versão anterior desse membro do conjunto de referências. Um membro não pode ser movido de um conjunto de referências para outro
  • referencedComponentId é mantido como o valor da versão anterior desse membro do conjunto de referências. Um membro não pode mudar o componente ao qual ele se refere..
      • Nesse caso, o registro existente do membro deve ser inativado e um novo deve ser criado.
  • Atributos específicos a um tipo de conjunto de referências são determinados da seguinte maneira:

    atributos adicionais - podem ser atualizados com um valor, de tipo (e possivelmente alcance) limitado pelo registro descritor para esse atributo de Conjunto de Referências
File TypeProcess
Concept

The metadata concept representing the reference set is retained

Reference Set

A new reference set row is created and the id is retained from the previous version of the refset member.

Versioning and module identification attributes are set accordingly:

  • effectiveTime is set to the date the extension will be published
  • active is set to reflect the status of the reference set member, i.e. '1' for active and '0 'for inactive
  • moduleId is set to identify a module managed by the extension producer

Attributes common for all reference set types are set accordingly:

  • refsetId is retained as the value from the previous version of this refset member. A member cannot move from one reference set to another
  • referencedComponentId id retained as the value from the previous version of this refset member. A member cannot change the component which it refers to.
    • In this case, the existing member record should be inactivated, and a new one created.

Attributes specific to the reference set type are set accordingly:

  • additional attributes - may be updated with a value, of type (and possibly range) limited by the descriptor record for this Reference Set attribute