Skip to content

Commit d812ec5

Browse files
Merge pull request #1547 from microsoft/mk/update-hidi-cmd-options
Update documentation with new hidi options
2 parents 9d15ca3 + 3c987ad commit d812ec5

File tree

1 file changed

+16
-12
lines changed

1 file changed

+16
-12
lines changed

src/Microsoft.OpenApi.Hidi/readme.md

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -68,24 +68,28 @@ Used to convert file formats from JSON to YAML and vice versa and performs slici
6868
This command accepts the following parameters:
6969

7070
• --openapi(-d) - OpenAPI description file path in the local filesystem or a valid URL hosted on a HTTPS server
71-
• --csdl(-cs) - CSDL file path in the local filesystem or a valid URL hosted on a HTTPS server
72-
• --csdlfilter(-csf) - a filter parameter that a user can use to select a subset of a large CSDL file. They do so by providing a comma delimited list of EntitySet and Singleton names that appear in the EntityContainer.
73-
• --output(-o) - Output directory path for the transformed document
74-
• --clean-ouput(-co) - an optional param that allows a user to overwrite an existing file.
75-
• --version(-v) - OpenAPI specification version
71+
• --csdl(--cs) - CSDL file path in the local filesystem or a valid URL hosted on a HTTPS server
72+
• --csdlfilter(--csf) - a filter parameter that a user can use to select a subset of a large CSDL file. They do so by providing a comma delimited list of EntitySet and Singleton names that appear in the EntityContainer.
73+
• --output(-o) - Output directory path for the transformed document.
74+
• --output-folder(--of) - The output directory path for the generated files.
75+
• --clean-ouput(--co) - an optional param that allows a user to overwrite an existing file.
76+
• --version(-v) - OpenAPI specification version.
77+
• --metadata-version(--mv) - the metadata version to use.
7678
• --format(-f) - File format
77-
• --loglevel(-ll) - The log level to use when logging messages to the main output
78-
• --inline(-i) - Inline $ref instances
79-
• --resolveExternal(-ex) - Resolve external $refs
80-
• --filterByOperationIds(-op) - Slice document based on OperationId(s) provided. Accepts a comma delimited list of operation ids.
79+
• --terse-output(--to) - Produce terse json output
80+
• --settings-path(--sp) - The configuration file with CSDL conversion settings.
81+
• --loglevel(--ll) - The log level to use when logging messages to the main output
82+
• --inline-local - Inline local $ref instances
83+
• --inline-external(--ex) - Inline external $refs
84+
• --filterByOperationIds(--op) - Slice document based on OperationId(s) provided. Accepts a comma delimited list of operation ids.
8185
• --filterByTags(-t) - Slice document based on tag(s) provided. Accepts a comma delimited list of tags.
8286
• --filterByCollection(-c) - Slices the OpenAPI document based on the Postman Collection file generated by Resource Explorer
83-
• --filterByManifest (-m) - Slices the OpenAPI document based on the requests defined in the API Manifest file referenced by the provided URI. For API manifests with multiple API Dependenties, use a fragment identifier to select the desired one. e.g ./apimanifest.json#example
87+
• --manifest (-m) - Slices the OpenAPI document based on the requests defined in the API Manifest file referenced by the provided URI. For API manifests with multiple API Dependenties, use a fragment identifier to select the desired one. e.g ./apimanifest.json#example
8488

8589
**Examples:**
8690

8791
1. Filtering by OperationIds
88-
hidi transform -d files\People.yml -f yaml -o files\People.yml -v OpenApi3_0 -op users_UpdateInsights -co
92+
hidi transform -d files\People.yml -f yaml -o files\People.yml -v OpenApi3_0 --op users_UpdateInsights --co
8993
9094
2. Filtering by Postman collection
9195
hidi transform --openapi files\People.yml --format yaml --output files\People2.yml --version OpenApi3_0 --filterByCollection Graph-Collection-0017059134807617005.postman_collection.json
@@ -94,7 +98,7 @@ This command accepts the following parameters:
9498
hidi transform --input Files/Todo.xml --output Files/Todo-subset.yml --format yaml --version OpenApi3_0 --filterByOperationIds Todos.Todo.UpdateTodo
9599
96100
4. CSDL Filtering by EntitySets and Singletons
97-
hidi transform -cs dataverse.csdl --csdlFilter "appointments,opportunities" -o appointmentsAndOpportunities.yaml -ll trace
101+
hidi transform --cs dataverse.csdl --csdlFilter "appointments,opportunities" -o appointmentsAndOpportunities.yaml --ll trace
98102
99103
Run transform -h to see all the available usage options.
100104

0 commit comments

Comments
 (0)