[ADF-1586] NodeService documentation update because of 2.0 reorg (#2710)

This commit is contained in:
Martin Bergljung
2017-11-23 13:01:24 +00:00
committed by Eugenio Romano
parent 86b488529c
commit 753c13feaa

View File

@@ -1,35 +1,36 @@
# Node Service # Node Service
Get Alfresco Repository node metadata and create nodes with metadata. Get Alfresco Repository node metadata and create nodes with metadata.
This service cannot be used to create nodes with content. This service cannot be used to create nodes with content.
## Methods ## Importing
#### getNodeMetadata(nodeId: string): Observable<NodeMetadata>
Get the metadata and type for passed in node ID (e.g. 3062d73b-fe47-4040-89d2-79efae63869c):
```ts ```ts
import { NodeService } from 'ng2-activiti-form'; import { NodeService } from '@alfresco/adf-core';
export class SomePageComponent implements OnInit { export class SomePageComponent implements OnInit {
constructor(private nodeService: NodeService) { constructor(private nodeService: NodeService) {
} }
```
ngOnInit() { ## Methods
#### getNodeMetadata(nodeId: string): Observable`<NodeMetadata>`
Get the metadata and type for passed in node ID (e.g. 3062d73b-fe47-4040-89d2-79efae63869c):
```ts
// Get the node reference from somewhere... // Get the node reference from somewhere...
const nodeId = '3062d73b-fe47-4040-89d2-79efae63869c'; const nodeId = '3062d73b-fe47-4040-89d2-79efae63869c';
this.nodeService.getNodeMetadata(nodeId).subscribe(data => { this.nodeService2.getNodeMetadata(nodeId).subscribe(data => {
const nodeMetadata = data.metadata; const nodeMetadata = data.metadata;
const nodeType = data.nodeType; const nodeType = data.nodeType;
},
this.handleError);
}
private handleError(err: any): any { console.log('nodeMetadata', nodeMetadata);
console.log('Error: ', err); console.log('nodeType', nodeType);
} }, error => {
console.log('Error: ', error);
});
``` ```
The metadata response doesn't include the `cm:auditable` properties (i.e. created, creator, modified, modifier, last access) The metadata response doesn't include the `cm:auditable` properties (i.e. created, creator, modified, modifier, last access)
@@ -51,37 +52,25 @@ such as `cm:content`.
Executing this method on a folder node returns no metadata, just the type. Executing this method on a folder node returns no metadata, just the type.
#### createNode(name: string, nodeType: string, properties: any, path: string): Observable<any> #### createNode(name: string, nodeType: string, properties: any, path: string): Observable`<any>`
Creates a node in the Alfresco Repository with passed in `name`, `nodeType`, and metadata `properties`. Creates a node in the Alfresco Repository with passed in `name`, `nodeType`, and metadata `properties`.
It will be created in the folder `path` that is passed in. It will be created in the folder `path` that is passed in.
```ts ```ts
import { NodeService } from 'ng2-activiti-form';
export class SomePageComponent implements OnInit {
constructor(private nodeService: NodeService) {
}
ngOnInit() {
const nodePath = '/Guest Home'; const nodePath = '/Guest Home';
const nodeName = 'someFolder'; const nodeName = 'someFolder';
const nodeType = 'cm:folder'; const nodeType = 'cm:folder';
const properties = { const properties = {
'cm:title': 'Some title', 'cm:title': 'Some title',
'cm:description': 'Some description' 'cm:description': 'Some description'
} };
this.nodeService.createNode(nodeName, nodeType, properties, nodePath).subscribe(nodeInfo => { this.nodeService2.createNode(nodeName, nodeType, properties, nodePath).subscribe(nodeInfo => {
console.log('Node info: ', nodeInfo); console.log('New Node info: ', nodeInfo);
}, }, error => {
this.handleError); console.log('Error: ', error);
} });
private handleError(err: any): any {
console.log('Error: ', err);
}
``` ```
Note that the `path` property should not include **/Company Home**. Note that the `path` property should not include the **/Company Home** bit.
The response includes all metadata about the new node: The response includes all metadata about the new node:
@@ -101,37 +90,25 @@ entry:
properties: {cm:title: "Some title", cm:description: "Some description"} properties: {cm:title: "Some title", cm:description: "Some description"}
``` ```
#### createNodeMetadata(nodeType: string, nameSpace: any, data: any, path: string, name?: string): Observable<any> #### createNodeMetadata(nodeType: string, nameSpace: any, data: any, path: string, name?: string): Observable`<any>`
This is a convenience method if your property list is missing namespace prefix for property names. This is a convenience method if your property list is missing namespace prefix for property names.
The namespace prefix can then be supplied separately and this method will prepend it automatically. The namespace prefix can then be supplied separately and this method will prepend it automatically.
This method calls the `createNode` method internally: This method calls the `createNode` method internally:
```ts ```ts
import { NodeService } from 'ng2-activiti-form';
export class SomePageComponent implements OnInit {
constructor(private nodeService: NodeService) {
}
ngOnInit() {
const nodePath = '/Guest Home'; const nodePath = '/Guest Home';
const nodeName = 'someFolder'; const nodeName = 'someOtherFolder';
const nodeType = 'cm:folder'; const nodeType = 'cm:folder';
const propNamespacePrefix = 'cm'; const propNamespacePrefix = 'cm';
const properties = { const properties = {
'title': 'Some title', 'title': 'Some title',
'description': 'Some description' 'description': 'Some description'
} };
this.nodeService.createNodeMetadata(nodeType, propNamespacePrefix, properties, nodePath, nodeName).subscribe(nodeInfo => { this.nodeService2.createNodeMetadata(nodeType, propNamespacePrefix, properties, nodePath, nodeName).subscribe(nodeInfo => {
console.log('Node info: ', nodeInfo); console.log('New Node info: ', nodeInfo);
}, }, error => {
this.handleError); console.log('Error: ', error);
} });
private handleError(err: any): any {
console.log('Error: ', err);
}
``` ```
See the `createNode` method for information about the response object. See the `createNode` method for information about the response object.