{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Wichtige Elemente des ECUI Clients sind hier beschrieben. Das ermöglicht ein besseres Verständnis für den Code aus dem bereits vorher zur Verfügung gestellten ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://encodo.atlassian.net/wiki/spaces/EB/pages/154828814"}},{"text":".","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"669aa25b-cc20-438e-9b05-96395b71d723"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"9b49e18f-b0b9-41dc-b307-dcef50d0a679"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Application Setup","type":"text"}]},{"type":"paragraph","content":[{"text":"Quino is leaning onto the general application approach that is also present in Quino-Standard and Quino-WebAPI.","type":"text"}]},{"type":"paragraph","content":[{"text":"An app normally wants to configure the modules it needs to run. The ","type":"text"},{"text":"QuinoApplicationRoot","type":"text","marks":[{"type":"code"}]},{"text":" component does most of the heavy lifting there for you. You can configure the setup of the app in the ","type":"text"},{"text":"setup","type":"text","marks":[{"type":"code"}]},{"text":" callback that has to be passed into the props of the component.","type":"text"}]},{"type":"paragraph","content":[{"text":"For most apps something like this will be sufficient:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"csharp"},"content":[{"text":"QuinoCoreModule.use(app);\nUIModule.use(app);\nDevExpressModule.use(app);\n","type":"text"}]},{"type":"paragraph","content":[{"text":"The final implementation then looks something like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":" {\n QuinoCoreModule.use(app);\n UIModule.use(app);\n DevExpressModule.use(app);\n }} onReady={(app) => {\n // Quino is ready and startup has been excuted.\n }}>\n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Service registrations","type":"text"}]},{"type":"paragraph","content":[{"text":"Sometimes it's necessary to override standard services to customize the behaviour. The application provides methods to do so.","type":"text"}]},{"type":"codeBlock","content":[{"text":"IApplication.register(identifier: Symbol, TImplementation): IApplication\nIApplication.registerSingle(identifier: Symbol, TImplementation): IApplication\nIApplication.registerConstant(identifier: Symbol, TImplementation): IApplication\n","type":"text"}]},{"type":"paragraph","content":[{"text":"An actual override could look like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"IApplication.register(QuinoCoreServiceSymbols.IRequestBuilder, RequestBuilder);\nIApplication.registerSingle(QuinoCoreServiceSymbols.ILogger, ConsoleLogger);\nIApplication.registerConstant(QuinoCoreServiceSymbols.IStorage, localStorage);\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Startup actions","type":"text"}]},{"type":"paragraph","content":[{"text":"The Quino application supports startup actions that can be used to execute actions before the app is ready. The following methods are available:","type":"text"}]},{"type":"codeBlock","content":[{"text":"IApplication.registerStartupAction(actionIdentifier: Symbol, (app) => {\n // Initialize your service and return a Promise or void.\n })\n","type":"text"}]},{"type":"paragraph","content":[{"text":"If you want to disable a startup action you can do so:","type":"text"}]},{"type":"codeBlock","content":[{"text":"IApplication.unregisterStartupAction(actionIdentifier: Symbol);\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Per default actions registered by the application will execute in parallel. This can be configured by adding additional groups. Behind the scenes all actions that register via the application get assigned to the ","type":"text"},{"text":"ApplicationStartupGroup","type":"text","marks":[{"type":"code"}]},{"text":". To register an additional startup group which will execute after all other groups:","type":"text"}]},{"type":"codeBlock","content":[{"text":"IApplication.registerStartupGroup(groupSymbol: Symbol);\n","type":"text"}]},{"type":"paragraph","content":[{"text":"To move an action to the specific group you can do so:","type":"text"}]},{"type":"codeBlock","content":[{"text":"IApplication.registerStartupAction(actionIdentifier: Symbol, (app) => {\n // Initialize your service and return a Promise or void.\n }).moveTo(groupSymbol);\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Reducers","type":"text"}]},{"type":"paragraph","content":[{"text":"Quino provides a set of reducers that provide some convenience functions.","type":"text"}]},{"type":"paragraph","content":[{"text":"To use a service registered in the IoC:","type":"text"}]},{"type":"codeBlock","content":[{"text":"const metaService = useService(QuinoCoreServiceSymbols.IMetadataTree);\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Your component must be a child of the ","type":"text"},{"text":"QuinoApplicationRoot","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Retrieve the label settings which are resolved over the ","type":"text"},{"text":"IQuinoLabelConfigurationService","type":"text","marks":[{"type":"code"}]},{"text":" and the ","type":"text"},{"text":"ILabelSettings","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"const labelSettings = useLabelSettings(element);\n","type":"text"}]},{"type":"paragraph","content":[{"text":"To retrieve metadata related to the ","type":"text"},{"text":"IMetaElement","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"const { readOnly, required, enabled } = useMetadata(metaProperty, bookmark.genericObject);\n","type":"text"}]},{"type":"paragraph","content":[{"text":"To get the related data source from an ","type":"text"},{"text":"IMetaRelation","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"const source = useRelatedSource(metaRelation, bookmark.genericObject);\n","type":"text"}]},{"type":"paragraph","content":[{"text":"To use a promise inside a component:","type":"text"}]},{"type":"codeBlock","content":[{"text":"const [loadResult, error] = usePromise(() => loadData(), [metaClass]);","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Storage","type":"text"}]},{"type":"paragraph","content":[{"text":"here are three main storage types supported:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"InMemoryStorage - only store the data while the app is in use. A refresh of the browser will discard the settings.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"LocalStorage - working according to the standard defined ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PersistentStorage - user based settings that are stored in the database if the client is configured accordingly.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Each storage is registered with it's own symbol and can therefore be overridden with a different implementation. For example if a server does not support the persistent settings the ","type":"text"},{"text":"LocalStorageService","type":"text","marks":[{"type":"code"}]},{"text":" could be registered to take place for the ","type":"text"},{"text":"PersistentStorageService","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"More specialized components that rely heavily on the usage of settings normally offer their own settings service to allow more specific customization of the behavior.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":596,"id":"b1464d66-555b-4916-9dc1-4c7b1c305f19","collection":"contentId-251330571","type":"file","height":572}},{"type":"caption","content":[{"text":"An example on how different storages are leveraged by different services.","type":"text"}]}]},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"}],"version":1}

Browser not supported