IP and Library labels

Learn how to create and attach labels on both IPLM CLI and IPLM Web, and how to search for IPs using labels on both clients.

Labels

Perforce IPLM uses labels to organize and categorize IPs and Libraries. Labels are tags or strings that can be attached to the IPs and Libraries. The labels first need to be created by an admin, users can then choose from a list of created labels to attach to a specific IP or Library. Details on using labels can be found on the Labels page in the User Guide.

Adding IP and Library labels using CLI

Below is an example of creating and adding a label to an IP.

> pi label add mixedsig
Successfully created Label 'mixedsig'.
> pi label attach tutorial.adc mixedsig
Successfully attached Label 'mixedsig' to IP 'tutorial.adc'.
> pi label attach tutorial.dac mixedsig
Successfully attached Label 'mixedsig' to IP 'tutorial.dac'.
> pi label list
┌──────────┬────────────┬───────────────────────────────┬───────┐
│ NAME     │ CREATED BY │ CREATED ON                    │ COUNT │
╞══════════╪════════════╪═══════════════════════════════╪═══════╡
│ MS90G    │ admin      │ 2020-06-19 10:15:16 -0400 EDT │ 1     │
│ analog   │ admin      │ 2020-06-19 10:15:15 -0400 EDT │ 6     │
│ digital  │ admin      │ 2020-06-19 10:15:16 -0400 EDT │ 6     │
│ mixedsig │ admin      │ 2020-06-19 17:53:46 -0400 EDT │ 2     │
│ project  │ admin      │ 2020-06-19 10:15:15 -0400 EDT │ 1     │
│ shared   │ admin      │ 2020-06-19 10:15:16 -0400 EDT │ 3     │
└──────────┴────────────┴───────────────────────────────┴───────┘
Found 6 matching object(s).

A label can also be detached from an IP:

> pi label detach tutorial.dbuf analog
Successfully detached Label 'analog' from IP 'tutorial.dbuf'.

The label can be used to filter the results on the command line:

> pi ip list --label mixedsig
┌──────────────────────┬──────┬─────────────┬────────────┬───────────────────────────────┬─────────────────┐
│ NAME                 │ DM   │ ALIASES     │ CREATED BY │ CREATED ON                    │ VERSION MESSAGE │
╞══════════════════════╪══════╪═════════════╪════════════╪═══════════════════════════════╪═════════════════╡
│ tutorial.adc@1.TRUNK │ P4   │ HEAD LATEST │ admin      │ 2020-06-19 10:13:48 -0400 EDT │ hier release    │
│ tutorial.dac@0.TRUNK │ CONT │ HEAD LATEST │ admin      │ 2020-06-19 10:13:45 -0400 EDT │ Initial version │
└──────────────────────┴──────┴─────────────┴────────────┴───────────────────────────────┴─────────────────┘
Found 2 matching object(s).

Adding IP and Library labels using IPLM Web

The web interface shows the new label in the IP catalog and also shows the list of IPs associated with the selected label.

Labels can be added and edited from the IPLM Web Labels page:

Labels can be applied to an IP from the Edit IP form: