Use the New-NAVAppManifest cmdlet to create a new in-memory manifest object that defines a NAV App along with its required prerequisites and dependencies.
The manifest object can then be written to disk using the New-NAVAppManifestFile cmdlet.
The manifest is required when creating the NAV App package file (.navx) using the New-NAVAppPackage cmdlet.
The manifest property values can be changed using the Set-NAVAppManifest cmdlet.
Examples
Example 1
New-NavAppManifest -Name "Proseware SmartApp" -Publisher "Proseware, Inc." -Description "First NAV App by Proseware"
AppId : 00001111-aaaa-2222-bbbb-3333cccc4444
AppName : Proseware SmartApp
AppPublisher : Proseware, Inc.
AppDescription : First NAV App by Proseware
AppBrief :
AppVersion : 1.0.0.0
AppCompatibilityId : 1.0.0.0
AppPrivacyStatement:
AppEula :
AppHelp :
AppUrl :
AppLogo :
AppScreenShots :
Capabilities : {}
Prerequisites : {}
Dependencies : {}
This example creates a new in-memory manifest object with the provided property values and defaults for properties not provided.
This example creates a new in-memory manifest object with values provided for all properties.
Example 3
New-NavAppManifest -Name "Proseware SmartApp" -Publisher "Proseware, Inc." -Description "First NAV App by Proseware" | New-NavAppManifestFile -Path ".\Manifest-Proseware SmartApp.xml"
This example uses New-NAVAPPManifestFile cmdlet to persist the new in-memory manifest to a file.
This can then be saved under source control for later use.
Example 4
New-NAVAppManifest -Name "Proseware SmartApp" -Publisher "Proseware, Inc." -Description "First NAV App by Proseware" | New-NAVAppPackage -Path 'C:\Proseware SmartApp.navx' -SourcePath C:\NavAppFiles
This example shows how to pass the in-memory manifest to New-NAVAppPackage cmdlet to get a .navx file.
Parameters
-Brief
Specifies the brief description for the NAV App.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
AppBrief
Parameter sets
(All)
Position:
4
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-CompatibilityId
Specifies the compatibility ID of the NAV App.
The compatibility ID is a version string in the format of Major.Minor.Build.Revision, with a default value of 1.0.0.0 if not provided.
The value is used to indicate whether there are compatibility related code changes between different versions of the NAV App.
If a new version of the NAV App does not break compatibility, leave the compatibility ID the same as the previous version.
Parameter properties
Type:
Version
Default value:
1.0.0.0
Supports wildcards:
False
DontShow:
False
Aliases:
AppCompatibilityId
Parameter sets
(All)
Position:
7
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-Dependencies
Specifies the path to a package file (.navx) for another NAV App that this NAV App is dependent on.
Use a comma (,) to separate the paths to multiple .navx files., such as in the following example: C:\Proseware\SmartAppBase.navx, C:\Proseware\ProsewareBase.navx
Parameter properties
Type:
String[]
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-Description
Specifies the description for the NAV App.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
AppDescription
Parameter sets
(All)
Position:
5
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-Eula
Specifies a hyperlink to the NAV AppEnd User License Agreement.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
AppEula
Parameter sets
(All)
Position:
9
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-Help
Specifies a hyperlink to the NAV App help site.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
AppHelp
Parameter sets
(All)
Position:
10
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-Id
Specifies the unique identifier for the NAV App.
A unique identifier will be generated if a value is not provided.
The same unique identifier should be used for each new version of the NAV App.
Parameter properties
Type:
Guid
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
AppId
Parameter sets
(All)
Position:
3
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-Name
Specifies the name of the NAV App.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
AppName
Parameter sets
(All)
Position:
1
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-Prerequisites
Specifies the objects that must exist in order to deploy the NAV App to a Microsoft Dynamics NAV server instance.
The prerequisites is a string in the format of type=ID, where type can be any NAV object type such as Table, CodeUnit, or Page.
Use a comma (,) to separate the prerequisites, such as in the following example: Table=397, CodeUnit=78
Parameter properties
Type:
String[]
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-PrivacyStatement
Specifies a hyperlink to the NAV App Privacy Statement.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
AppPrivacyStatment
Parameter sets
(All)
Position:
8
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-Publisher
Specifies the publisher of the NAV App, such as your company name.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
AppPublisher
Parameter sets
(All)
Position:
2
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-Url
Specifies a generic hyperlink.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
AppUrl
Parameter sets
(All)
Position:
11
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
-Version
Specifies the version of the NAV App.
The version is a string in the format of Major.Minor.Build.Revision, with a default value of 1.0.0.0 if not provided.
The value should be incremented for each new version of the NAV App.
Parameter properties
Type:
Version
Default value:
1.0.0.0
Supports wildcards:
False
DontShow:
False
Aliases:
AppVersion
Parameter sets
(All)
Position:
6
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
True
Value from remaining arguments:
False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters.